X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Fmount.lustre.8;h=f2fb607e4418dce54a625be23f3224265567de4d;hb=c30da8bfa199205194eefca2c5d2e6843a29a34b;hp=2b77c23409ac4d18804bf6654631c5086b31e96c;hpb=105e695731e129b3cd1c10827c02d12aee35a033;p=fs%2Flustre-release.git diff --git a/lustre/doc/mount.lustre.8 b/lustre/doc/mount.lustre.8 index 2b77c23..f2fb607 100644 --- a/lustre/doc/mount.lustre.8 +++ b/lustre/doc/mount.lustre.8 @@ -1,52 +1,60 @@ .\" -*- nroff -*- .\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved. .\" -.\" Copyright (c) 2012, 2016, Intel Corporation. +.\" Copyright (c) 2012, 2017, Intel Corporation. .\" .\" This file may be copied under the terms of the GNU Public License v2. .\" -.TH mount.lustre 8 "2008 Mar 15" Lustre "configuration utilities" +.TH mount.lustre 8 "2019 Jul 30" Lustre "configuration utilities" .SH NAME -mount.lustre \- start a Lustre client or target service +mount.lustre \- mount helper for Lustre client +mount.lustre_tgt \- mount helper for Lustre target service .SH SYNOPSIS .br -.BI "mount \-t lustre [\-o " options "] " "device mountpoint" +.BI "mount -t lustre [-o " options "] " ":/ " +.br +.BI "mount -t lustre_tgt [-o " options "] " " " .SH DESCRIPTION .B mount.lustre -is used to start a Lustre client or target service. This program should not be -called directly; rather it is a helper program invoked through +and +.B mount.lustre_tgt +are used to start a Lustre client or target service, respectively. They +should not be called directly; rather they are helper programs invoked through .BR mount (8) -as above. Lustre clients and targets are stopped by using the +as above when the +.B lustre +or +.B lustre_tgt +filesystem type is used. Lustre clients and targets are stopped by using the .BR umount (8) command. .br -There are two forms for the -.I device -option, depending on whether a client or a target service is started: +There are two forms for the device option passed to the +.I mount +command, depending on whether a client or a target service is started: .TP .IR :/ [/] -mounts the Lustre filesystem named +mounts the Lustre client filesystem named .I fsname (optionally starting at subdirectory .I subdir within the filesystem, if specified) on the client at the directory -.IR mountpoint , +.IR client_mountpoint , by contacting the Management Service at .IR mgsname . The format for .I mgsname -is defined below. A client filesystem can be listed in +is defined below. A client filesystem will typically be listed in .BR fstab (5) for automatic mount at boot time, is usable like any local filesystem, and provides a full POSIX-compilant interface. .TP .I block_device -starts the target service defined by the +specifies the phyisical disk or ZFS dataset uses to start the target service +formatted by the .IR mkfs.lustre (8) -command on the physical disk -.IR block_device . -The +command. The .I block_device may be specified using .BI -L label @@ -62,7 +70,7 @@ or similar. The mounted target service filesystem at .I mountpoint is only useful for .BR df (1) -operations and appears in +operations to show the current space usage, and appears in .BR /proc/mounts to show the device is in use. .SH OPTIONS @@ -80,8 +88,8 @@ and may be running on any one of the nodes. .BI := [,] Each .I mgsnode -may be specify a comma-separated list of NIDs, if there are different -LNet interfaces for that +may specify a comma-separated list of NIDs, if there are different +LNet interfaces for the same .IR mgsnode . .TP .BI mgssec= flavor @@ -150,7 +158,7 @@ support entirely, and is the default option. Applications calling .BR flock(2) will get an .B ENOSYS -error. It is up to theadministrator to choose either the +error. It is up to the administrator to choose either the .B localflock or .B flock @@ -187,13 +195,14 @@ Disable use of extended attributes by regular users. Root and system processes Force a client to keep pinging even if servers have enabled suppress_pings. .TP .BI verbose -Enable mount/umount console messages. +Enable mount/remount/umount console messages. .TP .BI noverbose -Disable mount/umount console messages. +Disable mount/remount/umount console messages. .TP .BI user_fid2path -Enable FID to path translation by regular users. +Enable FID to path translation by regular users via +.BR "lfs fid2path" . .TP .BI nouser_fid2path Disable FID to path translation by regular users. Root and process with @@ -206,7 +215,13 @@ This option can be useful in case of several Lustre client mount points on the same node, with each mount point using a different network. It is also interesting when running Lustre clients from containers, by restricting each container to a specific network. -.SH CLIENT OPTIONS +.PP +.RS +Warning! 'network' option is incompatible with LNet Dynamic Peer Discovery. +If you want to restrict client NID, please make sure LNet Dynamic Peer Discovery +is disabled. +.RE +.SH SERVER OPTIONS In addition to the standard mount options and backing disk type (e.g. ldiskfs) options listed in .BR mount (8), @@ -215,24 +230,37 @@ Lustre understands the following options: .TP .BI acl -Enable POSIX Access Control List support. See the +Enable POSIX Access Control List support for all clients. See the .BR acl (5) manual page. .TP -.BI noacl -Disable Access Control List support. +.BI no_precreate +Do not allow objects to be created on the OST after mounting. This +allows a (potentially newly-formatted) OST to be started without +clients starting to use it immediately. To allow the MDS to create +objects on the OST mount without this option, or run +.BI "lctl set_param obdfilter." fsname -OST nnnn .no_precreate=0 +on the OSS to re-enable object creation. +.BR NOTE : +this does not start the OST read-only, it only disables the +creation of new objects on the OST. This means existing objects +can be read, modified, or deleted, but if the OST is new then it +will not have any such objects. .TP .BI nosvc -Only start the MGC (and MGS, if co-located) for a target service, and not the actual service. +Only start the MGC (and MGS, if co-located) for a target service, +and not the actual MDS or OSS service. .TP .BI nomgs -Start a MDT with a co-located MGS without starting the MGS. +Start an MDT with a co-located MGS without starting the MGS service. .TP .BI noscrub -Not trigger OI scrub automatically when detect some inconsistency, unless it is started explicitly. +Do not trigger OI scrub automatically when an inconsistency is detected. +It is still possible to start explicitly using the +.BR "lctl lfsck_start" . .TP .BI skip_lfsck -Not resume the former paused/crashed LFSCK automatically when mount. +Do not resume the former paused/crashed LFSCK automatically when mounting. .TP .BI abort_recov Abort client recovery and start the target service immediately. @@ -286,17 +314,17 @@ tries the second one. On each service node, the comma-separated NIDs refer to different interfaces on the same host, and the Lustre client chooses the best one for communication based on which network interfaces are available locally. .TP -.B mount -t lustre /dev/sda1 /mnt/test/mdt +.B mount -t lustre_tgt /dev/sda1 /mnt/test/mdt Start the Lustre metadata target service from .B /dev/sda1 on mountpoint .BR /mnt/test/mdt . .TP -.B mount -t lustre -L testfs-MDT0000 -o abort_recov /mnt/test/mdt +.B mount -t lustre_tgt -L testfs-MDT0000 -o abort_recov /mnt/test/mdt Start the .B testfs-MDT0000 -service (by using the disk label), but aborts the recovery process if -all of the clients are known to be unavailable. +service (by using the disk label), but aborts the Lustre client recovery +process for the case that clients are known to be unavailable. .SH BUGS Not very many mount options can be changed with .BR "-o remount" .