X-Git-Url: https://git.whamcloud.com/?a=blobdiff_plain;f=lustre%2Fdoc%2Flconf.lyx;h=a7d8b6284adbc386bd2f6f3fc0b4531d71e7c731;hb=d5bf8446026361ad93cce6a85c6c148709bd96f2;hp=85c670b51f04d577c2b9007cd2170dc4963a2860;hpb=96ec6856f91f7f9031cfce4273c714d72cfe59ae;p=fs%2Flustre-release.git diff --git a/lustre/doc/lconf.lyx b/lustre/doc/lconf.lyx index 85c670b..a7d8b62 100644 --- a/lustre/doc/lconf.lyx +++ b/lustre/doc/lconf.lyx @@ -1,5 +1,5 @@ -#LyX 1.2 created this file. For more info see http://www.lyx.org/ -\lyxformat 220 +#LyX 1.3 created this file. For more info see http://www.lyx.org/ +\lyxformat 221 \textclass amsart \language english \inputencoding auto @@ -48,7 +48,7 @@ lconf\SpecialChar ~ DESCRIPTION \layout Standard -This program configures a node following directives in the .. +This program configures a node following directives in the . There will be single configuration file for all the nodes in a single cluster. This file should be distributed to all the nodes in the cluster or kept in a location accessible to all the nodes. @@ -56,32 +56,16 @@ This program configures a node following directives in the .. on an LDAP server that can be reached from all the cluster nodes. \layout Description ---ldapurl\SpecialChar ~ - LDAP server URL +--client_uuid\SpecialChar ~ + The failed client (required for recovery). \layout Description --config\SpecialChar ~ Cluster configuration name used for LDAP query \layout Description ---select\SpecialChar ~ - Select a particular node for a service -\layout Description - ---node\SpecialChar ~ -node_name Specify a specific node to configure. - By default, lconf will search for nodes with the local hostname and 'localhost'. - When -\emph on - --node -\emph default - is used, only -\emph on -node_name -\emph default - is searched for. - If a matching node is not found in the config, then lconf exits with an - error. +--conn_uuid\SpecialChar ~ + The failed connection (required for recovery). \layout Description --d|--cleanup Unconfigure a node. @@ -94,12 +78,18 @@ node_name including unloading the kernel modules. \layout Description ---force Forced unmounting and/or obd detach during cleanup. - Default is 0. - +--debug_path\SpecialChar ~ + Path to save debug dumps. \layout Description ---mds_ost_conn Open connections to OSTs on MDS. +--dump\SpecialChar ~ + Dump the kernel debug log to the specified file before portals + is unloaded during cleanup. +\layout Description + +--dump_path\SpecialChar ~ + Path to save debug dumps. + Default is /tmp/lustre_log \layout Description --failover Used to shutdown without saving state. @@ -109,12 +99,9 @@ node_name This will not be a clean shutdown. \layout Description ---noexec Print, but don't execute, the steps lconf will perform. - This is useful for debugging a configuration, and when used with -\emph on ---node -\emph default -, can be run on any host. +--force Forced unmounting and/or obd detach during cleanup. + Default is 0. + \layout Description --gdb Causes lconf to print a message and pause for 5 seconds after creating @@ -127,33 +114,28 @@ node_name Default is /tmp/ogdb. \layout Description ---dump_path\SpecialChar ~ - Path to save debug dumps. - Default is /tmp/lustre_log -\layout Description - ---recover\SpecialChar ~ - Recover a device. -\layout Description - ---nosetup Only load modules, do not configure devices or services. -\layout Description - --group\SpecialChar ~ - The group of devices tol cleanup/configure. + The group of devices to cleanup/configure. \layout Description ---nomod Only setup devices and services, do not load modules. +-h,--help Print help. \layout Description ---noexec,-n Don't do anything, but print what would happen. +--inactive\SpecialChar ~ + The UUID of the service to be ignored by a client mounting + Lustre. + Allows the client to mount in the presence of some inactive services. + (currently OST only). + Multiple UUIDs can be specified by repeating the option. + \layout Description ---verbose,-v Be verbose and show actions while going along. +--lctl-dump\SpecialChar ~ + Dump all ioctls to the specified file \layout Description ---timeout\SpecialChar ~ - Set the recovery timeout period. +--ldapurl\SpecialChar ~ + LDAP server URL \layout Description --lustre_upcall\SpecialChar ~ @@ -161,30 +143,11 @@ node_name by the client for recovery \layout Description ---portals_upcall\SpecialChar ~ - Specify the location of the Portals upcall scripts - used by the client for recovery -\layout Description - ---upcall\SpecialChar ~ - Set the location of both Lustre and Portals upcall scripts - used by the client for recovery -\layout Description - ---lctl-dump\SpecialChar ~ - Dump all ioctls to the specified file -\layout Description - ---dump\SpecialChar ~ - Dump the kernel debug log to the specified file before portals - is unloaded during cleanup. -\layout Description - ---reformat Reformat all the devices. - This is essential on the first time the file system is brought up. +--lustre=src_dir Specify the base directory for Lustre sources, this parameter + will cause lconf to load the lustre modules from this soure tree. \layout Description --h,--help Print help. +--mds_ost_conn Open connections to OSTs on MDS. \layout Description --maxlevel\SpecialChar ~ @@ -209,24 +172,137 @@ When used in conjunction with cleanup, services are torn down up to a certain Default is 0. \layout Description ---lustre=src_dir Specify the base directory for Lustre sources, this parameter - will cause lconf to load the lustre modules from this soure tree. +--mkfsoptions\SpecialChar ~ + Specify additional options for the mk*fs command + line. \layout Description ---portals=src_dir Portals source directory. - If this is a relative path, it is assumed to be relative to Lustre source - tree location. +--mountfsoptions\SpecialChar ~ + Specify additional options for mount fs command + line. + Mount options will be passed by this argument. + For example, extents are to be enabled by adding +\begin_inset Quotes eld +\end_inset + +,extents +\begin_inset Quotes erd +\end_inset + + to the --mountfsoptions option. +\begin_inset Quotes eld +\end_inset + +errors=remount-ro +\begin_inset Quotes erd +\end_inset + + and +\begin_inset Quotes eld +\end_inset + +asyncdel +\begin_inset Quotes erd +\end_inset + + can also be added to it. +\layout Description + +--node\SpecialChar ~ +node_name Specify a specific node to configure. + By default, lconf will search for nodes with the local hostname and 'localhost'. + When +\emph on + --node +\emph default + is used, only +\emph on +node_name +\emph default + is searched for. + If a matching node is not found in the config, then lconf exits with an + error. +\layout Description + +--noexec,-n Print, but don't execute, the steps lconf will perform. + This is useful for debugging a configuration, and when used with +\emph on +--node +\emph default +, can be run on any host. +\layout Description + +--nomod Only setup devices and services, do not load modules. +\layout Description + +--nosetup Only load modules, do not configure devices or services. +\layout Description + +--portals\SpecialChar ~ + Specify portals source directory. + If this is a relative path, then it is assumed to be relative to lustre. +\layout Description + +--portals_upcall\SpecialChar ~ + Specify the location of the Portals upcall scripts + used by the client for recovery \layout Description --ptldebug\SpecialChar ~ debug\SpecialChar ~ level This options can be used to set the required debug - level + level. +\layout Description + +--record Write config information on mds. +\layout Description + +--record_log\SpecialChar ~ + Specify the name of config record log. +\layout Description + +--record_device\SpecialChar ~ + Specify MDS device name that will record the config + commands. +\layout Description + +--recover\SpecialChar ~ + Recover a device. +\layout Description + +--reformat Reformat all the devices. + This is essential on the first time the file system is brought up. +\layout Description + +--select\SpecialChar ~ + Select a particular node for a service +\layout Description + +--single_socket Specify socknal option: only use one socket instead of bundle. \layout Description --subsystem\SpecialChar ~ - Set the portals debug subsystem + Set the portals debug subsystem. +\layout Description + +--tgt_uuid\SpecialChar ~ + Specify the failed target (required for recovery). +\layout Description + +--timeout\SpecialChar ~ + Set the recovery timeout period. +\layout Description + +--upcall\SpecialChar ~ + Set the location of both Lustre and Portals upcall scripts + used by the client for recovery +\layout Description + +--verbose,-v Be verbose and show actions while going along. +\layout Description + +--write_conf Save all client configuration information on the MDS \layout Subsection EXAMPLES @@ -282,6 +358,16 @@ ldlm|ha \end_inset +\layout Standard + +A subset of failed OSTs can be ignored during Lustre mount on the clients + by using the following option: +\layout LyX-Code + + lconf --inactive OST_ost1_UUID --inactive OST_ost2_UUID config.xml +\layout Standard + +where OST1 and OST2 have failed and need to be ignored. \layout Subsection BUGS