Transcript
Page 1: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release NotesDocumentation

Release 4.4.0

Apache CloudStack

July 22, 2014

Page 2: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management
Page 3: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

Contents

1 What’s New in 4.4 31.1 Support managed storage for root disks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 Root disk resize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.3 Per primary Storage OverProvisioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.4 VMWare Support for DRS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.5 CloudStack on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.6 Region wide Guest networks and VPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41.7 Virtual Router Service Failure Alerting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51.8 Distributed routing and network ACL with OVS plug-in . . . . . . . . . . . . . . . . . . . . . . . . 51.9 Hyper-V support improvements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2 Issues Fixed in 4.4.0 7

3 Compatibility Matrix 113.1 Supported OS Versions for Management Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.2 Supported Hypervisor Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.3 Supported External Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113.4 Supported Browsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

4 API Changes Introduced in 4.4.0 13

5 General Upgrade Notes 275.1 Depreciation of realhostip.com . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275.2 Settings Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275.3 OVS plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275.4 Active-Directory Authentication (LDAP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

6 Upgrade Instruction from 4.3.x 296.1 Packages repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296.2 Update System-VM templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296.3 Database Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296.4 Management Server on Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306.5 Management Server on CentOS/RHEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316.6 hypervisor: XenServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316.7 hypervisor: VMware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326.8 hypervisor: KVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326.9 Restart management services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336.10 System-VMs and Virtual-Routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

i

Page 4: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

7 Upgrade Instruction from 4.2.x 357.1 Packages repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357.2 Update System-VM templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367.3 Database Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377.4 Management Server Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387.5 Management Server CentOS/RHEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397.6 Hypervisor: Xen/XenServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397.7 Hypervisor: VMware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407.8 Hypervisor: KVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407.9 Restart management services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417.10 System-VMs and Virtual-Routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

8 Upgrade Instruction from 4.1.x 438.1 Packages repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438.2 Update System-VM templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448.3 Database Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458.4 Management Server Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468.5 Management Server on CentOS/RHEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478.6 Hypervisor: Xen/XenServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478.7 Hypervisor: VMware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478.8 Hypervisor: KVM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488.9 Restart management services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498.10 System-VMs and Virtual-Routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

9 Upgrade Instruction from 4.0.x 519.1 Packages repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519.2 Update System-VM templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519.3 Database Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539.4 Ubuntu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539.5 CentOS/RHEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559.6 Hypervisor: XenServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559.7 System-VMs and Virtual-Routers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

10 Upgrade Instruction from 3.0.x 5710.1 Packages repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5710.2 Update System-VM templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5710.3 Upgrade Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

11 Upgrade Instruction from 2.2.14 6711.1 Update System-VM templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6811.2 Upgrade Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

12 Validate 4.4 source code tarball 79

13 Known Issues in 4.4.0 81

ii

Page 5: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Warning: We are in the process of changing documentation format as well as hosting mechanism. Please bepatient with us as we migrate our entire documentation to this new setup.

This document contains information specific to this release of CloudStack, including upgrade instructions from priorreleases, 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 CloudStackAdministrator’s Guide.

Contents:

Contents 1

Page 6: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

2 Contents

Page 7: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 1

What’s New in 4.4

CloudStack 4.4 includes the following new features and improvements.

• Support managed storage for root disks• Root disk resize• Per primary Storage OverProvisioning• VMWare Support for DRS• CloudStack on Windows• Region wide Guest networks and VPC• Virtual Router Service Failure Alerting• Distributed routing and network ACL with OVS plug-in• Hyper-V support improvements

– Zone Wide Primary Store in Hyper-V– VPC support on Hyper-V– Storage Live-Migration support for Hyper-V

1.1 Support managed storage for root disks

Use of Primary Storage Plug-in for Root disks. See Configuring a Storage Plug-in

Supported hypervisors: XenServer, VMware

1.2 Root disk resize

Allow Root disk resize which remove need to have multiple templates of the same Operating System fordifferent disk size.

Supported hypervisor: KVMLink Root resize Functional spec

1.3 Per primary Storage OverProvisioning

Added per Primary Storage storage.overprovisioning.factor setting to overseed the GlobalSettings value.

3

Page 8: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

• admin can update an existing primary store by setting storage.overprovisioning.factorin the per primary setting.

• This value will override the value at the global level. This leverages the granularity of global param-eters introduced in 4.2

• To fall back to the global value, null value can be passed.

• To disable overprovision a value of 1 will be passed.

Supported hypervisor: KVMlink Storage Over Prov. Functional spec

1.4 VMWare Support for DRS

VMware DRS(Distributed Resource Scheduler), VM HA(High Availability): Provide highly availableresources to your workloads. Balance workloads for optimal performance. Scale and manage computingresources without service disruption.

• Load Balancing: distribution and usage of CPU and memory resources for all hosts and VMs in thecluster are continuously monitored and compared to ideal resource utilization given the attributes ofthe cluster’s resource pools and VMs, the current demand, and the imbalance target. It then performs(or recommends) virtual machine migrations accordingly. Also, when a VM is powered on in thecluster, DRS attempts to maintain proper load balancing by either placing the VM on an appropriatehost or making a recommendation.

• Power Management: When the vSphere Distributed Power Management (DPM) feature is enabled,DRS compares cluster- and host-level capacity to the demands of the cluster’s VMs, including recenthistorical demand. It places (or recommends placing) hosts in standby power mode if sufficientexcess capacity is found or powering on hosts if capacity is needed. Depending on the resulting hostpower state recommendations, VMs might need to be migrated to and from the hosts as well.

• Affinity Rules: control the placement of virtual machines on hosts within a cluster, by assigningaffinity rules

Supported hypervisors: VMwareLink DRS functional spec

1.5 CloudStack on Windows

Windowsfication of CloudStack Management Server, remove dependency on cygwin in order to runCloudStack Management Server on Windows based Operating System.

Supported hypervisors: N/ALink CLOUDSTACK-6105

1.6 Region wide Guest networks and VPC

Region level Guest networks and VPC deployment. Allowing VPC tiers and guest networks accessibilityacross zones.

Supported hypervisors: N/ALink VPC region functional spec

4 Chapter 1. What’s New in 4.4

Page 9: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

1.7 Virtual Router Service Failure Alerting

Send failure alerts to management server to notify admins using Monitoring VR services introduced inCloudStack 4.3.

Supported hypervisors: xenserver, kvm, vmwareLink VR failure alerting functional spec

1.8 Distributed routing and network ACL with OVS plug-in

Support distributed routing and network ACL with OVS plug-in.

Supported hypervisors: xenserver, kvm, vmwareLink CLOUDSTACK-6161

1.9 Hyper-V support improvements

1.9.1 Zone Wide Primary Store in Hyper-V

SMB share as zone wide primary storage.

Supported hypervisors: Hyper-VLink Hyper-V zone wide storage functional spec

1.9.2 VPC support on Hyper-V

Provide VPC capability on Hyper-V hypervisor.

Supported hypervisors: Hyper-VLink VPC support on Hyper-V functional spec

1.9.3 Storage Live-Migration support for Hyper-V

Hyper-V 2012 R2 allows migration of volumes (virtual disks) of a virtual machine from one storage toanother, while the virtual machine continues to run. It also allows live migration of a virtual machine andits volumes to another host and storage without any downtime.

The intend of this feature is to enable support of live migration of a virtual machines with its volumesacross hosts and storage pools. It’ll also migration of volumes across storage pools while the volumestays attached to a running virtual machine.

Supported hypervisors: Hyper-VLink Hyper-V storage motion functional spec

1.7. Virtual Router Service Failure Alerting 5

Page 10: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

6 Chapter 1. What’s New in 4.4

Page 11: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 2

Issues Fixed in 4.4.0

Apache CloudStack uses Jira to track its issues. All new features and bugs for 4.4.0 have been tracked in Jira, andhave a standard naming convention of “CLOUDSTACK-NNNN” where “NNNN” is the issue number.

For the list of issues fixed, see Issues Fixed in 4.4.0.

Bug ID DescriptionCLOUDSTACK-6997 conntrack set to a very low value on router...CLOUDSTACK-6996 Adding cluster to legacy zone failed...CLOUDSTACK-6989 Redunant virtual router(RvR): When time synced by ntpd, RvR may result in FAULT ...CLOUDSTACK-6941 Can’t choose storage for the volume, when attaching uploaded data volume to VM...CLOUDSTACK-6925 [OVS] get rid custom logic to create bridges on hosts in the XenServer pool...CLOUDSTACK-6908 ipv6 enabled by default...CLOUDSTACK-6899 listNics doesn’t have vm id in response but does take vm id as a param...CLOUDSTACK-6869 Public key content is overridden by template’s meta data when you create a insta...CLOUDSTACK-6859 Management Server PermGen run out of memory after some time due to class leak....CLOUDSTACK-6850 Cpu cores, cpu speed and memory are not returned by listUsageRecords...CLOUDSTACK-6816 cloudstack-setup-management make /root directory’s permission 0777 improperly...CLOUDSTACK-6756 usage id is not being returned for an ip in deleted ip range...CLOUDSTACK-6743 Race condition situation in MessageDetector may cause a outer tight loop to spin...CLOUDSTACK-6714 Service monitoring conf is has issue with script in vmware...CLOUDSTACK-6665 DHCP does not release ip addresses properly on VPC routers (edithosts.sh)...CLOUDSTACK-6646 Conntrackd is started on non-redundant virtual router...CLOUDSTACK-6578 DeleteRemoteAccessVpnCmd failed block enable Remote VPN access again on the IP a...CLOUDSTACK-6577 Disable service monitoring in RVR...CLOUDSTACK-6509 Cannot import multiple LDAP/AD users into a cloudstack account...CLOUDSTACK-6478 Failed to download Template when having 3 SSVM’s in one zone on Vmware...CLOUDSTACK-6472 listUsageRecords generates NPEs for expunging instances...CLOUDSTACK-6471 Add logs to better diagnose failures and errors in LDAP AD integration...CLOUDSTACK-6396 KVM RBD Volumes shown as OVM, prevents snapshots...CLOUDSTACK-6376 listnetworkacls api when called with a networkid of a network which was created ...CLOUDSTACK-6374 LB rules added while router reqiuires upgrade should be removed from lb vm map...CLOUDSTACK-6371 KVM - secondary_storage count for account does not get incremted when snapshots ...CLOUDSTACK-6358 Remove hardcoded guest OS mappings...CLOUDSTACK-6356 OVS: tunnel networks does not work across the XenServer clusers...CLOUDSTACK-6328 Prevent console proxy support scripts from spawning multiple java processes...CLOUDSTACK-6322 Contrail: Params validation is missing while launching a service instance thru c...CLOUDSTACK-6319 Cannot create OVS network offering for VPC...CLOUDSTACK-6317 [VMware] Tagged VLAN support broken for Management/Control/Storage traffic...CLOUDSTACK-6299 GetVMPassword decypher instructions are wrong...

Continued on next page

7

Page 12: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 2.1 – continued from previous pageBug ID DescriptionCLOUDSTACK-6289 [Hyper-V] Storage migration failing in case of hyper-v if there are multiple dis...CLOUDSTACK-6288 [Hyper-v] Change default ImageFormat to vhdx for hyper-v and allow registration ...CLOUDSTACK-6285 Some passwords in the VR would be cleared out by accident due to falsely match i...CLOUDSTACK-6277 Fail to add instance, the Network and Review steps display as blank pages....CLOUDSTACK-6269 [Simulator]: Exception “Unable to send command. Upgrade in progress. Please cont...CLOUDSTACK-6245 Security group rules on hypervisor host are lagging behind rules in DB...CLOUDSTACK-6241 Dnsmasq programming error when deploy IPv6 and IPv4 in one VM with IPv4 as defau...CLOUDSTACK-6236 Negative ref_cnt of template(snapshot/volume)_store_ref results in out-of-range ...CLOUDSTACK-6232 isolated network can no longer reserve ip range...CLOUDSTACK-6231 Cloudstack createNetworkACL cuts cidrlist at 256 characters...CLOUDSTACK-6227 Add copy-paste support for detail view fields...CLOUDSTACK-6224 VM Snapshot inconsistent size...CLOUDSTACK-6223 removeNicFromVirtualMachine fails if another instance in another domain has a ni...CLOUDSTACK-6211 Xenserver - HA - SSVM fails to start due to running out of management Ip ranges ...CLOUDSTACK-6210 LDAP:listLdapUsers api throws exception when we click on “Add LDAP Account” ...CLOUDSTACK-6196 Fixed invalid field name (label.dynamically.scalable) on instance details....CLOUDSTACK-6192 KVM: StartCommand and PrepareForMigrationCommand don’t fail if storage adaptor f...CLOUDSTACK-6187 Migrate router from UI is showing error...CLOUDSTACK-6183 Unplug the nic when all the ips of public subnet is released...CLOUDSTACK-6172 Volume is not retaining same uuid when migrating from one storage to another....CLOUDSTACK-6159 [Hyper-v]Attached data volumes are getting created with disk name in primary sto...CLOUDSTACK-6151 Local data disk with tag goes to the wrong local storage pool...CLOUDSTACK-6124 During MS maintenance unfinished work items are not cleaned up resulting in them...CLOUDSTACK-6103 vms with isos attached don’t migrate...CLOUDSTACK-6062 nic device ids for routers don’t always correspond...CLOUDSTACK-6053 While adding smb as primary or secondary the password should be uri encoded...CLOUDSTACK-6032 [VmScaleup]service offering id is not getting changed in usage_vm_instance table...CLOUDSTACK-6024 template copy to primary storage uses a random source secstorage from any zone...CLOUDSTACK-6011 NPE when detach is called on a deleted volume...CLOUDSTACK-6000 Volume lifecycle, stuck in expunging...CLOUDSTACK-5998 [AWSAPI] describe addresses call returns a fault with “domain cannot be null!!”...CLOUDSTACK-5995 change service offering is not honouring host tags ...CLOUDSTACK-5993 Cloud agent fails to start on 32-bit system vms (cpvm and ssvm) created with 4GB...CLOUDSTACK-5989 Trying to start a vm while ‘vm snapshot’ is in progress results in inconsistency...CLOUDSTACK-5976 [upgrade]Typo in “ssh_keypairs” table’s foreign key constraints on the Upgraded ...CLOUDSTACK-5965 VM displayname is not returned by API...CLOUDSTACK-5962 Value of Global parameter “custom.diskoffering.size.min” is not reflected in UI ...CLOUDSTACK-5961 CLONE - API: synchronization on the object is broken...CLOUDSTACK-5960 Domain admin or user cannot register a template using S3/Swift object store...CLOUDSTACK-5936 Hyper-V agent should log to windows event viewer...CLOUDSTACK-5935 Problem with VMware snapshot when datastore has a space in its name...CLOUDSTACK-5934 Problem with VMware snapshot when datastore has a space in its name...CLOUDSTACK-5929 [VM Sync] - Vmware - Even when starting Vm fails, startVirtualMachine async job ...CLOUDSTACK-5928 [VM Sync] - Vmware - When a Vm is “suspended” from outside of CloudStack , this ...CLOUDSTACK-5915 [AWSAPI] Instance launch is inconsistent if there are deleted service offerings...CLOUDSTACK-5891 [VMware] Template detail cpu.corespersocket’s value is not honoured...CLOUDSTACK-5870 API support for retrieving UserData...CLOUDSTACK-5865 Unable to use login API if domainId parameter is id and not uuid...CLOUDSTACK-5845 [doc] Document Heterogeneous Secondary Storage Not Supported in Region...CLOUDSTACK-5839 listNetworkServiceProviders API doesn’t return several parameters defined in the...CLOUDSTACK-5826 createPod: passing invalid gateway/netmask to the call causes infinite loop exec...

Continued on next page

8 Chapter 2. Issues Fixed in 4.4.0

Page 13: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 2.1 – continued from previous pageBug ID DescriptionCLOUDSTACK-5821 systemvmiso is locked by systevmvm in hyperv...CLOUDSTACK-5812 Secondary ip allocation in Basic zone - the pod is not respected...CLOUDSTACK-5810 addIpToNic: the owner of the secondary ip should be derived from vmInstance obje...CLOUDSTACK-5806 Storage types other than NFS/VMFS can’t overprovision...CLOUDSTACK-5785 VM display name cell not updated upon detaching volume from VM...CLOUDSTACK-5770 [Automation] Unexpected Exception while executing DeployVMCmd: StreamCorruptedEx...CLOUDSTACK-5765 [Automation] scale vm failed with error “Unable to serialize”...CLOUDSTACK-5731 [Automation] VM deployment failed with ConcurrentOperationException in vmware...CLOUDSTACK-5729 [Automation]Deletion of a Account reported Success inspite of VM Expunge Failure...CLOUDSTACK-5728 [Automation] ReplaceNetworkACLListCmd command failing with NPE...CLOUDSTACK-5727 [Automation] Inspite of VM Deployment Failure, the job reports success...CLOUDSTACK-5712 [Automation] Failed to stop vm during vm destroy command, observed the error “Un...CLOUDSTACK-5696 [Vmsync]- Stopped state of VM is not synced to CS when VM is stopped outside of ...CLOUDSTACK-5688 NPE when the KVM host is rebooted on the upgraded environment...CLOUDSTACK-5685 [Vmsync] - When VR is rebooted outside of cloudstack , there is no change in sta...CLOUDSTACK-5678 Cold Storage migration is failing...CLOUDSTACK-5660 Migrate vm live migration succeeds but throws error as “”Failed to migrate the s...CLOUDSTACK-5632 [Automation] XenServer - Template deletion fails with error “Please specify a te...CLOUDSTACK-5597 attachVolume shouldn’t create the volume on the primary storage if the vm’s root...CLOUDSTACK-5582 kvm - HA is not triggered when host is powered down since the host gets into “Di...CLOUDSTACK-5577 Remote Access VPN and S2S VPN should be treated as two seperate services for Net...CLOUDSTACK-5575 Remote Access VPN and S2S VPN should be treated as two seperate services on VPC...CLOUDSTACK-5563 path field is set to null in volumes table ...CLOUDSTACK-5505 [Automation] Private gateway not getting programmed in VPC router ...CLOUDSTACK-5501 Unable to create more than one vpnConnection per vpn customer gateway...CLOUDSTACK-5496 Account included in ActionEvents is Project Account ID...CLOUDSTACK-5463 Hyper-V does not report stopped VMs...CLOUDSTACK-5429 KVM - Primary store down/Network Failure - Hosts attempt to reboot becasue of pr...CLOUDSTACK-5419 missing parameters in configuration table and to remove unused parameters...CLOUDSTACK-5356 Xenserver - Failed to create snapshot when secondary store was made unavaibale f...CLOUDSTACK-5262 Few of the snapshot creation from ROOT volume fails when there are concurrent s...CLOUDSTACK-5220 NullPointerException when invalid zone is passed into UsageEventUtils...CLOUDSTACK-5205 System vm startup scripts calculate jvm memory wrong...CLOUDSTACK-5150 Creating template from a VM in Simulator results in incorrect size...CLOUDSTACK-5062 Deleting Load Balancing Rule fails when generating usage events are enabled...CLOUDSTACK-5043 [DOC] Page number missing and words truncated in PDFs since 4.1.1...CLOUDSTACK-5012 Bad data inserted into physical network labels for Zone Create Wizard using VMWa...CLOUDSTACK-4744 updateVolume needs more changes in the context of “Ability to have better contro...CLOUDSTACK-4652 ceph:UI:Noticed 2 records for same volume after migrating instance from one prim...CLOUDSTACK-4639 status of VM is not synced properly when host is HA during hypervisor failure...CLOUDSTACK-4578 [vmware]SSVM is not getting created if one host down from a cluster...CLOUDSTACK-4568 Need to add this to the release note of 4.2...CLOUDSTACK-4557 ceph:Performance:first time operstions taking more time...CLOUDSTACK-4549 ceph:deployvm from template created from snapshot is failing...CLOUDSTACK-4292 ceph:destroyedvm failed with ArrayIndexexception while expunging...CLOUDSTACK-4126 EN: Typo error after click “Migrate instance to another host” button under inst...CLOUDSTACK-3994 Wrong error notification is generated when Primary storage (Cluster wide) is add...CLOUDSTACK-2932 Allow deleting of snapshots that have errored out....CLOUDSTACK-2714 Setting tab should not be visible for user accounts ...CLOUDSTACK-2697 cluster id in alert message is null {alertType:: 1 // dataCenterId:: 1 // podId:...CLOUDSTACK-2031 [mipn] support for number of ips per nic limit needs to be added for the multipl...

9

Page 14: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

10 Chapter 2. Issues Fixed in 4.4.0

Page 15: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 3

Compatibility Matrix

3.1 Supported OS Versions for Management Server

This section describes the operating systems, browsers, and hypervisors that have been newly tested and certifiedcompatible with CloudStack 4.4.0. Most earlier OS and hypervisor versions are also still supported for use with 4.4.0.It might work well on other platforms, but the platforms listed below are the ones that are specifically tested againstand are more likely to be able to help troubleshoot if you run into any issues.

Note: That specific versions of the operating systems are tested, so compatibility with CentOS 6.3 may not indicatecompatibility with CentOS 6.2, 6.1 and so on.

• CentOS versions 6.5 (32 and 64 bit)

• FreeBSD 10 (32 and 64 bit)

• Microsoft Winows 8.1 (32 and 64 bit)

• Windows XP SP3 (32 and 64 bit)

3.2 Supported Hypervisor Versions

No new supported hypervisors in 4.4.0.

For more information, see the Hypervisor Compatibility Matrix in the CloudStack Installation Guide.

3.3 Supported External Devices

No new supported External Devices in 4.4.0.

For more information, see the CloudStack Installation Guide.

3.4 Supported Browsers

The CloudStack Web-based UI should be compatible with any modern browser, but it’s possible that some browserswill not render portions of the UI reliably, depending on their support of Web standards. For best results, one of thefollowing browsers recommended:

11

Page 16: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

• Internet Explorer versions 10 and 11

• Firefox version 26 or lower

• Google Chrome version 31

• Safari 5

12 Chapter 3. Compatibility Matrix

Page 17: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 4

API Changes Introduced in 4.4.0

API DescriptionlistNetworkACLs Request:

New parameters: fordisplay (optional)Response:

New parameters: fordisplay

reconnectHost Response:New parameters: gpugroup(*)

listNiciraNvpDeviceNetworks Response:New parameters: strechedl2subnet, zones-networkspans

addNicToVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

listNetworkOfferings Response:New parameters: supportsstrechedl2subnet

createVpnConnection Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

listVolumes Request:New parameters: diskofferingid (optional),displayvolume (optional)

Response:New parameters: chaininfo, isodisplaytext,isoid, isoname,templatedisplaytext, templateid, template-name

Continued on next page

13

Page 18: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptionlistLoadBalancers Request:

New parameters: fordisplay (optional)Response:

New parameters: fordisplay

importLdapUsers Request:New parameters: account (optional)

listLoadBalancerRuleInstances Request:New parameters: lbvmips (optional)

Response:New parameters: lbvmipaddresses, load-balancerruleinstance

Removed parameters: id, account, cpunumber, cpus-peed, cpuused,created, details, diskioread,diskiowrite,diskkbsread, diskkbswrite,displayname, displayvm, domain, domainid,forvirtualnetwork, group,groupid,guestosid, haenable, hostid, hostname,hypervisor,instancename, isdynamicallyscalable, isodisplay-text, isoid,isoname,keypair, memory, name, networkkbsread, net-workkbswrite, password,passwordenabled, project,projectid, publicip,publicipid,rootdeviceid, rootdevicetype, serviceofferingid,serviceofferingname,servicestate, state, templatedisplaytext, tem-plateid, templatename,zoneid, zonename, affinitygroup(*),nic(*), secu-ritygroup(*),tags(*), jobid, jobstatus

migrateVolume Response:New parameters: chaininfo, isodisplaytext,isoid, isoname,templatedisplaytext, templateid, template-name

listAutoScaleVmGroups Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

createNetwork Response:New parameters: strechedl2subnet, zones-networkspans

Continued on next page

14 Chapter 4. API Changes Introduced in 4.4.0

Page 19: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptionenableAccount Response:

New parameters: groups

listPublicIpAddresses Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

enableStorageMaintenance Response:New parameters: overprovisionfactor

listVpnGateways Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

attachVolume Response:New parameters: chaininfo, isodisplaytext,isoid, isoname,templatedisplaytext, templateid, template-name

updateVPCOffering Response:New parameters: distributedvpcrouter, sup-portsregionLevelvpc

resetSSHKeyForVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

updateVolume Request:New parameters: chaininfo (optional), cus-tomid (optional)

Response:New parameters: chaininfo, isodisplaytext,isoid, isoname,templatedisplaytext, templateid, template-name

listNetworks Request:New parameters: displaynetwork (optional)

Response:New parameters: strechedl2subnet, zones-networkspans

createAutoScaleVmProfile Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

Continued on next page

15

Page 20: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptioncancelHostMaintenance Response:

New parameters: gpugroup(*)

updateServiceOffering Response:New parameters: hypervisorsnapshotre-serve, iscustomizediops, maxiops, miniops

updateStoragePool Response:New parameters: overprovisionfactor

addBaremetalHost Response:New parameters: gpugroup(*)

resizeVolume Request:Changed parameters: id (old version - op-tional, new version - required)

Response:New parameters: chaininfo, isodisplaytext,isoid, isoname, templatedisplaytext,templateid, templatename

createIpForwardingRule Response:New parameters: fordisplay

updateDiskOffering Response:New parameters: cacheMode, hypervi-sorsnapshotreserve

listNetworkACLLists Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

recoverVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

listCapabilities Response:New parameters: customdiskofferingmin-size

updateVPC Request:New parameters: customid (optional),fordisplay (optional)

Changed parameters: name (old version - required, newversion - optional)Response:

New parameters: distributedvpcrouter,fordisplay, regionlevelvpc

Continued on next page

16 Chapter 4. API Changes Introduced in 4.4.0

Page 21: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptionupdateAutoScaleVmProfile Request:

New parameters: customid (optional),fordisplay (optional)

Response:New parameters: fordisplay

updatePortForwardingRule Request:New parameters: id (required), customid(optional), fordisplay (optional)

Changed parameters: privateport (old version - required,new version -

optional), protocol (old version -required,new version - optional),ipaddressid (old version - required, newversion - optional), publicportold version - required, new version - op-tional)

Response:New parameters: fordisplay

listPortForwardingRules Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

createLoadBalancer Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

cancelStorageMaintenance Response:New parameters: overprovisionfactor

deployVirtualMachine Request:New parameters: customid (optional), de-ploymentplanner (optional),rootdisksize (optional)

Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

createNetworkACLList Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

createPortForwardingRule Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

Continued on next page

17

Page 22: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptioncreateVPCOffering Request:

New parameters: servicecapabilitylist (op-tional)

Response:New parameters: distributedvpcrouter, sup-portsregionLevelvpc

createEgressFirewallRule Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

listUsageRecords Response:New parameters: cpunumber, cpuspeed,memory

updateNetworkACLItem Request:New parameters: customid (optional),fordisplay (optional)

Response:New parameters: fordisplay

updateAccount Response:New parameters: groups

listLBHealthCheckPolicies Request:New parameters: fordisplay (optional)

addHost Response:New parameters: gpugroup(*)

createAutoScaleVmGroup Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

createLBHealthCheckPolicy Request:New parameters: fordisplay (optional)

updateHost Response:New parameters: gpugroup(*)

lockAccount Response:New parameters: groups

listDiskOfferings Response:New parameters: cacheMode, hypervi-sorsnapshotreserve

Continued on next page

18 Chapter 4. API Changes Introduced in 4.4.0

Page 23: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptiondetachVolume Response:

New parameters: chaininfo, isodisplaytext,isoid, isoname,templatedisplaytext, templateid, template-name

updateLoadBalancerRule Request:New parameters: customid (optional),fordisplay (optional)

Response:New parameters: fordisplay

createVpnGateway Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

listF5LoadBalancerNetworks Response:New parameters: strechedl2subnet, zones-networkspans

ldapCreateAccount Response:New parameters: groups

listRemoteAccessVpns Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

disableAutoScaleVmGroup Response:New parameters: fordisplay

createAccount Response:New parameters: groups

prepareHostForMaintenance Response:New parameters: gpugroup(*)

attachIso Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

getUser Request:New parameters: apikey (required)

Removed parameters: userapikeylistLoadBalancerRules Request:

New parameters: fordisplay (optional)Response:

New parameters: fordisplay

Continued on next page

19

Page 24: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptionenableAutoScaleVmGroup Response:

New parameters: fordisplay

listResourceDetails Request:Changed parameters: resourceid (old ver-sion - required, new version - optional)

listPaloAltoFirewallNetworks Response:New parameters: strechedl2subnet, zones-networkspans

restartNetwork Response:New parameters: fordisplay

rebootVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

listLBStickinessPolicies Request:New parameters: fordisplay (optional)

listFirewallRules Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

updateVMAffinityGroup Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

listNics Request:New parameters: fordisplay (optional), net-workid (optional)

Response:New parameters: deviceid, virtualma-chineid

createStoragePool Response:New parameters: overprovisionfactor

listSrxFirewallNetworks Response:New parameters: strechedl2subnet, zones-networkspans

Continued on next page

20 Chapter 4. API Changes Introduced in 4.4.0

Page 25: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptioncreateServiceOffering Request:

New parameters: customizediops (op-tional), hypervisorsnapshotreserve(optional), maxiops (optional), miniops op-tional)

