X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/34bf35c0f3da4ec629be9cb56646fe8501f156f4..f21b6023893e85b6edc6642af11278d7a959c59c:/doc/install.sgml

diff --git a/doc/install.sgml b/doc/install.sgml
index ca78bc0..84cfab9 100644
--- a/doc/install.sgml
+++ b/doc/install.sgml
@@ -212,6 +212,14 @@
           kernel parameter <literal>nosmp</literal>.
         </para>
 
+        <para>
+          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
+          <literal>XENDOMAINS_SAVE</literal> in the file
+          <literal>/etc/default/xendomains</literal> is set to an empty value.
+        </para>
+
         <formalpara>
           <title>Debian</title>
           <para>
@@ -241,6 +249,21 @@
 </screen>
           </para>
         </formalpara>
+        <para>
+          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
+          <filename>/etc/xen/xend-config.sxp</filename>:
+<screen>
+(vnc-listen '0.0.0.0')
+(vncpasswd '')
+</screen>
+          You need to restart the Xen daemon for these settings to
+          take effect:
+<screen>
+/etc/init.d/xend restart
+</screen>
+        </para>
 
       </sect3>
 
@@ -293,7 +316,7 @@ ln -s initrd.img-2.6.18-5-xen-686 initrd-2.6-xenU
       <para>
         Supported DRBD versions: the <literal>0.7</literal> series
         <emphasis role="strong">or</emphasis>
-        <literal>8.0.x</literal>. It's recommended to have at least
+        <literal>8.0.7</literal>. It's recommended to have at least
         version <literal>0.7.24</literal> if you use
         <command>udev</command> since older versions have a bug
         related to device discovery which can be triggered in cases of
@@ -338,8 +361,11 @@ m-a a-i drbd0.7
 echo drbd minor_count=64 >> /etc/modules
 modprobe drbd minor_count=64
       </screen>
-      <para>or for using DRBD <literal>8.x</literal> from the etch
-      backports:</para>
+      <para>
+        or for using DRBD <literal>8.x</literal> from the etch
+        backports (note: you need at least 8.0.7, older version have
+        a bug that breaks ganeti's usage of drbd):
+      </para>
       <screen>
 apt-get install -t etch-backports drbd8-module-source drbd8-utils
 m-a update
@@ -447,7 +473,7 @@ skip resource "r1" {
       <screen>
 # apt-get install lvm2 ssh bridge-utils iproute iputils-arping \
   python2.4 python-twisted-core python-pyopenssl openssl \
-  mdadm
+  mdadm python-pyparsing python-simplejson
       </screen>
 
     </sect2>
@@ -597,8 +623,8 @@ vgextend xenvg /dev/sdd1
       </para>
 
         <screen>
-tar xvzf ganeti-1.2b2.tar.gz
-cd ganeti-1.2b2
+tar xvzf ganeti-@GANETI_VERSION@.tar.gz
+cd ganeti-@GANETI_VERSION@
 ./configure --localstatedir=/var --sysconfdir=/etc
 make
 make install
@@ -637,13 +663,15 @@ mkdir /srv/ganeti/ /srv/ganeti/os /srv/ganeti/export
         provided on the project web site.  Download it from <ulink
         url="http://code.google.com/p/ganeti/"></ulink> and follow the
         instructions in the <filename>README</filename> file.  Here is
-        the installation procedure:
+        the installation procedure (replace <constant>0.2</constant>
+        with the latest version that is compatible with your ganeti
+        version):
       </para>
 
       <screen>
 cd /srv/ganeti/os
-tar xvf instance-debian-etch-0.2.tar
-mv instance-debian-etch-0.2 debian-etch
+tar xvf ganeti-instance-debian-etch-0.4.tar
+mv ganeti-instance-debian-etch-0.4 debian-etch
       </screen>
 
       <para>
@@ -723,6 +751,20 @@ gnt-cluster init <replaceable>CLUSTERNAME</replaceable>
       </para>
 
       <para>
+        To set up the cluster as an HVM cluster, use the
+        <option>--hypervisor=xen-hvm3.1</option> 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
+        <filename>/etc/ganeti/vnc-cluster-password</filename>
+        which contains one line with the default VNC password for the
+        cluster.
+      </para>
+
+      <para>
         You can also invoke the command with the
         <option>--help</option> option in order to see all the
         possibilities.