-Setting up and managing virtual instances
------------------------------------------
-
-Setting up virtual instances
-++++++++++++++++++++++++++++
-
-This step shows how to setup a virtual instance with either
-non-mirrored disks (``plain``) or with network mirrored disks
-(``drbd``). All commands need to be executed on the Ganeti master
-node (the one on which ``gnt-cluster init`` was run). Verify that the
-OS scripts are present on all cluster nodes with ``gnt-os list``.
-
-
-To create a virtual instance, you need a hostname which is resolvable
-(DNS or ``/etc/hosts`` on all nodes). The following command will
-create a non-mirrored instance for you::
-
- gnt-instance add -t plain -s 1G -n node1 -o debootstrap instance1.example.com
- * creating instance disks...
- adding instance instance1.example.com to cluster config
- - INFO: Waiting for instance instance1.example.com to sync disks.
- - INFO: Instance instance1.example.com's disks are in sync.
- creating os for instance instance1.example.com on node node1.example.com
- * running the instance OS create scripts...
- * starting instance...
-
-The above instance will have no network interface enabled. You can
-access it over the virtual console with ``gnt-instance console
-inst1``. There is no password for root. As this is a Debian instance,
-you can modify the ``/etc/network/interfaces`` file to setup the
-network interface (eth0 is the name of the interface provided to the
-instance).
-
-To create a network mirrored instance, change the argument to the *-t*
-option from ``plain`` to ``drbd`` and specify the node on which the
-mirror should reside with the second value of the *--node* option,
-like this (note that the command output includes timestamps which have
-been removed for clarity)::
-
- # gnt-instance add -t drbd -s 1G -n node1:node2 -o debootstrap instance2
- * creating instance disks...
- adding instance instance2.example.com to cluster config
- - INFO: Waiting for instance instance2.example.com to sync disks.
- - INFO: - device disk/0: 35.50% done, 11 estimated seconds remaining
- - INFO: - device disk/0: 100.00% done, 0 estimated seconds remaining
- - INFO: Instance instance2.example.com's disks are in sync.
- creating os for instance instance2.example.com on node node1.example.com
- * running the instance OS create scripts...
- * starting instance...
-
-Managing virtual instances
-++++++++++++++++++++++++++
-
-All commands need to be executed on the Ganeti master node.
-
-To access the console of an instance, run::
-
- gnt-instance console INSTANCENAME