Response:New parameters: hypervisorsnapshotre-serve, iscustomizediops, maxiops, miniops

removeNicFromVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

updateDefaultNicForVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

createNetworkACL Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

createVPC Request:New parameters: fordisplay (optional)

Response:New parameters: distributedvpcrouter,fordisplay, regionlevelvpc

listOsTypes Response:New parameters: isuserdefined

addResourceDetail Request:New parameters: fordisplay (optional)

listExternalLoadBalancers Response:New parameters: gpugroup(*)

resetPasswordForVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

createVolume Request:New parameters: customid (optional)

Response:New parameters: chaininfo, isodisplaytext,isoid, isoname,templatedisplaytext, templateid, template-name

Continued on next page

21

Page 26: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptionassignToLoadBalancerRule Request:

New parameters: vmidipmap (optional)Changed parameters: virtualmachineids (old version -required,

new version - optional)

changeServiceForVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

listStoragePools Response:New parameters: overprovisionfactor

resetVpnConnection Response:New parameters: fordisplay

startVirtualMachine Request:New parameters: deploymentplanner (op-tional)

Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

createRemoteAccessVpn Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

detachIso Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

associateIpAddress Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

disableAccount Response:New parameters: groups

migrateVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

removeFromLoadBalancerRule Request:New parameters: vmidipmap (optional)

Changed parameters: virtualmachineids (old version -required,

new version - optional)

Continued on next page

22 Chapter 4. API Changes Introduced in 4.4.0

Page 27: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptionlistVPCs Request:

New parameters: fordisplay (optional)Response:

New parameters: distributedvpcrouter,fordisplay, regionlevelvpc

assignVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

updateVirtualMachine Request:New parameters: customid (optional),name (optional)

Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

listServiceOfferings Response:New parameters: hypervisorsnapshotre-serve, iscustomizediops,maxiops, miniops

createLoadBalancerRule Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

restoreVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

createNetworkOffering Response:New parameters: supportsstrechedl2subnet

uploadVolume Response:New parameters: chaininfo, isodisplaytext,isoid, isoname, templatedisplaytext,templateid, templatename

listAutoScaleVmProfiles Request:New parameters: fordisplay (optional), ser-viceofferingid (optional),zoneid (optional)

Response:New parameters: fordisplay

createLBStickinessPolicy Request:New parameters: fordisplay (optional)

Continued on next page

23

Page 28: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptionmigrateVirtualMachineWithVolume Response:

New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

stopVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

listAccounts Response:New parameters: groups

listIpForwardingRules Response:New parameters: fordisplay

destroyVirtualMachine Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

updateNetwork Request:New parameters: customid (optional)

Response:New parameters: strechedl2subnet, zones-networkspans

createDiskOffering Response:New parameters: cacheMode, hypervi-sorsnapshotreserve

listNetscalerLoadBalancerNetworks Response:New parameters: strechedl2subnet, zones-networkspans

createFirewallRule Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

revertToVMSnapshot Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

markDefaultZoneForAccount Response:New parameters: groups

listVirtualMachines Request:New parameters: displayvm (optional), ids(optional), serviceofferingid (optional)

Response:New parameters: diskofferingid, diskoffer-ingname, ostypeid, vgpu

Continued on next page

24 Chapter 4. API Changes Introduced in 4.4.0

Page 29: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 4.1 – continued from previous pageAPI DescriptionrestartVPC Response:

New parameters: distributedvpcrouter,fordisplay, regionlevelvpc

listEgressFirewallRules Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

updateAutoScaleVmGroup Request:New parameters: customid (optional),fordisplay (optional)

Response:New parameters: fordisplay

listHosts Response:New parameters: gpugroup(*)

listVpnConnections Request:New parameters: fordisplay (optional)

Response:New parameters: fordisplay

listVPCOfferings Response:New parameters: distributedvpcrouter, sup-portsregionLevelvpc

updateNetworkOffering Response:New parameters: supportsstrechedl2subnet

findStoragePoolsForMigration Response:New parameters: overprovisionfactor

25

Page 30: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

26 Chapter 4. API Changes Introduced in 4.4.0

Page 31: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 5

General Upgrade Notes

5.1 Depreciation of realhostip.com

The realhostip.com dynamic DNS resolution service is being retired on September 30th, 2014. In advance of that,CloudStack 4.4 and later no longer uses realhostip.com DNS domains or SSL certificates to encrypt Console Proxy orfile copy communications.

For latest update about realhostip.com follow Apache CloudStack Blog.

5.2 Settings Changes

After upgrading to 4.2 and later, Settings mem.overporvisioning.factor andcpu.overporvisioning.factor are now at the cluster level and be set to 1 which is the default.

If Global Settings mem.overporvisioning.factor and cpu.overporvisioning.factor have beenchanged prior the upgrade to 4.2 and later, the upgrade process will be reset them to 1. Values can be changed byediting clusters settings.

All clusters created after the upgrade will get created with the Global Settings values formem.overporvisioning.factor and cpu.overporvisioning.factor.

5.3 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 unplugOvs-Vswitchd is crashing resulting in loosing all the openflow rules added to the bridge. Ovs daemon gets started andcreates a bridge but configure openflow rules are lost resulting in the disruption of connectivity for the VM’s on thehost.

5.4 Active-Directory Authentication (LDAP)

If using Active-Directory (LDAP/LDAPs) as user authentication; Upgrading to 4.3 and later require changes in GlobalSettings. After upgrading CloudStack to 4.3 or latest, following Global Settings must be change:

