X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/6c4811dc68db531aa3bc45c451cb8a352a345baa..90e722d13c324c95e82447ba154b00c95125ff2b:/doc/install.sgml
diff --git a/doc/install.sgml b/doc/install.sgml
index e196778..cb5cb1f 100644
--- a/doc/install.sgml
+++ b/doc/install.sgml
@@ -212,6 +212,14 @@
kernel parameter nosmp.
+
+ It is recommended that you disable xen's automatic save of virtual
+ machines at system shutdown and subsequent restore of them at reboot.
+ To obtain this make sure the variable
+ XENDOMAINS_SAVE in the file
+ /etc/default/xendomains is set to an empty value.
+
+
Debian
@@ -241,6 +249,21 @@
+
+ If you want to test the HVM support
+ with Ganeti and want VNC access to the console of your
+ instances, set the following two entries in
+ /etc/xen/xend-config.sxp:
+
+(vnc-listen '0.0.0.0')
+(vncpasswd '')
+
+ You need to restart the Xen daemon for these settings to
+ take effect:
+
+/etc/init.d/xend restart
+
+
@@ -291,13 +314,8 @@ ln -s initrd.img-2.6.18-5-xen-686 initrd-2.6-xenU
- Supported DRBD versions: the 0.7 series
- or
- 8.0.x. It's recommended to have at least
- version 0.7.24 if you use
- udev since older versions have a bug
- related to device discovery which can be triggered in cases of
- hard drive failure.
+ Supported DRBD versions: 8.0.x.
+ It's recommended to have at least version 8.0.7.
@@ -313,44 +331,32 @@ ln -s initrd.img-2.6.18-5-xen-686 initrd-2.6-xenU
you have the DRBD utils installed and the module in your
kernel you're fine. Please check that your system is
configured to load the module at every boot, and that it
- passes the following option to the module (for
- 0.7.x:
- minor_count=64 (this will
- allow you to use up to 32 instances per node) or for
- 8.0.x you can use up to
- 255
- (i.e. minor_count=255, but
- for most clusters 128 should be enough).
+ passes the following option to the module
+ minor_count=255. This will
+ allow you to use up to 128 instances per node (for most clusters
+ 128 should be enough, though).
Debian
- You can just install (build) the DRBD 0.7 module with the
+ You can just install (build) the DRBD 8.0.x module with the
following commands (make sure you are running the Xen
kernel):
-apt-get install drbd0.7-module-source drbd0.7-utils
-m-a update
-m-a a-i drbd0.7
-echo drbd minor_count=64 >> /etc/modules
-modprobe drbd minor_count=64
-
- or for using DRBD 8.x from the etch
- backports:
-
-apt-get install -t etch-backports drbd8-module-source drbd8-utils
+apt-get install -t etch-backports drbd8-source drbd8-utils
m-a update
m-a a-i drbd8
echo drbd minor_count=128 >> /etc/modules
+depmod -a
modprobe drbd minor_count=128
It is also recommended that you comment out the default
- resources in the /etc/dbrd.conf file, so
+ resources in the /etc/drbd.conf file, so
that the init script doesn't try to configure any drbd
devices. You can do this by prefixing all
resource lines in the file with the keyword
@@ -402,19 +408,9 @@ skip resource "r1" {
(part of iputils package)
- mdadm
- (Linux Software Raid tools)
-
- Python 2.4
- Python
- Twisted library - the core library is
- enough
-
- Python OpenSSL
bindings
@@ -446,8 +442,7 @@ skip resource "r1" {
# apt-get install lvm2 ssh bridge-utils iproute iputils-arping \
- python2.4 python-twisted-core python-pyopenssl openssl \
- mdadm
+ python2.4 python-pyopenssl openssl python-pyparsing python-simplejson
@@ -597,8 +592,8 @@ vgextend xenvg /dev/sdd1
-tar xvzf ganeti-1.2b1.tar.gz
-cd ganeti-1.2b1
+tar xvzf ganeti-@GANETI_VERSION@.tar.gz
+cd ganeti-@GANETI_VERSION@
./configure --localstatedir=/var --sysconfdir=/etc
make
make install
@@ -637,13 +632,15 @@ mkdir /srv/ganeti/ /srv/ganeti/os /srv/ganeti/export
provided on the project web site. Download it from and follow the
instructions in the README file. Here is
- the installation procedure:
+ the installation procedure (replace 0.2
+ with the latest version that is compatible with your ganeti
+ version):
cd /srv/ganeti/os
-tar xvf instance-debian-etch-0.1.tar
-mv instance-debian-etch-0.1 debian-etch
+tar xvf ganeti-instance-debian-etch-0.4.tar
+mv ganeti-instance-debian-etch-0.4 debian-etch
@@ -701,7 +698,9 @@ gnt-cluster init CLUSTERNAME
nodes names for a multi-node cluster. In general the best
choice is to have a unique name for a cluster, even if it
consists of only one machine, as you will be able to expand it
- later without any problems.
+ later without any problems. Please note that the hostname used
+ for this must resolve to an IP address reserved exclusively
+ for this purpose.
@@ -723,6 +722,20 @@ gnt-cluster init CLUSTERNAME
+ To set up the cluster as an HVM cluster, use the
+ option to use
+ the Xen 3.1 HVM hypervisor. Note that with the
+ HVM support, you will only be able to create
+ HVM instances in a cluster set to this hypervisor type. Mixed
+ PVM/HVM clusters are not supported by the Ganeti 1.2
+ HVM support. You will also need to create the VNC
+ cluster password file
+ /etc/ganeti/vnc-cluster-password
+ which contains one line with the default VNC password for the
+ cluster.
+
+
+
You can also invoke the command with the
option in order to see all the
possibilities.
@@ -788,8 +801,7 @@ node1.example.com 197404 197404 2047 1896 125 0 0
This step shows how to setup a virtual instance with either
non-mirrored disks (plain) or
with network mirrored disks
- (remote_raid1 for drbd 0.7
- and drbd for drbd 8.x). All
+ (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
@@ -826,14 +838,13 @@ creating os for instance inst1.example.com on node node1.example.com
To create a network mirrored instance, change the argument to
the option from plain
- to remote_raid1 (drbd 0.7) or
- drbd (drbd 8.0) and specify the node on
+ to drbd and specify the node on
which the mirror should reside with the second value of the
option, like this:
-# gnt-instance add -t remote_raid1 -n node1:node2 -o debian-etch instance2
+# gnt-instance add -t drbd -n node1:node2 -o debian-etch instance2
* creating instance disks...
adding instance instance2 to cluster config
Waiting for instance instance1 to sync disks.
@@ -873,8 +884,8 @@ creating os for instance instance2 on node node1.example.com
To failover an instance to its secondary node (only possible
- in remote_raid1 or drbd
- disk templates), use gnt-instance failover
+ with drbd disk templates), use
+ gnt-instance failover
INSTANCENAME.