</para>
<para>
- Its function is to try to keep running all instances which are
- marked as <emphasis>up</emphasis> in the configuration file, by
- trying to start them a limited number of times.
+ Its primary function is to try to keep running all instances
+ which are marked as <emphasis>up</emphasis> in the configuration
+ file, by trying to start them a limited number of times.
+ </para>
+
+ <para>
+ Its other function is to <quote>repair</quote> DRBD links by
+ reactivating the block devices of instances which have
+ secondaries on nodes that have been rebooted.
</para>
<para>In order to prevent piling up commands, all the
</refsect1>
- <refsect1>
- <title>KNOWN BUGS</title>
-
- <para>
- Due to the way we initialize DRBD peers, restarting a secondary
- node for an instance will cause the DRBD endpoints on that node
- to disappear, thus all instances which have that node as a
- secondary will lose redundancy. The watcher does not detect this
- situation. The workaround is to manually run
- <command>gnt-instance activate-disks</command> for all the
- affected instances.
- </para>
- </refsect1>
-
&footer;
</refentry>
<para>
The ganeti software manages physical nodes and virtual instances
of a cluster based on a virtualization software. The current
- version (1.2) supports Xen 3.0.
+ version (1.2) supports Xen 3.0 (also tested with 3.1).
</para>
</refsect1>
</cmdsynopsis>
<para>
- Exports an instance to the target node. All the instance
- data and its configuration will be exported under the
- /srv/ganeti/exports/instance directory on the target node.
+ Exports an instance to the target node. All the instance data
+ and its configuration will be exported under the
+ /srv/ganeti/exports/<replaceable>instance</replaceable>
+ directory on the target node.
</para>
<para>
<arg>plain</arg>
<arg>local_raid1</arg>
<arg>remote_raid1</arg>
+ <arg>drbd</arg>
</group>
</arg>
+ <sbr>
<arg choice="req">--src-node=<replaceable>source-node</replaceable></arg>
<arg choice="req">--src-dir=<replaceable>source-dir</replaceable></arg>
<arg choice="req"><replaceable>instance</replaceable></arg>
<para>
The <option>-s</option> option specifies the disk size for
- the instance, in gigibytes (defaults to 20 GiB).
+ the instance, in gibibytes (defaults to 20 GiB).
</para>
<para>
<para>
The <option>-m</option> option specifies the memory size for
- the instance, in megibytes (defaults to 128 MiB).
+ the instance, in mebibytes (defaults to 128 MiB).
</para>
<para>
<term>remote_raid1</term>
<listitem>
<para>
- Disk devices will be md raid1 arrays with one component (so
- it's not actually raid1): a drbd device between the instance's
- primary node and the node given by the second value of the
+ Disk devices will be md raid1 arrays with one
+ component (so it's not actually raid1): a drbd (0.7.x)
+ device between the instance's primary node and the
+ node given by the second value of the
<option>--node</option> option.
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>drbd</term>
+ <listitem>
+ <para>
+ Disk devices will be drbd (version 8.x) on top of lvm
+ volumes. They are equivalent in functionality to
+ <replaceable>remote_raid1</replaceable>, but are
+ recommended for new instances (if you have drbd 8.x
+ installed).
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</para>
</cmdsynopsis>
<para>
- Lists the exports currently available in the default directory in all
- the nodes of the current cluster, or optionally only a subset of them
- specified by the <option>--nodes</option> option.
+ Lists the exports currently available in the default directory
+ in all the nodes of the current cluster, or optionally only a
+ subset of them specified by the <option>--nodes</option>
+ option (use this option multiple times to select multiple
+ nodes).
</para>
+ <para>
+ Example:
+<screen>
+# gnt-backup list --nodes node1 --nodes node2
+</screen>
</refsect2>
</refsect1>
<cmdsynopsis>
<command>destroy</command>
+ <arg choice="req">--yes-do-it</arg>
</cmdsynopsis>
<para>
a <command>gnt-cluster init</command> can be done again
afterwards.
</para>
+
+ <para>
+ Since this is a dangerous command, you are required to pass
+ the argument <replaceable>--yes-do-it.</replaceable>
+ </para>
</refsect2>
<refsect2>
<arg>plain</arg>
<arg>local_raid1</arg>
<arg>remote_raid1</arg>
+ <arg>drbd</arg>
</group>
</arg>
<sbr>
<term>remote_raid1</term>
<listitem>
<para>
- Disk devices will be md raid1 arrays with one component (so
- it's not actually raid1): a drbd device between the
- instance's primary node and the node given by the second
- value of the <option>--node</option> option.
+ Disk devices will be md raid1 arrays with one
+ component (so it's not actually raid1): a drbd
+ (0.7.x) device between the instance's primary node
+ and the node given by the second value of the
+ <option>--node</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>drbd</term>
+ <listitem>
+ <para>
+ Disk devices will be drbd (version 8.x) on top of
+ lvm volumes. They are equivalent in functionality to
+ <replaceable>remote_raid1</replaceable>, but are
+ recommended for new instances (if you have drbd 8.x
+ installed).
</para>
</listitem>
</varlistentry>
<cmdsynopsis>
<command>volumes</command>
+ <arg>--no-headers</arg>
+ <arg>--human-readable</arg>
+ <arg>--separator=<replaceable>SEPARATOR</replaceable></arg>
+ <arg>--output=<replaceable>FIELDS</replaceable></arg>
+ <sbr>
<arg rep="repeat"><replaceable>node</replaceable></arg>
</cmdsynopsis>
</para>
<para>
+ The <option>--no-headers</option> option will skip the initial
+ header line. The <option>--separator</option> option takes an
+ argument which denotes what will be used between the output
+ fields. Both these options are to help scripting.
+ </para>
+
+ <para>
+ The <option>-o</option> option takes a comma-separated list of
+ output fields. The available fields and their meaning are:
+ <variablelist>
+ <varlistentry>
+ <term>node</term>
+ <listitem>
+ <simpara>the node name on which the volume exists</simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>phys</term>
+ <listitem>
+ <simpara>the physical drive (on which the LVM physical
+ volume lives)</simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>vg</term>
+ <listitem>
+ <simpara>the volume group name</simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>name</term>
+ <listitem>
+ <simpara>the logical volume name</simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>size</term>
+ <listitem>
+ <simpara>the logical volume size</simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>instance</term>
+ <listitem>
+ <simpara>The name of the instance to which this volume
+ belongs, or (in case it's an orphan volume) the
+ character <quote>-</quote></simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+
+ <para>
Example:
<screen>
# gnt-node volumes node5.example.com