Whamcloud - gitweb
- add manual pages with configuration help.
[fs/lustre-release.git] / lustre / doc / lconf.lyx
1 #LyX 1.2 created this file. For more info see http://www.lyx.org/
2 \lyxformat 220
3 \textclass amsart
4 \language english
5 \inputencoding auto
6 \fontscheme times
7 \graphics default
8 \paperfontsize default
9 \spacing single 
10 \papersize letterpaper
11 \paperpackage a4
12 \use_geometry 0
13 \use_amsmath 0
14 \use_natbib 0
15 \use_numerical_citations 0
16 \paperorientation portrait
17 \secnumdepth 3
18 \tocdepth 3
19 \paragraph_separation skip
20 \defskip medskip
21 \quotes_language english
22 \quotes_times 2
23 \papercolumns 1
24 \papersides 1
25 \paperpagestyle default
26
27 \layout Section
28
29 lconf
30 \layout Subsection
31
32 NAME
33 \layout Standard
34
35 lctl - low level Lustre file system configuration utility
36 \layout Subsection
37
38 SYNOPSIS
39 \layout Standard
40
41
42 \series bold 
43 lconf\SpecialChar ~
44 [--node <node_name>] [--cleanup] [--noexec] [--gdb] <XML-config file>
45 \layout Subsection
46
47 DESCRIPTION
48 \layout Standard
49
50 This program configures a node following directives in the <XML-config-file>
51 \layout Description
52
53 --node\SpecialChar ~
54 node_name Specifiy a specific node to configure.
55  By default, LCONF will search for nodes with the local hostname and 'localhost'.
56  When --node is used, only node_name is searched for.
57  If a matching node is not found in the config, then LCONF exits with an
58  error.
59 \layout Description
60
61 --cleanup Unconfigure a node.
62  The same config and --node argument used for configuration needs to be
63  used for cleanup as well.
64  This will attempt to undo all of the configuration steps done by LCONF,
65  including unloading the kernel modules.
66 \layout Description
67
68 --noexec Print, but don't execute, the steps lconf will perform.
69  This is useful for debugging a configuration, and when used with --node,
70  can be run on any host.
71 \layout Description
72
73 --gdb Causes LCONF to print a message and pause for 5 seconds after creating
74  a gdb module script and before doing any lustre configuration.
75  (The gdb module script is always created, however.)
76 \layout Subsection
77
78 EXAMPLES
79 \layout Standard
80
81 On client nodes this is typically invoked as 
82 \layout LyX-Code
83
84 lconf --node client config.xml
85 \layout Standard
86
87 in order to give clients, regardless of hostname a single configuration.
88 \layout Subsection
89
90 BUGS
91 \layout Standard
92
93 None are known.
94 \layout Subsection
95
96 AUTHOR
97 \layout Standard
98
99 Cluster File Systems, Inc.
100  2002 - created
101 \the_end