27

Page 32: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Global Settings Default Newldap.user.object inetOrgPerson userldap.username.attribute uid sAMAccountName

28 Chapter 5. General Upgrade Notes

Page 33: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 6

Upgrade Instruction from 4.3.x

This section will guide you from CloudStack 4.3.x to CloudStack 4.4.

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 workingthrough 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. Upgrade CloudStack management server(s)

3. Update hypervisors specific dependencies

6.1 Packages repository

Most users of CloudStack manage the installation and upgrades of CloudStack with one of Linux’s predominantpackage systems, RPM or APT. This guide assumes you’ll be using RPM and Yum (for Red Hat Enterprise Linux orCentOS), or APT and Debian packages (for Ubuntu).

Create RPM or Debian packages (as appropriate) and a repository from the 4.4 source, or check the Apache Cloud-Stack downloads page at http://cloudstack.apache.org/downloads.html for package repositories supplied by commu-nity members. You will need them for Management Server on Ubuntu or Management Server on CentOS/RHEL andhypervisor: KVM hosts upgrade.

Instructions for creating packages from the CloudStack source are in the CloudStack Installation Guide.

6.2 Update System-VM templates

This Upgrade path from version 4.3.x to 4.4.0 does not require systemvm-templates upgrade.

6.3 Database Preparation

Backup current database

29

Page 34: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

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. Make a backup of your MySQL database. If you run into any issues or need to roll back the upgrade, this willassist in debugging or restoring your existing environment. You’ll be prompted for your password.

$ mysqldump -u root -p cloud > cloudstack-backup.sql$ mysqldump -u root -p cloud_usage > cloud_usage-backup.sql

4. (KVM Only) If primary storage of type local storage is in use, the path for this storage needs to be verified toensure it passes new validation. Check local storage by querying the cloud.storage_pool table:

$ mysql -u cloud -p -e "select id,name,path from cloud.storage_pool where pool_type=’Filesystem’"

If local storage paths are found to have a trailing forward slash, remove it:

$ mysql -u cloud -p -e ’update cloud.storage_pool set path="/var/lib/libvirt/images" where path="/var/lib/libvirt/images/"’;

6.4 Management Server on Ubuntu

If you are using Ubuntu, follow this procedure to upgrade your packages. If not, skip to step Management Server onCentOS/RHEL.

Note: Community Packages: This section assumes you’re using the community supplied packages for CloudStack.If you’ve created your own packages and APT repository, substitute your own URL for the ones used in these examples.

The first order of business will be to change the sources list for each system with CloudStack packages. This meansall management servers, and any hosts that have the KVM agent. (No changes should be necessary for hosts that arerunning VMware or Xen.)

6.4.1 CloudStack apt repository

Start by opening /etc/apt/sources.list.d/cloudstack.list on any systems that haveCloudStack packages installed.

This file should have one line, which contains:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.3

We’ll change it to point to the new package repository:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.4

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

1. Now update your apt package list:

$ sudo apt-get update

2. Now that you have the repository configured, it’s time to upgrade the cloudstack-management package.

30 Chapter 6. Upgrade Instruction from 4.3.x

Page 35: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

$ sudo apt-get upgrade cloudstack-management

3. If you use CloudStack usage server

$ sudo apt-get upgrade cloudstack-usage

6.5 Management Server on CentOS/RHEL

If you are using CentOS or RHEL, follow this procedure to upgrade your packages. If not, skip to hypervisors section,then System-VMs and Virtual-Routers.

Note: Community Packages: This section assumes you’re using the community supplied packages for CloudStack.If you’ve created your own packages and yum repository, substitute your own URL for the ones used in these examples.

6.5.1 CloustStack RPM repository

The first order of business will be to change the yum repository for each system with CloudStack packages.This means all management servers, and any hosts that have the KVM agent.

(No changes should be necessary for hosts that are running VMware or Xen.)

Start by opening /etc/yum.repos.d/cloudstack.repo on any systems that have CloudStackpackages installed.

This file should have content similar to the following:

[apache-cloudstack]name=Apache CloudStackbaseurl=http://cloudstack.apt-get.eu/rhel/4.3/enabled=1gpgcheck=0

If you are using the community provided package repository, change the base url tohttp://cloudstack.apt-get.eu/rhel/4.4/

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

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.

wget -P /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver \http://download.cloud.com.s3.amazonaws.com/tools/vhd-util

6.5. Management Server on CentOS/RHEL 31

Page 36: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

6.7 hypervisor: VMware

Warning: For VMware hypervisor CloudStack management server packages must be build using“noredist”. Refer to Building from Source.

(VMware only) Additional steps are required for each VMware cluster. These steps will not affect run-ning guests in the cloud. These steps are required only for clouds using VMware clusters:

1. Stop the Management Server:

$ sudo service cloudstack-management stop

2. Generate the encrypted equivalent of your vCenter password:

$ java -classpath /usr/share/cloudstack-common/lib/jasypt-1.9.0.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI encrypt.sh input="_your_vCenter_password_" password="‘cat /etc/cloudstack/management/key‘" verbose=false

Store the output from this step, we need to add this in cluster_details table and vmware_data_center tables inplace of the plain text password

3. Find the ID of the row of cluster_details table that you have to update:

$ mysql -u <username> -p<password>

select * from cloud.cluster_details;

4. Update the plain text password with the encrypted one

update cloud.cluster_details set value = ’_ciphertext_from_step_1_’ where id = _id_from_step_2_;

5. Confirm that the table is updated:

select * from cloud.cluster_details;

6. Find the ID of the correct row of vmware_data_center that you want to update

select * from cloud.vmware_data_center;

7. update the plain text password with the encrypted one:

update cloud.vmware_data_center set password = ’_ciphertext_from_step_1_’ where id = _id_from_step_5_;

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. Configure the CloudStack apt repository as detailed above.

2. Stop the running agent.

32 Chapter 6. Upgrade Instruction from 4.3.x

Page 37: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

$ sudo service cloudstack-agent stop

3. Update the agent software.

$ sudo apt-get upgrade cloudstack-agent

4. Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

5. Start the agent.

$ sudo service cloudstack-agent start

6.8.2 KVM on CentOS/RHEL

For KVM hosts, upgrade the cloudstack-agent package

1. Configure the CloustStack RPM repository as detailed above.

$ sudo yum upgrade cloudstack-agent

2. Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

3. Restart the agent:

$ sudo service cloudstack-agent stop$ sudo killall jsvc$ sudo service cloudstack-agent start

6.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

6.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 thatthe admin port is set to 8096 by using the “integration.api.port” global parameter. This port is used by the cloud-sysvmadm script at the end of the upgrade procedure. For information about how to set this parameter, see SettingGlobal Configuration Parameters in the Installation Guide. Changing this parameter will require management serverrestart. Also make sure port 8096 is open in your local host firewall to do this.

6.9. Restart management services 33

Page 38: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

There is a script that will do this for you, all you need to do is run the script and supply the IP address for your MySQLinstance and your MySQL credentials:

# nohup cloudstack-sysvmadm -d IPaddress -u cloud -p password -a > sysvm.log 2>&1 &

You can monitor the log for progress. The process of restarting the system VMs can take an hour or more.

# tail -f sysvm.log

The output to sysvm.log will look something like this:

Stopping and starting 1 secondary storage vm(s)...Done stopping and starting secondary storage vm(s)Stopping and starting 1 console proxy vm(s)...Done stopping and starting console proxy vm(s).Stopping and starting 4 running routing vm(s)...Done restarting router(s).

34 Chapter 6. Upgrade Instruction from 4.3.x

Page 39: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 7

Upgrade Instruction from 4.2.x

This section will guide you from CloudStack 4.2.x to CloudStack 4.4.

If you run into any issues during upgrades, please feel free to ask questions on [email protected] [email protected].

Warning: Depreciation of realhostip.com DNS and SSL certificateThe realhostip.com dynamic DNS resolution service is being retired this summer. In advance of that, CloudStack4.3 and later no longer uses realhostip.com DNS domains or SSL certificates to encrypt Console Proxy or file copycommunications.

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 workingthrough 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. Install new System-VM templates

2. Backup CloudStack database (MySQL)

3. Upgrade CloudStack management server(s)

4. Update hypervisors specific dependencies

5. Restart System-VMs and Virtual-Routers

7.1 Packages repository

Most users of CloudStack manage the installation and upgrades of CloudStack with one of Linux’s predominantpackage systems, RPM or APT. This guide assumes you’ll be using RPM and Yum (for Red Hat Enterprise Linux orCentOS), or APT and Debian packages (for Ubuntu).

Create RPM or Debian packages (as appropriate) and a repository from the 4.4 source, or check the Apache Cloud-Stack downloads page at http://cloudstack.apache.org/downloads.html for package repositories supplied by commu-nity members. You will need them for Management Server Ubuntu or Management Server CentOS/RHEL and Hyper-visor: KVM hosts upgrade.

Instructions for creating packages from the CloudStack source are in the CloudStack Installation Guide.

35

Page 40: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

7.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):

36 Chapter 7. Upgrade Instruction from 4.2.x

Page 41: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Hy-pervi-sor

Description

XenServerName: systemvm-xenserver-4.3Description: systemvm-xenserver-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-xen.vhd.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: XenServerFormat: VHDOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

KVM Name: systemvm-kvm-4.3Description: systemvm-kvm-4.3URL: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-kvm.qcow2.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: KVMFormat: QCOW2OS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

VMware Name: systemvm-vmware-4.3Description: systemvm-vmware-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-vmware.ovaZone: Choose the zone where this hypervisor is usedHypervisor: VMwareFormat: OVAOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

6. Watch the screen to be sure that the template downloads successfully and enters the READY state. Do notproceed until this is successful.

7.3 Database Preparation

Backup current database

7.3. Database Preparation 37

Page 42: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

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. Make a backup of your MySQL database. If you run into any issues or need to roll back the upgrade, this willassist in debugging or restoring your existing environment. You’ll be prompted for your password.

$ mysqldump -u root -p cloud > cloud-backup.sql$ mysqldump -u root -p cloud_usage > cloud_usage-backup.sql

4. (KVM Only) If primary storage of type local storage is in use, the path for this storage needs to be verified toensure it passes new validation. Check local storage by querying the cloud.storage_pool table:

$ mysql -u cloud -p -e "select id,name,path from cloud.storage_pool where pool_type=’Filesystem’"

If local storage paths are found to have a trailing forward slash, remove it:

$ mysql -u cloud -p -e ’update cloud.storage_pool set path="/var/lib/libvirt/images" where path="/var/lib/libvirt/images/"’;

7.4 Management Server Ubuntu

If you are using Ubuntu, follow this procedure to upgrade your packages. If not, skip to step Management ServerCentOS/RHEL.

Note: Community Packages: This section assumes you’re using the community supplied packages for CloudStack.If you’ve created your own packages and APT repository, substitute your own URL for the ones used in these examples.

The first order of business will be to change the sources list for each system with CloudStack packages. This meansall management servers, and any hosts that have the KVM agent. (No changes should be necessary for hosts that arerunning VMware or Xen.)

7.4.1 CloudStack apt repository

Start by opening /etc/apt/sources.list.d/cloudstack.list on any systems that haveCloudStack packages installed.

This file should have one line, which contains:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.2

We’ll change it to point to the new package repository:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.4

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

1. Now update your apt package list:

$ sudo apt-get update

2. Now that you have the repository configured, it’s time to upgrade the cloudstack-management package.

38 Chapter 7. Upgrade Instruction from 4.2.x

Page 43: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

$ sudo apt-get upgrade cloudstack-management

3. If you use CloudStack usage server

$ sudo apt-get upgrade cloudstack-usage

7.5 Management Server CentOS/RHEL

If you are using CentOS or RHEL, follow this procedure to upgrade your packages. If not, skip to hypervisors section,then System-VMs and Virtual-Routers.

Note: Community Packages: This section assumes you’re using the community supplied packages for CloudStack.If you’ve created your own packages and yum repository, substitute your own URL for the ones used in these examples.

7.5.1 CloustStack RPM repository

The first order of business will be to change the yum repository for each system with CloudStack packages.This means all management servers, and any hosts that have the KVM agent.

(No changes should be necessary for hosts that are running VMware or Xen.)

Start by opening /etc/yum.repos.d/cloudstack.repo on any systems that have CloudStackpackages installed.

This file should have content similar to the following:

[apache-cloudstack]name=Apache CloudStackbaseurl=http://cloudstack.apt-get.eu/rhel/4.2/enabled=1gpgcheck=0

If you are using the community provided package repository, change the base url tohttp://cloudstack.apt-get.eu/rhel/4.4/

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

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: 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.

wget -P /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver \http://download.cloud.com.s3.amazonaws.com/tools/vhd-util

7.5. Management Server CentOS/RHEL 39

Page 44: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

7.7 Hypervisor: VMware

Warning: For VMware hypervisor CloudStack management server packages must be build using“noredist”. Refer to Building from Source.

(VMware only) Additional steps are required for each VMware cluster. These steps will not affect run-ning guests in the cloud. These steps are required only for clouds using VMware clusters:

1. Stop the Management Server:

$ sudo service cloudstack-management stop

2. Generate the encrypted equivalent of your vCenter password:

$ java -classpath /usr/share/cloudstack-common/lib/jasypt-1.9.0.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI encrypt.sh input="_your_vCenter_password_" password="‘cat /etc/cloudstack/management/key‘" verbose=false

Store the output from this step, we need to add this in cluster_details table and vmware_data_center tables inplace of the plain text password

3. Find the ID of the row of cluster_details table that you have to update:

$ mysql -u <username> -p<password>

select * from cloud.cluster_details;

4. Update the plain text password with the encrypted one

update cloud.cluster_details set value = ’_ciphertext_from_step_1_’ where id = _id_from_step_2_;

5. Confirm that the table is updated:

select * from cloud.cluster_details;

6. Find the ID of the correct row of vmware_data_center that you want to update

select * from cloud.vmware_data_center;

7. Update the plain text password with the encrypted one:

update cloud.vmware_data_center set password = ’_ciphertext_from_step_1_’ where id = _id_from_step_5_;

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. Configure the CloudStack apt repository as detailed above.

2. Stop the running agent.

40 Chapter 7. Upgrade Instruction from 4.2.x

Page 45: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

$ sudo service cloudstack-agent stop

3. Update the agent software.

$ sudo apt-get upgrade cloudstack-agent

4. Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

5. Start the agent.

$ sudo service cloudstack-agent start

7.8.2 KVM on CentOS/RHEL

For KVM hosts, upgrade the cloudstack-agent package

1. Configure the CloustStack RPM repository as detailed above.

$ sudo yum upgrade cloudstack-agent

2. Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

3. Restart the agent:

$ sudo service cloudstack-agent stop$ sudo killall jsvc$ sudo service cloudstack-agent start

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 thatthe admin port is set to 8096 by using the “integration.api.port” global parameter. This port is used by the cloud-sysvmadm script at the end of the upgrade procedure. For information about how to set this parameter, see SettingGlobal Configuration Parameters in the Installation Guide. Changing this parameter will require management serverrestart. Also make sure port 8096 is open in your local host firewall to do this.

7.9. Restart management services 41

Page 46: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

There is a script that will do this for you, all you need to do is run the script and supply the IP address for your MySQLinstance and your MySQL credentials:

# nohup cloudstack-sysvmadm -d IPaddress -u cloud -p password -a > sysvm.log 2>&1 &

You can monitor the log for progress. The process of restarting the system VMs can take an hour or more.

# tail -f sysvm.log

The output to sysvm.log will look something like this:

Stopping and starting 1 secondary storage vm(s)...Done stopping and starting secondary storage vm(s)Stopping and starting 1 console proxy vm(s)...Done stopping and starting console proxy vm(s).Stopping and starting 4 running routing vm(s)...Done restarting router(s).

42 Chapter 7. Upgrade Instruction from 4.2.x

Page 47: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 8

Upgrade Instruction from 4.1.x

This section will guide you from CloudStack 4.1.x versions to CloudStack 4.4.

If you run into any issues during upgrades, please feel free to ask questions on [email protected] [email protected].

Warning: Depreciation of realhostip.com DNS and SSL certificateThe realhostip.com dynamic DNS resolution service is being retired this summer. In advance of that, CloudStack4.3 and later no longer uses realhostip.com DNS domains or SSL certificates to encrypt Console Proxy or file copycommunications.

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 workingthrough 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. Install new System-VM templates

2. Backup CloudStack database (MySQL)

3. Upgrade CloudStack management server(s)

4. Update hypervisors specific dependencies

5. Restart System-VMs and Virtual-Routers

8.1 Packages repository

Most users of CloudStack manage the installation and upgrades of CloudStack with one of Linux’s predominantpackage systems, RPM or APT. This guide assumes you’ll be using RPM and Yum (for Red Hat Enterprise Linux orCentOS), or APT and Debian packages (for Ubuntu).

Create RPM or Debian packages (as appropriate) and a repository from the 4.4 source, or check the Apache Cloud-Stack downloads page at http://cloudstack.apache.org/downloads.html for package repositories supplied by commu-nity members. You will need them for Management Server Ubuntu or Management Server on CentOS/RHEL andHypervisor: KVM hosts upgrade.

Instructions for creating packages from the CloudStack source are in the CloudStack Installation Guide.

43

Page 48: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

8.2 Update System-VM templates

1. While running the existing 4.1.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):

44 Chapter 8. Upgrade Instruction from 4.1.x

