root / man / gnt-node.sgml @ 9d95c3af
History | View | Annotate | Download (23.8 kB)
1 | a8083063 | Iustin Pop | <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [ |
---|---|---|---|
2 | a8083063 | Iustin Pop | |
3 | a8083063 | Iustin Pop | <!-- Fill in your name for FIRSTNAME and SURNAME. --> |
4 | a8083063 | Iustin Pop | <!-- Please adjust the date whenever revising the manpage. --> |
5 | d3b4cf9f | Iustin Pop | <!ENTITY dhdate "<date>February 12, 2009</date>"> |
6 | a8083063 | Iustin Pop | <!-- SECTION should be 1-8, maybe w/ subsection other parameters are |
7 | a8083063 | Iustin Pop | allowed: see man(7), man(1). --> |
8 | a8083063 | Iustin Pop | <!ENTITY dhsection "<manvolnum>8</manvolnum>"> |
9 | a8083063 | Iustin Pop | <!ENTITY dhucpackage "<refentrytitle>gnt-node</refentrytitle>"> |
10 | a8083063 | Iustin Pop | <!ENTITY dhpackage "gnt-node"> |
11 | a8083063 | Iustin Pop | |
12 | a8083063 | Iustin Pop | <!ENTITY debian "<productname>Debian</productname>"> |
13 | a8083063 | Iustin Pop | <!ENTITY gnu "<acronym>GNU</acronym>"> |
14 | a8083063 | Iustin Pop | <!ENTITY gpl "&gnu; <acronym>GPL</acronym>"> |
15 | a8083063 | Iustin Pop | <!ENTITY footer SYSTEM "footer.sgml"> |
16 | a8083063 | Iustin Pop | ]> |
17 | a8083063 | Iustin Pop | |
18 | a8083063 | Iustin Pop | <refentry> |
19 | a8083063 | Iustin Pop | <refentryinfo> |
20 | a8083063 | Iustin Pop | <copyright> |
21 | a8083063 | Iustin Pop | <year>2006</year> |
22 | a8083063 | Iustin Pop | <year>2007</year> |
23 | e7c6e02b | Michael Hanselmann | <year>2008</year> |
24 | d3b4cf9f | Iustin Pop | <year>2009</year> |
25 | a8083063 | Iustin Pop | <holder>Google Inc.</holder> |
26 | a8083063 | Iustin Pop | </copyright> |
27 | a8083063 | Iustin Pop | &dhdate; |
28 | a8083063 | Iustin Pop | </refentryinfo> |
29 | a8083063 | Iustin Pop | <refmeta> |
30 | a8083063 | Iustin Pop | &dhucpackage; |
31 | a8083063 | Iustin Pop | |
32 | a8083063 | Iustin Pop | &dhsection; |
33 | d3b4cf9f | Iustin Pop | <refmiscinfo>ganeti 2.0</refmiscinfo> |
34 | a8083063 | Iustin Pop | </refmeta> |
35 | a8083063 | Iustin Pop | <refnamediv> |
36 | a8083063 | Iustin Pop | <refname>&dhpackage;</refname> |
37 | a8083063 | Iustin Pop | |
38 | a8083063 | Iustin Pop | <refpurpose>node administration</refpurpose> |
39 | a8083063 | Iustin Pop | </refnamediv> |
40 | a8083063 | Iustin Pop | <refsynopsisdiv> |
41 | a8083063 | Iustin Pop | <cmdsynopsis> |
42 | a8083063 | Iustin Pop | <command>&dhpackage; </command> |
43 | a8083063 | Iustin Pop | |
44 | a8083063 | Iustin Pop | <arg choice="req">command</arg> |
45 | a8083063 | Iustin Pop | <arg>arguments...</arg> |
46 | a8083063 | Iustin Pop | </cmdsynopsis> |
47 | a8083063 | Iustin Pop | </refsynopsisdiv> |
48 | a8083063 | Iustin Pop | <refsect1> |
49 | a8083063 | Iustin Pop | <title>DESCRIPTION</title> |
50 | a8083063 | Iustin Pop | |
51 | a8083063 | Iustin Pop | <para> |
52 | a8083063 | Iustin Pop | The <command>&dhpackage;</command> is used for managing the |
53 | a8083063 | Iustin Pop | (physical) nodes in the ganeti system. |
54 | a8083063 | Iustin Pop | </para> |
55 | a8083063 | Iustin Pop | |
56 | a8083063 | Iustin Pop | </refsect1> |
57 | a8083063 | Iustin Pop | <refsect1> |
58 | a8083063 | Iustin Pop | <title>COMMANDS</title> |
59 | a8083063 | Iustin Pop | |
60 | a8083063 | Iustin Pop | <refsect2> |
61 | a8083063 | Iustin Pop | <title>ADD</title> |
62 | a8083063 | Iustin Pop | |
63 | a8083063 | Iustin Pop | <cmdsynopsis> |
64 | a8083063 | Iustin Pop | <command>add</command> |
65 | e7c6e02b | Michael Hanselmann | <arg>--readd</arg> |
66 | a8083063 | Iustin Pop | <arg>-s <replaceable>secondary_ip</replaceable></arg> |
67 | a8083063 | Iustin Pop | <arg choice="req"><replaceable>nodename</replaceable></arg> |
68 | a8083063 | Iustin Pop | </cmdsynopsis> |
69 | a8083063 | Iustin Pop | |
70 | a8083063 | Iustin Pop | <para> |
71 | a8083063 | Iustin Pop | Adds the given node to the cluster. |
72 | a8083063 | Iustin Pop | </para> |
73 | a8083063 | Iustin Pop | |
74 | a8083063 | Iustin Pop | <para> |
75 | a8083063 | Iustin Pop | This command is used to join a new node to the cluster. You |
76 | a8083063 | Iustin Pop | will have to provide the password for root of the node to be |
77 | a8083063 | Iustin Pop | able to add the node in the cluster. The command needs to be |
78 | a8083063 | Iustin Pop | run on the ganeti master. |
79 | a8083063 | Iustin Pop | </para> |
80 | a8083063 | Iustin Pop | |
81 | a8083063 | Iustin Pop | <para> |
82 | a8083063 | Iustin Pop | Note that the command is potentially destructive, as it will |
83 | a8083063 | Iustin Pop | forcibly join the specified host the cluster, not paying |
84 | a8083063 | Iustin Pop | attention to its current status (it could be already in a |
85 | a8083063 | Iustin Pop | cluster, etc.) |
86 | a8083063 | Iustin Pop | </para> |
87 | a8083063 | Iustin Pop | |
88 | a8083063 | Iustin Pop | <para> |
89 | a8083063 | Iustin Pop | The <option>-s</option> is used in dual-home clusters and |
90 | a8083063 | Iustin Pop | specifies the new node's IP in the secondary network. See the |
91 | a8083063 | Iustin Pop | discussion in <citerefentry> |
92 | a8083063 | Iustin Pop | <refentrytitle>gnt-cluster</refentrytitle> |
93 | a8083063 | Iustin Pop | <manvolnum>8</manvolnum> </citerefentry> for more |
94 | 5bbd3f7f | Michael Hanselmann | information. |
95 | a8083063 | Iustin Pop | </para> |
96 | a8083063 | Iustin Pop | |
97 | a8083063 | Iustin Pop | <para> |
98 | d3b4cf9f | Iustin Pop | In case you're readding a node after hardware failure, you can |
99 | d3b4cf9f | Iustin Pop | use the <option>--readd</option> parameter. In this case, you |
100 | d3b4cf9f | Iustin Pop | don't need to pass the secondary IP again, it will reused from |
101 | d3b4cf9f | Iustin Pop | the cluster. Also, the <literal>drained</literal> and |
102 | d3b4cf9f | Iustin Pop | <literal>offline</literal> flags of the node will be cleared |
103 | d3b4cf9f | Iustin Pop | before re-adding it. |
104 | e7c6e02b | Michael Hanselmann | </para> |
105 | e7c6e02b | Michael Hanselmann | |
106 | e7c6e02b | Michael Hanselmann | <para> |
107 | a8083063 | Iustin Pop | Example: |
108 | a8083063 | Iustin Pop | <screen> |
109 | a8083063 | Iustin Pop | # gnt-node add node5.example.com |
110 | a8083063 | Iustin Pop | # gnt-node add -s 192.168.44.5 node5.example.com |
111 | a8083063 | Iustin Pop | </screen> |
112 | a8083063 | Iustin Pop | </para> |
113 | a8083063 | Iustin Pop | </refsect2> |
114 | a8083063 | Iustin Pop | |
115 | a8083063 | Iustin Pop | <refsect2> |
116 | cc425644 | Iustin Pop | <title>ADD-TAGS</title> |
117 | cc425644 | Iustin Pop | |
118 | cc425644 | Iustin Pop | <cmdsynopsis> |
119 | cc425644 | Iustin Pop | <command>add-tags</command> |
120 | 810c50b7 | Iustin Pop | <arg choice="opt">--from <replaceable>file</replaceable></arg> |
121 | cc425644 | Iustin Pop | <arg choice="req"><replaceable>nodename</replaceable></arg> |
122 | cc425644 | Iustin Pop | <arg choice="req" |
123 | cc425644 | Iustin Pop | rep="repeat"><replaceable>tag</replaceable></arg> |
124 | cc425644 | Iustin Pop | </cmdsynopsis> |
125 | cc425644 | Iustin Pop | |
126 | cc425644 | Iustin Pop | <para> |
127 | cc425644 | Iustin Pop | Add tags to the given node. If any of the tags contains |
128 | cc425644 | Iustin Pop | invalid characters, the entire operation will abort. |
129 | cc425644 | Iustin Pop | </para> |
130 | 810c50b7 | Iustin Pop | |
131 | 810c50b7 | Iustin Pop | <para> |
132 | 810c50b7 | Iustin Pop | If the <option>--from</option> option is given, the list of |
133 | 810c50b7 | Iustin Pop | tags will be extended with the contents of that file (each |
134 | 810c50b7 | Iustin Pop | line becomes a tag). In this case, there is not need to pass |
135 | 810c50b7 | Iustin Pop | tags on the command line (if you do, both sources will be |
136 | 810c50b7 | Iustin Pop | used). A file name of - will be interpreted as stdin. |
137 | 810c50b7 | Iustin Pop | </para> |
138 | cc425644 | Iustin Pop | </refsect2> |
139 | cc425644 | Iustin Pop | |
140 | cc425644 | Iustin Pop | <refsect2> |
141 | a5bc662a | Iustin Pop | <title>EVACUATE</title> |
142 | a5bc662a | Iustin Pop | |
143 | a5bc662a | Iustin Pop | <cmdsynopsis> |
144 | a5bc662a | Iustin Pop | <command>evacuate</command> |
145 | a5bc662a | Iustin Pop | <arg>-f</arg> |
146 | d3b4cf9f | Iustin Pop | <group> |
147 | d3b4cf9f | Iustin Pop | <arg>--iallocator <replaceable>NAME</replaceable></arg> |
148 | d3b4cf9f | Iustin Pop | <arg>--new-secondary <replaceable>destination_node</replaceable></arg> |
149 | d3b4cf9f | Iustin Pop | </group> |
150 | d3b4cf9f | Iustin Pop | <arg choice="req"><replaceable>node</replaceable></arg> |
151 | a5bc662a | Iustin Pop | </cmdsynopsis> |
152 | a5bc662a | Iustin Pop | |
153 | a5bc662a | Iustin Pop | <para> |
154 | d3b4cf9f | Iustin Pop | This command will move all secondary instances away from the |
155 | d3b4cf9f | Iustin Pop | given node. It works only for instances having a drbd disk |
156 | d3b4cf9f | Iustin Pop | template. |
157 | d3b4cf9f | Iustin Pop | </para> |
158 | d3b4cf9f | Iustin Pop | |
159 | d3b4cf9f | Iustin Pop | <para> |
160 | d3b4cf9f | Iustin Pop | The new location for the instances can be specified in two ways: |
161 | d3b4cf9f | Iustin Pop | <itemizedlist> |
162 | d3b4cf9f | Iustin Pop | <listitem> |
163 | d3b4cf9f | Iustin Pop | <simpara>as a single node for all instances, via the |
164 | d3b4cf9f | Iustin Pop | <option>--new-secondary</option> option</simpara> |
165 | d3b4cf9f | Iustin Pop | </listitem> |
166 | d3b4cf9f | Iustin Pop | <listitem> |
167 | d3b4cf9f | Iustin Pop | <simpara>or via the <option>--iallocator</option> option, |
168 | d3b4cf9f | Iustin Pop | giving a script name as parameter, so each instance will |
169 | d3b4cf9f | Iustin Pop | be in turn placed on the (per the script) optimal |
170 | d3b4cf9f | Iustin Pop | node</simpara> |
171 | d3b4cf9f | Iustin Pop | </listitem> |
172 | d3b4cf9f | Iustin Pop | </itemizedlist> |
173 | a5bc662a | Iustin Pop | </para> |
174 | a5bc662a | Iustin Pop | |
175 | a5bc662a | Iustin Pop | <para> |
176 | a5bc662a | Iustin Pop | Example: |
177 | a5bc662a | Iustin Pop | <screen> |
178 | d3b4cf9f | Iustin Pop | # gnt-node evacuate -I dumb node3.example.com |
179 | a5bc662a | Iustin Pop | </screen> |
180 | a5bc662a | Iustin Pop | </para> |
181 | a5bc662a | Iustin Pop | </refsect2> |
182 | a5bc662a | Iustin Pop | |
183 | a5bc662a | Iustin Pop | <refsect2> |
184 | c450e9b0 | Iustin Pop | <title>FAILOVER</title> |
185 | c450e9b0 | Iustin Pop | |
186 | c450e9b0 | Iustin Pop | <cmdsynopsis> |
187 | c450e9b0 | Iustin Pop | <command>failover</command> |
188 | c450e9b0 | Iustin Pop | <arg>-f</arg> |
189 | c450e9b0 | Iustin Pop | <arg>--ignore-consistency</arg> |
190 | c450e9b0 | Iustin Pop | <arg choice="req"><replaceable>node</replaceable></arg> |
191 | c450e9b0 | Iustin Pop | </cmdsynopsis> |
192 | c450e9b0 | Iustin Pop | |
193 | c450e9b0 | Iustin Pop | <para> |
194 | c450e9b0 | Iustin Pop | This command will fail over all instances having the given |
195 | c450e9b0 | Iustin Pop | node as primary to their secondary nodes. This works only for |
196 | bd028152 | Iustin Pop | instances having a drbd disk template. |
197 | c450e9b0 | Iustin Pop | </para> |
198 | c450e9b0 | Iustin Pop | |
199 | c450e9b0 | Iustin Pop | <para> |
200 | c450e9b0 | Iustin Pop | Normally the failover will check the consistency of the disks |
201 | c450e9b0 | Iustin Pop | before failing over the instance. If you are trying to migrate |
202 | c450e9b0 | Iustin Pop | instances off a dead node, this will fail. Use the |
203 | c450e9b0 | Iustin Pop | <option>--ignore-consistency</option> option for this purpose. |
204 | c450e9b0 | Iustin Pop | </para> |
205 | c450e9b0 | Iustin Pop | |
206 | c450e9b0 | Iustin Pop | <para> |
207 | c450e9b0 | Iustin Pop | Example: |
208 | c450e9b0 | Iustin Pop | <screen> |
209 | c450e9b0 | Iustin Pop | # gnt-node failover node1.example.com |
210 | c450e9b0 | Iustin Pop | </screen> |
211 | c450e9b0 | Iustin Pop | </para> |
212 | c450e9b0 | Iustin Pop | </refsect2> |
213 | c450e9b0 | Iustin Pop | |
214 | c450e9b0 | Iustin Pop | <refsect2> |
215 | a8083063 | Iustin Pop | <title>INFO</title> |
216 | a8083063 | Iustin Pop | |
217 | a8083063 | Iustin Pop | <cmdsynopsis> |
218 | a8083063 | Iustin Pop | <command>info</command> |
219 | a8083063 | Iustin Pop | <arg rep="repeat"><replaceable>node</replaceable></arg> |
220 | a8083063 | Iustin Pop | </cmdsynopsis> |
221 | a8083063 | Iustin Pop | |
222 | a8083063 | Iustin Pop | <para> |
223 | a8083063 | Iustin Pop | Show detailed information about the nodes in the cluster. If you |
224 | a8083063 | Iustin Pop | don't give any arguments, all nodes will be shows, otherwise the |
225 | a8083063 | Iustin Pop | output will be restricted to the given names. |
226 | a8083063 | Iustin Pop | </para> |
227 | a8083063 | Iustin Pop | </refsect2> |
228 | a8083063 | Iustin Pop | |
229 | a8083063 | Iustin Pop | <refsect2> |
230 | a8083063 | Iustin Pop | <title>LIST</title> |
231 | a8083063 | Iustin Pop | |
232 | a8083063 | Iustin Pop | <cmdsynopsis> |
233 | a8083063 | Iustin Pop | <command>list</command> |
234 | d3b4cf9f | Iustin Pop | <arg>--sync</arg> |
235 | d3b4cf9f | Iustin Pop | <sbr> |
236 | a8083063 | Iustin Pop | <arg>--no-headers</arg> |
237 | a8083063 | Iustin Pop | <arg>--separator=<replaceable>SEPARATOR</replaceable></arg> |
238 | d3b4cf9f | Iustin Pop | <sbr> |
239 | d3b4cf9f | Iustin Pop | <arg>--units=<replaceable>UNITS</replaceable></arg> |
240 | 48c4dfa8 | Iustin Pop | <arg>-o <replaceable>[+]FIELD,...</replaceable></arg> |
241 | d3b4cf9f | Iustin Pop | <sbr> |
242 | d3b4cf9f | Iustin Pop | <arg rep="repeat">node</arg> |
243 | a8083063 | Iustin Pop | </cmdsynopsis> |
244 | a8083063 | Iustin Pop | |
245 | a8083063 | Iustin Pop | <para> |
246 | d3b4cf9f | Iustin Pop | Lists the nodes in the cluster. |
247 | a8083063 | Iustin Pop | </para> |
248 | a8083063 | Iustin Pop | |
249 | a8083063 | Iustin Pop | <para> |
250 | a8083063 | Iustin Pop | The <option>--no-headers</option> option will skip the initial |
251 | a8083063 | Iustin Pop | header line. The <option>--separator</option> option takes an |
252 | a8083063 | Iustin Pop | argument which denotes what will be used between the output |
253 | a8083063 | Iustin Pop | fields. Both these options are to help scripting. |
254 | a8083063 | Iustin Pop | </para> |
255 | a8083063 | Iustin Pop | |
256 | a8083063 | Iustin Pop | <para> |
257 | d3b4cf9f | Iustin Pop | The units used to display the numeric values in the output |
258 | d3b4cf9f | Iustin Pop | varies, depending on the options given. By default, the values |
259 | d3b4cf9f | Iustin Pop | will be formatted in the most appropriate unit. If the |
260 | d3b4cf9f | Iustin Pop | <option>--separator</option> option is given, then the values |
261 | d3b4cf9f | Iustin Pop | are shown in mebibytes to allow parsing by scripts. In both |
262 | d3b4cf9f | Iustin Pop | cases, the <option>--units</option> option can be used to |
263 | d3b4cf9f | Iustin Pop | enforce a given output unit. |
264 | d3b4cf9f | Iustin Pop | </para> |
265 | d3b4cf9f | Iustin Pop | |
266 | d3b4cf9f | Iustin Pop | <para> |
267 | d3b4cf9f | Iustin Pop | By default, the query of nodes will be done in parallel with |
268 | d3b4cf9f | Iustin Pop | any running jobs. This might give inconsistent results for the |
269 | d3b4cf9f | Iustin Pop | free disk/memory. The <option>--sync</option> can be used to |
270 | d3b4cf9f | Iustin Pop | grab locks for all the nodes and ensure consistent view of the |
271 | d3b4cf9f | Iustin Pop | cluster (but this might stall the query for a long time). |
272 | d3b4cf9f | Iustin Pop | </para> |
273 | d3b4cf9f | Iustin Pop | |
274 | d3b4cf9f | Iustin Pop | <para> |
275 | a8083063 | Iustin Pop | The <option>-o</option> option takes a comma-separated list of |
276 | a8083063 | Iustin Pop | output fields. The available fields and their meaning are: |
277 | a8083063 | Iustin Pop | <variablelist> |
278 | a8083063 | Iustin Pop | <varlistentry> |
279 | a8083063 | Iustin Pop | <term>name</term> |
280 | a8083063 | Iustin Pop | <listitem> |
281 | a8083063 | Iustin Pop | <simpara>the node name</simpara> |
282 | a8083063 | Iustin Pop | </listitem> |
283 | a8083063 | Iustin Pop | </varlistentry> |
284 | a8083063 | Iustin Pop | <varlistentry> |
285 | d8a4b51d | Iustin Pop | <term>pinst_cnt</term> |
286 | a8083063 | Iustin Pop | <listitem> |
287 | a8083063 | Iustin Pop | <simpara>the number of instances having this node as |
288 | a8083063 | Iustin Pop | primary</simpara> |
289 | a8083063 | Iustin Pop | </listitem> |
290 | a8083063 | Iustin Pop | </varlistentry> |
291 | a8083063 | Iustin Pop | <varlistentry> |
292 | d8a4b51d | Iustin Pop | <term>pinst_list</term> |
293 | d8a4b51d | Iustin Pop | <listitem> |
294 | d8a4b51d | Iustin Pop | <simpara>the list of instances having this node as |
295 | d8a4b51d | Iustin Pop | primary, comma separated</simpara> |
296 | d8a4b51d | Iustin Pop | </listitem> |
297 | d8a4b51d | Iustin Pop | </varlistentry> |
298 | d8a4b51d | Iustin Pop | <varlistentry> |
299 | d8a4b51d | Iustin Pop | <term>sinst_cnt</term> |
300 | a8083063 | Iustin Pop | <listitem> |
301 | a8083063 | Iustin Pop | <simpara>the number of instances having this node as a |
302 | a8083063 | Iustin Pop | secondary node</simpara> |
303 | a8083063 | Iustin Pop | </listitem> |
304 | a8083063 | Iustin Pop | </varlistentry> |
305 | a8083063 | Iustin Pop | <varlistentry> |
306 | d8a4b51d | Iustin Pop | <term>sinst_list</term> |
307 | d8a4b51d | Iustin Pop | <listitem> |
308 | d8a4b51d | Iustin Pop | <simpara>the list of instances having this node as a |
309 | d8a4b51d | Iustin Pop | secondary node, comma separated</simpara> |
310 | d8a4b51d | Iustin Pop | </listitem> |
311 | d8a4b51d | Iustin Pop | </varlistentry> |
312 | d8a4b51d | Iustin Pop | <varlistentry> |
313 | a8083063 | Iustin Pop | <term>pip</term> |
314 | a8083063 | Iustin Pop | <listitem> |
315 | a8083063 | Iustin Pop | <simpara>the primary ip of this node (used for cluster |
316 | a8083063 | Iustin Pop | communication)</simpara> |
317 | a8083063 | Iustin Pop | </listitem> |
318 | a8083063 | Iustin Pop | </varlistentry> |
319 | a8083063 | Iustin Pop | <varlistentry> |
320 | a8083063 | Iustin Pop | <term>sip</term> |
321 | a8083063 | Iustin Pop | <listitem> |
322 | a8083063 | Iustin Pop | <simpara> |
323 | a8083063 | Iustin Pop | the secondary ip of this node (used for data |
324 | a8083063 | Iustin Pop | replication in dual-ip clusters, see <citerefentry> |
325 | a8083063 | Iustin Pop | <refentrytitle>gnt-cluster</refentrytitle> |
326 | a8083063 | Iustin Pop | <manvolnum>8</manvolnum> |
327 | a8083063 | Iustin Pop | </citerefentry> |
328 | a8083063 | Iustin Pop | </simpara> |
329 | a8083063 | Iustin Pop | </listitem> |
330 | a8083063 | Iustin Pop | </varlistentry> |
331 | a8083063 | Iustin Pop | <varlistentry> |
332 | a8083063 | Iustin Pop | <term>dtotal</term> |
333 | a8083063 | Iustin Pop | <listitem> |
334 | a8083063 | Iustin Pop | <simpara>total disk space in the volume group used for |
335 | a8083063 | Iustin Pop | instance disk allocations</simpara> |
336 | a8083063 | Iustin Pop | </listitem> |
337 | a8083063 | Iustin Pop | </varlistentry> |
338 | a8083063 | Iustin Pop | <varlistentry> |
339 | a8083063 | Iustin Pop | <term>dfree</term> |
340 | a8083063 | Iustin Pop | <listitem> |
341 | a8083063 | Iustin Pop | <simpara>available disk space in the volume group</simpara> |
342 | a8083063 | Iustin Pop | </listitem> |
343 | a8083063 | Iustin Pop | </varlistentry> |
344 | a8083063 | Iustin Pop | <varlistentry> |
345 | a8083063 | Iustin Pop | <term>mtotal</term> |
346 | a8083063 | Iustin Pop | <listitem> |
347 | a8083063 | Iustin Pop | <simpara>total memory on the physical node</simpara> |
348 | a8083063 | Iustin Pop | </listitem> |
349 | a8083063 | Iustin Pop | </varlistentry> |
350 | a8083063 | Iustin Pop | <varlistentry> |
351 | a8083063 | Iustin Pop | <term>mnode</term> |
352 | a8083063 | Iustin Pop | <listitem> |
353 | a8083063 | Iustin Pop | <simpara>the memory used by the node itself</simpara> |
354 | a8083063 | Iustin Pop | </listitem> |
355 | a8083063 | Iustin Pop | </varlistentry> |
356 | a8083063 | Iustin Pop | <varlistentry> |
357 | a8083063 | Iustin Pop | <term>mfree</term> |
358 | a8083063 | Iustin Pop | <listitem> |
359 | a8083063 | Iustin Pop | <simpara>memory available for instance |
360 | a8083063 | Iustin Pop | allocations</simpara> |
361 | a8083063 | Iustin Pop | </listitem> |
362 | a8083063 | Iustin Pop | </varlistentry> |
363 | d8a4b51d | Iustin Pop | <varlistentry> |
364 | d8a4b51d | Iustin Pop | <term>bootid</term> |
365 | d8a4b51d | Iustin Pop | <listitem> |
366 | d8a4b51d | Iustin Pop | <simpara>the node bootid value; this is a linux specific |
367 | d8a4b51d | Iustin Pop | feature that assigns a new UUID to the node at each boot |
368 | d8a4b51d | Iustin Pop | and can be use to detect node reboots (by tracking |
369 | d8a4b51d | Iustin Pop | changes in this value)</simpara> |
370 | d8a4b51d | Iustin Pop | </listitem> |
371 | d8a4b51d | Iustin Pop | </varlistentry> |
372 | 130a6a6f | Iustin Pop | <varlistentry> |
373 | 130a6a6f | Iustin Pop | <term>tags</term> |
374 | 130a6a6f | Iustin Pop | <listitem> |
375 | 130a6a6f | Iustin Pop | <simpara>comma-separated list of the node's |
376 | 130a6a6f | Iustin Pop | tags</simpara> |
377 | 130a6a6f | Iustin Pop | </listitem> |
378 | 130a6a6f | Iustin Pop | </varlistentry> |
379 | 38d7239a | Iustin Pop | <varlistentry> |
380 | 38d7239a | Iustin Pop | <term>serial_no</term> |
381 | 38d7239a | Iustin Pop | <listitem> |
382 | 38d7239a | Iustin Pop | <simpara>the so called 'serial number' of the instance; |
383 | 38d7239a | Iustin Pop | this is a numeric field that is incremented each time |
384 | 38d7239a | Iustin Pop | the instance is modified, and it can be used to detect |
385 | 38d7239a | Iustin Pop | modifications</simpara> |
386 | 38d7239a | Iustin Pop | </listitem> |
387 | 38d7239a | Iustin Pop | </varlistentry> |
388 | d3b4cf9f | Iustin Pop | <varlistentry> |
389 | d3b4cf9f | Iustin Pop | <term>ctotal</term> |
390 | d3b4cf9f | Iustin Pop | <listitem> |
391 | d3b4cf9f | Iustin Pop | <simpara>the toal number of logical processors</simpara> |
392 | d3b4cf9f | Iustin Pop | </listitem> |
393 | d3b4cf9f | Iustin Pop | </varlistentry> |
394 | d3b4cf9f | Iustin Pop | <varlistentry> |
395 | d3b4cf9f | Iustin Pop | <term>cnodes</term> |
396 | d3b4cf9f | Iustin Pop | <listitem> |
397 | d3b4cf9f | Iustin Pop | <simpara>the number of NUMA domains on the node, if the |
398 | d3b4cf9f | Iustin Pop | hypervisor can export this information</simpara> |
399 | d3b4cf9f | Iustin Pop | </listitem> |
400 | d3b4cf9f | Iustin Pop | </varlistentry> |
401 | d3b4cf9f | Iustin Pop | <varlistentry> |
402 | d3b4cf9f | Iustin Pop | <term>csockets</term> |
403 | d3b4cf9f | Iustin Pop | <listitem> |
404 | d3b4cf9f | Iustin Pop | <simpara>the number of physical CPU sockets, if the |
405 | d3b4cf9f | Iustin Pop | hypervisor can export this information</simpara> |
406 | d3b4cf9f | Iustin Pop | </listitem> |
407 | d3b4cf9f | Iustin Pop | </varlistentry> |
408 | d3b4cf9f | Iustin Pop | <varlistentry> |
409 | d3b4cf9f | Iustin Pop | <term>master_candidate</term> |
410 | d3b4cf9f | Iustin Pop | <listitem> |
411 | d3b4cf9f | Iustin Pop | <simpara>whether the node is a master candidate or not</simpara> |
412 | d3b4cf9f | Iustin Pop | </listitem> |
413 | d3b4cf9f | Iustin Pop | </varlistentry> |
414 | d3b4cf9f | Iustin Pop | <varlistentry> |
415 | d3b4cf9f | Iustin Pop | <term>drained</term> |
416 | d3b4cf9f | Iustin Pop | <listitem> |
417 | 253ba78f | Raiford Storey | <simpara>whether the node is drained or not; the cluster |
418 | 253ba78f | Raiford Storey | still communicates with drained nodes but excludes them |
419 | 253ba78f | Raiford Storey | from allocation operations</simpara> |
420 | d3b4cf9f | Iustin Pop | </listitem> |
421 | d3b4cf9f | Iustin Pop | </varlistentry> |
422 | d3b4cf9f | Iustin Pop | <varlistentry> |
423 | d3b4cf9f | Iustin Pop | <term>offline</term> |
424 | d3b4cf9f | Iustin Pop | <listitem> |
425 | 253ba78f | Raiford Storey | <simpara>whether the node is offline or not; if offline, |
426 | 253ba78f | Raiford Storey | the cluster does not communicate with offline nodes; |
427 | 253ba78f | Raiford Storey | useful for nodes that are not reachable in order to |
428 | 253ba78f | Raiford Storey | avoid delays</simpara> |
429 | d3b4cf9f | Iustin Pop | </listitem> |
430 | d3b4cf9f | Iustin Pop | </varlistentry> |
431 | c120ff34 | Iustin Pop | <varlistentry> |
432 | c120ff34 | Iustin Pop | <term>role</term> |
433 | c120ff34 | Iustin Pop | <listitem> |
434 | c120ff34 | Iustin Pop | <para> |
435 | c120ff34 | Iustin Pop | A condensed version of the node flags; this field will |
436 | c120ff34 | Iustin Pop | output a one-character field, with the following |
437 | c120ff34 | Iustin Pop | possible values: |
438 | c120ff34 | Iustin Pop | <itemizedlist> |
439 | c120ff34 | Iustin Pop | <listitem> |
440 | c120ff34 | Iustin Pop | <simpara><emphasis>M</emphasis> for the master |
441 | c120ff34 | Iustin Pop | node</simpara> |
442 | c120ff34 | Iustin Pop | </listitem> |
443 | c120ff34 | Iustin Pop | <listitem> |
444 | c120ff34 | Iustin Pop | <simpara><emphasis>C</emphasis> for a master |
445 | c120ff34 | Iustin Pop | candidate</simpara> |
446 | c120ff34 | Iustin Pop | </listitem> |
447 | c120ff34 | Iustin Pop | <listitem> |
448 | c120ff34 | Iustin Pop | <simpara><emphasis>R</emphasis> for a regular |
449 | c120ff34 | Iustin Pop | node</simpara> |
450 | c120ff34 | Iustin Pop | </listitem> |
451 | c120ff34 | Iustin Pop | <listitem> |
452 | c120ff34 | Iustin Pop | <simpara><emphasis>D</emphasis> for a drained |
453 | c120ff34 | Iustin Pop | node</simpara> |
454 | c120ff34 | Iustin Pop | </listitem> |
455 | c120ff34 | Iustin Pop | <listitem> |
456 | c120ff34 | Iustin Pop | <simpara><emphasis>O</emphasis> for an offline |
457 | c120ff34 | Iustin Pop | node</simpara> |
458 | c120ff34 | Iustin Pop | </listitem> |
459 | c120ff34 | Iustin Pop | </itemizedlist> |
460 | c120ff34 | Iustin Pop | </para> |
461 | c120ff34 | Iustin Pop | </listitem> |
462 | c120ff34 | Iustin Pop | </varlistentry> |
463 | a8083063 | Iustin Pop | </variablelist> |
464 | a8083063 | Iustin Pop | </para> |
465 | a8083063 | Iustin Pop | |
466 | a8083063 | Iustin Pop | <para> |
467 | 48c4dfa8 | Iustin Pop | If the value of the option starts with the character |
468 | 48c4dfa8 | Iustin Pop | <constant>+</constant>, the new fields will be added to the |
469 | 48c4dfa8 | Iustin Pop | default list. This allows to quickly see the default list plus |
470 | 48c4dfa8 | Iustin Pop | a few other fields, instead of retyping the entire list of |
471 | 48c4dfa8 | Iustin Pop | fields. |
472 | 48c4dfa8 | Iustin Pop | </para> |
473 | 48c4dfa8 | Iustin Pop | |
474 | 48c4dfa8 | Iustin Pop | <para> |
475 | a8083063 | Iustin Pop | Note that some of this fields are known from the configuration |
476 | d3b4cf9f | Iustin Pop | of the cluster (e.g. <simplelist type="inline"> |
477 | a8083063 | Iustin Pop | <member>name</member> <member>pinst</member> |
478 | a8083063 | Iustin Pop | <member>sinst</member> <member>pip</member> |
479 | a8083063 | Iustin Pop | <member>sip</member> </simplelist> and thus the master does |
480 | a8083063 | Iustin Pop | not need to contact the node for this data (making the listing |
481 | a8083063 | Iustin Pop | fast if only fields from this set are selected), whereas the |
482 | a8083063 | Iustin Pop | other fields are "live" fields and we need to make a query to |
483 | a8083063 | Iustin Pop | the cluster nodes. |
484 | a8083063 | Iustin Pop | </para> |
485 | a8083063 | Iustin Pop | |
486 | a8083063 | Iustin Pop | <para> |
487 | a8083063 | Iustin Pop | Depending on the virtualization type and implementation |
488 | a8083063 | Iustin Pop | details, the mtotal, mnode and mfree may have slighly varying |
489 | a8083063 | Iustin Pop | meanings. For example, some solutions share the node memory |
490 | a8083063 | Iustin Pop | with the pool of memory used for instances |
491 | d3b4cf9f | Iustin Pop | (<acronym>KVM</acronym>), whereas others have separate memory |
492 | a8083063 | Iustin Pop | for the node and for the instances (Xen). |
493 | a8083063 | Iustin Pop | </para> |
494 | d3b4cf9f | Iustin Pop | |
495 | d3b4cf9f | Iustin Pop | <para> |
496 | d3b4cf9f | Iustin Pop | If no node names are given, then all nodes are |
497 | d3b4cf9f | Iustin Pop | queried. Otherwise, only the given nodes will be listed. |
498 | d3b4cf9f | Iustin Pop | </para> |
499 | a8083063 | Iustin Pop | </refsect2> |
500 | a8083063 | Iustin Pop | |
501 | a8083063 | Iustin Pop | <refsect2> |
502 | cc425644 | Iustin Pop | <title>LIST-TAGS</title> |
503 | cc425644 | Iustin Pop | |
504 | cc425644 | Iustin Pop | <cmdsynopsis> |
505 | cc425644 | Iustin Pop | <command>list-tags</command> |
506 | cc425644 | Iustin Pop | <arg choice="req"><replaceable>nodename</replaceable></arg> |
507 | cc425644 | Iustin Pop | </cmdsynopsis> |
508 | cc425644 | Iustin Pop | |
509 | cc425644 | Iustin Pop | <para>List the tags of the given node.</para> |
510 | cc425644 | Iustin Pop | </refsect2> |
511 | cc425644 | Iustin Pop | |
512 | cc425644 | Iustin Pop | <refsect2> |
513 | d3b4cf9f | Iustin Pop | <title>MIGRATE</title> |
514 | d3b4cf9f | Iustin Pop | <cmdsynopsis> |
515 | d3b4cf9f | Iustin Pop | <command>migrate</command> |
516 | d3b4cf9f | Iustin Pop | <arg>-f</arg> |
517 | d3b4cf9f | Iustin Pop | <arg>--non-live</arg> |
518 | d3b4cf9f | Iustin Pop | <arg choice="req"><replaceable>node</replaceable></arg> |
519 | d3b4cf9f | Iustin Pop | </cmdsynopsis> |
520 | d3b4cf9f | Iustin Pop | |
521 | d3b4cf9f | Iustin Pop | <para> |
522 | d3b4cf9f | Iustin Pop | This command will migrate all instances having the given |
523 | d3b4cf9f | Iustin Pop | node as primary to their secondary nodes. This works only for |
524 | d3b4cf9f | Iustin Pop | instances having a drbd disk template. |
525 | d3b4cf9f | Iustin Pop | </para> |
526 | d3b4cf9f | Iustin Pop | |
527 | d3b4cf9f | Iustin Pop | <para> |
528 | d3b4cf9f | Iustin Pop | As for the <command>gnt-instance migrate</command> command, |
529 | d3b4cf9f | Iustin Pop | the <option>--no-live</option> option can be given to do a |
530 | d3b4cf9f | Iustin Pop | non-live migration. |
531 | d3b4cf9f | Iustin Pop | </para> |
532 | d3b4cf9f | Iustin Pop | |
533 | d3b4cf9f | Iustin Pop | <para> |
534 | d3b4cf9f | Iustin Pop | Example: |
535 | d3b4cf9f | Iustin Pop | <screen> |
536 | d3b4cf9f | Iustin Pop | # gnt-node migrate node1.example.com |
537 | d3b4cf9f | Iustin Pop | </screen> |
538 | d3b4cf9f | Iustin Pop | </para> |
539 | d3b4cf9f | Iustin Pop | |
540 | d3b4cf9f | Iustin Pop | </refsect2> |
541 | d3b4cf9f | Iustin Pop | |
542 | d3b4cf9f | Iustin Pop | <refsect2> |
543 | 949bdabe | Iustin Pop | <title>MODIFY</title> |
544 | 949bdabe | Iustin Pop | <cmdsynopsis> |
545 | 949bdabe | Iustin Pop | <command>modify</command> |
546 | 949bdabe | Iustin Pop | <arg>-f</arg> |
547 | 949bdabe | Iustin Pop | <arg>--submit</arg> |
548 | 949bdabe | Iustin Pop | <arg>--master-candidate=<option>yes|no</option></arg> |
549 | 949bdabe | Iustin Pop | <arg>--drained=<option>yes|no</option></arg> |
550 | 949bdabe | Iustin Pop | <arg>--offline=<option>yes|no</option></arg> |
551 | 949bdabe | Iustin Pop | <arg choice="req"><replaceable>node</replaceable></arg> |
552 | 949bdabe | Iustin Pop | </cmdsynopsis> |
553 | 949bdabe | Iustin Pop | |
554 | 949bdabe | Iustin Pop | <para> |
555 | 949bdabe | Iustin Pop | This command changes the role of the node. Each options takes |
556 | 949bdabe | Iustin Pop | either a literal <literal>yes</literal> or |
557 | 949bdabe | Iustin Pop | <literal>no</literal>, and only one option should be given as |
558 | 949bdabe | Iustin Pop | <literal>yes</literal>. The meaning of the roles are described |
559 | 949bdabe | Iustin Pop | in the manpage <citerefentry> |
560 | 949bdabe | Iustin Pop | <refentrytitle>ganeti</refentrytitle> <manvolnum>7</manvolnum> |
561 | 949bdabe | Iustin Pop | </citerefentry>. |
562 | 949bdabe | Iustin Pop | </para> |
563 | 949bdabe | Iustin Pop | |
564 | 949bdabe | Iustin Pop | <para> |
565 | 949bdabe | Iustin Pop | In case a node is demoted from the master candidate role, but |
566 | 949bdabe | Iustin Pop | there are not enough new nodes for this case, the operation |
567 | 949bdabe | Iustin Pop | will be refused. To override this check, pass the |
568 | 949bdabe | Iustin Pop | <option>--force</option> option. |
569 | 949bdabe | Iustin Pop | </para> |
570 | 949bdabe | Iustin Pop | |
571 | 949bdabe | Iustin Pop | <para> |
572 | 949bdabe | Iustin Pop | Example (setting a node offline, which will demote it from |
573 | 949bdabe | Iustin Pop | master candidate role if is in that role): |
574 | 949bdabe | Iustin Pop | <screen> |
575 | 949bdabe | Iustin Pop | # gnt-node modify --offline=yes node1.example.com |
576 | 949bdabe | Iustin Pop | </screen> |
577 | 949bdabe | Iustin Pop | </para> |
578 | 949bdabe | Iustin Pop | |
579 | 949bdabe | Iustin Pop | <para>Example (setting the node back to online and master candidate): |
580 | 949bdabe | Iustin Pop | <screen> |
581 | 949bdabe | Iustin Pop | # gnt-node modify --offline=no --master-candidate=yes node1.example.com |
582 | 949bdabe | Iustin Pop | </screen> |
583 | 949bdabe | Iustin Pop | </para> |
584 | 949bdabe | Iustin Pop | |
585 | 949bdabe | Iustin Pop | </refsect2> |
586 | 949bdabe | Iustin Pop | |
587 | 949bdabe | Iustin Pop | <refsect2> |
588 | a8083063 | Iustin Pop | <title>REMOVE</title> |
589 | a8083063 | Iustin Pop | |
590 | a8083063 | Iustin Pop | <cmdsynopsis> |
591 | a8083063 | Iustin Pop | <command>remove</command> |
592 | a8083063 | Iustin Pop | <arg choice="req"><replaceable>nodename</replaceable></arg> |
593 | a8083063 | Iustin Pop | </cmdsynopsis> |
594 | a8083063 | Iustin Pop | |
595 | a8083063 | Iustin Pop | <para> |
596 | a8083063 | Iustin Pop | Removes a node from the cluster. Instances must be removed or |
597 | a8083063 | Iustin Pop | migrated to another cluster before. |
598 | a8083063 | Iustin Pop | </para> |
599 | a8083063 | Iustin Pop | |
600 | a8083063 | Iustin Pop | <para> |
601 | a8083063 | Iustin Pop | Example: |
602 | a8083063 | Iustin Pop | <screen> |
603 | a8083063 | Iustin Pop | # gnt-node remove node5.example.com |
604 | a8083063 | Iustin Pop | </screen> |
605 | a8083063 | Iustin Pop | </para> |
606 | a8083063 | Iustin Pop | </refsect2> |
607 | a8083063 | Iustin Pop | |
608 | dcb93971 | Michael Hanselmann | <refsect2> |
609 | cc425644 | Iustin Pop | <title>REMOVE-TAGS</title> |
610 | cc425644 | Iustin Pop | <cmdsynopsis> |
611 | cc425644 | Iustin Pop | <command>remove-tags</command> |
612 | 810c50b7 | Iustin Pop | <arg choice="opt">--from <replaceable>file</replaceable></arg> |
613 | cc425644 | Iustin Pop | <arg choice="req"><replaceable>nodename</replaceable></arg> |
614 | cc425644 | Iustin Pop | <arg choice="req" |
615 | cc425644 | Iustin Pop | rep="repeat"><replaceable>tag</replaceable></arg> |
616 | cc425644 | Iustin Pop | </cmdsynopsis> |
617 | cc425644 | Iustin Pop | |
618 | cc425644 | Iustin Pop | <para> |
619 | cc425644 | Iustin Pop | Remove tags from the given node. If any of the tags are not |
620 | cc425644 | Iustin Pop | existing on the node, the entire operation will abort. |
621 | cc425644 | Iustin Pop | </para> |
622 | 810c50b7 | Iustin Pop | |
623 | 810c50b7 | Iustin Pop | <para> |
624 | 810c50b7 | Iustin Pop | If the <option>--from</option> option is given, the list of |
625 | 810c50b7 | Iustin Pop | tags will be extended with the contents of that file (each |
626 | 810c50b7 | Iustin Pop | line becomes a tag). In this case, there is not need to pass |
627 | 810c50b7 | Iustin Pop | tags on the command line (if you do, both sources will be |
628 | 810c50b7 | Iustin Pop | used). A file name of - will be interpreted as stdin. |
629 | 810c50b7 | Iustin Pop | </para> |
630 | cc425644 | Iustin Pop | </refsect2> |
631 | cc425644 | Iustin Pop | |
632 | cc425644 | Iustin Pop | <refsect2> |
633 | dcb93971 | Michael Hanselmann | <title>VOLUMES</title> |
634 | dcb93971 | Michael Hanselmann | |
635 | dcb93971 | Michael Hanselmann | <cmdsynopsis> |
636 | dcb93971 | Michael Hanselmann | <command>volumes</command> |
637 | f69dab6d | Iustin Pop | <arg>--no-headers</arg> |
638 | f69dab6d | Iustin Pop | <arg>--human-readable</arg> |
639 | f69dab6d | Iustin Pop | <arg>--separator=<replaceable>SEPARATOR</replaceable></arg> |
640 | f69dab6d | Iustin Pop | <arg>--output=<replaceable>FIELDS</replaceable></arg> |
641 | f69dab6d | Iustin Pop | <sbr> |
642 | dcb93971 | Michael Hanselmann | <arg rep="repeat"><replaceable>node</replaceable></arg> |
643 | dcb93971 | Michael Hanselmann | </cmdsynopsis> |
644 | dcb93971 | Michael Hanselmann | |
645 | dcb93971 | Michael Hanselmann | <para> |
646 | dcb93971 | Michael Hanselmann | Lists all logical volumes and their physical disks from the node(s) |
647 | dcb93971 | Michael Hanselmann | provided. |
648 | dcb93971 | Michael Hanselmann | </para> |
649 | dcb93971 | Michael Hanselmann | |
650 | dcb93971 | Michael Hanselmann | <para> |
651 | f69dab6d | Iustin Pop | The <option>--no-headers</option> option will skip the initial |
652 | f69dab6d | Iustin Pop | header line. The <option>--separator</option> option takes an |
653 | f69dab6d | Iustin Pop | argument which denotes what will be used between the output |
654 | f69dab6d | Iustin Pop | fields. Both these options are to help scripting. |
655 | f69dab6d | Iustin Pop | </para> |
656 | f69dab6d | Iustin Pop | |
657 | f69dab6d | Iustin Pop | <para> |
658 | d3b4cf9f | Iustin Pop | The units used to display the numeric values in the output |
659 | d3b4cf9f | Iustin Pop | varies, depending on the options given. By default, the values |
660 | d3b4cf9f | Iustin Pop | will be formatted in the most appropriate unit. If the |
661 | d3b4cf9f | Iustin Pop | <option>--separator</option> option is given, then the values |
662 | d3b4cf9f | Iustin Pop | are shown in mebibytes to allow parsing by scripts. In both |
663 | d3b4cf9f | Iustin Pop | cases, the <option>--units</option> option can be used to |
664 | d3b4cf9f | Iustin Pop | enforce a given output unit. |
665 | d3b4cf9f | Iustin Pop | </para> |
666 | d3b4cf9f | Iustin Pop | |
667 | d3b4cf9f | Iustin Pop | <para> |
668 | f69dab6d | Iustin Pop | The <option>-o</option> option takes a comma-separated list of |
669 | f69dab6d | Iustin Pop | output fields. The available fields and their meaning are: |
670 | f69dab6d | Iustin Pop | <variablelist> |
671 | f69dab6d | Iustin Pop | <varlistentry> |
672 | f69dab6d | Iustin Pop | <term>node</term> |
673 | f69dab6d | Iustin Pop | <listitem> |
674 | f69dab6d | Iustin Pop | <simpara>the node name on which the volume exists</simpara> |
675 | f69dab6d | Iustin Pop | </listitem> |
676 | f69dab6d | Iustin Pop | </varlistentry> |
677 | f69dab6d | Iustin Pop | <varlistentry> |
678 | f69dab6d | Iustin Pop | <term>phys</term> |
679 | f69dab6d | Iustin Pop | <listitem> |
680 | f69dab6d | Iustin Pop | <simpara>the physical drive (on which the LVM physical |
681 | f69dab6d | Iustin Pop | volume lives)</simpara> |
682 | f69dab6d | Iustin Pop | </listitem> |
683 | f69dab6d | Iustin Pop | </varlistentry> |
684 | f69dab6d | Iustin Pop | <varlistentry> |
685 | f69dab6d | Iustin Pop | <term>vg</term> |
686 | f69dab6d | Iustin Pop | <listitem> |
687 | f69dab6d | Iustin Pop | <simpara>the volume group name</simpara> |
688 | f69dab6d | Iustin Pop | </listitem> |
689 | f69dab6d | Iustin Pop | </varlistentry> |
690 | f69dab6d | Iustin Pop | <varlistentry> |
691 | f69dab6d | Iustin Pop | <term>name</term> |
692 | f69dab6d | Iustin Pop | <listitem> |
693 | f69dab6d | Iustin Pop | <simpara>the logical volume name</simpara> |
694 | f69dab6d | Iustin Pop | </listitem> |
695 | f69dab6d | Iustin Pop | </varlistentry> |
696 | f69dab6d | Iustin Pop | <varlistentry> |
697 | f69dab6d | Iustin Pop | <term>size</term> |
698 | f69dab6d | Iustin Pop | <listitem> |
699 | f69dab6d | Iustin Pop | <simpara>the logical volume size</simpara> |
700 | f69dab6d | Iustin Pop | </listitem> |
701 | f69dab6d | Iustin Pop | </varlistentry> |
702 | f69dab6d | Iustin Pop | <varlistentry> |
703 | f69dab6d | Iustin Pop | <term>instance</term> |
704 | f69dab6d | Iustin Pop | <listitem> |
705 | f69dab6d | Iustin Pop | <simpara>The name of the instance to which this volume |
706 | f69dab6d | Iustin Pop | belongs, or (in case it's an orphan volume) the |
707 | f69dab6d | Iustin Pop | character <quote>-</quote></simpara> |
708 | f69dab6d | Iustin Pop | </listitem> |
709 | f69dab6d | Iustin Pop | </varlistentry> |
710 | f69dab6d | Iustin Pop | </variablelist> |
711 | f69dab6d | Iustin Pop | </para> |
712 | f69dab6d | Iustin Pop | |
713 | f69dab6d | Iustin Pop | <para> |
714 | dcb93971 | Michael Hanselmann | Example: |
715 | dcb93971 | Michael Hanselmann | <screen> |
716 | dcb93971 | Michael Hanselmann | # gnt-node volumes node5.example.com |
717 | dcb93971 | Michael Hanselmann | Node PhysDev VG Name Size Instance |
718 | dcb93971 | Michael Hanselmann | node1.example.com /dev/hdc1 xenvg instance1.example.com-sda_11000.meta 128 instance1.example.com |
719 | dcb93971 | Michael Hanselmann | node1.example.com /dev/hdc1 xenvg instance1.example.com-sda_11001.data 256 instance1.example.com |
720 | dcb93971 | Michael Hanselmann | </screen> |
721 | dcb93971 | Michael Hanselmann | </para> |
722 | dcb93971 | Michael Hanselmann | </refsect2> |
723 | dcb93971 | Michael Hanselmann | |
724 | a8083063 | Iustin Pop | </refsect1> |
725 | a8083063 | Iustin Pop | |
726 | a8083063 | Iustin Pop | &footer; |
727 | a8083063 | Iustin Pop | |
728 | a8083063 | Iustin Pop | </refentry> |
729 | a8083063 | Iustin Pop | |
730 | a8083063 | Iustin Pop | <!-- Keep this comment at the end of the file |
731 | a8083063 | Iustin Pop | Local variables: |
732 | a8083063 | Iustin Pop | mode: sgml |
733 | a8083063 | Iustin Pop | sgml-omittag:t |
734 | a8083063 | Iustin Pop | sgml-shorttag:t |
735 | a8083063 | Iustin Pop | sgml-minimize-attributes:nil |
736 | a8083063 | Iustin Pop | sgml-always-quote-attributes:t |
737 | a8083063 | Iustin Pop | sgml-indent-step:2 |
738 | a8083063 | Iustin Pop | sgml-indent-data:t |
739 | a8083063 | Iustin Pop | sgml-parent-document:nil |
740 | a8083063 | Iustin Pop | sgml-default-dtd-file:nil |
741 | a8083063 | Iustin Pop | sgml-exposed-tags:nil |
742 | a8083063 | Iustin Pop | sgml-local-catalogs:nil |
743 | a8083063 | Iustin Pop | sgml-local-ecat-files:nil |
744 | a8083063 | Iustin Pop | End: |
745 | a8083063 | Iustin Pop | --> |