From bf6fe28b64a8cbc8ae14637d60ffd20f760b4f6d Mon Sep 17 00:00:00 2001
From: Alexander Schreiber <als@google.com>
Date: Fri, 21 Dec 2007 14:00:15 +0000
Subject: [PATCH] HVM proof-of-concept documentation
Update documentation to document the HVM proof-of-concept.
Reviewed-by: iustinp
---
doc/install.sgml | 33 +++++++++++++++++++++++++++++++++
man/gnt-cluster.sgml | 11 +++++++++++
2 files changed, 44 insertions(+)
diff --git a/doc/install.sgml b/doc/install.sgml
index b3bbe2deb..e27a39394 100644
--- a/doc/install.sgml
+++ b/doc/install.sgml
@@ -249,6 +249,21 @@
</screen>
</para>
</formalpara>
+ <para>
+ If you want to test the experimental 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>
@@ -735,6 +750,24 @@ gnt-cluster init <replaceable>CLUSTERNAME</replaceable>
to <computeroutput>gnt-cluster init</computeroutput>.
</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
+ experimental 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
+ experimental 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. Finally, you need to provide an installation ISO
+ image for HVM instance which will not only be mapped to the
+ first CDROM of the instance, but which the instance will also
+ boot from. This ISO image is expected at
+ <filename>/srv/ganeti/iso/hvm-install.iso</filename>.
+ </para>
+
<para>
You can also invoke the command with the
<option>--help</option> option in order to see all the
diff --git a/man/gnt-cluster.sgml b/man/gnt-cluster.sgml
index bb18efb94..7a49126a7 100644
--- a/man/gnt-cluster.sgml
+++ b/man/gnt-cluster.sgml
@@ -236,6 +236,17 @@
The <option>-b</option> option specifies the default bridge
for instances.
</para>
+ <para>
+ The <option>-t</option> allows to set the hypervisor type of
+ the cluster. Available hypervisor types are: xen-3.0, fake and
+ xen-hvm3.1. The default is the xen-3.0 hypervisor.
+ Note that if you init the cluster with hypervisor-type
+ xen-hvm3.1 you also need to provide the cluster VNC password
+ file <filename>/etc/ganeti/vnc-cluster-password</filename> and
+ the HVM boot ISO image
+ <filename>/srv/ganeti/iso/hvm-install.iso</filename> because
+ instances created by the experimental HVM support require them.
+ </para>
</refsect2>
<refsect2>
--
GitLab