Page 49: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Hy-pervi-sor

Description

XenServerName: systemvm-xenserver-4.3Description: systemvm-xenserver-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-xen.vhd.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: XenServerFormat: VHDOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

KVM Name: systemvm-kvm-4.3Description: systemvm-kvm-4.3URL: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-kvm.qcow2.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: KVMFormat: QCOW2OS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

VMware Name: systemvm-vmware-4.3Description: systemvm-vmware-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-vmware.ovaZone: Choose the zone where this hypervisor is usedHypervisor: VMwareFormat: OVAOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

6. Watch the screen to be sure that the template downloads successfully and enters the READY state. Do notproceed until this is successful.

8.3 Database Preparation

Backup current database

8.3. Database Preparation 45

Page 50: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

1. Stop your management server or servers. Run this on all management server hosts:

$ sudo service cloud-management stop

2. If you are running a usage server or usage servers, stop those as well:

$ sudo service cloud-usage stop

3. Make a backup of your MySQL database. If you run into any issues or need to roll back the upgrade, this willassist in debugging or restoring your existing environment. You’ll be prompted for your password.

$ mysqldump -u root -p cloud > cloud-backup.sql$ mysqldump -u root -p cloud_usage > cloud_usage-backup.sql

4. (KVM Only) If primary storage of type local storage is in use, the path for this storage needs to be verified toensure it passes new validation. Check local storage by querying the cloud.storage_pool table:

$ mysql -u cloud -p -e "select id,name,path from cloud.storage_pool where pool_type=’Filesystem’"

If local storage paths are found to have a trailing forward slash, remove it:

$ mysql -u cloud -p -e ’update cloud.storage_pool set path="/var/lib/libvirt/images" where path="/var/lib/libvirt/images/"’;

8.4 Management Server Ubuntu

If you are using Ubuntu, follow this procedure to upgrade your packages. If not, skip to step Management Server onCentOS/RHEL.

Note: Community Packages: This section assumes you’re using the community supplied packages for CloudStack.If you’ve created your own packages and APT repository, substitute your own URL for the ones used in these examples.

1. The first order of business will be to change the sources list for each system with CloudStack packages. Thismeans all management servers, and any hosts that have the KVM agent. (No changes should be necessary forhosts that are running VMware or Xen.)

Start by opening /etc/apt/sources.list.d/cloudstack.list on any systems that have Cloud-Stack packages installed.

This file should have one line, which contains:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.1

We’ll change it to point to the new package repository:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.4

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

2. Now update your apt package list:

$ sudo apt-get update

3. Now that you have the repository configured, it’s time to install the cloudstack-management package.This will pull in any other dependencies you need.

$ sudo apt-get upgrade cloudstack-management

4. If you use CloudStack usage server

46 Chapter 8. Upgrade Instruction from 4.1.x

Page 51: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

$ sudo apt-get upgrade cloudstack-usage

8.5 Management Server on CentOS/RHEL

If you are using CentOS or RHEL, follow this procedure to upgrade your packages. If not, skip to hypervisors section,then System-VMs and Virtual-Routers.

Note: Community Packages: This section assumes you’re using the community supplied packages for CloudStack.If you’ve created your own packages and yum repository, substitute your own URL for the ones used in these examples.

8.5.1 CloustStack RPM repository

The first order of business will be to change the yum repository for each system with CloudStack packages.This means all management servers, and any hosts that have the KVM agent.

(No changes should be necessary for hosts that are running VMware or Xen.)

Start by opening /etc/yum.repos.d/cloudstack.repo on any systems that have CloudStackpackages installed.

This file should have content similar to the following:

[apache-cloudstack]name=Apache CloudStackbaseurl=http://cloudstack.apt-get.eu/rhel/4.1/enabled=1gpgcheck=0

If you are using the community provided package repository, change the base url tohttp://cloudstack.apt-get.eu/rhel/4.4/

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

1. Now that you have the repository configured, it’s time to install the cloudstack-management package byupgrading the older cloudstack-management package.

$ 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.

8.7 Hypervisor: VMware

(VMware only) Additional steps are required for each VMware cluster. These steps will not affect running guests inthe cloud. These steps are required only for clouds using VMware clusters:

8.5. Management Server on CentOS/RHEL 47

Page 52: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

1. Stop the Management Server:

service cloudstack-management stop

2. Generate the encrypted equivalent of your vCenter password:

java -classpath /usr/share/cloudstack-common/lib/jasypt-1.9.0.jar org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI encrypt.sh input="_your_vCenter_password_" password="‘cat /etc/cloudstack/management/key‘" verbose=false

Store the output from this step, we need to add this in cluster_details table and vmware_data_center tables inplace of the plain text password

3. Find the ID of the row of cluster_details table that you have to update:

mysql -u <username> -p<password>

select * from cloud.cluster_details;

4. Update the plain text password with the encrypted one

update cloud.cluster_details set value = ’_ciphertext_from_step_1_’ where id = _id_from_step_2_;

5. Confirm that the table is updated:

select * from cloud.cluster_details;

6. Find the ID of the correct row of vmware_data_center that you want to update

select * from cloud.vmware_data_center;

7. Update the plain text password with the encrypted one:

update cloud.vmware_data_center set password = ’_ciphertext_from_step_1_’ where id = _id_from_step_5_;

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. Configure the CloudStack yum repository as detailed above.

2. Stop the running agent.

$ sudo service cloud-agent stop$ killall jsvc

3. Update the agent software.

$ sudo apt-get upgrade cloudstack-agent

During the installation of cloudstack-agent, APT will copy your agent.properties,log4j-cloud.xml, and environment.properties from /etc/cloud/agent to/etc/cloudstack/agent.

When prompted whether you wish to keep your configuration, say Yes.

48 Chapter 8. Upgrade Instruction from 4.1.x

Page 53: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

4. Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

5. Start the agent.

$ sudo service cloudstack-agent start

8.8.2 KVM on CentOS

1. Stop the running agent.

# service cloud-agent stop# killall jsvc

2. Configure the CloustStack RPM repository as detailed above.

# yum upgrade cloudstack-agent

3. Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

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 thatthe admin port is set to 8096 by using the “integration.api.port” global parameter. This port is used by the cloud-sysvmadm script at the end of the upgrade procedure. For information about how to set this parameter, see SettingGlobal Configuration Parameters in the Installation Guide. Changing this parameter will require management serverrestart. Also make sure port 8096 is open in your local host firewall to do this.

There is a script that will do this for you, all you need to do is run the script and supply the IP address for your MySQLinstance and your MySQL credentials:

# nohup cloudstack-sysvmadm -d IPaddress -u cloud -p password -a > sysvm.log 2>&1 &

You can monitor the log for progress. The process of restarting the system VMs can take an hour or more.

# tail -f sysvm.log

The output to sysvm.log will look something like this:

8.9. Restart management services 49

Page 54: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Stopping and starting 1 secondary storage vm(s)...Done stopping and starting secondary storage vm(s)Stopping and starting 1 console proxy vm(s)...Done stopping and starting console proxy vm(s).Stopping and starting 4 running routing vm(s)...Done restarting router(s).

50 Chapter 8. Upgrade Instruction from 4.1.x

Page 55: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 9

Upgrade Instruction from 4.0.x

This section will guide you from CloudStack 4.0.x versions to CloudStack 4.4.

If you run into any issues during upgrades, please feel free to ask questions on [email protected] [email protected].

Warning: Depreciation of realhostip.com DNS and SSL certificateThe realhostip.com dynamic DNS resolution service is being retired this summer. In advance of that, CloudStack4.3 and later no longer uses realhostip.com DNS domains or SSL certificates to encrypt Console Proxy or file copycommunications.

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 workingthrough it on a test system before working on a production system.

Note: The following upgrade instructions should be performed regardless of hypervisor type.

Important: Package Structure Changes: The package structure for CloudStack has changed significantly sincethe 4.0.x releases. If you’ve compiled your own packages, you’ll notice that the package names and the number ofpackages has changed. This is not a bug. However, this does mean that the procedure is not as simple as an apt-getupgrade or yum update, so please follow this section carefully.

9.1 Packages repository

Most users of CloudStack manage the installation and upgrades of CloudStack with one of Linux’s predominantpackage systems, RPM or APT. This guide assumes you’ll be using RPM and Yum (for Red Hat Enterprise Linux orCentOS), or APT and Debian packages (for Ubuntu).

Create RPM or Debian packages (as appropriate) and a repository from the 4.4 source, or check the Apache Cloud-Stack downloads page at http://cloudstack.apache.org/downloads.html for package repositories supplied by commu-nity members. You will need them for Ubuntu or CentOS/RHEL hosts upgrade.

Instructions for creating packages from the CloudStack source are in the CloudStack Installation Guide.

9.2 Update System-VM templates

1. While running the existing 4.0.x system, log in to the UI as root administrator.

51

Page 56: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

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):

Hy-pervi-sor

Description

XenServerName: systemvm-xenserver-4.3Description: systemvm-xenserver-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-xen.vhd.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: XenServerFormat: VHDOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

KVM Name: systemvm-kvm-4.3Description: systemvm-kvm-4.3URL: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-kvm.qcow2.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: KVMFormat: QCOW2OS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

VMware Name: systemvm-vmware-4.3Description: systemvm-vmware-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-vmware.ovaZone: Choose the zone where this hypervisor is usedHypervisor: VMwareFormat: OVAOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

6. Watch the screen to be sure that the template downloads successfully and enters the READY state. Do not

52 Chapter 9. Upgrade Instruction from 4.0.x

Page 57: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

proceed until this is successful.

9.3 Database Preparation

1. Stop your management server or servers. Run this on all management server hosts:

# service cloud-management stop

2. If you are running a usage server or usage servers, stop those as well:

# service cloud-usage stop

3. Make a backup of your MySQL database. If you run into any issues or need to roll back the upgrade, this willassist in debugging or restoring your existing environment. You’ll be prompted for your password.

# mysqldump -u root -p cloud > cloudstack-backup.sql

4. Whether you’re upgrading a Red Hat/CentOS based system or Ubuntu based system, you’re going to need tostop the CloudStack management server before proceeding.

# service cloud-management stop

5. If you have made changes to /etc/cloud/management/components.xml, you’ll need to carry theseover manually to the new file, /etc/cloudstack/management/componentContext.xml. This isnot done automatically. (If you’re unsure, we recommend making a backup of the original components.xmlto be on the safe side.

6. After upgrading to 4.4, API clients are expected to send plain text passwords for login and user creation, insteadof MD5 hash. Incase, api client changes are not acceptable, following changes are to be made for backwardcompatibility:

Modify componentContext.xml, and make PlainTextUserAuthenticator as the default authenticator (1st entry inthe userAuthenticators adapter list is default)

<!-- Security adapters --><bean id="userAuthenticators" class="com.cloud.utils.component.AdapterList"><property name="Adapters">

<list><ref bean="PlainTextUserAuthenticator"/><ref bean="MD5UserAuthenticator"/><ref bean="LDAPUserAuthenticator"/>

</list></property>

</bean>

PlainTextUserAuthenticator works the same way MD5UserAuthenticator worked prior to 4.1.

9.4 Ubuntu

If you are using Ubuntu, follow this procedure to upgrade your packages. If not, skip to CentOS/RHEL.

Note: Community Packages: This section assumes you’re using the community supplied packages for CloudStack.If you’ve created your own packages and APT repository, substitute your own URL for the ones used in these examples.

9.3. Database Preparation 53

Page 58: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

1. The first order of business will be to change the sources list for each system with CloudStack packages. Thismeans all management servers, and any hosts that have the KVM agent. (No changes should be necessary forhosts that are running VMware or Xen.)

Start by opening /etc/apt/sources.list.d/cloudstack.list on any systems that have Cloud-Stack packages installed.

This file should have one line, which contains:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.0

We’ll change it to point to the new package repository:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.4

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

2. Now update your apt package list:

$ sudo apt-get update

3. Now that you have the repository configured, it’s time to install the cloudstack-management package.This will pull in any other dependencies you need.

$ sudo apt-get install cloudstack-management

4. You will need to manually install the cloudstack-agent package:

$ sudo apt-get install cloudstack-agent

During the installation of cloudstack-agent, APT will copy your agent.properties,log4j-cloud.xml, and environment.properties from /etc/cloud/agent to/etc/cloudstack/agent.

When prompted whether you wish to keep your configuration, say Yes.

5. Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

6. Restart the agent:

service cloud-agent stopkillall jsvcservice cloudstack-agent start

7. During the upgrade, log4j-cloud.xml was simply copied over, so the logs will continue to be added to/var/log/cloud/agent/agent.log. There’s nothing wrong with this, but if you prefer to be consistent,you can change this by copying over the sample configuration file:

cd /etc/cloudstack/agentmv log4j-cloud.xml.dpkg-dist log4j-cloud.xmlservice cloudstack-agent restart

8. Once the agent is running, you can uninstall the old cloud-* packages from your system:

sudo dpkg --purge cloud-agent

54 Chapter 9. Upgrade Instruction from 4.0.x

Page 59: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

9.5 CentOS/RHEL

If you are using CentOS or RHEL, follow this procedure to upgrade your packages. If not, skip to step System-VMsand Virtual-Routers.

Note: Community Packages: This section assumes you’re using the community supplied packages for CloudStack.If you’ve created your own packages and yum repository, substitute your own URL for the ones used in these examples.

1. The first order of business will be to change the yum repository for each system with CloudStack packages. Thismeans all management servers, and any hosts that have the KVM agent. (No changes should be necessary forhosts that are running VMware or Xen.)

Start by opening /etc/yum.repos.d/cloudstack.repo on any systems that have CloudStack pack-ages installed.

This file should have content similar to the following:

[apache-cloudstack]name=Apache CloudStackbaseurl=http://cloudstack.apt-get.eu/rhel/4.0/enabled=1gpgcheck=0

If you are using the community provided package repository, change the baseurl tohttp://cloudstack.apt-get.eu/rhel/4.4/

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

2. Now that you have the repository configured, it’s time to install the cloudstack-management package byupgrading the older cloud-client package.

$ sudo yum upgrade cloud-client

3. For KVM hosts, you will need to upgrade the cloud-agent package, similarly installing the new version ascloudstack-agent.

$ sudo yum upgrade cloud-agent

During the installation of cloudstack-agent, the RPM will copy your agent.properties,log4j-cloud.xml, and environment.properties from /etc/cloud/agent to/etc/cloudstack/agent.

4. Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

5. Restart the agent:

service cloud-agent stopkillall jsvcservice cloudstack-agent start

9.6 Hypervisor: XenServer

(XenServer only) Copy vhd-utils file on CloudStack management servers.

9.5. CentOS/RHEL 55

Page 60: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Copy the file vhd-utils to /usr/share/cloudstack-common/scripts/vm/hypervisor/xenserver.

9.7 System-VMs and Virtual-Routers

Once you’ve upgraded the packages on your management servers, you’ll need to restart the system VMs. Ensure thatthe admin port is set to 8096 by using the “integration.api.port” global parameter. This port is used by the cloud-sysvmadm script at the end of the upgrade procedure. For information about how to set this parameter, see SettingGlobal Configuration Parameters in the Installation Guide. Changing this parameter will require management serverrestart. Also make sure port 8096 is open in your local host firewall to do this.

There is a script that will do this for you, all you need to do is run the script and supply the IP address for your MySQLinstance and your MySQL credentials:

# nohup cloudstack-sysvmadm -d IPaddress -u cloud -p password -a > sysvm.log 2>&1 &

You can monitor the log for progress. The process of restarting the system VMs can take an hour or more.

# tail -f sysvm.log

The output to sysvm.log will look something like this:

Stopping and starting 1 secondary storage vm(s)...Done stopping and starting secondary storage vm(s)Stopping and starting 1 console proxy vm(s)...Done stopping and starting console proxy vm(s).Stopping and starting 4 running routing vm(s)...Done restarting router(s).

56 Chapter 9. Upgrade Instruction from 4.0.x

Page 61: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 10

Upgrade Instruction from 3.0.x

This section will guide you from Citrix CloudStack 3.0.x to Apache CloudStack 4.4.

If you run into any issues during upgrades, please feel free to ask questions on [email protected] [email protected].

Warning: Depreciation of realhostip.com DNS and SSL certificateThe realhostip.com dynamic DNS resolution service is being retired this summer. In advance of that, CloudStack4.3 and later no longer uses realhostip.com DNS domains or SSL certificates to encrypt Console Proxy or file copycommunications.

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 workingthrough it on a test system before working on a production system.

Note: The following upgrade instructions should be performed regardless of hypervisor type.

Important: Package Structure Changes: The package structure for CloudStack has changed significantly sincethe 3.0.x releases. If you’ve compiled your own packages, you’ll notice that the package names and the number ofpackages has changed. This is not a bug. However, this does mean that the procedure is not as simple as an apt-getupgrade or yum update, so please follow this section carefully.

10.1 Packages repository

Most users of CloudStack manage the installation and upgrades of CloudStack with one of Linux’s predominantpackage systems, RPM or APT. This guide assumes you’ll be using RPM and Yum (for Red Hat Enterprise Linux orCentOS), or APT and Debian packages (for Ubuntu).

Create RPM or Debian packages (as appropriate) and a repository from the 4.4 source, or check the Apache Cloud-Stack downloads page at http://cloudstack.apache.org/downloads.html for package repositories supplied by commu-nity members. You will need them for Ubuntu or CentOS/RHEL hosts upgrade.

Instructions for creating packages from the CloudStack source are in the CloudStack Installation Guide.

10.2 Update System-VM templates

1. While running the existing 3.0.x system, log in to the UI as root administrator.

57

Page 62: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

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):

