diff --git a/docs/en-US/Release_Notes.xml b/docs/en-US/Release_Notes.xml
index 290f19db8d3..f1a159c68d8 100644
--- a/docs/en-US/Release_Notes.xml
+++ b/docs/en-US/Release_Notes.xml
@@ -22,16 +22,32 @@ under the License.
- Welcome to &PRODUCT; 4.1
- Welcome to the 4.1.0 release of &PRODUCT;, the first major release from the Apache
- CloudStack project since its graduation from the Apache Incubator.
+ Welcome to &PRODUCT; 4.2
+ Welcome to the 4.2.0 release of &PRODUCT;, the second major release from the Apache
+ CloudStack project since its graduation from the Apache Incubator. &PRODUCT; 4.2 includes more
+ than 50 new features and enhancements. The focus of the release is on three major
+ areas:
+
+
+ Improved support for both legacy-style and cloud-style workloads
+
+
+ New third-party plug-in architecture
+
+
+ Networking enhancements
+
+
+ In addition to these major new areas of functionality, &PRODUCT; 4.2 provides many
+ additional enhancements in a variety of product areas. All of the new features are summarized
+ later in this Release Note.
This document contains information specific to this release of &PRODUCT;, including
upgrade instructions from prior releases, new features added to &PRODUCT;, API changes, and
issues fixed in the release. For installation instructions, please see the Installation Guide. For usage and administration instructions, please see the
&PRODUCT; Administrator's Guide. Developers and users who wish to work with the API
will find instruction in the If you find any errors or problems in this guide, please see .
We hope you enjoy working with &PRODUCT;!
+
+ Version 4.2.0
+
+ What’s New in 4.2
+ Apache CloudStack 4.2.0 includes many new features. This section covers the most
+ prominent new features and changes.
+
+ Windows 8 and Windows Server as VM Guest OS
+ Supported on XenServer, VMware, and KVM.
+ Windows 8 and Windows Server 2012 can now be used as OS types on guest virtual
+ machines. The OS would be made available the same as any other, by uploading an ISO or a
+ template. The instructions for uploading ISOs and templates are given in the
+ Administrator's Guide.
+
+ Limitation: When used with VMware hosts, this
+ feature works only for the following versions: vSphere ESXi 5.1 and ESXi 5.0 Patch
+ 4.
+
+
+
+ Portable IPs
+ CLOUDSTACK-3236:Portable IPs in &PRODUCT; are nothing but elastic IPs that can
+ be transferred across geographically separated zones. As an administrator, you can
+ provision a pool of portable IPs at region level and are available for user consumption.
+ The users can acquire portable IPs if admin has provisioned portable public IPs at the
+ region level they are part of. These IPs can be used for any service within an advanced
+ zone. You can also use portable IPs for EIP service in Basic zones. Additionally, a
+ portable IP can be transferred from one network to another network.
+
+
+ N-Tier Applications
+ CLOUDSTACK-770:In &PRODUCT; 3.0.6, a functionality was added to allow users to
+ create a multi-tier application connected to a single instance of a Virtual Router that
+ supports inter-VLAN routing. Such a multi-tier application is called a virtual private
+ cloud (VPC). Users were also able to connect their multi-tier applications to a private
+ Gateway or a Site-to-Site VPN tunnel and route certain traffic to those gateways. For
+ &PRODUCT; 4.2, additional features are implemented to enhance VPC applications.
+
+
+ Internal Load Balancing between VPC tiers
+
+
+ Source NAT and ACL support on private gateways
+
+
+ Multiple private gateway support
+
+
+ Support for ACL deny rules
+
+
+ ACL support on all layer 4 protocols
+
+
+ Support up to 8 VPN Gateways
+
+
+ Support for blacklisting routes
+
+
+ NetScaler support for VPC load balancing
+
+
+ Support for KVM hypervisor
+
+
+ Support for the ability to simultaneously deploy an instance on a VPC Tier and one
+ or more Shared Networks
+
+
+
+
+ Cisco VNMC Support
+ CLOUDSTACK-742:&PRODUCT; supports Cisco Virtual Network Management Center
+ (VNMC) on Cisco Nexus 1000v dvSwich-enabled VMware hypervisors. &PRODUCT; supports Cisco
+ ASA 1000v as an external Firewall provider when integrated with Cisco VNMC.
+ When Cisco VNMC is integrated with ASA 1000v Cloud Firewall and Cisco Nexus 1000v
+ dvSwitch in &PRODUCT; you will be able to:
+
+
+ Configure Cisco ASA 1000v Firewalls
+
+
+ Create and apply security profiles that contain ACL policy sets for both ingress
+ and egress traffic, connection timeout, NAT policy sets, and TCP intercept
+
+
+ Consider the following use cases before using this feature:
+
+
+ A Cloud administrator adds VNMC as a network element by using the admin API
+ addCiscoVnmcResource after specifying the credentials
+
+
+ A Cloud administrator adds ASA 1000v appliances by using the admin API
+ addCiscoAsa1000vResource. You can configure one per guest network.
+
+
+ A Cloud administrator creates an Isolated guest network offering by using ASA
+ 1000v as the service provider for Firewall, Source NAT, Port Forwarding, and Static
+ NAT.
+
+
+
+
+ VMware vNetwork Distributed vSwitch
+ CLOUDSTACK-772:&PRODUCT; 4.2 supports VMware vSphere Distributed Switch (VDS)
+ for virtual network configuration in a VMware vSphere environment. Each vCenter server
+ instance can support up to 128 VDSs and each VDS can manage up to 500 VMware hosts.
+
+ About VMware Distributed Virtual Switch
+ VMware VDS is an aggregation of host-level virtual switches on a VMware vCenter
+ server. VDS abstracts the configuration of individual virtual switches that span across
+ a large number of hosts, and enables centralized provisioning, administration, and
+ monitoring for your entire datacenter from a centralized interface. VDS is controlled as
+ a single distributed switch at the datacenter level. So there needed a component to
+ ensure that the network configurations on the source and the destination virtual switch
+ are consistent and will allow the VM to operate without breaking connectivity or network
+ policies. Particularly during migration of VM across hosts, the sync up among peers need
+ to be taken care. However in case of distributed vSwitch during VMotion, the vCenter
+ server, would update the vSwitch modules on the hosts in cluster accordingly.
+
+
+ Enabling Virtual Distributed Switch in &PRODUCT;
+ To make a &PRODUCT; deployment VDS enabled, set the vmware.use.dvswitch parameter to
+ true by using the Global Settings page in the &PRODUCT; UI and restart the Management
+ Server. Unless you enable the vmware.use.dvswitch parameter, you cannot see any UI
+ options specific to VDS, and &PRODUCT; ignores the VDS-specific parameters specified in
+ the AddCluster API call. Additionally, &PRODUCT; uses VDS for virtual network
+ infrastructure if the value of vmware.use.dvswitch parameter is true and the value of
+ vmware.use.nexus.dvswitch parameter is false.
+ &PRODUCT; supports configuring virtual networks in a deployment with a mix of
+ Virtual Distributed Switch, Standard Virtual Switch and Nexus 1000v Virtual Switch.
+
+
+
+
+ Health Checks for Load Balanced Instances
+
+ CLOUDSTACK-4243: This feature is supported only on NetScaler version 10.0 and
+ beyond. The Nitro API is not compatible with NetScaler 9.3 and therefore this version is
+ not supported for this feature.
+
+ CLOUDSTACK-816:(NetScaler load balancer only) A load balancer rule distributes
+ requests among a pool of services (a service in this context means an application running
+ on a virtual machine). When creating a load balancer rule, you can specify a health check
+ which will ensure that the rule forwards requests only to services that are healthy
+ (running and available). This is in addition to specifying the stickiness policy,
+ algorithm, and other load balancer rule options. You can configure one health check policy
+ per load balancer rule.
+ When a health check is in effect, the load balancer will stop forwarding requests to
+ any resources that it has found to be unhealthy. If the resource later becomes available
+ again, the periodic health check (periodicity is configurable) will discover it and the
+ resource will once again be added to the pool of resources that can receive requests from
+ the load balancer.
+ You can delete or modify existing health check policies.
+ To configure how often the health check is performed by default, use the global
+ configuration setting healthcheck.update.interval. This default applies to all the health
+ check policies in the cloud. You can override this value for an individual health check
+ policy.
+
+
+
+ Issues Fixed in 4.2.0
+ Apache CloudStack uses Jira to track its issues. All new features and bugs for 4.2.0 have been tracked
+ in Jira, and have a standard naming convention of "CLOUDSTACK-NNNN" where "NNNN" is the
+ issue number.
+ This section includes a summary of known issues against 4.0.0 that were fixed in 4.2.0.
+ Approximately 470 bugs were resolved or closed in the 4.2.0 cycle.
+
+
+
+
+
+
+
+ Defect
+
+
+ Description
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Known Issues in 4.2.0
+
+
+
+
+
+
+
+ Issue ID
+
+
+ Description
+
+
+
+
+
+ CLOUDSTACK-2709
+
+ Egress rules are are not supported on shared networks.
+
+
+
+ CLOUDSTACK-1747
+ mvn deploydb only creates 4.0 DB, not 4.2
+ Due to tooling changes between 4.2 and 4.2, CloudStack's database is created
+ using the 4.0 schema and updated to the 4.2 schema when the management server
+ starts for the first time. It's OK to see the same schema if the management server
+ has not started yet.
+
+
+
+
+ CLOUDSTACK-1306
+
+
+ Better Error message when trying to deploy Vm by passing static Ipv4 addresses
+ that are assigned to another VM/IP4 address is outside the iprange.
+
+
+
+
+ CLOUDSTACK-1236
+
+
+ Warning while adding Xen 6.1 host [Unable to create local link network]
+
+
+
+
+ CLOUDSTACK-969
+
+
+ api: zone response lists vlan in it as "vlan range of zone" but the
+ vlan belongs to physical network
+
+
+
+
+ CLOUDSTACK-963
+
+
+ [cloud.utils.AnnotationHelper] class java.lang.Stringdoes not have a Table
+ annotation
+
+
+
+
+ CLOUDSTACK-458
+
+
+ xen:snapshots:Storage gc fail to clean the failed snapshot images from
+ secondarystorage
+
+
+
+
+ CLOUDSTACK-315
+
+
+ Infrastructure view does not show capacity values
+
+
+
+
+ CLOUDSTACK-300
+
+
+ Creation of compute offering allow combination of local storage + HA
+
+
+
+
+ CLOUDSTACK-276
+
+
+ SSVM ID is exposed in the Error Message thrown by AddTrafficType API
+
+
+
+
+ CLOUDSTACK-270
+
+
+ Ui should not ask for a vlan range if the physical network isolation type is
+ not VLAN
+
+
+
+
+ CLOUDSTACK-245
+
+
+ VPC ACLs are not stored and programmed consistently
+
+
+
+
+ CLOUDSTACK-231
+
+
+ Tag creation using special charecters
+
+
+
+
+ CLOUDSTACK-124
+
+
+ NetworkGarbageCollector not cleaning up networks
+
+
+
+
+ CLOUDSTACK-62
+
+
+ console proxy does not support any keymaps besides us, jp
+
+
+
+
+
+
+
Version 4.1.0
@@ -350,19 +841,6 @@ under the License.
configuration settings. Note that api.throttling.enabled is set to
false by default.
-
- Windows 8 and Windows Server as VM Guest OS
- Supported on XenServer, VMware, and KVM.
- Windows 8 and Windows Server 2012 can now be used as OS types on guest virtual
- machines. The OS would be made available the same as any other, by uploading an ISO or a
- template. The instructions for uploading ISOs and templates are given in the
- Administrator's Guide.
-
- Limitation: When used with VMware hosts, this
- feature works only for the following versions: vSphere ESXi 5.1 and ESXi 5.0 Patch
- 4.
-
-
S3 Backed Secondary Storage
CLOUDSTACK-2709
+ >CLOUDSTACK-2709
Egress rules are are not supported on shared networks.
@@ -5606,8 +6084,8 @@ service cloudstack-agent start
$ sudo apt-get install cloudstack-management
- On KVM hosts, you will need to manually install the cloudstack-agent
- package:
+ 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,