Whamcloud - gitweb
- add collaborative caching document. Radhika: one more pass and add
[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 lconf- 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>] [-d,--cleanup] [--noexec] [--gdb] [--nosetup]
45  [--nomod] [-n,--noexec] [-v,--verbose] [-h,--help] <XML-config file>
46 \layout Subsection
47
48 DESCRIPTION
49 \layout Standard
50
51 This program configures a node following directives in the <XML-config-file>
52 \layout Description
53
54 --node\SpecialChar ~
55 node_name Specifiy a specific node to configure.
56  By default, LCONF will search for nodes with the local hostname and 'localhost'.
57  When --node is used, only node_name is searched for.
58  If a matching node is not found in the config, then LCONF exits with an
59  error.
60 \layout Description
61
62 --cleanup Unconfigure a node.
63  The same config and --node argument used for configuration needs to be
64  used for cleanup as well.
65  This will attempt to undo all of the configuration steps done by LCONF,
66  including unloading the kernel modules.
67 \layout Description
68
69 --noexec Print, but don't execute, the steps lconf will perform.
70  This is useful for debugging a configuration, and when used with --node,
71  can be run on any host.
72 \layout Description
73
74 --gdb Causes LCONF to print a message and pause for 5 seconds after creating
75  a gdb module script and before doing any lustre configuration.
76  (The gdb module script is always created, however.)
77 \layout Description
78
79 --nosetup Only load modules, do not configure devices or services
80 \layout Description
81
82 --nomod Only setup devices and services, do not load modules
83 \layout Description
84
85 --noexec,-n Don't do anything, but print what would happen.
86 \layout Description
87
88 --verbose,-v Be verbose and show actions while going along
89 \layout Description
90
91 -h,--help Print help.
92 \layout Description
93
94 --maxlevel\SpecialChar ~
95 <level> [NOT IMPLEMENTED] Perform configuration of devices and
96  services up to level given.
97  
98 \emph on 
99 level
100 \emph default 
101  can take the values 
102 \series bold 
103 net, dev, svc, fs.
104  
105 \series default 
106 When used in conjunction with cleanup services are torn down up to a certain
107  level.
108 \layout Subsection
109
110 EXAMPLES
111 \layout Standard
112
113 On client nodes this is typically invoked as 
114 \layout LyX-Code
115
116 lconf --node client config.xml
117 \layout Standard
118
119 in order to give clients, regardless of hostname a single configuration.
120 \layout Subsection
121
122 BUGS
123 \layout Standard
124
125 None are known.
126 \layout Subsection
127
128 AUTHOR
129 \layout Standard
130
131 Cluster File Systems, Inc.
132  2002 - created
133 \the_end