1 #LyX 1.3 created this file. For more info see http://www.lyx.org/
10 \papersize letterpaper
15 \use_numerical_citations 0
16 \paperorientation portrait
19 \paragraph_separation skip
21 \quotes_language english
25 \paperpagestyle default
35 lconf Lustre filesystem configuration utility.
44 [--node <node_name>] [-d,--cleanup] [--noexec] [--gdb] [--nosetup]
45 [--nomod] [-n,--noexec] [-v,--verbose] [-h,--help] <XML-config file>
51 This program configures a node following directives in the <XML-config-file>.
52 There will be single configuration file for all the nodes in a single cluster.
53 This file should be distributed to all the nodes in the cluster or kept
54 in a location accessible to all the nodes.
55 One option is to store the cluster configuration information in LDAP format
56 on an LDAP server that can be reached from all the cluster nodes.
59 --config\SpecialChar ~
60 <arg> Cluster configuration name used for LDAP query
63 --d|--cleanup Unconfigure a node.
68 argument used for configuration needs to be used for cleanup as well.
69 This will attempt to undo all of the configuration steps done by lconf,
70 including unloading the kernel modules.
74 <file> Dump the kernel debug log to the specified file before portals
75 is unloaded during cleanup.
78 --dump_path\SpecialChar ~
79 <arg> Path to save debug dumps.
80 Default is /tmp/lustre_log
83 --failover Used to shutdown without saving state.
85 This will allow the node to give up service to another node for failover
87 This will not be a clean shutdown.
90 --force Forced unmounting and/or obd detach during cleanup.
95 --gdb Causes lconf to print a message and pause for 5 seconds after creating
96 a gdb module script and before doing any Lustre configuration (the gdb
97 module script is always created, however).
100 --gdb_script\SpecialChar ~
101 <arg> Full name of gdb debug script.
102 Default is /tmp/ogdb.
105 --group\SpecialChar ~
106 <arg> The group of devices to cleanup/configure.
109 -h,--help Print help.
112 --inactive\SpecialChar ~
113 <UUID> The UUID of the service to be ignored by a client mounting
115 Allows the client to mount in the presence of some inactive services.
116 (currently OST only).
117 Multiple UUIDs can be specified by repeating the option.
121 --lctl-dump\SpecialChar ~
122 <arg> Dump all ioctls to the specified file
125 --ldapurl\SpecialChar ~
126 <arg> LDAP server URL
129 --lustre_upcall\SpecialChar ~
130 <path> Set the location of the Lustre upcall scripts used
131 by the client for recovery
134 --lustre=src_dir Specify the base directory for Lustre sources, this parameter
135 will cause lconf to load the lustre modules from this soure tree.
138 --mds_ost_conn Open connections to OSTs on MDS.
141 --maxlevel\SpecialChar ~
142 <level> Perform configuration of devices and services up to level
153 When used in conjunction with cleanup, services are torn down up to a certain
158 --minlevel\SpecialChar ~
159 <level> Specify the minimum level of services to configure/cleanup.
164 node_name Specify a specific node to configure.
165 By default, lconf will search for nodes with the local hostname and 'localhost'.
175 If a matching node is not found in the config, then lconf exits with an
179 --noexec,-n Print, but don't execute, the steps lconf will perform.
180 This is useful for debugging a configuration, and when used with
184 , can be run on any host.
187 --nomod Only setup devices and services, do not load modules.
190 --nosetup Only load modules, do not configure devices or services.
193 --portals_upcall\SpecialChar ~
194 <path> Specify the location of the Portals upcall scripts
195 used by the client for recovery
198 --ptldebug\SpecialChar ~
200 level This options can be used to set the required debug
204 --recover\SpecialChar ~
205 <arg> Recover a device.
208 --reformat Reformat all the devices.
209 This is essential on the first time the file system is brought up.
212 --select\SpecialChar ~
213 <arg> Select a particular node for a service
216 --subsystem\SpecialChar ~
217 <arg> Set the portals debug subsystem.
220 --timeout\SpecialChar ~
221 <arg> Set the recovery timeout period.
224 --upcall\SpecialChar ~
225 <path> Set the location of both Lustre and Portals upcall scripts
226 used by the client for recovery
229 --verbose,-v Be verbose and show actions while going along.
232 --write_conf Save all client configuration information on the MDS
238 On client nodes this is typically invoked as:
243 lconf --node client config.xml
246 in order to give clients, regardless of hostname, a single configuration.
249 Required debug levels can be set like this:
254 ## Everything but these
260 \begin_inset Quotes eld
263 ~(portals | malloc | trace)
264 \begin_inset Quotes erd
274 ## Only these debug types
280 \begin_inset Quotes eld
284 \begin_inset Quotes erd
290 A subset of failed OSTs can be ignored during Lustre mount on the clients
291 by using the following option:
294 lconf --inactive OST_ost1_UUID --inactive OST_ost2_UUID config.xml
297 where OST1 and OST2 have failed and need to be ignored.