From 1108aa7d4c7a512768ac494fb956afc3e5e84ce9 Mon Sep 17 00:00:00 2001 From: radhikap Date: Tue, 20 Aug 2013 13:42:03 +0530 Subject: [PATCH] added a new chapter for 4.2 --- docs/en-US/Release_Notes.xml | 520 +++++++++++++++++++++++++++++++++-- 1 file changed, 499 insertions(+), 21 deletions(-) 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,