You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by se...@apache.org on 2015/06/08 12:43:26 UTC
[2/3] cloudstack-docs-rn git commit: document that XenServer depends
on pool HA these days
document that XenServer depends on pool HA these days
backported from master
Signed-off-by: Sebastien Goasguen <ru...@gmail.com>
Project: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/commit/fa98a388
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/tree/fa98a388
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/diff/fa98a388
Branch: refs/heads/4.5
Commit: fa98a388d2952acd6be335bbae2c3a346621172e
Parents: 62c9857
Author: Remi Bergsma <gi...@remi.nl>
Authored: Sat May 23 22:15:57 2015 +0200
Committer: Sebastien Goasguen <ru...@gmail.com>
Committed: Mon Jun 8 12:42:43 2015 +0200
----------------------------------------------------------------------
source/compat.rst | 5 ++++-
source/upgrade/upgrade-4.2.rst | 34 ++++++++++++++++++++++++++++++++--
source/upgrade/upgrade-4.3.rst | 31 +++++++++++++++++++++++++++++++
source/upgrade/upgrade-4.4.rst | 30 ++++++++++++++++++++++++++++++
4 files changed, 97 insertions(+), 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/fa98a388/source/compat.rst
----------------------------------------------------------------------
diff --git a/source/compat.rst b/source/compat.rst
index e4ba17b..95feec5 100644
--- a/source/compat.rst
+++ b/source/compat.rst
@@ -47,6 +47,9 @@ and VMware with vSphere.
- CentOS 6.2+ with KVM
- Red Hat Enterprise Linux 6.2 with KVM
- XenServer versions 6.1, 6.2 SP1 and 6.5 with latest hotfixes
+
+ .. note:: It is now required to enable HA on the XenServer pool in order to recover from a pool-master failure. Please refer to the `XenServer documentation <http://docs.vmd.citrix.com/XenServer/6.5.0/1.0/en_gb/>`_.
+
- VMware versions 5.0 Update 3a, 5.1 Update 2a, and 5.5 Update 2
- Bare metal hosts are supported, which have no hypervisor. These hosts
can run the following operating systems:
@@ -86,4 +89,4 @@ best results, one of the following browsers recommended:
- Google Chrome version 36.0.1985
-- Safari 6+
\ No newline at end of file
+- Safari 6+
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/fa98a388/source/upgrade/upgrade-4.2.rst
----------------------------------------------------------------------
diff --git a/source/upgrade/upgrade-4.2.rst b/source/upgrade/upgrade-4.2.rst
index f1749f1..a909835 100644
--- a/source/upgrade/upgrade-4.2.rst
+++ b/source/upgrade/upgrade-4.2.rst
@@ -238,8 +238,8 @@ read as appropriate for your |version| repository.
$ sudo yum upgrade cloudstack-usage
-Hypervisor: Xen/XenServer
--------------------------
+Hypervisor: XenServer
+---------------------
**(XenServer only)** Copy vhd-utils file on CloudStack management servers.
Copy the file `vhd-utils <http://download.cloud.com.s3.amazonaws.com/tools/vhd-util>`_
@@ -250,6 +250,36 @@ to ``/usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver``.
wget -P /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver \
http://download.cloud.com.s3.amazonaws.com/tools/vhd-util
+Make sure XenServer has enabled HA on the pool.
+
+To test if poolHA is currently turned on:
+
+.. sourcecode:: bash
+
+ xe pool-list params=all | grep -E "ha-enabled|ha-config"
+
+Output when poolHA is ON:
+
+.. sourcecode:: bash
+
+ ha-enabled ( RO): true
+ ha-configuration ( RO): timeout: 180
+
+Output when poolHA is OFF:
+
+.. sourcecode:: bash
+
+ ha-enabled ( RO): false
+ ha-configuration ( RO):
+
+To enable poolHA, use something like this:
+
+.. sourcecode:: bash
+
+ xe pool-enable-ha heartbeat-sr-uuids={SR-UUID} ha-config:timeout=180
+
+Please refer to the `XenServer documentation <http://docs.vmd.citrix.com/XenServer/>`_, as there are multiple ways of configuring it either on NFS, iSCSI or Fibre Channel. Be aware though, that the timeout setting is not documented. The default is 30 seconds so you may want to bump that towards 120-180 seconds.
+
Hypervisor: VMware
------------------
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/fa98a388/source/upgrade/upgrade-4.3.rst
----------------------------------------------------------------------
diff --git a/source/upgrade/upgrade-4.3.rst b/source/upgrade/upgrade-4.3.rst
index 9b0b490..279d11e 100644
--- a/source/upgrade/upgrade-4.3.rst
+++ b/source/upgrade/upgrade-4.3.rst
@@ -254,6 +254,37 @@ to ``/usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver``.
wget -P /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver \
http://download.cloud.com.s3.amazonaws.com/tools/vhd-util
+Make sure XenServer has enabled HA on the pool.
+
+To test if poolHA is currently turned on:
+
+.. sourcecode:: bash
+
+ xe pool-list params=all | grep -E "ha-enabled|ha-config"
+
+Output when poolHA is ON:
+
+.. sourcecode:: bash
+
+ ha-enabled ( RO): true
+ ha-configuration ( RO): timeout: 180
+
+Output when poolHA is OFF:
+
+.. sourcecode:: bash
+
+ ha-enabled ( RO): false
+ ha-configuration ( RO):
+
+To enable poolHA, use something like this:
+
+.. sourcecode:: bash
+
+ xe pool-enable-ha heartbeat-sr-uuids={SR-UUID} ha-config:timeout=180
+
+Please refer to the `XenServer documentation <http://docs.vmd.citrix.com/XenServer/>`_, as there are multiple ways of configuring it either on NFS, iSCSI or Fibre Channel. Be aware though, that the timeout setting is not documented. The default is 30 seconds so you may want to bump that towards 120-180 seconds.
+
+
Hypervisor: VMware
------------------
http://git-wip-us.apache.org/repos/asf/cloudstack-docs-rn/blob/fa98a388/source/upgrade/upgrade-4.4.rst
----------------------------------------------------------------------
diff --git a/source/upgrade/upgrade-4.4.rst b/source/upgrade/upgrade-4.4.rst
index 64f662a..f2db269 100644
--- a/source/upgrade/upgrade-4.4.rst
+++ b/source/upgrade/upgrade-4.4.rst
@@ -256,6 +256,36 @@ to ``/usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver``.
wget -P /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver \
http://download.cloud.com.s3.amazonaws.com/tools/vhd-util
+Make sure XenServer has enabled HA on the pool.
+
+To test if poolHA is currently turned on:
+
+.. sourcecode:: bash
+
+ xe pool-list params=all | grep -E "ha-enabled|ha-config"
+
+Output when poolHA is ON:
+
+.. sourcecode:: bash
+
+ ha-enabled ( RO): true
+ ha-configuration ( RO): timeout: 180
+
+Output when poolHA is OFF:
+
+.. sourcecode:: bash
+
+ ha-enabled ( RO): false
+ ha-configuration ( RO):
+
+To enable poolHA, use something like this:
+
+.. sourcecode:: bash
+
+ xe pool-enable-ha heartbeat-sr-uuids={SR-UUID} ha-config:timeout=180
+
+Please refer to the `XenServer documentation <http://docs.vmd.citrix.com/XenServer/>`_, as there are multiple ways of configuring it either on NFS, iSCSI or Fibre Channel. Be aware though, that the timeout setting is not documented. The default is 30 seconds so you may want to bump that towards 120-180 seconds.
+
Hypervisor: VMware
------------------