CloudStack Release Notes Documentation Release 4.5.
Contents 1 What’s New in 4.5 1.1 NuageVsp Network Plugin . . . . . . . . . . . . . . . . . 1.2 Bind integration with Globo DNSAPI . . . . . . . . . . . 1.3 SAML 2.0 Plugin . . . . . . . . . . . . . . . . . . . . . . 1.4 Managed storage for KVM . . . . . . . . . . . . . . . . . 1.5 Improved CloudByte Storage Plugin . . . . . . . . . . . . 1.6 Use SSH for commands sent to Virtual-Router . . . . . . 1.7 Baremetal Advanced Networking Support . . . . . . . . . 1.
6.5 6.6 6.7 6.8 6.9 6.10 7 8 9 Management Server on CentOS/RHEL Hypervisor: XenServer . . . . . . . . . Hypervisor: VMware . . . . . . . . . . Hypervisor: KVM . . . . . . . . . . . Restart management services . . . . . System-VMs and Virtual-Routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
CloudStack Release Notes Documentation, Release 4.5.1 This document contains information specific to this release of CloudStack, including upgrade instructions from prior releases, new features added to CloudStack, API changes, and issues fixed in the release. For installation instructions, please see the CloudStack Installation Guide. For usage and administration instructions, please see the CloudStack Administrator’s Guide.
CloudStack Release Notes Documentation, Release 4.5.
CHAPTER 1 What’s New in 4.5 Version 4.5.1 includes more than 200 bug fixes from previous release, the following new features and improvements. 1.1 NuageVsp Network Plugin The Nuage NetworksTM Virtualized Services Platform (VSP) is a Software-Defined Networking (SDN) solution that virtualizes any datacenter (DC) network infrastructure and automatically establishes connectivity between compute resources upon their creation.
CloudStack Release Notes Documentation, Release 4.5.1 1.4 Managed storage for KVM This adapter provides one to one mapping between SAN volume to VM’s disk. This is to guarantee quality of services for performance sensitive applications. This adapter is based on nfs protocol. Supported hypervisors: Link KVM CLOUDSTACK-7576 1.5 Improved CloudByte Storage Plugin The new improved CloudByte plugin support the following features: • Managed storage, where each vm disk has the guaranteed QoS.
CloudStack Release Notes Documentation, Release 4.5.1 1.8 Instance Password Generation length can now be changed For instance using random password generated by CloudStack, Password length and encoder can now be define with following Global Settings: vm.password.length, user.password.encoders.exclude, user.password.encoders.order 1.
CloudStack Release Notes Documentation, Release 4.5.1 6 Chapter 1. What’s New in 4.
CHAPTER 2 Issues Fixed in 4.5 Apache CloudStack uses Jira to track its issues. All new features and bugs for 4.5.1 have been tracked in Jira, and have a standard naming convention of “CLOUDSTACK-NNNN” where “NNNN” is the issue number. 2.1 Issues Fixed in 4.5.1 For the list of issues fixed, see Issues Fixed in 4.5.1.
CloudStack Release Notes Documentation, Release 4.5.1 2.2 Issues Fixed in 4.5.0 For the list of issues fixed, see Issues Fixed in 4.5.1.
CloudStack Release Notes Documentation, Release 4.5.
CloudStack Release Notes Documentation, Release 4.5.
CloudStack Release Notes Documentation, Release 4.5.
CloudStack Release Notes Documentation, Release 4.5.1 Bug ID CLOUDSTACK-5324 CLOUDSTACK-5309 CLOUDSTACK-5241 CLOUDSTACK-4770 CLOUDSTACK-4665 CLOUDSTACK-4587 CLOUDSTACK-4451 CLOUDSTACK-4364 CLOUDSTACK-4351 CLOUDSTACK-4322 CLOUDSTACK-4292 CLOUDSTACK-4200 CLOUDSTACK-3995 CLOUDSTACK-3815 CLOUDSTACK-3608 CLOUDSTACK-3607 CLOUDSTACK-2625 CLOUDSTACK-1990 CLOUDSTACK-315 12 Table 2.1 – continued from previous page Description error message not proper when start VM fails because router requires upgrade...
CHAPTER 3 Compatibility Matrix 3.1 Supported OS Versions for Management Server This section lists the operating systems that are supported for running CloudStack Management Server. Note that specific versions of the operating systems are tested, so compatibility with CentOS 6.3 may not indicate compatibility with CentOS 6.2, 6.1 and so on. • RHEL versions 6.3, 6.5, 6.6 and 7.0 • CentOS versions 6.6, 7.0 • Ubuntu 14.04 LTS 3.1.1 Software Requirements • Java 1.7 • MySQL 5.6 (RHEL 7) • MySQL 5.1 (RHEL 6.
CloudStack Release Notes Documentation, Release 4.5.1 – Fedora 17 – Ubuntu 12.04 For more information, see the Hypervisor Compatibility Matrix in the CloudStack Installation Guide. 3.3 Supported External Devices • Netscaler VPX and MPX versions 9.3, 10.1e and 10.5 • Netscaler SDX version 9.3, 10.1e and 10.5 • SRX (Model srx100b) versions 10.3 to 10.4 R7.5 • F5 11.X • Force 10 Switch version S4810 for Baremetal Advanced Networks 3.
CHAPTER 4 API Changes Introduced in 4.5 For the complete list of API commands and params consult the CloudStack Apidocs. 4.
CloudStack Release Notes Documentation, Release 4.5.
CloudStack Release Notes Documentation, Release 4.5.1 API updateTrafficType Table 4.
CloudStack Release Notes Documentation, Release 4.5.1 API listInternalLoadBalancerVMs Table 4.
CloudStack Release Notes Documentation, Release 4.5.1 API rebootRouter Table 4.
CloudStack Release Notes Documentation, Release 4.5.1 20 Chapter 4. API Changes Introduced in 4.
CHAPTER 5 General Upgrade Notes 5.1 Job timeouts are shorter than before Please be aware that in 4.5 a bug is fixed (CLOUDSTACK-7595) that makes sure global settings ‘job.cancel.threshold.minutes’ and ‘job.expire.minutes’ are defined in minutes as they are supposed to be. Before, they were accidentally 60x bigger than configured. This means previous versions had a much higher timeout. You might hit this timeout when migrating large disks or making big snapshots, etc. 5.2 Java version upgraded to Java 1.
CloudStack Release Notes Documentation, Release 4.5.1 5.5 OVS plug-in OVS plug-in functionality is disrupted if ovsdaemon crashes A critical functionality issue came out with CLOUDSTACK-6779. On XenServer it is observed that on VIF unplug Ovs-Vswitchd is crashing resulting in loosing all the openflow rules added to the bridge. Ovs daemon gets started and creates a bridge but configure openflow rules are lost resulting in the disruption of connectivity for the VM’s on the host. 5.
CHAPTER 6 Upgrade Instruction from 4.4.x This section will guide you from CloudStack 4.4.x to CloudStack 4.5. Any steps that are hypervisor-specific will be called out with a note. We recommend reading through this section once or twice before beginning your upgrade procedure, and working through it on a test system before working on a production system. Note: The following upgrade instructions should be performed regardless of hypervisor type. Upgrade Steps: 1. Backup CloudStack database (MySQL) 2.
CloudStack Release Notes Documentation, Release 4.5.1 5. In the Register template dialog box, specify the following values (do not change these): 24 Chapter 6. Upgrade Instruction from 4.4.
CloudStack Release Notes Documentation, Release 4.5.1 HyDescription pervisor XenServerName: systemvm-xenserver-4.5 Description: systemvm-xenserver-4.5 URL: http://packages.shapeblue.com/systemvmtemplate/4.5/systemvm64template-4.5-xen.vhd.bz2 Zone: Choose the zone where this hypervisor is used Hypervisor: XenServer Format: VHD OS Type: Debian GNU/Linux 7.
CloudStack Release Notes Documentation, Release 4.5.1 6. Watch the screen to be sure that the template downloads successfully and enters the READY state. Do not proceed until this is successful. 6.3 Database Preparation Backup current database 1. Stop your management server or servers. Run this on all management server hosts: $ sudo service cloudstack-management stop 2. If you are running a usage server or usage servers, stop those as well: $ sudo service cloudstack-usage stop 3.
CloudStack Release Notes Documentation, Release 4.5.1 deb http://packages.shapeblue.com/cloudstack/upstream/debian/4.5/ ./ Setup the public key for the above repository: wget -qO - http://packages.shapeblue.com/release.asc | sudo apt-key add - If you’re using your own package repository, change this line to read as appropriate for your 4.5 repository. 1. Now update your apt package list: $ sudo apt-get update 2.
CloudStack Release Notes Documentation, Release 4.5.1 1. Now that you have the repository configured, it’s time to upgrade the cloudstack-management. $ sudo yum upgrade cloudstack-management 2. If you use CloudStack usage server $ sudo yum upgrade cloudstack-usage 6.6 Hypervisor: XenServer (XenServer only) Copy vhd-utils file on CloudStack management servers. Copy the file vhd-utils to /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver.
CloudStack Release Notes Documentation, Release 4.5.1 update cloud.vmware_data_center set password = '_ciphertext_from_step_1_' where id = _id_from_st 8. Confirm that the table is updated: select * from cloud.vmware_data_center; 6.8 Hypervisor: KVM 6.8.1 KVM on Ubuntu (KVM only) Additional steps are required for each KVM host. These steps will not affect running guests in the cloud. These steps are required only for clouds using KVM as hosts and only on the KVM hosts. 1.
CloudStack Release Notes Documentation, Release 4.5.1 6.9 Restart management services 1. If upgrading fresh installation of 4.4.0 If you are upgrading fresh installation of CloudStack 4.4.0, the following MySQL command must be executed before restarting the management server. If the system was running pre 4.4 and then upgraded to 4.4.0, the MySQL command is not required. Refer to: CLOUDSTACK-7813 use cloud; ALTER TABLE `snapshot_policy` ADD `display` TINYINT( 1 ) NOT NULL DEFAULT '1'; 2.
CHAPTER 7 Upgrade Instruction from 4.3.x This section will guide you from CloudStack 4.3.x to CloudStack 4.5. Any steps that are hypervisor-specific will be called out with a note. We recommend reading through this section once or twice before beginning your upgrade procedure, and working through it on a test system before working on a production system. Note: The following upgrade instructions should be performed regardless of hypervisor type. Upgrade Steps: 1. Backup CloudStack database (MySQL) 2.
CloudStack Release Notes Documentation, Release 4.5.1 5. In the Register template dialog box, specify the following values (do not change these): 32 Chapter 7. Upgrade Instruction from 4.3.
CloudStack Release Notes Documentation, Release 4.5.1 HyDescription pervisor XenServerName: systemvm-xenserver-4.5 Description: systemvm-xenserver-4.5 URL: http://packages.shapeblue.com/systemvmtemplate/4.5/systemvm64template-4.5-xen.vhd.bz2 Zone: Choose the zone where this hypervisor is used Hypervisor: XenServer Format: VHD OS Type: Debian GNU/Linux 7.
CloudStack Release Notes Documentation, Release 4.5.1 6. Watch the screen to be sure that the template downloads successfully and enters the READY state. Do not proceed until this is successful. 7.3 Database Preparation Backup current database 1. Stop your management server or servers. Run this on all management server hosts: $ sudo service cloudstack-management stop 2. If you are running a usage server or usage servers, stop those as well: $ sudo service cloudstack-usage stop 3.
CloudStack Release Notes Documentation, Release 4.5.1 deb http://packages.shapeblue.com/cloudstack/upstream/debian/4.5/ ./ Setup the public key for the above repository: wget -qO - http://packages.shapeblue.com/release.asc | sudo apt-key add - If you’re using your own package repository, change this line to read as appropriate for your 4.5 repository. 1. Now update your apt package list: $ sudo apt-get update 2.
CloudStack Release Notes Documentation, Release 4.5.1 1. Now that you have the repository configured, it’s time to upgrade the cloudstack-management. $ sudo yum upgrade cloudstack-management 2. If you use CloudStack usage server $ sudo yum upgrade cloudstack-usage 7.6 Hypervisor: XenServer (XenServer only) Copy vhd-utils file on CloudStack management servers. Copy the file vhd-utils to /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver.
CloudStack Release Notes Documentation, Release 4.5.1 update cloud.vmware_data_center set password = '_ciphertext_from_step_1_' where id = _id_from_st 8. Confirm that the table is updated: select * from cloud.vmware_data_center; 7.8 Hypervisor: KVM 7.8.1 KVM on Ubuntu (KVM only) Additional steps are required for each KVM host. These steps will not affect running guests in the cloud. These steps are required only for clouds using KVM as hosts and only on the KVM hosts. 1.
CloudStack Release Notes Documentation, Release 4.5.1 7.9 Restart management services 1. Now it’s time to start the management server $ sudo service cloudstack-management start 2. If you use it, start the usage server $ sudo service cloudstack-usage start 7.10 System-VMs and Virtual-Routers Once you’ve upgraded the packages on your management servers, you’ll need to restart the system VMs. Ensure that the admin port is set to 8096 by using the “integration.api.port” global parameter.
CHAPTER 8 Upgrade Instruction from 4.2.x This section will guide you from CloudStack 4.2.x to CloudStack 4.5. If you run into any issues during upgrades, please feel free to ask questions on users@cloudstack.apache.org or dev@cloudstack.apache.org. Warning: Depreciation of realhostip.com DNS and SSL certificate The realhostip.com dynamic DNS resolution service is being retired this summer. In advance of that, CloudStack 4.3 and later no longer uses realhostip.
CloudStack Release Notes Documentation, Release 4.5.1 8.2 Update System-VM templates 1. While running the existing 4.2.x system, log in to the UI as root administrator. 2. In the left navigation bar, click Templates. 3. In Select view, click Templates. 4. Click Register template. The Register template dialog box is displayed. 5. In the Register template dialog box, specify the following values (do not change these): 40 Chapter 8. Upgrade Instruction from 4.2.
CloudStack Release Notes Documentation, Release 4.5.1 HyDescription pervisor XenServerName: systemvm-xenserver-4.5 Description: systemvm-xenserver-4.5 URL: http://packages.shapeblue.com/systemvmtemplate/4.5/systemvm64template-4.5-xen.vhd.bz2 Zone: Choose the zone where this hypervisor is used Hypervisor: XenServer Format: VHD OS Type: Debian GNU/Linux 7.
CloudStack Release Notes Documentation, Release 4.5.1 6. Watch the screen to be sure that the template downloads successfully and enters the READY state. Do not proceed until this is successful. 8.3 Database Preparation Backup current database 1. Stop your management server or servers. Run this on all management server hosts: $ sudo service cloudstack-management stop 2. If you are running a usage server or usage servers, stop those as well: $ sudo service cloudstack-usage stop 3.
CloudStack Release Notes Documentation, Release 4.5.1 deb http://packages.shapeblue.com/cloudstack/upstream/debian/4.5/ ./ Setup the public key for the above repository: wget -qO - http://packages.shapeblue.com/release.asc | sudo apt-key add - If you’re using your own package repository, change this line to read as appropriate for your 4.5 repository. 1. Now update your apt package list: $ sudo apt-get update 2.
CloudStack Release Notes Documentation, Release 4.5.1 1. Now that you have the repository configured, it’s time to upgrade the cloudstack-management. $ sudo yum upgrade cloudstack-management 2. If you use CloudStack usage server $ sudo yum upgrade cloudstack-usage 8.6 Hypervisor: Xen/XenServer (XenServer only) Copy vhd-utils file on CloudStack management servers. Copy the file vhd-utils to /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver.
CloudStack Release Notes Documentation, Release 4.5.1 update cloud.vmware_data_center set password = '_ciphertext_from_step_1_' where id = _id_from_st 8. Confirm that the table is updated: select * from cloud.vmware_data_center; 8.8 Hypervisor: KVM 8.8.1 KVM on Ubuntu (KVM only) Additional steps are required for each KVM host. These steps will not affect running guests in the cloud. These steps are required only for clouds using KVM as hosts and only on the KVM hosts. 1.
CloudStack Release Notes Documentation, Release 4.5.1 8.9 Restart management services 1. Now it’s time to start the management server $ sudo service cloudstack-management start 2. If you use it, start the usage server $ sudo service cloudstack-usage start 8.10 System-VMs and Virtual-Routers Once you’ve upgraded the packages on your management servers, you’ll need to restart the system VMs. Ensure that the admin port is set to 8096 by using the “integration.api.port” global parameter.
CHAPTER 9 Validate 4.5 source code tarball 1. Perform the following to verify the artifacts: (a) (optional) Install GPG keys if needed: $ sudo apt-get install gpg (b) Import the GPG keys stored in the source distribution’s KEYS file $ gpg --import KEYS Alternatively, download the signing keys, the IDs found in the KEYS file, individually by using a keyserver. For example: $ gpg --recv-keys CC56CEA8 (c) Verify signatures and hash files: $ gpg --verify apache-cloudstack-4.5-src.tar.bz2.
CloudStack Release Notes Documentation, Release 4.5.1 (h) Compare the contents of the release artifact with the contents pulled from the repo: $ diff -r /tmp/cloudstack/apache-cloudstack-4.5-src /tmp/cloudstack/tree Ensure that content is the same. (i) Verify the Code License Headers: $ cd /tmp/cloudstack/apache-cloudstack-4.5-src $ mvn --projects='org.apache.cloudstack:cloudstack' org.apache.rat:apache-rat-plugin:0.
CHAPTER 10 Known Issues in 4.5.1 Apache CloudStack uses Jira to track its issues. All new features and bugs for 4.5.1 have been tracked in Jira, and have a standard naming convention of “CLOUDSTACK-NNNN” where “NNNN” is the issue number. For the list of known issues, see Known Issues in 4.5.1.
CloudStack Release Notes Documentation, Release 4.5.
CloudStack Release Notes Documentation, Release 4.5.
CloudStack Release Notes Documentation, Release 4.5.
CloudStack Release Notes Documentation, Release 4.5.
CloudStack Release Notes Documentation, Release 4.5.
