X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/f69dab6d3a2b5eb3488bf3a8ae88ced091c0f221..c2b05d853ec44201234c36a16bb9c8df3f483351:/man/gnt-cluster.sgml
diff --git a/man/gnt-cluster.sgml b/man/gnt-cluster.sgml
index c98934a..6af0c3f 100644
--- a/man/gnt-cluster.sgml
+++ b/man/gnt-cluster.sgml
@@ -2,7 +2,7 @@
- June 20, 2007">
+ December 12, 2007">
8">
@@ -102,6 +102,21 @@
+ The command is executed serially on the selected nodes. If the
+ master node is present in the list, the command will be
+ executed last on the master. Regarding the other nodes, the
+ execution order is somewhat alphabetic (it's smarter so that
+ node2.example.com will be earlier than node10.example.com but
+ after node1.example.com).
+
+
+
+ So given the node names node1, node2, node3, node10, node11,
+ with node3 being the master, the order will be: node1, node2,
+ node10, node11, node3.
+
+
+
The command is constructed by concatenating all other command
line arguments. For example, to list the contents of the
/etc directory on all
@@ -195,6 +210,11 @@
init-s secondary_ip-b bridge
+ -t hypervisor-type
+ -g vg-name
+ --master-netdev vg-name
+ -m mac-prefix
+ --no-lvm-storageclustername
@@ -208,7 +228,8 @@
Note that the clustername is not
any random name. It has to be resolvable to an IP address
using DNS, and it is best if you give the fully-qualified
- domain name.
+ domain name. This hostname must resolve to an IP address
+ reserved exclusively for this purpose.
@@ -226,7 +247,6 @@
Note that for Ganeti it doesn't matter if the secondary
-
network is actually a separate physical network, or is done
using tunneling, etc. For performance reasons, it's
recommended to use a separate network, of course.
@@ -236,6 +256,50 @@
The option specifies the default bridge
for instances.
+
+
+ The allows to set the hypervisor type of
+ the cluster. Available hypervisor types are: xen-pvm, fake and
+ xen-hvm. The default is the xen-pvm hypervisor.
+ Note that if you init the cluster with hypervisor-type
+ xen-hvm you also need to provide the cluster VNC password
+ file /etc/ganeti/vnc-cluster-password
+ because HVM instances require it for VNC console
+ authentication.
+
+
+
+ The option will let you specify a volume group
+ different than 'xenvg' for ganeti to use when creating instance disks.
+ This volume group must have the same name on all nodes. Once the
+ cluster is initialized this can be altered by using the
+ modify command. If you don't want to use lvm
+ storage at all use the option.
+ Once the cluster is initialized you can change this setup with the
+ modify command.
+
+
+
+ The option is useful for specifying a
+ different interface on which the master will activate its IP address.
+ It's important that all nodes have this interface because you'll need
+ it for a master failover.
+
+
+
+ The option will let you specify a three byte prefix
+ under which the virtual MAC addresses of your instances will be
+ generated. The prefix must be specified in the format XX:XX:XX and the
+ default is aa:00:00.
+
+
+
+ The allows you to initialize the
+ cluster without lvm support. This means that only instances using
+ files as storage backend will be possible to create. Once the cluster
+ is initialized you can change this setup with the
+ modify command.
+
@@ -261,6 +325,25 @@
+ MODIFY
+
+
+ modify
+ -g vg-name
+ --no-lvm-storage
+
+
+
+ Modify the options for the cluster.
+
+
+
+ The and are
+ described in the init command.
+
+
+
+ REMOVE-TAGS
@@ -348,6 +431,7 @@
verify
+ --no-nplus1-mem
@@ -355,6 +439,32 @@
respect to running instances, and incurs no downtime of the
instances.
+
+
+ If the option is given, ganeti won't
+ check whether if it loses a node it can restart all the instances on
+ their secondaries (and report an error otherwise).
+
+
+
+
+ VERIFY-DISKS
+
+
+ verify-disks
+
+
+
+ The command checks which instances have degraded DRBD disks
+ and activates the disks of those instances.
+
+
+
+ This command is run from the ganeti-watcher
+ tool, which also has a different, complementary algorithm for
+ doing this check. Together, these two should ensure that DRBD
+ disks are kept consistent.
+