Hy-pervi-sor

Description

XenServerName: systemvm-xenserver-4.3Description: systemvm-xenserver-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-xen.vhd.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: XenServerFormat: VHDOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

KVM Name: systemvm-kvm-4.3Description: systemvm-kvm-4.3URL: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-kvm.qcow2.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: KVMFormat: QCOW2OS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

VMware Name: systemvm-vmware-4.3Description: systemvm-vmware-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-vmware.ovaZone: Choose the zone where this hypervisor is usedHypervisor: VMwareFormat: OVAOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

6. Watch the screen to be sure that the template downloads successfully and enters the READY state. Do not

58 Chapter 10. Upgrade Instruction from 3.0.x

Page 63: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

proceed until this is successful.

10.3 Upgrade Steps

1. (KVM on RHEL 6.0/6.1 only) If your existing CloudStack deployment includes one or more clusters of KVMhosts running RHEL 6.0 or RHEL 6.1, perform the following:

(a) Ensure that you upgrade the operating system version on those hosts before upgrading CloudStack

To do that, change the yum repository for each system with CloudStack packages, that implies that all theManagement Servers and any hosts that have the KVM agent.

(b) Open /etc/yum.repos.d/cloudstack.repo on any systems that have CloudStack packages in-stalled.

(c) Edit as follows:

[upgrade]name=rhel63baseurl=url-of-your-rhel6.3-repoenabled=1gpgcheck=0[apache CloudStack]name= Apache CloudStackbaseurl= http://cloudstack.apt-get.eu/rhel/4.4/enabled=1gpgcheck=0

If you are using the community provided package repository, change the baseurl tohttp://cloudstack.apt-get.eu/rhel/4.4/

If you are using your own package repository, change this line to read as appropriate for your 4.4 repository.

(d) Now that you have the repository configured, upgrade the host operating system from RHEL 6.0 to 6.3:

# yum upgrade

2. Stop all Usage Servers if running. Run this on all Usage Server hosts.

# service cloud-usage stop

3. Stop the Management Servers. Run this on all Management Server hosts.

# service cloud-management stop

4. On the MySQL master, take a backup of the MySQL databases. We recommend performing this step even intest upgrades. If there is an issue, this will assist with debugging.

In the following commands, it is assumed that you have set the root password on the database, which is aCloudStack recommended best practice. Substitute your own MySQL root password.

# mysqldump -u root -pmysql_password cloud > cloud-backup.dmp# mysqldump -u root -pmysql_password cloud_usage > cloud-usage-backup.dmp

5. Either build RPM/DEB packages as detailed in the Installation Guide, or use one of the community providedyum/apt repositories to gain access to the CloudStack binaries.

6. If you are using Ubuntu, follow this procedure to upgrade your packages. If not, skip to step 8.

Note: Community Packages: This section assumes you’re using the community supplied packages for Cloud-

10.3. Upgrade Steps 59

Page 64: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Stack. If you’ve created your own packages and APT repository, substitute your own URL for the ones used inthese examples.

(a) The first order of business will be to change the sources list for each system with CloudStack packages.This means all management servers, and any hosts that have the KVM agent. (No changes should benecessary for hosts that are running VMware or Xen.)

Start by opening /etc/apt/sources.list.d/cloudstack.list on any systems that haveCloudStack packages installed.

This file should have one line, which contains:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.0

We’ll change it to point to the new package repository:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.4

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

(b) Now update your apt package list:

$ sudo apt-get update

(c) Now that you have the repository configured, it’s time to install the cloudstack-management pack-age. This will pull in any other dependencies you need.

$ sudo apt-get install cloudstack-management

(d) You will need to manually install the cloudstack-agent package:

$ sudo apt-get install cloudstack-agent

During the installation of cloudstack-agent, APT will copy your agent.properties,log4j-cloud.xml, and environment.properties from /etc/cloud/agent to/etc/cloudstack/agent.

When prompted whether you wish to keep your configuration, say Yes.

(e) Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

(f) Restart the agent:

service cloud-agent stopkillall jsvcservice cloudstack-agent start

(g) During the upgrade, log4j-cloud.xml was simply copied over, so the logs will continue to be addedto /var/log/cloud/agent/agent.log. There’s nothing wrong with this, but if you prefer to beconsistent, you can change this by copying over the sample configuration file:

cd /etc/cloudstack/agentmv log4j-cloud.xml.dpkg-dist log4j-cloud.xmlservice cloudstack-agent restart

(h) Once the agent is running, you can uninstall the old cloud-* packages from your system:

60 Chapter 10. Upgrade Instruction from 3.0.x

Page 65: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

sudo dpkg --purge cloud-agent

7. If you are using CentOS or RHEL, follow this procedure to upgrade your packages. If not, skip to step 9.

Note: Community Packages: This section assumes you’re using the community supplied packages for Cloud-Stack. If you’ve created your own packages and yum repository, substitute your own URL for the ones used inthese examples.

(a) The first order of business will be to change the yum repository for each system with CloudStack packages.This means all management servers, and any hosts that have the KVM agent. (No changes should benecessary for hosts that are running VMware or Xen.)

Start by opening /etc/yum.repos.d/cloudstack.repo on any systems that have CloudStackpackages installed.

This file should have content similar to the following:

[apache-cloudstack]name=Apache CloudStackbaseurl=http://cloudstack.apt-get.eu/rhel/4.0/enabled=1gpgcheck=0

If you are using the community provided package repository, change the baseurl tohttp://cloudstack.apt-get.eu/rhel/4.4/

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

(b) Now that you have the repository configured, it’s time to install the cloudstack-management pack-age by upgrading the older cloud-client package.

$ sudo yum upgrade cloud-client

(c) For KVM hosts, you will need to upgrade the cloud-agent package, similarly installing the new versionas cloudstack-agent.

$ sudo yum upgrade cloud-agent

During the installation of cloudstack-agent, the RPM will copy your agent.properties,log4j-cloud.xml, and environment.properties from /etc/cloud/agent to/etc/cloudstack/agent.

(d) Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

(e) Restart the agent:

service cloud-agent stopkillall jsvcservice cloudstack-agent start

8. If you have made changes to your copy of /etc/cloud/management/components.xml the changeswill be preserved in the upgrade. However, you need to do the following steps to place these changes in a newversion of the file which is compatible with version 4.x.x.

(a) Make a backup copy of /etc/cloud/management/components.xml. For example:

10.3. Upgrade Steps 61

Page 66: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

# mv /etc/cloud/management/components.xml /etc/cloud/management/components.xml-backup

(b) Copy /etc/cloud/management/components.xml.rpmnew to create a new/etc/cloud/management/components.xml:

# cp -ap /etc/cloud/management/components.xml.rpmnew /etc/cloud/management/components.xml

(c) Merge your changes from the backup file into the new components.xml.

# vi /etc/cloudstack/management/components.xml

Note: If you have more than one management server node, repeat the upgrade steps on each node.

9. After upgrading to 4.4, API clients are expected to send plain text passwords for login and user creation, insteadof MD5 hash. Incase, api client changes are not acceptable, following changes are to be made for backwardcompatibility:

Modify componentContext.xml, and make PlainTextUserAuthenticator as the default authenticator (1st entry inthe userAuthenticators adapter list is default)

<!-- Security adapters --><bean id="userAuthenticators" class="com.cloud.utils.component.AdapterList"><property name="Adapters">

<list><ref bean="PlainTextUserAuthenticator"/><ref bean="MD5UserAuthenticator"/><ref bean="LDAPUserAuthenticator"/>

</list></property>

</bean>

PlainTextUserAuthenticator works the same way MD5UserAuthenticator worked prior to 4.4

10. Start the first Management Server. Do not start any other Management Server nodes yet.

# service cloudstack-management start

Wait until the databases are upgraded. Ensure that the database upgrade is complete. After confirmation, startthe other Management Servers one at a time by running the same command on each node.

Note: Failing to restart the Management Server indicates a problem in the upgrade. Having the ManagementServer restarted without any issues indicates that the upgrade is successfully completed.

11. Start all Usage Servers (if they were running on your previous version). Perform this on each Usage Server host.

# service cloudstack-usage start

12. Additional steps are required for each KVM host. These steps will not affect running guests in the cloud. Thesesteps are required only for clouds using KVM as hosts and only on the KVM hosts.

(a) Configure a yum or apt repository containing the CloudStack packages as outlined in the InstallationGuide.

(b) Stop the running agent.

# service cloud-agent stop

(c) Update the agent software with one of the following command sets as appropriate for your environment.

# yum update cloud-*

62 Chapter 10. Upgrade Instruction from 3.0.x

Page 67: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

# apt-get update

# apt-get upgrade cloud-*

(d) Edit /etc/cloudstack/agent/agent.properties to change the resourceparameter from “com.cloud.agent.resource.computing.LibvirtComputingResource” to“com.cloud.hypervisor.kvm.resource.LibvirtComputingResource”.

(e) Upgrade all the existing bridge names to new bridge names by running this script:

# cloudstack-agent-upgrade

(f) Install a libvirt hook with the following commands:

# mkdir /etc/libvirt/hooks# cp /usr/share/cloudstack-agent/lib/libvirtqemuhook /etc/libvirt/hooks/qemu# chmod +x /etc/libvirt/hooks/qemu

(g) Restart libvirtd.

# service libvirtd restart

(h) Start the agent.

# service cloudstack-agent start

(i) When the Management Server is up and running, log in to the CloudStack UI and restart the virtual routerfor proper functioning of all the features.

13. Log in to the CloudStack UI as administrator, and check the status of the hosts. All hosts should come to Upstate (except those that you know to be offline). You may need to wait 20 or 30 minutes, depending on thenumber of hosts.

Note: Troubleshooting: If login fails, clear your browser cache and reload the page.

Do not proceed to the next step until the hosts show in Up state.

14. If you are upgrading from 3.0.x, perform the following:

(a) Ensure that the admin port is set to 8096 by using the “integration.api.port” global parameter.

This port is used by the cloud-sysvmadm script at the end of the upgrade procedure. For information abouthow to set this parameter, see “Setting Global Configuration Parameters” in the Installation Guide.

(b) Restart the Management Server.

Note: If you don’t want the admin port to remain open, you can set it to null after the upgrade is done andrestart the management server.

15. Run the cloudstack-sysvmadm script to stop, then start, all Secondary Storage VMs, Console Proxy VMs,and virtual routers. Run the script once on each management server. Substitute your own IP address of theMySQL instance, the MySQL user to connect as, and the password to use for that user. In addition to thoseparameters, provide the -c and -r arguments. For example:

# nohup cloudstack-sysvmadm -d 192.168.1.5 -u cloud -p password -c -r >sysvm.log 2>&1 &

# tail -f sysvm.log

This might take up to an hour or more to run, depending on the number of accounts in the system.

10.3. Upgrade Steps 63

Page 68: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

16. If needed, upgrade all Citrix XenServer hypervisor hosts in your cloud to a version supported by CloudStack4.4. The supported versions are XenServer 5.6 SP2 and 6.0.2. Instructions for upgrade can be found in theCloudStack 4.4 Installation Guide under “Upgrading XenServer Versions.”

17. Now apply the XenServer hotfix XS602E003 (and any other needed hotfixes) to XenServer v6.0.2 hypervisorhosts.

(a) Disconnect the XenServer cluster from CloudStack.

In the left navigation bar of the CloudStack UI, select Infrastructure. Under Clusters, click View All.Select the XenServer cluster and click Actions - Unmanage.

This may fail if there are hosts not in one of the states Up, Down, Disconnected, or Alert. You may needto fix that before unmanaging this cluster.

Wait until the status of the cluster has reached Unmanaged. Use the CloudStack UI to check on the status.When the cluster is in the unmanaged state, there is no connection to the hosts in the cluster.

(b) To clean up the VLAN, log in to one XenServer host and run:

/opt/xensource/bin/cloud-clean-vlan.sh

(c) Now prepare the upgrade by running the following on one XenServer host:

/opt/xensource/bin/cloud-prepare-upgrade.sh

If you see a message like “can’t eject CD”, log in to the VM and unmount the CD, then run this scriptagain.

(d) Upload the hotfix to the XenServer hosts. Always start with the Xen pool master, then the slaves. Usingyour favorite file copy utility (e.g. WinSCP), copy the hotfixes to the host. Place them in a temporaryfolder such as /tmp.

On the Xen pool master, upload the hotfix with this command:

xe patch-upload file-name=XS602E003.xsupdate

Make a note of the output from this command, which is a UUID for the hotfix file. You’ll need it in anotherstep later.

Note: (Optional) If you are applying other hotfixes as well, you can repeat the commands in this sectionwith the appropriate hotfix number. For example, XS602E004.xsupdate.

(e) Manually live migrate all VMs on this host to another host. First, get a list of the VMs on this host:

# xe vm-list

Then use this command to migrate each VM. Replace the example host name and VM name with yourown:

# xe vm-migrate live=true host=host-name vm=‘‘VM-name‘‘

Note: Troubleshooting: If you see a message like “You attempted an op-eration on a VM which requires PV drivers to be installed but the driverswere not detected,” run: /opt/xensource/bin/make_migratable.shb6cf79c8-02ee-050b-922f-49583d9f1a14.

(f) Apply the hotfix. First, get the UUID of this host:

# xe host-list

64 Chapter 10. Upgrade Instruction from 3.0.x

Page 69: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Then use the following command to apply the hotfix. Replace the example host UUID with the currenthost ID, and replace the hotfix UUID with the output from the patch-upload command you ran on thismachine earlier. You can also get the hotfix UUID by running xe patch-list.

xe patch-apply host-uuid=host-uuid uuid=hotfix-uuid

(g) Copy the following files from the CloudStack Management Server to the host.

Copy from here... ...to here/usr/lib64/cloud/common /scripts/vm/hypervisor/xenserver/xenserver60/N FSSR.py

/opt/xensource/sm/NFSSR.py

/usr/lib64/cloud/common /scripts/vm/hypervisor/xenserver/setupxenserve r.sh

/opt/xensource/bin/setupxenserver.sh

/usr/lib64/cloud/common /scripts/vm/hypervisor/xenserver/make_migrata ble.sh

/opt/xensource/bin/make_migratable.sh

(h) (Only for hotfixes XS602E005 and XS602E007) You need to apply a new Cloud Support Pack.

• Download the CSP software onto the XenServer host from one of the following links:

For hotfix XS602E005: http://coltrane.eng.hq.xensource.com/release/XenServer-6.x/XS-6.0.2/hotfixes/XS602E005/56710/xe-phase-2/xenserver-cloud-supp.tgz

For hotfix XS602E007: http://coltrane.eng.hq.xensource.com/release/XenServer-6.x/XS-6.0.2/hotfixes/XS602E007/57824/xe-phase-2/xenserver-cloud-supp.tgz

• Extract the file:

# tar xf xenserver-cloud-supp.tgz

• Run the following script:

# xe-install-supplemental-pack xenserver-cloud-supp.iso

• If the XenServer host is part of a zone that uses basic networking, disable Open vSwitch (OVS):

# xe-switch-network-backend bridge

(i) Reboot this XenServer host.

(j) Run the following:

/opt/xensource/bin/setupxenserver.sh

Note: If the message “mv: cannot stat ‘/etc/cron.daily/logrotate’: No such file or directory” appears, youcan safely ignore it.

(k) Run the following:

for pbd in ‘xe pbd-list currently-attached=false| grep ^uuid | awk ’{print $NF}’‘; do xe pbd-plug uuid=$pbd ;

(l) On each slave host in the Xen pool, repeat these steps, starting from “manually live migrate VMs.”

Note: Troubleshooting Tip: If passwords which you know to be valid appear not to work after upgrade, or other UIissues are seen, try clearing your browser cache and reloading the UI page.

10.3. Upgrade Steps 65

Page 70: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

66 Chapter 10. Upgrade Instruction from 3.0.x

Page 71: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 11

Upgrade Instruction from 2.2.14

This section will guide you from pre-Apache versions of Citrix CloudStack 2.2.14 version to Apache CloudStack 4.4.

If you run into any issues during upgrades, please feel free to ask questions on [email protected] [email protected].

Warning: Depreciation of realhostip.com DNS and SSL certificateThe realhostip.com dynamic DNS resolution service is being retired this summer. In advance of that, CloudStack4.3 and later no longer uses realhostip.com DNS domains or SSL certificates to encrypt Console Proxy or file copycommunications.

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 workingthrough it on a test system before working on a production system.

Note: The following upgrade instructions should be performed regardless of hypervisor type.

Important: Package Structure Changes: The package structure for CloudStack has changed significantly sincethe 2.2.14 releases. If you’ve compiled your own packages, you’ll notice that the package names and the number ofpackages has changed. This is not a bug. However, this does mean that the procedure is not as simple as an apt-getupgrade or yum update, so please follow this section carefully.

1. Ensure that you query your IPaddress usage records and process them; for example, issue invoices for any usagethat you have not yet billed users for.

Starting in 3.0.2, the usage record format for IP addresses is the same as the rest of the usage types. Insteadof a single record with the assignment and release dates, separate records are generated per aggregation periodwith start and end dates. After upgrading to 4.4, any existing IP address usage records in the old format will nolonger be available.

2. If you are using version 2.2.0 - 2.2.13, first upgrade to 2.2.14 by using the instructions in the 2.2.14 ReleaseNotes.

