Citrix Systems 4.2 Server User Manual


 
Upgrade from 2.1.x to 4.2
37
Note
(VMware only) After upgrade, whenever you add a new VMware cluster to a zone that was
created with a previous version of CloudPlatform, the fields vCenter host, vCenter Username,
vCenter Password, and vCenter Datacenter are required. The Add Cluster dialog in the
CloudPlatform user interface incorrectly shows them as optional, and will allow you to proceed
with adding the cluster even though these important fields are blank. If you do not provide the
values, you will see an error message like "Your host and/or path is wrong. Make sure it's of the
format http://hostname/path".
4.3. Upgrade from 2.1.x to 4.2
Direct upgrades from version 2.1.0 - 2.1.10 to 4.2 are not supported. CloudPlatform must first
be upgraded to version 2.2.14. For information on how to upgrade from 2.1.x to 2.2.14, see the
CloudPlatform 2.2.14 Release Notes.
4.4. Upgrading and Hotfixing XenServer Hypervisor Hosts
In CloudPlatform 4.2, you can upgrade XenServer hypervisor host software without having to
disconnect the XenServer cluster. You can upgrade XenServer 5.6 GA, 5.6 FP1, or 5.6 SP2 to any
newer version that is supported by CloudPlatform. The actual upgrade is described in XenServer
documentation, but there are some additional steps you must perform before and after the upgrade.
4.4.1. Upgrading to a New XenServer Version
To upgrade XenServer hosts when running CloudPlatform 4.2:
1. Edit the file /etc/cloudstack/management/environment.properties and add the following line:
manage.xenserver.pool.master=false
2. Restart the Management Server to put the new setting into effect.
# service cloudstack-management start
3. Find the hostname of the master host in your XenServer cluster (pool):
a. Run the following command on any host in the pool, and make a note of the host-uuid of the
master host:
# xe pool-list
b. Now run the following command, and find the host that has a host-uuid that matches the
master host from the previous step. Make a note of this host's hostname. You will need to
input it in a later step.
# xe host-list
4. On CloudPlatform, put the master host into maintenance mode. Use the hostname you discovered
in the previous step.