Synnefo » snf-ganeti

<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [

  <!-- Fill in your name for FIRSTNAME and SURNAME. -->

  <!-- Please adjust the date whenever revising the manpage. -->

  <!ENTITY dhdate      "<date>Jul 6, 2007</date>">

  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are

       allowed: see man(7), man(1). -->

  <!ENTITY dhsection   "<manvolnum>8</manvolnum>">

  <!ENTITY dhucpackage "<refentrytitle>gnt-backup</refentrytitle>">

  <!ENTITY dhpackage   "gnt-backup">

  <!ENTITY debian      "<productname>Debian</productname>">

  <!ENTITY gnu         "<acronym>GNU</acronym>">

  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">

  <!ENTITY footer SYSTEM "footer.sgml">

]>

<refentry>

  <refentryinfo>

    <copyright>

      <year>2007</year>

      <holder>Google Inc.</holder>

    </copyright>

    &dhdate;

  </refentryinfo>

  <refmeta>

    &dhucpackage;

    &dhsection;

    <refmiscinfo>ganeti 1.2</refmiscinfo>

  </refmeta>

  <refnamediv>

    <refname>&dhpackage;</refname>

    <refpurpose>ganeti instance import/export</refpurpose>

  </refnamediv>

  <refsynopsisdiv>

    <cmdsynopsis>

      <command>&dhpackage; </command>

      <arg choice="req">command</arg>

      <arg>arguments...</arg>

    </cmdsynopsis>

  </refsynopsisdiv>

  <refsect1>

    <title>DESCRIPTION</title>

    <para>

      The <command>&dhpackage;</command> is used for importing and exporting

      instances and their configuration from a ganeti system. It is useful for

      backing instances up and also to migrate them between clusters.

    </para>

  </refsect1>

  <refsect1>

    <title>COMMANDS</title>

    <refsect2>

      <title>EXPORT</title>

      <cmdsynopsis>

        <command>export</command>

        <arg choice="req">-n <replaceable>node</replaceable></arg>

        <arg>--noshutdown</arg>

        <arg choice="req"><replaceable>instance</replaceable></arg>

      </cmdsynopsis>

      <para>

        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>

        The <option>--noshutdown</option> option will create a

        snapshot disk of the instance without shutting it down first.

        While this is faster and involves no downtime, it cannot be

        guaranteed that the instance data will be in a consistent state

        in the exported dump.

      </para>

      <para>

        Example:

        <screen>

# gnt-backup export -n node1.example.com instance3.example.com

        </screen>

      </para>

    </refsect2>

    <refsect2>

      <title>IMPORT</title>

      <cmdsynopsis>

        <command>import</command>

        <group choice="req">

          <arg>-n <replaceable>node<optional>:secondary-node</optional></replaceable></arg>

          <arg>--iallocator <replaceable>name</replaceable></arg>

        </group>

        <sbr>

        <arg>-s <replaceable>disksize</replaceable></arg>

        <arg>--swap-size <replaceable>disksize</replaceable></arg>

        <arg>-m <replaceable>memsize</replaceable></arg>

        <sbr>

        <arg>-b <replaceable>bridge</replaceable></arg>

        <arg choice="req">--src-node=<replaceable>source-node</replaceable></arg>

        <arg choice="req">--src-dir=<replaceable>source-dir</replaceable></arg>

        <sbr>

        <arg choice="req">-t<group>

            <arg>diskless</arg>

            <arg>plain</arg>

            <arg>drbd</arg>

          </group></arg>

        <sbr>

        <arg choice="req"><replaceable>instance</replaceable></arg>

      </cmdsynopsis>

      <para>

        Imports a new instance from an export residing on

        <replaceable>source-node</replaceable> in

        <replaceable>source-dir</replaceable>.

        <replaceable>instance</replaceable> must be in DNS and

        resolve to a IP in the same network as the nodes in the

        cluster.

      </para>

      <para>

        The <option>-s</option> option specifies the disk size for

        the instance, in mebibytes (defaults to

        <constant>20480MiB</constant> =

        <constant>20GiB</constant>). You can also use one of the

        suffixes <literal>m</literal>, <literal>g</literal> or

        <literal>t</literal> to specificy the exact the units used;

        these suffixes map to mebibytes, gibibytes and tebibytes.

      </para>

      <para>

        The <option>--swap-size</option> option specifies the swap

        disk size (in mebibytes) for the instance (the one presented

        as <filename class="devicefile">/dev/sdb</filename>). The

        default is <constant>4096MiB</constant>. As for the disk

        size, you can specify other suffixes.

      </para>

      <para>

        The <option>-m</option> option specifies the memory size for

        the instance, in mebibytes (defaults to 128 MiB). Again, you

        can use other suffixes (e.g. <userinput>2g</userinput>).

      </para>

      <para>

        The <option>-b</option> option specifies the bridge to which the

        instance will be connected. (defaults to the cluster-wide default

        bridge specified at cluster intialization time).

      </para>

      <para>

        The <option>-t</option> options specifies the disk layout type for

        the instance. The available choices are:

        <variablelist>

          <varlistentry>

            <term>diskless</term>

            <listitem>

              <para>

                This creates an instance with no disks. Its useful for

                testing only (or other special cases).

              </para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>plain</term>

            <listitem>

              <para>Disk devices will be logical volumes.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>drbd</term>

            <listitem>

              <para>

                Disk devices will be drbd (version 8.x) on top of lvm

                volumes.

              </para>

            </listitem>

          </varlistentry>

        </variablelist>

      </para>

      <para>

        The <option>--iallocator</option> option specifies the instance

        allocator plugin to use. If you pass in this option the allocator will

        select nodes for this instance automatically, so you don't need to pass

        them with the <option>-n</option> option. For more information please

        refer to the instance allocator documentation.

      </para>

      <para>

        The optional second value of the <option>--node</option> is used for

        the remote raid template type and specifies the remote node.

      </para>

      <para>

        If you do not want gnt-backup to wait for the disk mirror

        to be synced, use the <option>--no-wait-for-sync</option>

        option.

      </para>

      <para>

        Example:

        <screen>

# gnt-backup import -t plain -s 30 -m 512 -n node1.example.com \

> --src-node=node2.example.com \

> --src-dir=/srv/ganeti/exports/instance3.example.com \

> instance3.example.com

        </screen>

      </para>

    </refsect2>

    <refsect2>

      <title>LIST</title>

      <cmdsynopsis>

        <command>list</command>

        <arg>--node=<replaceable>NODE</replaceable></arg>

      </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 using the <option>--node</option>

        option (which can be used multiple times)

      </para>

      <para>

      Example:

<screen>

# gnt-backup list --nodes node1 --nodes node2

</screen>

    </refsect2>

  </refsect1>

  &footer;

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:2

sgml-indent-data:t

sgml-parent-document:nil

sgml-default-dtd-file:nil

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

-->