Warning: KVM Hosts: If KVM hypervisor is used in your cloud, be sure you completed the step to inserta valid username and password into the host_details table on each KVM node as described in the 2.2.14Release Notes. This step is critical, as the database will be encrypted after the upgrade to 4.4.

67

Page 72: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

11.1 Update System-VM templates

1. While running the existing 2.2.14 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):

68 Chapter 11. Upgrade Instruction from 2.2.14

Page 73: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Hy-pervi-sor

Description

XenServerName: systemvm-xenserver-4.3Description: systemvm-xenserver-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-xen.vhd.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: XenServerFormat: VHDOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

KVM Name: systemvm-kvm-4.3Description: systemvm-kvm-4.3URL: http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-kvm.qcow2.bz2Zone: Choose the zone where this hypervisor is usedHypervisor: KVMFormat: QCOW2OS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

VMware Name: systemvm-vmware-4.3Description: systemvm-vmware-4.3URL:http://download.cloud.com/templates/4.3/systemvm64template-2014-01-14-master-vmware.ovaZone: Choose the zone where this hypervisor is usedHypervisor: VMwareFormat: OVAOS Type: Debian GNU/Linux 7.0 (64-bit) (or the highest Debian release number available in thedropdown)Extractable: noPassword Enabled: noPublic: noFeatured: noRouting: yes

6. Watch the screen to be sure that the template downloads successfully and enters the READY state. Do notproceed until this is successful.

7. WARNING: If you use more than one type of hypervisor in your cloud, be sure you have repeated these stepsto download the system VM template for each hypervisor type. Otherwise, the upgrade will fail.

11.1. Update System-VM templates 69

Page 74: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

11.2 Upgrade Steps

1. (KVM on RHEL 6.0/6.1 only) If your existing CloudStack deployment includes one or more clusters of KVMhosts running RHEL 6.0 or RHEL 6.1, perform the following:

(a) Ensure that you upgrade the operating system version on those hosts before upgrading CloudStack

To do that, change the yum repository for each system with CloudStack packages, that implies that all theManagement Servers and any hosts that have the KVM agent.

(b) Open /etc/yum.repos.d/cloudstack.repo on any systems that have CloudStack packages in-stalled.

(c) Edit as follows:

[upgrade]name=rhel63baseurl=url-of-your-rhel6.3-repoenabled=1gpgcheck=0[apache CloudStack]name= Apache CloudStackbaseurl= http://cloudstack.apt-get.eu/rhel/4.4/enabled=1gpgcheck=0

If you are using the community provided package repository, change the baseurl tohttp://cloudstack.apt-get.eu/rhel/4.4/

If you are using your own package repository, change this line to read as appropriate for your 4.4 repository.

(d) Now that you have the repository configured, upgrade the host operating system from RHEL 6.0 to 6.3:

# yum upgrade

2. Stop all Usage Servers if running. Run this on all Usage Server hosts.

# service cloud-usage stop

3. Stop the Management Servers. Run this on all Management Server hosts.

# service cloud-management stop

4. On the MySQL master, take a backup of the MySQL databases. We recommend performing this step even intest upgrades. If there is an issue, this will assist with debugging.

In the following commands, it is assumed that you have set the root password on the database, which is aCloudStack recommended best practice. Substitute your own MySQL root password.

# mysqldump -u root -pmysql_password cloud > cloud-backup.dmp# mysqldump -u root -pmysql_password cloud_usage > cloud-usage-backup.dmp

5. Either build RPM/DEB packages as detailed in the Installation Guide, or use one of the community providedyum/apt repositories to gain access to the CloudStack binaries.

6. If you are using Ubuntu, follow this procedure to upgrade your packages. If not, skip to step 13.

Note: Community Packages: This section assumes you’re using the community supplied packages for Cloud-Stack. If you’ve created your own packages and APT repository, substitute your own URL for the ones used inthese examples.

70 Chapter 11. Upgrade Instruction from 2.2.14

Page 75: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

(a) The first order of business will be to change the sources list for each system with CloudStack packages.This means all management servers, and any hosts that have the KVM agent. (No changes should benecessary for hosts that are running VMware or Xen.)

Start by opening /etc/apt/sources.list.d/cloudstack.list on any systems that haveCloudStack packages installed.

This file should have one line, which contains:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.0

We’ll change it to point to the new package repository:

deb http://cloudstack.apt-get.eu/ubuntu precise 4.4

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

(b) Now update your apt package list:

$ sudo apt-get update

(c) Now that you have the repository configured, it’s time to install the cloudstack-management pack-age. This will pull in any other dependencies you need.

$ sudo apt-get install cloudstack-management

(d) On KVM hosts, you will need to manually install the cloudstack-agent package:

$ sudo apt-get install cloudstack-agent

During the installation of cloudstack-agent, APT will copy your agent.properties,log4j-cloud.xml, and environment.properties from /etc/cloud/agent to/etc/cloudstack/agent.

When prompted whether you wish to keep your configuration, say Yes.

(e) Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

(f) Restart the agent:

service cloud-agent stopkillall jsvcservice cloudstack-agent start

(g) During the upgrade, log4j-cloud.xml was simply copied over, so the logs will continue to be addedto /var/log/cloud/agent/agent.log. There’s nothing wrong with this, but if you prefer to beconsistent, you can change this by copying over the sample configuration file:

cd /etc/cloudstack/agentmv log4j-cloud.xml.dpkg-dist log4j-cloud.xmlservice cloudstack-agent restart

(h) Once the agent is running, you can uninstall the old cloud-* packages from your system:

sudo dpkg --purge cloud-agent

7. If you are using CentOS or RHEL, follow this procedure to upgrade your packages. If not, skip to step 14.

Note: Community Packages: This section assumes you’re using the community supplied packages for Cloud-

11.2. Upgrade Steps 71

Page 76: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Stack. If you’ve created your own packages and yum repository, substitute your own URL for the ones used inthese examples.

(a) The first order of business will be to change the yum repository for each system with CloudStack packages.This means all management servers, and any hosts that have the KVM agent. (No changes should benecessary for hosts that are running VMware or Xen.)

Start by opening /etc/yum.repos.d/cloudstack.repo on any systems that have CloudStackpackages installed.

This file should have content similar to the following:

[apache-cloudstack]name=Apache CloudStackbaseurl=http://cloudstack.apt-get.eu/rhel/4.0/enabled=1gpgcheck=0

If you are using the community provided package repository, change the baseurl tohttp://cloudstack.apt-get.eu/rhel/4.4/

If you’re using your own package repository, change this line to read as appropriate for your 4.4 repository.

(b) Now that you have the repository configured, it’s time to install the cloudstack-management pack-age by upgrading the older cloud-client package.

$ sudo yum upgrade cloud-client

(c) For KVM hosts, you will need to upgrade the cloud-agent package, similarly installing the new versionas cloudstack-agent.

$ sudo yum upgrade cloud-agent

During the installation of cloudstack-agent, the RPM will copy your agent.properties,log4j-cloud.xml, and environment.properties from /etc/cloud/agent to/etc/cloudstack/agent.

(d) Verify that the file /etc/cloudstack/agent/environment.properties has a line that reads:

paths.script=/usr/share/cloudstack-common

If not, add the line.

(e) Restart the agent:

service cloud-agent stopkillall jsvcservice cloudstack-agent start

8. If you have made changes to your existing copy of the file components.xml in your previous-version CloudStackinstallation, the changes will be preserved in the upgrade. However, you need to do the following steps to placethese changes in a new version of the file which is compatible with version 4.0.0-incubating.

Note: How will you know whether you need to do this? If the upgrade output in the previous step included amessage like the following, then some custom content was found in your old components.xml, and you need tomerge the two files:

warning: /etc/cloud/management/components.xml created as/etc/cloud/management/components.xml.rpmnew

72 Chapter 11. Upgrade Instruction from 2.2.14

Page 77: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

(a) Make a backup copy of your /etc/cloud/management/components.xml file. For example:

# mv /etc/cloud/management/components.xml /etc/cloud/management/components.xml-backup

(b) Copy /etc/cloud/management/components.xml.rpmnew to create a new/etc/cloud/management/components.xml:

# cp -ap /etc/cloud/management/components.xml.rpmnew /etc/cloud/management/components.xml

(c) Merge your changes from the backup file into the new components.xml file.

# vi /etc/cloudstack/management/components.xml

9. After upgrading to 4.4, API clients are expected to send plain text passwords for login and user creation, in-stead of MD5 hash. If API client changes are not acceptable, following changes are to be made for backwardcompatibility:

Modify componentContext.xml, and make PlainTextUserAuthenticator as the default authenticator (1st entry inthe userAuthenticators adapter list is default)

<!-- Security adapters --><bean id="userAuthenticators" class="com.cloud.utils.component.AdapterList"><property name="Adapters">

<list><ref bean="PlainTextUserAuthenticator"/><ref bean="MD5UserAuthenticator"/><ref bean="LDAPUserAuthenticator"/>

</list></property>

</bean>

PlainTextUserAuthenticator works the same way MD5UserAuthenticator worked prior to 4.2.

10. If you have made changes to your existing copy of the /etc/cloud/management/db.properties filein your previous-version CloudStack installation, the changes will be preserved in the upgrade. However, youneed to do the following steps to place these changes in a new version of the file which is compatible with thisversion.

(a) Make a backup copy of your file /etc/cloud/management/db.properties. For example:

# mv /etc/cloud/management/db.properties /etc/cloud/management/db.properties-backup

(b) Copy /etc/cloud/management/db.properties.rpmnew to create a new/etc/cloud/management/db.properties:

# cp -ap /etc/cloud/management/db.properties.rpmnew etc/cloud/management/db.properties

(c) Merge your changes from the backup file into the new db.properties file.

# vi /etc/cloudstack/management/db.properties

11. On the management server node, run the following command. It is recommended that you use the command-lineflags to provide your own encryption keys. See Password and Key Encryption in the Installation Guide.

# cloudstack-setup-encryption -e encryption_type -m management_server_key -k database_key

When used without arguments, as in the following example, the default encryption type and keys will be used:

• (Optional) For encryption_type, use file or web to indicate the technique used to pass in the databaseencryption password. Default: file.

11.2. Upgrade Steps 73

Page 78: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

• (Optional) For management_server_key, substitute the default key that is used to encrypt confidential pa-rameters in the properties file. Default: password. It is highly recommended that you replace this with amore secure value

• (Optional) For database_key, substitute the default key that is used to encrypt confidential parameters inthe CloudStack database. Default: password. It is highly recommended that you replace this with a moresecure value.

12. Repeat steps 10 - 14 on every management server node. If you provided your own encryption key in step 14,use the same key on all other management servers.

13. Start the first Management Server. Do not start any other Management Server nodes yet.

# service cloudstack-management start

Wait until the databases are upgraded. Ensure that the database upgrade is complete. You should see a messagelike “Complete! Done.” After confirmation, start the other Management Servers one at a time by running thesame command on each node.

14. Start all Usage Servers (if they were running on your previous version). Perform this on each Usage Server host.

# service cloudstack-usage start

15. (KVM only) Perform the following additional steps on each KVM host.

These steps will not affect running guests in the cloud. These steps are required only for clouds using KVM ashosts and only on the KVM hosts.

(a) Configure your CloudStack package repositories as outlined in the Installation Guide

(b) Stop the running agent.

# service cloud-agent stop

(c) Update the agent software with one of the following command sets as appropriate.

# yum update cloud-*

# apt-get update# apt-get upgrade cloud-*

(d) Copy the contents of the agent.properties file to the new agent.properties file by using thefollowing command

sed -i ’s/com.cloud.agent.resource.computing.LibvirtComputingResource/com.cloud.hypervisor.kvm.resource.LibvirtComputingResource/g’ /etc/cloudstack/agent/agent.properties

(e) Upgrade all the existing bridge names to new bridge names by running this script:

# cloudstack-agent-upgrade

(f) Install a libvirt hook with the following commands:

# mkdir /etc/libvirt/hooks# cp /usr/share/cloudstack-agent/lib/libvirtqemuhook /etc/libvirt/hooks/qemu# chmod +x /etc/libvirt/hooks/qemu

(g) Restart libvirtd.

# service libvirtd restart

(h) Start the agent.

74 Chapter 11. Upgrade Instruction from 2.2.14

Page 79: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

# service cloudstack-agent start

(i) When the Management Server is up and running, log in to the CloudStack UI and restart the virtual routerfor proper functioning of all the features.

16. Log in to the CloudStack UI as admin, and check the status of the hosts. All hosts should come to Up state(except those that you know to be offline). You may need to wait 20 or 30 minutes, depending on the number ofhosts.

Do not proceed to the next step until the hosts show in the Up state. If the hosts do not come to the Up state,contact support.

17. Run the following script to stop, then start, all Secondary Storage VMs, Console Proxy VMs, and virtual routers.

(a) Run the command once on one management server. Substitute your own IP address of the MySQL in-stance, the MySQL user to connect as, and the password to use for that user. In addition to those parame-ters, provide the “-c” and “-r” arguments. For example:

# nohup cloudstack-sysvmadm -d 192.168.1.5 -u cloud -p password -c -r > sysvm.log 2>&1 &# tail -f sysvm.log

This might take up to an hour or more to run, depending on the number of accounts in the system.

(b) After the script terminates, check the log to verify correct execution:

# tail -f sysvm.log

The content should be like the following:

Stopping and starting 1 secondary storage vm(s)...Done stopping and starting secondary storage vm(s)Stopping and starting 1 console proxy vm(s)...Done stopping and starting console proxy vm(s).Stopping and starting 4 running routing vm(s)...Done restarting router(s).

18. If you would like additional confirmation that the new system VM templates were correctly applied when thesesystem VMs were rebooted, SSH into the System VM and check the version.

Use one of the following techniques, depending on the hypervisor.

XenServer or KVM:

SSH in by using the link local IP address of the system VM. For example, in the command below, substituteyour own path to the private key used to log in to the system VM and your own link local IP.

Run the following commands on the XenServer or KVM host on which the system VM is present:

# ssh -i private-key-path link-local-ip -p 3922# cat /etc/cloudstack-release

The output should be like the following:

Cloudstack Release 4.0.0-incubating Mon Oct 9 15:10:04 PST 2012

ESXi:

SSH in using the private IP address of the system VM. For example, in the command below, substitute your ownpath to the private key used to log in to the system VM and your own private IP.

Run the following commands on the Management Server:

11.2. Upgrade Steps 75

Page 80: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

# ssh -i private-key-path private-ip -p 3922# cat /etc/cloudstack-release

The output should be like the following:

Cloudstack Release 4.0.0-incubating Mon Oct 9 15:10:04 PST 2012

19. If needed, upgrade all Citrix XenServer hypervisor hosts in your cloud to a version supported by CloudStack4.0.0-incubating. The supported versions are XenServer 5.6 SP2 and 6.0.2. Instructions for upgrade can befound in the CloudStack 4.0.0-incubating Installation Guide.

20. Apply the XenServer hotfix XS602E003 (and any other needed hotfixes) to XenServer v6.0.2 hypervisor hosts.

(a) Disconnect the XenServer cluster from CloudStack.

In the left navigation bar of the CloudStack UI, select Infrastructure. Under Clusters, click View All.Select the XenServer cluster and click Actions - Unmanage.

This may fail if there are hosts not in one of the states Up, Down, Disconnected, or Alert. You may needto fix that before unmanaging this cluster.

Wait until the status of the cluster has reached Unmanaged. Use the CloudStack UI to check on the status.When the cluster is in the unmanaged state, there is no connection to the hosts in the cluster.

(b) To clean up the VLAN, log in to one XenServer host and run:

/opt/xensource/bin/cloud-clean-vlan.sh

(c) Prepare the upgrade by running the following on one XenServer host:

/opt/xensource/bin/cloud-prepare-upgrade.sh

If you see a message like “can’t eject CD”, log in to the VM and umount the CD, then run this script again.

(d) Upload the hotfix to the XenServer hosts. Always start with the Xen pool master, then the slaves. Usingyour favorite file copy utility (e.g. WinSCP), copy the hotfixes to the host. Place them in a temporaryfolder such as /root or /tmp.

On the Xen pool master, upload the hotfix with this command:

xe patch-upload file-name=XS602E003.xsupdate

Make a note of the output from this command, which is a UUID for the hotfix file. You’ll need it in anotherstep later.

Note: (Optional) If you are applying other hotfixes as well, you can repeat the commands in this sectionwith the appropriate hotfix number. For example, XS602E004.xsupdate.

(e) Manually live migrate all VMs on this host to another host. First, get a list of the VMs on this host:

# xe vm-list

Then use this command to migrate each VM. Replace the example host name and VM name with yourown:

# xe vm-migrate live=true host=host-name vm=VM-name

Note: Troubleshooting: If you see a message like “You attempted an op-eration on a VM which requires PV drivers to be installed but the driverswere not detected,” run: /opt/xensource/bin/make_migratable.shb6cf79c8-02ee-050b-922f-49583d9f1a14.

76 Chapter 11. Upgrade Instruction from 2.2.14

Page 81: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

(f) Apply the hotfix. First, get the UUID of this host:

# xe host-list

Then use the following command to apply the hotfix. Replace the example host UUID with the currenthost ID, and replace the hotfix UUID with the output from the patch-upload command you ran on thismachine earlier. You can also get the hotfix UUID by running xe patch-list.

xe patch-apply host-uuid=host-uuid uuid=‘‘hotfix-uuid‘‘

