1 #LyX 1.2 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 --ldapurl\SpecialChar ~
63 --config\SpecialChar ~
64 <arg> Cluster configuration name used for LDAP query
67 --select\SpecialChar ~
68 <arg> Select a particular node for a service
72 node_name Specify a specific node to configure.
73 By default, lconf will search for nodes with the local hostname and 'localhost'.
83 If a matching node is not found in the config, then lconf exits with an
87 --d|--cleanup Unconfigure a node.
92 argument used for configuration needs to be used for cleanup as well.
93 This will attempt to undo all of the configuration steps done by lconf,
94 including unloading the kernel modules.
97 --force Forced unmounting and/or obd detach during cleanup.
102 --mds_ost_conn Open connections to OSTs on MDS.
105 --failover Used to shutdown without saving state.
107 This will allow the node to give up service to another node for failover
109 This will not be a clean shutdown.
112 --noexec Print, but don't execute, the steps lconf will perform.
113 This is useful for debugging a configuration, and when used with
117 , can be run on any host.
120 --gdb Causes lconf to print a message and pause for 5 seconds after creating
121 a gdb module script and before doing any Lustre configuration (the gdb
122 module script is always created, however).
125 --gdb_script\SpecialChar ~
126 <arg> Full name of gdb debug script.
127 Default is /tmp/ogdb.
130 --dump_path\SpecialChar ~
131 <arg> Path to save debug dumps.
132 Default is /tmp/lustre_log
135 --recover\SpecialChar ~
136 <arg> Recover a device.
139 --nosetup Only load modules, do not configure devices or services.
142 --group\SpecialChar ~
143 <arg> The group of devices to cleanup/configure.
146 --nomod Only setup devices and services, do not load modules.
149 --noexec,-n Don't do anything, but print what would happen.
150 Useful for debugging purposes.
153 --verbose,-v Be verbose and show actions while going along.
156 --timeout\SpecialChar ~
157 <arg> Set the recovery timeout period.
160 --lustre_upcall\SpecialChar ~
161 <path> Set the location of the Lustre upcall scripts used
162 by the client for recovery
165 --portals_upcall\SpecialChar ~
166 <path> Specify the location of the Portals upcall scripts
167 used by the client for recovery
170 --upcall\SpecialChar ~
171 <path> Set the location of both Lustre and Portals upcall scripts
172 used by the client for recovery
175 --lctl-dump\SpecialChar ~
176 <arg> Dump all ioctls to the specified file
180 <file> Dump the kernel debug log to the specified file before portals
181 is unloaded during cleanup.
184 --reformat Reformat all the devices.
185 This is essential on the first time the file system is brought up.
188 -h,--help Print help.
191 --maxlevel\SpecialChar ~
192 <level> Perform configuration of devices and services up to level
203 When used in conjunction with cleanup, services are torn down up to a certain
208 --minlevel\SpecialChar ~
209 <level> Specify the minimum level of services to configure/cleanup.
213 --lustre=src_dir Specify the base directory for Lustre sources, this parameter
214 will cause lconf to load the lustre modules from this soure tree.
217 --ptldebug\SpecialChar ~
219 level This options can be used to set the required debug
223 --subsystem\SpecialChar ~
224 <arg> Set the portals debug subsystem.
230 On client nodes this is typically invoked as:
235 lconf --node client config.xml
238 in order to give clients, regardless of hostname, a single configuration.
241 Required debug levels can be set like this:
246 ## Everything but these
252 \begin_inset Quotes eld
255 ~(portals | malloc | trace)
256 \begin_inset Quotes erd
266 ## Only these debug types
272 \begin_inset Quotes eld
276 \begin_inset Quotes erd