diff --git a/docs/en-US/Release_Notes.xml b/docs/en-US/Release_Notes.xml
index 97f776bd18b..96cf6e63b39 100644
--- a/docs/en-US/Release_Notes.xml
+++ b/docs/en-US/Release_Notes.xml
@@ -55,836 +55,848 @@ under the License.
If you find any errors or problems in this guide, please see .
We hope you enjoy working with &PRODUCT;!
-
- What's New in 4.2
- &PRODUCT; 4.2 includes the following new features.
-
- Features to Support Heterogeneous Workloads
- The following new features help &PRODUCT; 4.2 better support both legacy and cloud-era
- style zones.
-
- Regions
- To increase reliability of the cloud, you can optionally group resources into
- geographic regions. A region is the largest available organizational unit within a cloud
- deployment. A region is made up of several availability zones, where each zone is
- equivalent to a datacenter. Each region is controlled by its own cluster of Management
- Servers, running in one of the zones. The zones in a region are typically located in close
- geographical proximity. Regions are a useful technique for providing fault tolerance and
- disaster recovery.
- By grouping zones into regions, the cloud can achieve higher availability and
- scalability. User accounts can span regions, so that users can deploy VMs in multiple,
- widely-dispersed regions. Even if one of the regions becomes unavailable, the services are
- still available to the end-user through VMs deployed in another region. And by grouping
- communities of zones under their own nearby Management Servers, the latency of
- communications within the cloud is reduced compared to managing widely-dispersed zones
- from a single central Management Server.
- Usage records can also be consolidated and tracked at the region level, creating
- reports or invoices for each geographic region.
+
+ Version 4.2.0
+
+ &PRODUCT; 4.2 includes the following new features.
+
+ Features to Support Heterogeneous Workloads
+ The following new features help &PRODUCT; 4.2 better support both legacy and cloud-era
+ style zones.
+
+ Regions
+ To increase reliability of the cloud, you can optionally group resources into
+ geographic regions. A region is the largest available organizational unit within a cloud
+ deployment. A region is made up of several availability zones, where each zone is
+ equivalent to a datacenter. Each region is controlled by its own cluster of Management
+ Servers, running in one of the zones. The zones in a region are typically located in
+ close geographical proximity. Regions are a useful technique for providing fault
+ tolerance and disaster recovery.
+ By grouping zones into regions, the cloud can achieve higher availability and
+ scalability. User accounts can span regions, so that users can deploy VMs in multiple,
+ widely-dispersed regions. Even if one of the regions becomes unavailable, the services
+ are still available to the end-user through VMs deployed in another region. And by
+ grouping communities of zones under their own nearby Management Servers, the latency of
+ communications within the cloud is reduced compared to managing widely-dispersed zones
+ from a single central Management Server.
+ Usage records can also be consolidated and tracked at the region level, creating
+ reports or invoices for each geographic region.
+
+
+
+
+
+ region-overview.png: Nested structure of a region.
+
+
+
+
+ Object Storage Plugin Architecture
+ Artifacts such as templates, ISOs and snapshots are kept in storage which &PRODUCT;
+ refers to as secondary storage. To improve scalability and performance, as when a number
+ of hosts access secondary storage concurrently, object storage can be used for secondary
+ storage. Object storage can also provide built-in high availability capability. When
+ using object storage, access to secondary storage data can be made available across
+ multiple zones in a region. This is a huge benefit, as it is no longer necessary to copy
+ templates, snapshots etc. across zones as would be needed in an NFS-only
+ environment.
+ Object storage is provided through third-party software such as Amazon Simple
+ Storage Service (S3) or any other object storage that supports the S3 interface. These
+ third party object storages can be integrated with &PRODUCT; by writing plugin software
+ that uses the object storage plugin capability introduced in &PRODUCT; 4.2. Several new
+ pluggable service interfaces are available so that different storage providers can
+ develop vendor-specific plugins based on the well-defined contracts that can be
+ seemlessly managed by &PRODUCT;.
+
+
+ Zone-Wide Primary Storage
+ (Supported on KVM and VMware)
+ In &PRODUCT; 4.2, you can provision primary storage on a per-zone basis. Data
+ volumes in the primary storage can be attached to any VM on any host in the zone.
+ In previous &PRODUCT; versions, each cluster had its own primary storage. Data in
+ the primary storage was directly available only to VMs within that cluster. If a VM in a
+ different cluster needed some of the data, it must be copied from one cluster to
+ another, using the zone's secondary storage as an intermediate step. This operation was
+ unnecessarily time-consuming.
+
+
+ VMware Datacenter Now Visible As a &PRODUCT; Zone
+ In order to support zone-wide functions for VMware, changes have been made so that
+ &PRODUCT; is now aware of VMware Datacenters and can map each Datacenter to a &PRODUCT;
+ zone. Previously, &PRODUCT; was only aware of VMware Clusters, a smaller organizational
+ unit than Datacenters. This implies that a single &PRODUCT; zone could possibly contain
+ clusters from different VMware Datacenters. In order for zone-wide functions, such as
+ zone-wide primary storage, to work for VMware hosts, &PRODUCT; has to make sure that a
+ zone contains only a single VMware Datacenter. Therefore, when you are creating a new
+ &PRODUCT; zone, you will now be able to select a VMware Datacenter for the zone. If you
+ are provisioning multiple VMware Datacenters, each one will be set up as a single zone
+ in &PRODUCT;.
+
+ If you are upgrading from a previous &PRODUCT; version, and your existing
+ deployment contains a zone with clusters from multiple VMware Datacenters, that zone
+ will not be forcibly migrated to the new model. It will continue to function as
+ before. However, any new zone-wide operations, such as zone-wide primary storage, will
+ not be available in that zone.
+
+
+
+
+
+ Third-Party UI Plugin Framework
+ Using the new third-party plugin framework, you can write and install extensions to
+ &PRODUCT;. The installed and enabled plugins will appear in the UI alongside the
+ Citrix-provided features.
+ The basic procedure for adding a UI plugin is explained in the Developer Guide. In
+ summary, the plugin developer creates the plugin code itself (in Javascript), a thumbnail
+ image, the plugin listing, and a CSS file. The &PRODUCT; administrator adds the folder
+ containing the plugin code under the &PRODUCT; PLUGINS folder and adds the plugin name to
+ a configuration file (plugins.js).
+ The next time the user refreshes the UI in the browser, the plugin will appear under
+ the Plugins button in the left navigation bar.
-
+
- region-overview.png: Nested structure of a region.
+ plugin4.jpg: The plugin appears in the UI
-
- Object Storage Plugin Architecture
- Artifacts such as templates, ISOs and snapshots are kept in storage which &PRODUCT;
- refers to as secondary storage. To improve scalability and performance, as when a number
- of hosts access secondary storage concurrently, object storage can be used for secondary
- storage. Object storage can also provide built-in high availability capability. When using
- object storage, access to secondary storage data can be made available across multiple
- zones in a region. This is a huge benefit, as it is no longer necessary to copy templates,
- snapshots etc. across zones as would be needed in an NFS-only environment.
- Object storage is provided through third-party software such as Amazon Simple Storage
- Service (S3) or any other object storage that supports the S3 interface. These third party
- object storages can be integrated with &PRODUCT; by writing plugin software that uses the
- object storage plugin capability introduced in &PRODUCT; 4.2. Several new pluggable
- service interfaces are available so that different storage providers can develop
- vendor-specific plugins based on the well-defined contracts that can be seemlessly managed
- by &PRODUCT;.
-
-
- Zone-Wide Primary Storage
- (Supported on KVM and VMware)
- In &PRODUCT; 4.2, you can provision primary storage on a per-zone basis. Data volumes
- in the primary storage can be attached to any VM on any host in the zone.
- In previous &PRODUCT; versions, each cluster had its own primary storage. Data in the
- primary storage was directly available only to VMs within that cluster. If a VM in a
- different cluster needed some of the data, it must be copied from one cluster to another,
- using the zone's secondary storage as an intermediate step. This operation was
- unnecessarily time-consuming.
-
-
- VMware Datacenter Now Visible As a &PRODUCT; Zone
- In order to support zone-wide functions for VMware, changes have been made so that
- &PRODUCT; is now aware of VMware Datacenters and can map each Datacenter to a &PRODUCT;
- zone. Previously, &PRODUCT; was only aware of VMware Clusters, a smaller organizational
- unit than Datacenters. This implies that a single &PRODUCT; zone could possibly contain
- clusters from different VMware Datacenters. In order for zone-wide functions, such as
- zone-wide primary storage, to work for VMware hosts, &PRODUCT; has to make sure that a
- zone contains only a single VMware Datacenter. Therefore, when you are creating a new
- &PRODUCT; zone, you will now be able to select a VMware Datacenter for the zone. If you
- are provisioning multiple VMware Datacenters, each one will be set up as a single zone in
- &PRODUCT;.
-
- If you are upgrading from a previous &PRODUCT; version, and your existing deployment
- contains a zone with clusters from multiple VMware Datacenters, that zone will not be
- forcibly migrated to the new model. It will continue to function as before. However, any
- new zone-wide operations, such as zone-wide primary storage, will not be available in
- that zone.
-
-
-
-
-
- Third-Party UI Plugin Framework
- Using the new third-party plugin framework, you can write and install extensions to
- &PRODUCT;. The installed and enabled plugins will appear in the UI alongside the
- Citrix-provided features.
- The basic procedure for adding a UI plugin is explained in the Developer Guide. In
- summary, the plugin developer creates the plugin code itself (in Javascript), a thumbnail
- image, the plugin listing, and a CSS file. The &PRODUCT; administrator adds the folder
- containing the plugin code under the &PRODUCT; PLUGINS folder and adds the plugin name to a
- configuration file (plugins.js).
- The next time the user refreshes the UI in the browser, the plugin will appear under the
- Plugins button in the left navigation bar.
-
-
-
-
-
- plugin4.jpg: The plugin appears in the UI
-
-
-
-
- Networking Enhancements
- The following new features provide additional networking functionality in &PRODUCT;
- 4.2.
-
- IPv6 (Technical Preview)
- &PRODUCT; 4.2 introduces initial support for IPv6. This feature is provided as a
- technical preview only. Full support is planned for a future release.
-
-
- Portable IPs
- Portable IPs in &PRODUCT; are 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
- 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.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Support for KVM
- VPC is now supported on KVM hypervisors.
+
+ Networking Enhancements
+ The following new features provide additional networking functionality in &PRODUCT;
+ 4.2.
+
+ IPv6 (Technical Preview)
+ &PRODUCT; 4.2 introduces initial support for IPv6. This feature is provided as a
+ technical preview only. Full support is planned for a future release.
-
- Support for Simultaneously Deploying a VM on VPC and Multiple Shared
- Networks
- Support for the ability to simultaneously deploy a VM on a VPC tier and one or more
- Shared networks is supported.
+
+ Portable IPs
+ Portable IPs in &PRODUCT; are 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.
-
- Load Balancing Support for VPC
- In a VPC, you can configure two types of load balancing—external LB and
- internal LB. External LB is nothing but a LB rule created to redirect the traffic
- received at a public IP of the VPC virtual router. The traffic is load balanced within a
- tier based on your configuration. Citrix NetScaler and VPC virtual router are supported
- for external LB. When you use internal LB service, traffic received at a tier is load
- balanced across different VMs within that tier. For example, traffic reached at Web tier
- is redirected to another VM in that tier. External load balancing devices are not
- supported for internal LB. The service is provided by a internal LB VM configured on the
- target tier.
-
- Load Balancing Within a Tier (External LB)
- A &PRODUCT; user or administrator may create load balancing rules that balance
- traffic received at a public IP to one or more VMs that belong to a network tier that
- provides load balancing service in a VPC. A user creates a rule, specifies an
- algorithm, and assigns the rule to a set of VMs within a tier.
+
+ N-Tier Applications
+ 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.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Support for KVM
+ VPC is now supported on KVM hypervisors.
-
- Load Balancing Across Tiers
- &PRODUCT; supports sharing workload across different tiers within your VPC. Assume
- that multiple tiers are set up in your environment, such as Web tier and Application
- tier. Traffic to each tier is balanced on the VPC virtual router on the public side.
- If you want the traffic coming from the Web tier to the Application tier to be
- balanced, use the internal load balancing feature offered by &PRODUCT;.
+
+ Support for Simultaneously Deploying a VM on VPC and Multiple Shared
+ Networks
+ Support for the ability to simultaneously deploy a VM on a VPC tier and one or
+ more Shared networks is supported.
-
- Netscaler Support for VPC
- Citrix NetScaler is supported for external LB. Certified version for this feature
- is NetScaler 10.0 Build 74.4006.e.
+
+ Load Balancing Support for VPC
+ In a VPC, you can configure two types of load balancing—external LB and
+ internal LB. External LB is nothing but a LB rule created to redirect the traffic
+ received at a public IP of the VPC virtual router. The traffic is load balanced within
+ a tier based on your configuration. Citrix NetScaler and VPC virtual router are
+ supported for external LB. When you use internal LB service, traffic received at a
+ tier is load balanced across different VMs within that tier. For example, traffic
+ reached at Web tier is redirected to another VM in that tier. External load balancing
+ devices are not supported for internal LB. The service is provided by a internal LB VM
+ configured on the target tier.
+
+ Load Balancing Within a Tier (External LB)
+ A &PRODUCT; user or administrator may create load balancing rules that balance
+ traffic received at a public IP to one or more VMs that belong to a network tier
+ that provides load balancing service in a VPC. A user creates a rule, specifies an
+ algorithm, and assigns the rule to a set of VMs within a tier.
+
+
+ Load Balancing Across Tiers
+ &PRODUCT; supports sharing workload across different tiers within your VPC.
+ Assume that multiple tiers are set up in your environment, such as Web tier and
+ Application tier. Traffic to each tier is balanced on the VPC virtual router on the
+ public side. If you want the traffic coming from the Web tier to the Application
+ tier to be balanced, use the internal load balancing feature offered by
+ &PRODUCT;.
+
+
+ Netscaler Support for VPC
+ Citrix NetScaler is supported for external LB. Certified version for this
+ feature is NetScaler 10.0 Build 74.4006.e.
+
+
+
+
+ Deploying VMs to a VPC Tier and Shared Networks
+ &PRODUCT; allows you to deploy VMs on a VPC tier and one or more shared networks.
+ With this feature, the VMs deployed in a multi-tier application can receive services
+ offered by a service provider over the shared network. One example of such a service
+ is monitoring service.
+
+
+ Adding a Private Gateway to a VPC
+ A private gateway can be added by the root admin only. The VPC private network has
+ 1:1 relationship with the NIC of the physical network. You can configure multiple
+ private gateways to a single VPC. No gateways with duplicated VLAN and IP are allowed
+ in the same data center.
+
+ Source NAT on Private Gateway
+ You might want to deploy multiple VPCs with the same super CIDR and guest tier
+ CIDR. Therefore, multiple guest VMs from different VPCs can have the same IPs to
+ reach a enterprise data center through the private gateway. In such cases, a NAT
+ service need to be configured on the private gateway. If Source NAT is enabled, the
+ guest VMs in VPC reaches the enterprise network via private gateway IP address by
+ using the NAT service.
+ The Source NAT service on a private gateway can be enabled while adding the
+ private gateway. On deletion of a private gateway, source NAT rules specific to the
+ private gateway are deleted.
+
+
+ VPN Gateways
+ Support up to 8 VPN Gateways is added.
+
+
+ Creating a Static Route
+ &PRODUCT; enables you to specify routing for the VPN connection you create. You
+ can enter one or CIDR addresses to indicate which traffic is to be routed back to
+ the gateway.
+
+
+ Blacklisting Routes
+ &PRODUCT; enables you to block a list of routes so that they are not assigned to
+ any of the VPC private gateways. Specify the list of routes that you want to
+ blacklist in the blacklisted.routes global parameter. Note that the
+ parameter update affects only new static route creations. If you block an existing
+ static route, it remains intact and continue functioning. You cannot add a static
+ route if the route is blacklisted for the zone.
+
-