(g) Copy the following files from the CloudStack Management Server to the host.

Copy from here... ...to here/usr/share/cloudstack -common/scripts/vm/hypervisor/xenserver/xenser ver60/NFSSR.py

/opt/xensource/sm/NFSSR.py

/usr/share/cloudstack -common/scripts/vm/hypervisor/xenserver/setupx enserver.sh

/opt/xensource/bin/setupxenserver.sh

/usr/lib64/cloudstack -common/scripts/vm/hypervisor/xenserver/make_m igratable.sh

/opt/xensource/bin/make_migratable.sh

(h) (Only for hotfixes XS602E005 and XS602E007) You need to apply a new Cloud Support Pack.

• Download the CSP software onto the XenServer host from one of the following links:

For hotfix XS602E005: http://coltrane.eng.hq.xensource.com/release/XenServer-6.x/XS-6.0.2/hotfixes/XS602E005/56710/xe-phase-2/xenserver-cloud-supp.tgz

For hotfix XS602E007: http://coltrane.eng.hq.xensource.com/release/XenServer-6.x/XS-6.0.2/hotfixes/XS602E007/57824/xe-phase-2/xenserver-cloud-supp.tgz

• Extract the file:

# tar xf xenserver-cloud-supp.tgz

• Run the following script:

# xe-install-supplemental-pack xenserver-cloud-supp.iso

• If the XenServer host is part of a zone that uses basic networking, disable Open vSwitch (OVS):

# xe-switch-network-backend bridge

(i) Reboot this XenServer host.

(j) Run the following:

/opt/xensource/bin/setupxenserver.sh

Note: If the message “mv: cannot stat ‘/etc/cron.daily/logrotate’: No such file or directory” appears, youcan safely ignore it.

(k) Run the following:

‘‘for pbd in ‘xe pbd-list currently-attached=false| grep ^uuid | awk ’{print $NF}’‘; do xe pbd-plug uuid=$pbd ; ‘‘

(l) On each slave host in the Xen pool, repeat these steps, starting from “manually live migrate VMs.”

11.2. Upgrade Steps 77

Page 82: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

78 Chapter 11. Upgrade Instruction from 2.2.14

Page 83: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 12

Validate 4.4 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.4-src.tar.bz2.asc$ gpg --print-md MD5 apache-cloudstack-4.4-src.tar.bz2 | diff - apache-cloudstack-4.4-src.tar.bz2.md5$ gpg --print-md SHA512 apache-cloudstack-4.4-src.tar.bz2 | diff - apache-cloudstack-4.4-src.tar.bz2.sha

Each of these commands should return no output. Any output from them implies that there is a differencebetween the hash you generated locally and the hash that has been pulled from the server.

(d) Get the commit hash from the VOTE email.

For example: 4cd60f3d1683a3445c3248f48ae064fb573db2a1. The value changes betweenreleases.

(e) Create two new temporary directories:

$ mkdir /tmp/cloudstack/git$ mkdir /tmp/cloudstack/tree

(f) Check out the 4.4 branch:

$ git clone https://git-wip-us.apache.org/repos/asf/cloudstack.git /tmp/cloudstack/git$ cd /tmp/cloudstack/git$ git archive --format=tar --prefix=/tmp/cloudstack/tree/ <commit-hash> | tar Pxf -

(g) Unpack the release artifact:

$ cd /tmp/cloudstack$ tar xvfj apache-cloudstack-4.4-src.tar.bz2

79

Page 84: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

(h) Compare the contents of the release artifact with the contents pulled from the repo:

$ diff -r /tmp/cloudstack/apache-cloudstack-4.4-src /tmp/cloudstack/tree

Ensure that content is the same.

(i) Verify the Code License Headers:

$ cd /tmp/cloudstack/apache-cloudstack-4.4-src$ mvn --projects=’org.apache.cloudstack:cloudstack’ org.apache.rat:apache-rat-plugin:0.8:check

The build fails if any non-compliant files are present that are not specifically excluded from the ASF licenseheader requirement. You can optionally review the target/rat.txt file after the run completes. Passing thebuild implies that RAT certifies that the files are compliant and this test is passed.

80 Chapter 12. Validate 4.4 source code tarball

Page 85: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CHAPTER 13

Known Issues in 4.4.0

Apache CloudStack uses Jira to track its issues. All new features and bugs for 4.4.0 have been tracked in Jira, andhave a standard naming convention of “CLOUDSTACK-NNNN” where “NNNN” is the issue number.

For the list of known issues, see Known Issues in 4.4.0.

Bug ID DescriptionCLOUDSTACK-5212 [UI]Need Support for the LXC for the Report sockets CS-4908...CLOUDSTACK-5357 Xenserver - Failed to create snapshot due to “unable to destroy task(com.xe nsou...CLOUDSTACK-5372 Xenserver - SR not being recreated when the Primary storage is brought down and ...CLOUDSTACK-5469 Snapshot creation fails with following exception - “Failed to backup snapshot: q...CLOUDSTACK-5485 Vmware - Whe 10 hourly snapshots are scheduled at the same time , we see only 5 ...CLOUDSTACK-5736 KVM - Recurring Snapshots - Snapshots reported as being in “BackedUp” state even...CLOUDSTACK-5738 Recurring Snapshots - Few Snapshots are stuck in “Creating” state for more than ...CLOUDSTACK-5746 Can’t access vm console from IE browser...CLOUDSTACK-5853 cannot deploy vm with differing service storage tag and data disk storage tag...CLOUDSTACK-6036 CloudStack stops the machine for no reason...CLOUDSTACK-6177 CS does XS master switch, which may cause weid XS behavior...CLOUDSTACK-6360 Usage server failed to start with 4.4 build...CLOUDSTACK-6392 system template always create with name “master” instead of specific branch...CLOUDSTACK-6405 Observed SQL exceptions during db upgrade from 4.0.0 to 4.4.0...CLOUDSTACK-6430 [SDN] CS asks for vlan range even we create physical network with GRE isolation ...CLOUDSTACK-6459 Unable to enable maintenance mode on a Primary storage that crashed...CLOUDSTACK-6464 [KVM:basic zone- upgrade to 4.3],after any vm restart,all the nics are plugg...CLOUDSTACK-6465 vmware.reserve.mem is missing from cluster level settings ...CLOUDSTACK-6496 addHost fails for XenServer with vSwitch networking...CLOUDSTACK-6590 No option in UI to acquire secondary IP for VM nic...CLOUDSTACK-6594 Observed many DB Exception while starting MS “Can’t DROP ‘last_sent’; check that...CLOUDSTACK-6635 more details required in Alert generated in MS from router vm ...CLOUDSTACK-6684 Error instances are not getting expunged within the specified expunge interval...CLOUDSTACK-6691 NPE while assigning a VM nic primary/secondaryip to internal lb rule....CLOUDSTACK-6693 Enabling Dynamic scale is causing for Windows 8 instance to repair state ...CLOUDSTACK-6694 [UI]while assigning VM to internal LB(VPC),ListVMs is not listing VM nic primary...CLOUDSTACK-6696 UI: createAccount under sub-domain is created with ROOT domain id...CLOUDSTACK-6698 listResourceDetals - normal user able to list details not belonging to it...CLOUDSTACK-6707 [SDN] OVS bridge/tunnel ports are not getting deleted from Host even though ther...CLOUDSTACK-6713 NumberFormatException for NetworkUsage command...CLOUDSTACK-6717 [OVS][UI]VPC network creation page does not display custom network offering crea...CLOUDSTACK-6718 [OVS][UI] Isolated network offering (non-vpc) creation page shows ovs as the ser...CLOUDSTACK-6725 [OVS][UI] vm deployment wizard does not show all available zones in a region whi...

Continued on next page

81

Page 86: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 13.1 – continued from previous pageBug ID DescriptionCLOUDSTACK-6748 Creating an instance with user-data when network doesn’t support user-data shoul...CLOUDSTACK-6762 [OVS]Flow rules to drop Broadcast/Multicast traffic on tunnel ports are not adde...CLOUDSTACK-6783 ceph: Volume operations can fail if libvirt lost the storage pool...CLOUDSTACK-6796 [OVS]Failure in network update does not change network offering to original offe...CLOUDSTACK-6797 volume resize should not be allowed for detached volumes...CLOUDSTACK-6803 UI:QuickView: Unable to render Quick view overlay on VM snapshots...CLOUDSTACK-6809 listStoragePoolsForMigration doesn’t list the zone wide primary storages if the ...CLOUDSTACK-6821 Disk allocated for primary storage remain unchanged after volume deletion ...CLOUDSTACK-6827 Can’t enable VR service provider in case of multiple physical networks...CLOUDSTACK-6828 [OVS] Tunnel ports are not getting deleted even failure in vm deployment...CLOUDSTACK-6838 Add test cases for download url expiration functionality...CLOUDSTACK-6840 [OVS][UI] Ovs provider should not be displayed in NetworkServiceProviders if the...CLOUDSTACK-6841 [OVS] Remote_ips for tunnel ports are not configured properly in case of multipe...CLOUDSTACK-6882 Doc generator should be generate doc for plugins ...CLOUDSTACK-6892 Database HA Config prevents mgmt server from starting...CLOUDSTACK-6898 [Hyper-V] Open the console of a VM from CS, reboot the VM ( from CS or from insi...CLOUDSTACK-6905 NPE XenServerGuru.java:95 when remove the nic from the vm in Stopped state...CLOUDSTACK-6910 Phase 1: tagging of test cases...CLOUDSTACK-6928 IOPS throttling setting isn’t applied to a dinamically attached volume...CLOUDSTACK-6990 VM console displays blank page.AgentControlChannelException in cloud.log...CLOUDSTACK-7011 [Automation] MS log getting created with owner root instead of cloud, and logs n...CLOUDSTACK-7049 APIs return sensitive information which CloudStack does not manage and which cal...CLOUDSTACK-7078 CLONE - [VMWARE]System VM’s are failed to start with Nexus enabled Zone ...CLOUDSTACK-7129 Non-admin user can use deleteNetwork with shared networks...CLOUDSTACK-77 console proxy display issues...CLOUDSTACK-107 Network domain guest suffix is not getting programmed as part of hostnames on Gu...CLOUDSTACK-237 StopVMCommand reported success in spite of failing to stop a VM which got stuck ...CLOUDSTACK-238 vpn:fail to connect to vpnserver using non-sourceNAT IP...CLOUDSTACK-252 UpdateNetwork Operation on a guest network that is currently using Virtual Route...CLOUDSTACK-255 Null pointer exception while creating portforwarding rule after performing Updat...CLOUDSTACK-317 get xcp 1.5 into an advanced network zone...CLOUDSTACK-375 Unable to delete physical network - because there are other networks attached...CLOUDSTACK-992 Template creations dies after 2h for no reason...CLOUDSTACK-1007 Not able to delete Shared network because of not being able to stop the router....CLOUDSTACK-1091 Fix API server’s parsing mechanism for POST requests...CLOUDSTACK-1092 Fix API Server’s parsing mechanism to parse GET request as multimap...CLOUDSTACK-1309 Large guest subnets downgrade performance...CLOUDSTACK-1389 Interactive Password Prompts during Management Server Startup...CLOUDSTACK-1413 Need something to concretely identify the version of the code in a particular bu...CLOUDSTACK-1527 Non-fatal POSTIN scriptlet failure in rpm package cloudstack-management-4.2.0-SN...CLOUDSTACK-1717 AWS Regions - Local region entry that gets added by default should not include ”...CLOUDSTACK-1885 Broken testcases in 4.1...CLOUDSTACK-1990 Docs: Update “Choosing a Hypervisor” feature matrix with new info...CLOUDSTACK-2004 IPV6 - UI - Router details page - NICs tab - Guest traffic type does not displa...CLOUDSTACK-2009 IPV6 - listNetwork() command does not return ip6dns1 and ip6dns2 entries....CLOUDSTACK-2022 IPV6 - ListRouter() should return guestip6address parameter similar to guestaddr...CLOUDSTACK-2023 IPV6 - Dashboard View - System wide Capacity for Shared Network IPs does not inc...CLOUDSTACK-2026 IPV6 - UI - Provide the ability to turn off all the IPV6 parameters by using a g...CLOUDSTACK-2099 Not able to add a host after a failed attempt to add the host to a wrong cluster...CLOUDSTACK-2112 VM went in stopped state after live migration failed while vmscaleup...CLOUDSTACK-2191 sanity tests for “EIP : Optional public IP” changes ...

Continued on next page

82 Chapter 13. Known Issues in 4.4.0

Page 87: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 13.1 – continued from previous pageBug ID DescriptionCLOUDSTACK-2291 [BasicZone-XenServer] NPE while trying DeleteNetworkCmd...CLOUDSTACK-2293 [BasicZone-XenServer] DeletePhysicalNetworkCmd is not deleting the external devi...CLOUDSTACK-2412 [UI]Disable CiscoVnmc provider for PF/SourceNat/StaticNAT/Firewall dropdown list...CLOUDSTACK-2418 [GSLB] NPE while removing the GSLB enabled Netscaler device...CLOUDSTACK-2471 test_host_high_availability.py refers to non-existent library method wait_for_vm...CLOUDSTACK-2501 Scalevm - Need to take care of upgraded vms...CLOUDSTACK-2790 AWSAPI: packaging includes all .class files bloating size of the RPM...CLOUDSTACK-2795 Create template failed...CLOUDSTACK-2845 [DB upgrade] [ExternalLoadBalancer NetworkUsage] Duplicate entries in the databa...CLOUDSTACK-2853 Cloudstack copies xenserver scripts while adding host even the server is KVM hos...CLOUDSTACK-2860 Add new host into VMWare Cluster failed...CLOUDSTACK-2910 SC: Ctrl combinated with >. is not working of SC IME...CLOUDSTACK-2911 KO: Key translation fails for KO keyboard Right Alt, Han/Eng, Hanja keys...CLOUDSTACK-2919 Snapshot cannot be saved to full Secondary Storage, but doesn’t utilize other Se...CLOUDSTACK-3066 No Error message is popped up on UI when a dedicated resource is dedicated to an...CLOUDSTACK-3095 [UI][API]Able to add multiple tier networks to a deployed VM using “Add network”...CLOUDSTACK-3111 [UI] Storage tab is not showing the Hypervisor column as ‘KVM’ if the (root/data...CLOUDSTACK-3186 Duplicate entries in /etc/hosts file on VR after reboot...CLOUDSTACK-3195 cannot view/delete forward rules if underlying/target VM is destroyed first...CLOUDSTACK-3197 UI: NTier: User is required to scroll down every single time to “Create Network”...CLOUDSTACK-3212 [Advanced_With_SG]View IP Address Range in Default Guest Network page does not s...CLOUDSTACK-3338 Please provide an icon for “assignVMs” action in internal LB rule detailView...CLOUDSTACK-3518 G11n: JA,SC: Un translation issue occurred on the strings of different UI Specif...CLOUDSTACK-3519 G11n: JA,SC: Un translation issue occurred on the strings of different dropdown ...CLOUDSTACK-3520 G11n: JA,SC: Un translation issue occurred on the strings of different error/war...CLOUDSTACK-3521 G11n: JA,SC: Un translation issue occurred on the strings of different tooltips....CLOUDSTACK-3522 G11n: JA,SC: Un translation issue occurred on the strings of different buttons. ...CLOUDSTACK-3523 G11n: JA,SC: Un translation issue occurred on the strings of different popup mes...CLOUDSTACK-3528 [UI]list calls are in the processing state forever with invalid name provided wi...CLOUDSTACK-3579 [DOC]CLONE - Physical Netwok traffic label update requires Management Server res...CLOUDSTACK-3607 “guest_os_hypervisor” table has values that are not registered in “guest_os” tab...CLOUDSTACK-3608 “guest_os_hypervisor” table has repeated mappings of hypervisor and guest OS...CLOUDSTACK-3656 lots of cloud-management should be changed to cloudstack-management...CLOUDSTACK-3788 [KVM] Weekly Snapshot got stuck in “Allocated State”...CLOUDSTACK-3813 “Service.provider.create” event doesnt mention about the Service Provider in the...CLOUDSTACK-3880 /sbin/poweroff et al or ACPID initiated shutdown does not stop cloudstack-[usage...CLOUDSTACK-3885 CLONE - Volume Donwload URLs should expire - functionality missing...CLOUDSTACK-3952 Persist VR nic details in DB for additional public ranges...CLOUDSTACK-3973 [GSLB] [LOGS Message] Improving logs messages for GSLB rule configuration...CLOUDSTACK-4016 [PortableIP] [VPC] listPublicIpAddresses lists the portable IP that was already ...CLOUDSTACK-4139 [VMWARE]Failed to resize the volumes which are created from snapshot of root vol...CLOUDSTACK-4247 [VMWARE]Network read/write statistics is zero always...CLOUDSTACK-4475 [ZWPS] attaching an uploaded volume to a VM is always going to first primary sto...CLOUDSTACK-4517 [upgrade][Vmware]Deployment of VM using centos 6.2 template registered before up...CLOUDSTACK-4536 [object_store_refactor] Inconsistency in volume store location on secondary stor...CLOUDSTACK-4587 VM is failing to deploy on a Legacy zone after adding zone wide primary storage ...CLOUDSTACK-4593 [VMWARE] [Upgrade]Livestorage Migration & VM Snapshot features are not fully fu...CLOUDSTACK-4644 Tool Tip information is not provided for the new fields which are added in 4.2 (...CLOUDSTACK-4789 Fix ResourceMetaDataManagerTest...CLOUDSTACK-4987 Able to add isolated network belonging to an account to a virtual machine belong...CLOUDSTACK-5044 Configuration Framework Issue...

Continued on next page

83

Page 88: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 13.1 – continued from previous pageBug ID DescriptionCLOUDSTACK-5090 Anti-Affinity: VM fails to start on a cluster belonging to a different pod....CLOUDSTACK-5243 SSVM responds with timestamp...CLOUDSTACK-5296 Add certificate chain support for NS...CLOUDSTACK-5307 Same router is listed twice in router view of project...CLOUDSTACK-5324 error message not proper when start VM fails because router reuires upgrade...CLOUDSTACK-5359 Failed to add second VMWARE cluster on a standard vSwitch enabled zone when vCen...CLOUDSTACK-5395 When backup snapshot fails becasue of backup.snapshot.wait time exceeding , the ...CLOUDSTACK-5446 KVM-Secondary Store down-Even after secondary store is brought back up after bei...CLOUDSTACK-5474 EventBus: RabbitMQ provider expects password to be stored in plain text....CLOUDSTACK-5475 cluster.cpu/(memory).allocated.capacity.disablethreshold is getting displayed mu...CLOUDSTACK-5482 Vmware - When nfs was down for about 1 hour , when snapshots were in progress , ...CLOUDSTACK-5504 Vmware-Primary store unavailable for 10 mts - All snapshot tasks reported failur...CLOUDSTACK-5512 template format name checking is crude and doesn’t work with advanced URLs...CLOUDSTACK-5536 Restarting cloudstack service with template download in progress creates redunda...CLOUDSTACK-5550 UI - Api key and secret key not fully visible in user detail view....CLOUDSTACK-5576 RemoteVPNonVPC : Label needs to be changed to “Enable Remote Access VPN”...CLOUDSTACK-5583 vmopsSnapshot plug-in (XenServer) does not return an error when it should...CLOUDSTACK-5600 Xenserver - After HA , CPVM’s disk is corrupted resulting in CPVM being stuck in...CLOUDSTACK-5616 [DBHA]:There is no way to know to which DB is the CS writing in the case of DBHA...CLOUDSTACK-5673 [Hyper-V] Default IP address never configured on eth0 with default CentOS templa...CLOUDSTACK-5700 [Vmsync] - kvm- “paused” state of Vm is not synced to CS....CLOUDSTACK-5719 [UI] Not listing shared network offerings tagged on second physical network...CLOUDSTACK-5724 Console Proxy View - when using ctl c , errors seen on the console proxy view....CLOUDSTACK-5744 [Hyper-v] White screen on console window when more than two console sessions are...CLOUDSTACK-5753 [Hyper-v] ConsoleProxyLoadReportCommand does not honor the default value of cons...CLOUDSTACK-5762 [dynamic compute offerings]UI change required for select compute offerinngs in ...CLOUDSTACK-5794 [Hyper-v] Specify username and domain name together in the username field while ...CLOUDSTACK-5798 While attaching a disk to WIN2012 VM with xencenter tools installed got error as...CLOUDSTACK-5800 While creating a VM from template (which is created based on existing newly crea...CLOUDSTACK-5807 Problem with shared datastore in VMware cluster with only one host...CLOUDSTACK-5809 Not able to deploy Vm becasue of crossing pool.storage.allocate d.capacity.disab...CLOUDSTACK-5832 Separate remote access VPN service from site 2 site vpn Service...CLOUDSTACK-5834 [upgrade]Error while collecting disk stats from : You gave an invalid object ref...CLOUDSTACK-5836 When tried to reverting back to (disk attached)quiesced vm snapshot, got error a...CLOUDSTACK-5843 registering templates/isos should be either async or changed to non-blocking...CLOUDSTACK-5847 [Hyper-V] [doc] Document creation of external vswitch for Hyper-V 2012 R2 (unlik...CLOUDSTACK-5879 Document on how to use RabbitMq event bus with spring modularisation done in 4.3...CLOUDSTACK-5883 unable to copy vmware routing template to primary storage...CLOUDSTACK-5910 mark the LDAP user as imported from LDAP...CLOUDSTACK-5972 [DOC] Service monitoring enable/disable from global setting...CLOUDSTACK-5975 Validate ICMP protocol type and codes in API layer...CLOUDSTACK-5991 [UI]Infinite scrolling should be enabled to the Ldap user add page...CLOUDSTACK-5992 [Upgrade] default values of configuraiton parameters in configuration table are ...CLOUDSTACK-5999 Virtual Router does not start if Guest VM is rebooted from CloudStack...CLOUDSTACK-6039 systemvm template for VMWare with jre7...CLOUDSTACK-6043 VMware detaching volume fails if volume has snapshots...CLOUDSTACK-6045 [GSoC] Create GUI to add primary storage based on plug-ins...CLOUDSTACK-6075 Increase the ram size for router service offering ...CLOUDSTACK-6096 Using eject on Windows will prevent attaching ISO to the instance...CLOUDSTACK-6101 Contrail:MS: Disable NAT on acquired IP results in exception...CLOUDSTACK-6128 Clean up over-permissive filesystem grants in Cloudstack...

Continued on next page

84 Chapter 13. Known Issues in 4.4.0

Page 89: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 13.1 – continued from previous pageBug ID DescriptionCLOUDSTACK-6148 UI for feature “Use Secondary IP Address of NIC in load balancing”...CLOUDSTACK-6169 assignVirtualMachine leaves associated tags assigned to old account...CLOUDSTACK-6213 Add new field to API @Parameter indicating if the param should be skipped from l...CLOUDSTACK-6220 Cloudstack agent fails to start due to broken init script...CLOUDSTACK-6225 resize volume fails on CentOS 6, Ubuntu 12.04...CLOUDSTACK-6228 Some action confirm dialogs show incorrect icon...CLOUDSTACK-6248 Improve getting alerts from VR to execute in parallel in case of multipleVRs...CLOUDSTACK-6274 Scope issue attaching a disk to a VM...CLOUDSTACK-6320 Upgrade 4.1.1 -> 4.3.0 OVS provider should be inserted to the physical network...CLOUDSTACK-6323 GetUser API always returns admin info...CLOUDSTACK-6403 ListApi Responses does not have “count” parameter and response arrays defined as...CLOUDSTACK-6414 [UI] UI is not allowing to create DomainAdmin User (ReferenceError: rootDomainId...CLOUDSTACK-6417 Adding the KVM host to management server is failing...CLOUDSTACK-6420 Network implement: use network stateMachine instead of explicitly setting the st...CLOUDSTACK-6426 Event Bus no longer receives events for AsyncJobs...CLOUDSTACK-6448 VPC router won’t be created when a private gateway is defined. ...CLOUDSTACK-6460 Migration of CLVM volumes to another primary storage fail...CLOUDSTACK-6473 Debian 7 Virtual Router ip_conntrack_max not set at boot...CLOUDSTACK-6485 [vpc] new private gateway network is registered wrong in network table...CLOUDSTACK-6486 Isolation network creation fails when isolationMethod is set in lower case for t...CLOUDSTACK-6495 JSVC package dependancy failures during installation of Cloudstack Agent on RHE...CLOUDSTACK-6514 VMware: Is space allocated for snapshots counted correctly?...CLOUDSTACK-6515 VMware: Only updating chain_info in volumes table when VM is started...CLOUDSTACK-6562 [Automation] [XenServer] Secondary Storage count for account shows double the va...CLOUDSTACK-6591 AddNetworkOffering Page gives DB Exception while executing listServiceOfferings ...CLOUDSTACK-6623 Register template does not work as expected, when deploying simulator and xen zo...CLOUDSTACK-6634 DOC: update the ldap section of the admin guide...CLOUDSTACK-6650 Reorder Cluster list in deployment planner to protect GPU enabled hosts from non...CLOUDSTACK-6670 A lot of “IAMServiceImpl] (main:null) Invalidate IAM cache” message in log until...CLOUDSTACK-6690 ListView while assigning VM to internal LB rule in VPC is not valid....CLOUDSTACK-6705 [SDN] VNI range is not allowing more than 2147483647 as a maximum vnet range...CLOUDSTACK-6716 /usr has been sized to small and ends up being 100% full on SSVM and CVM...CLOUDSTACK-6719 OVS:VPC:UI wizard allowing to add non OVS enabled network to distributed VPC...CLOUDSTACK-6722 [OVS][UI] Network created with StretchedL2Subnet is not available for vm deploye...CLOUDSTACK-6724 Generate only alert message in MS for an iteration in router vm ...CLOUDSTACK-6765 unable to create primary storage...CLOUDSTACK-6787 Event Bus - Publishing uuids missing in some cases...CLOUDSTACK-6811 Allocated capacity is greater than the total capacity for primary storage with o...CLOUDSTACK-6812 For storage type which does not support over provisioning ,over provisioning fac...CLOUDSTACK-6815 CallContext contains incorrect UUID for Account...CLOUDSTACK-6826 Ability to gracefully expire urls and clean them up when ssvm is destroyed...CLOUDSTACK-6829 [UI]If no storage is available for migrate volume UI should popup “no storage av...CLOUDSTACK-6851 ResourceTagResponse does not have “id” field due to which resource level permiss...CLOUDSTACK-6860 DataCenter creation is failing in DevCloud in 4.4,errors out with failing to ini...CLOUDSTACK-6866 First Class object hiding feature is not working for VirtualMachine and Networks...CLOUDSTACK-6870 getDomainId implementation returns invalid value at places...CLOUDSTACK-6874 automation test failures....CLOUDSTACK-6881 MS:IPv4 Incorrect IPv4 address as iptonetworklist param raises insufficient addr...CLOUDSTACK-6891 [Automation] - port 8096 is being used when executing the suite when admin’s key...CLOUDSTACK-6900 If we download a volume and then migrate the same volume, then migration fails....CLOUDSTACK-6909 Marvin fails to handle SMB credentials in deployDataCenter...

Continued on next page

85

Page 90: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 13.1 – continued from previous pageBug ID DescriptionCLOUDSTACK-6924 Exceptions are thrown when a data disk on local storage is attached/migrated to ...CLOUDSTACK-6927 Security group python script has several issues...CLOUDSTACK-6933 [Automation] Registering an iso fails in KVM deployment....CLOUDSTACK-6937 IAM - ROOT admin - Not able to list network owned by accounts under any domain b...CLOUDSTACK-6939 IAM - DomainAdmin - Not able to listNetwork belonging to a subdomain by passing ...CLOUDSTACK-6952 Building from Source Doc needs updating...CLOUDSTACK-6969 Data Volume Shrink operation failing with “Unexpected Exception”...CLOUDSTACK-6973 IAM - listNetworks - When Domain Admin calls listNetwork with listall=false , is...CLOUDSTACK-6974 IAM-Root Admin - When listNetwork is used with listall=false (or no listall pass...CLOUDSTACK-6991 VM does not get expunged even after waiting for 10 times the expunge interval ti...CLOUDSTACK-7004 [Automation] [KVM] Deploying a VM with rootdisksize less than the size of templa...CLOUDSTACK-7088 Snapshot manager should search for guest OS including deleted...CLOUDSTACK-7093 GPU enabled VMs are always showing xen-tools as installed even though if tools a...CLOUDSTACK-7094 Update PV-tools in all the VMs in case of xenserver upgrade to avoid PV-tools er...CLOUDSTACK-7153 addNicToVirtualMachine not BaseAsyncCreate but creates an entity...CLOUDSTACK-124 NetworkGarbageCollector not cleaning up networks...CLOUDSTACK-231 Tag creation using special charecters ...CLOUDSTACK-245 VPC ACLs are not stored and programmed consistently...CLOUDSTACK-270 Ui should not ask for a vlan range if the physical network isolation type is not...CLOUDSTACK-300 Creation of compute offering allow combination of local storage + HA...CLOUDSTACK-310 Failed to add host - Plugin error...CLOUDSTACK-315 Infrastructure view does not show capacity values...CLOUDSTACK-338 Unique Names of Disk and Service Offerings in the database are prefixed with “Cl...CLOUDSTACK-458 xen:snapshots:Storage gc fail to clean the failed snapshot images from secondary...CLOUDSTACK-963 [cloud.utils.AnnotationHelper] class java.lang.Stringdoes not have a Table anno...CLOUDSTACK-969 api: zone response lists vlan in it as “vlan range of zone” but the vlan belongs...CLOUDSTACK-1302 Add per storage setting for cache=”none/writeback/writethrough” options for VMs ...CLOUDSTACK-1306 Better Error message when trying to deploy Vm by passing static Ipv4 addresses t...CLOUDSTACK-1432 [UI] Inconsistent field names in “Add Cluster” dialog...CLOUDSTACK-1471 Pop up window for host details/(host related operation) are not properly alligne...CLOUDSTACK-1524 “White-box” effect changes when changing value in combo box...CLOUDSTACK-1932 AutoScale UI documentation doesn’t mention the option appears only for NetScaler...CLOUDSTACK-2213 russian language select failure...CLOUDSTACK-2345 [GSLB] deleting GSLB rules is not cleaning server info from GSLB device...CLOUDSTACK-2436 Message “You do not have any affinity groups. Please continue to the next step.”...CLOUDSTACK-2439 “Domain” field under login page should be mandatory for the non root accounts....CLOUDSTACK-2449 Dropdown menu for action button scaleup System VM shows all service offering inc...CLOUDSTACK-2453 Select view dropdown under “Network” is listing the options in the absence of ad...CLOUDSTACK-2464 [GSLB][UI] “Add GSLB” wizard doesn’t prompt for “PersistenceType”...CLOUDSTACK-2533 Add Network to VM dialog should only show those network in the dropdown which ar...CLOUDSTACK-2535 Cleanup port-profiles that gets created on Nexus switch as part of network clean...CLOUDSTACK-2559 [UI]Resource Name should not be present in UI as it is not available in listASA1...CLOUDSTACK-2605 Add Network to VM Command button should not be displayed for VMs belonging to B...CLOUDSTACK-2951 [UI][Mixed-Zone-Management] during “add Instance” wizard, listTemplates API is n...CLOUDSTACK-2993 [PortableIPRange] remove some of the unused columns if they are not required fro...CLOUDSTACK-3025 The page and pagesize parameters are not working in ListCfgsByCmds with zoneid s...CLOUDSTACK-3063 [UI]Dedicating a host to non-root domain which has instances of other domain(ro...CLOUDSTACK-3101 [DR] list* APIs are not working based on the display* flags ...CLOUDSTACK-3225 Multiple NPEs when cloudstack-management service is restarted with incomplete ta...CLOUDSTACK-3265 [Health Check for NS LB]Failure to create a lb health check policy returns a API...CLOUDSTACK-3325 [UI] [GSLB]: add text box to specify weight for each load balancer participating...

Continued on next page

86 Chapter 13. Known Issues in 4.4.0

Page 91: CloudStack Release Notes Documentation - Read the … · CloudStack Release Notes Documentation, Release 4.4.0 1.7Virtual Router Service Failure Alerting Send failure alerts to management

CloudStack Release Notes Documentation, Release 4.4.0

Table 13.1 – continued from previous pageBug ID DescriptionCLOUDSTACK-3406 UI: ZWPS: Zone wizard: Primary storage creation failed after “fix error” in “add...CLOUDSTACK-3477 resizeDataVolume doesn’t return proper error message when trying to shrink volum...CLOUDSTACK-3553 [UI]UI remains in the processing state forever when it failed to delete primary ...CLOUDSTACK-3671 Set Host, Management Network and Storage Network Properly when there are multipl...CLOUDSTACK-3815 “SNAPSHOT.CREATE” event’s states are not registered on the events table ...CLOUDSTACK-3895 VM Migration across VMWARE clusters which are added with different switches(Stan...CLOUDSTACK-3896 [PrimaryStorage] deleteStoragePool is not kicking GC for the downloaded system v...CLOUDSTACK-3995 No error notification is generated when Primary storage (Zonelevel) is added wit...CLOUDSTACK-4071 [UI] - Word ‘Default’ is misspelled in descripiton of integration.api.port under...CLOUDSTACK-4183 [Non-Contiguous VLAN] Typos Appear in an Error Message...CLOUDSTACK-4770 Management server fails to start with “Unable to get the management server node”...CLOUDSTACK-5033 ipaddress in management-server.log and api.log are wrong if management servers i...CLOUDSTACK-5309 version number and requires upgrade fields are not displayed for routers when na...CLOUDSTACK-5524 [UI]”root disk size” field should be removed from the add instance wizard since ...CLOUDSTACK-5885 When process receives error, loading overlay on listView element does not disapp...CLOUDSTACK-6265 Recover/restore VM actions: Fix icon, label, and confirmation dialog...CLOUDSTACK-6412 [UI]Incorrect Field value added with host details page(Dedicated label.no)...CLOUDSTACK-6534 Have to click in field to access VMware properties...CLOUDSTACK-6576 No Error Handling while deploying GPU unsupported instances on a GPU enabled hos...CLOUDSTACK-6666 UI search for vm’s in port forward rules field does not work...CLOUDSTACK-6772 [UI]need to change popup message fo Attach volume failure “Unexpected exceptio...CLOUDSTACK-7038 MySQL Client RPMs not a dependency in CS Packages...CLOUDSTACK-5522 Need of one more column i.e., “Name” at Home>Storage - Snapshots...CLOUDSTACK-6552 Cloudstack-Management install package creates log directory that is never used...CLOUDSTACK-6837 Template order changes are not permanent...

87


Recommended