You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by jz...@apache.org on 2013/04/05 17:24:30 UTC

[1/4] changes to the Release Notes and feedback section.

Updated Branches:
  refs/heads/4.1 fb8ea7570 -> 42a2d429a


http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7b77aff4/docs/publican-cloudstack/en-US/Feedback.xml
----------------------------------------------------------------------
diff --git a/docs/publican-cloudstack/en-US/Feedback.xml b/docs/publican-cloudstack/en-US/Feedback.xml
index fb457a9..8aa5f67 100644
--- a/docs/publican-cloudstack/en-US/Feedback.xml
+++ b/docs/publican-cloudstack/en-US/Feedback.xml
@@ -2,33 +2,43 @@
 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
 ]>
 <!-- Licensed to the Apache Software Foundation (ASF) under one
- or more contributor license agreements.  See the NOTICE file
- distributed with this work for additional information
- regarding copyright ownership.  The ASF licenses this file
- to you under the Apache License, Version 2.0 (the
- "License"); you may not use this file except in compliance
- with the License.  You may obtain a copy of the License at
- 
-   http://www.apache.org/licenses/LICENSE-2.0
- 
- Unless required by applicable law or agreed to in writing,
- software distributed under the License is distributed on an
- "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
- KIND, either express or implied.  See the License for the
- specific language governing permissions and limitations
- under the License.
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
 -->
 
-<section>
-    <title>We Need Feedback!</title>
-     <indexterm>
+<section id="feedback">
+    <title>Submitting Feedback and Getting Help</title>
+    <indexterm>
         <primary>feedback1</primary>
-         <secondary>contact information for this brand</secondary>
+        <secondary>contact information for this brand</secondary>
 
     </indexterm>
-     <para>If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a bug: <ulink url="https://issues.apache.org/jira/browse/CLOUDSTACK">https://issues.apache.org/jira/browse/CLOUDSTACK</ulink> against the component <application>Doc</application>.</para>
+    <para>If you find a typographical error in this manual, or if you have thought of a way to make this manual better, we would love to hear from you! Please submit a bug: <ulink url="https://issues.apache.org/jira/browse/CLOUDSTACK">https://issues.apache.org/jira/browse/CLOUDSTACK</ulink> against the component <application>Doc</application>.</para>
     <para>If you have a suggestion for improving the documentation, try to be as specific as possible when describing it. If you have found an error, please include the section number and some of the surrounding text so we can find it easily.</para>
-    <para>Better yet, feel free to submit a patch if you would like to enhance the documentation. Our documentation is, along with the rest of the CloudStack source code, kept in the project's git repository.</para>
+    <para>Better yet, feel free to submit a patch if you would like to enhance the documentation. Our documentation is, along with the rest of the &PRODUCT; source code, kept in the project's git repository.</para>
+    <para>The most efficient way to get help with &PRODUCT; is to ask on the mailing lists.</para>
+    <para>The Apache CloudStack project has mailing lists for users and developers. These are the
+        official channels of communication for the project and are the best way to get answers about
+        using and contributing to CloudStack. It's a good idea to subscribe to the
+        users@cloudstack.apache.org mailing list if you've deployed or are deploying
+        CloudStack into production, and even for test deployments.</para>
+    <para>The CloudStack developer's mailing list (dev@cloudstack.apache.org) is for discussions
+        about CloudStack development, and is the best list for discussing possible bugs in CloudStack.
+        Anyone contributing to CloudStack should be on this mailing list.</para>
+    <para>To posts to the lists, you'll need to be subscribed. See the
+        <ulink url="http://cloudstack.apache.org/mailing-lists.html">CloudStack Web site</ulink>
+        for instructions.</para>
 </section>
-
-


[4/4] git commit: updated refs/heads/4.1 to 42a2d42

Posted by jz...@apache.org.
Changes to release notes.


Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/42a2d429
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/42a2d429
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/42a2d429

Branch: refs/heads/4.1
Commit: 42a2d429ad5017df9e52ec4b16a148947e6a8c5a
Parents: 7b77aff fb8ea75
Author: Joe Brockmeier <jz...@zonker.net>
Authored: Fri Apr 5 10:24:07 2013 -0500
Committer: Joe Brockmeier <jz...@zonker.net>
Committed: Fri Apr 5 10:24:07 2013 -0500

----------------------------------------------------------------------
 packaging/centos63/cloud.spec          |    1 +
 packaging/debian/init/cloud-management |    3 +--
 2 files changed, 2 insertions(+), 2 deletions(-)
----------------------------------------------------------------------



[3/4] git commit: updated refs/heads/4.1 to 42a2d42

Posted by jz...@apache.org.
changes to the Release Notes and feedback section.


Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/7b77aff4
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/7b77aff4
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/7b77aff4

Branch: refs/heads/4.1
Commit: 7b77aff4539a6ba3bd09f245a665bb84504d2ee4
Parents: 76438b8
Author: Joe Brockmeier <jz...@zonker.net>
Authored: Fri Apr 5 10:23:30 2013 -0500
Committer: Joe Brockmeier <jz...@zonker.net>
Committed: Fri Apr 5 10:23:30 2013 -0500

----------------------------------------------------------------------
 docs/en-US/Book_Info_Release_Notes_4-0.xml  |    7 +-
 docs/en-US/Release_Notes.xml                | 2005 +---------------------
 docs/publican-cloudstack/en-US/Feedback.xml |   56 +-
 3 files changed, 103 insertions(+), 1965 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7b77aff4/docs/en-US/Book_Info_Release_Notes_4-0.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/Book_Info_Release_Notes_4-0.xml b/docs/en-US/Book_Info_Release_Notes_4-0.xml
index 0d57fb6..9655986 100644
--- a/docs/en-US/Book_Info_Release_Notes_4-0.xml
+++ b/docs/en-US/Book_Info_Release_Notes_4-0.xml
@@ -18,14 +18,13 @@
   specific language governing permissions and limitations
   under the License.
 -->
-<bookinfo id="book-release-notes-4.0">
-  <title>Version 4.0.0-incubating Release Notes</title>
-  <subtitle>Revised October 17, 2012 19:49 UTC</subtitle>
+<bookinfo id="book-release-notes-4.1">
+  <title>Version 4.1.0 Release Notes</title>
   <productname>Apache CloudStack</productname>
   <productnumber/>
   <pubsnumber/>
   <abstract>
-    <para>Release notes for the Apache CloudStack 4.0.0-incubating release.</para>
+    <para>Release notes for the Apache CloudStack 4.1.0 release.</para>
   </abstract>
   <corpauthor>
     <inlinemediaobject>


[2/4] changes to the Release Notes and feedback section.

Posted by jz...@apache.org.
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7b77aff4/docs/en-US/Release_Notes.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/Release_Notes.xml b/docs/en-US/Release_Notes.xml
index 45daaad..07ff60b 100644
--- a/docs/en-US/Release_Notes.xml
+++ b/docs/en-US/Release_Notes.xml
@@ -19,26 +19,36 @@
   under the License.
 -->
 <book>
-  <xi:include href="Book_Info_Release_Notes_4-0.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
-  <chapter id="submitting-feedback">
-    <title>Submitting Feedback and Getting Help</title>
-    <para>The Apache CloudStack project has mailing lists for users and developers. These are the
-      official channels of communication for the project and are the best way to get answers about
-      using and contributing to CloudStack. It's a good idea to subscribe to the 
-      users@cloudstack.apache.org mailing list if you've deployed or are deploying 
-      CloudStack into production, and even for test deployments.</para>
-  <para>The CloudStack developer's mailing list (dev@cloudstack.apache.org) is for discussions 
-      about CloudStack development, and is the best list for discussing possible bugs in CloudStack.
-      Anyone contributing to CloudStack should be on this mailing list.</para>
-  <para>You can also report bugs in CloudStack using the 
-      <ulink url="https://issues.apache.org/jira/secure/CreateIssue!default.jspa">Apache 
-          Defect Tracking System</ulink>.</para>
-  <para>To posts to the lists, you'll need to be subscribed. See the 
-      <ulink url="http://cloudstack.apache.org/mailing-lists.html">CloudStack Web site</ulink>
-      for instructions.</para>
+    <xi:include href="Book_Info_Release_Notes_4-0.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+    <xi:include href="Preface.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+  <chapter id="welcome-4.1">
+    <title>Welcome to &PRODUCT; 4.1</title>
+    <para>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.</para>
+    <para>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 <ulink url="http://cloudstack.apache.org/docs/en-US/Apache_CloudStack/4.1.0/html/Installation_Guide/index.html">Installation Guide</ulink>. For usage and administration instructions, please see the <ulink url="http://cloudstack.apache.org/docs/en-US/Apache_CloudStack/4.1.0/html/Admin_Guide/index.html">&PRODUCT; Administrator's Guide</ulink>. Developers and users who wish to work with the API will find instruction in the <ulink url="http://cloudstack.apache.org/docs/en-US/Apache_CloudStack/4.0.1-incubating/html/API_Developers_Guide/index.html">&PRODUCT; API Developer's Guide</ulink></para>
+    <para>If you find any errors or problems in this guide, please see <xref linkend="feedback" />. We hope you enjoy working with &PRODUCT;!</para>
   </chapter>
   <chapter id="upgrade-instructions">
-    <title>Upgrade Instructions</title>
+      <title>Upgrade Instructions</title>
+      <para>This section contains upgrade instructions from prior versions of CloudStack to Apache CloudStack 4.1.0. We include instructions on upgrading to Apache CloudStack from pre-Apache versions of Citrix CloudStack (last version prior to Apache is 3.0.2) and from the releases made while CloudStack was in the Apache Incubator.</para>
+      <para>If you run into any issues during upgrades, please feel free to ask questions on users@apache.cloudstack.org or dev@apache.cloudstack.org.</para>
+      <section id="upgrade-from-4.0-to-4.1">
+          <title>Upgrade from 4.0.x to 4.1.0</title>
+          <para>This section will guide you from Apache CloudStack 4.0.x versions (4.0.0-incubating, 4.0.1-incubating, and 4.0.2) to &PRODUCT; 4.1.0.</para>
+          <para>Any steps that are hypervisor-specific will be called out with a note.</para>
+          <orderedlist>
+              <listitem>
+                  <para>Create RPM or Debian packages (as appropriate) and a repository from the 4.1.0 source, or check the Apache CloudStack downloads page at <ulink url="http://cloudstack.apache.org/downloads.html">http://cloudstack.apache.org/downloads.html</ulink> for package repositories supplied by community members. Instructions for creating packages from the &PRODUCT; source are in the <ulink url="http://cloudstack.apache.org/docs/en-US/index.html">Installation Guide</ulink>.</para>
+              </listitem>
+              <listitem>
+                  <para>Stop your management server or servers. Run this on all management server hosts:</para>
+                  <programlisting># service cloud-management stop</programlisting>
+              </listitem>
+              <listitem>
+                  <para>Make a backup of your MySQL database. If you run into any issues or need to roll back the upgrade, this will assist in debugging or restoring your existing environment. You'll be prompted for your password.</para>
+                  <programlisting># mysqldump -u root -p cloud &gt; cloudstack-backup.sql</programlisting>
+              </listitem>
+          </orderedlist>
+      </section>
     <section id="upgrade-from-3.0.2-to-4.0">
         <title>Upgrade from 3.0.2 to 4.1.0</title>
         <para>This section will guide you from Citrix CloudStack 3.0.2 to Apache CloudStack 4.1.0. Sections that are hypervisor-specific will be called out with a note.</para>
@@ -540,8 +550,8 @@
                     </row>
                     <row>
                       <entry><para>KVM</para></entry>
-                      <entry><para>Name: systemvm-kvm-3.0.0</para>
-                        <para>Description: systemvm-kvm-3.0.0</para>
+                      <entry><para>Name: systemvm-kvm-4.1.0</para>
+                        <para>Description: systemvm-kvm-4.1.0</para>
                         <para>URL:
                           http://download.cloud.com/templates/acton/acton-systemvm-02062012.qcow2.bz2</para>
                         <para>Zone: Choose the zone where this hypervisor is used</para>
@@ -556,8 +566,8 @@
                     </row>
                     <row>
                       <entry><para>VMware</para></entry>
-                      <entry><para>Name: systemvm-vmware-3.0.0</para>
-                        <para>Description: systemvm-vmware-3.0.0</para>
+                      <entry><para>Name: systemvm-vmware-4.1.0</para>
+                        <para>Description: systemvm-vmware-4.1.0</para>
                         <para>URL:
                           http://download.cloud.com/templates/burbank/burbank-systemvm-08012012.ova</para>
                         <para>Zone: Choose the zone where this hypervisor is used</para>
@@ -975,369 +985,18 @@ Done restarting router(s).
       </orderedlist>
     </section>
   </chapter>
-  <chapter id="version-4.0">
-    <title>Version 4.0.0-incubating</title>
-    <section id="what-new-in-4.0">
-      <title>What’s New in 4.0.0-incubating</title>
-      <para>Apache CloudStack 4.0.0-incubating includes the following new features:</para>
-      <section id="inter-vlan-routing">
-        <title>Inter-VLAN Routing</title>
-        <para>Inter-VLAN Routing is the capability to route network traffic between VLANs. This
-          feature enables you to set up Virtual Private Clouds (VPC) that can hold multi-tier
-          applications. These tiers are deployed on different VLANs that can communicate with each
-          other. You can provision VLANs to the tiers your create, and VMs can be deployed on
-          different tiers, such as Web, Application, or Database. The VLANs are connected to a
-          virtual router, which facilitates communication between the VMs. In effect, you can
-          segment VMs by means of VLANs into different networks that can host multi-tier
-          applications. Such segmentation by means of VLANs logically separate application VMs for
-          higher security and lower broadcasts, while remaining physically connected to the same
-          device.</para>
-        <para>This feature is supported on XenServer and VMware hypervisors.</para>
-      </section>
-      <section id="site-to-site-vpn">
-        <title>Site-to-Site VPN</title>
-        <para>A Site-to-Site VPN connection helps you establish a secure connection from an
-          enterprise datacenter to the cloud infrastructure. This allows users to access the guest
-          VMs by establishing a VPN connection to the virtual router of the account from a device in
-          the datacenter of the enterprise. Having this facility eliminates the need to establish
-          VPN connections to individual VMs.</para>
-        <para>The supported endpoints on the remote datacenters are:</para>
-        <itemizedlist>
-          <listitem>
-            <para>Cisco ISR with IOS 12.4 or later</para>
-          </listitem>
-          <listitem>
-            <para>Juniper J-Series routers with JunOS 9.5 or later</para>
-          </listitem>
-        </itemizedlist>
-      </section>
-      <section id="local-storage-support">
-        <title>Local Storage Support for Data Volumes</title>
-        <para>You can now create data volumes on local storage. The data volume is placed on the
-          same XenServer host as the VM instance that is attached to the data volume. These local
-          data volumes can be attached to virtual machines, detached, re-attached, and deleted just
-          as with the other types of data volume. In earlier releases of CloudStack, only the root
-          disk could be placed in local storage.</para>
-        <para>Local storage is ideal for scenarios where persistence of data volumes and HA is not
-          required. Some of the benefits include reduced disk I/O latency and cost reduction from
-          using inexpensive local disks.</para>
-        <para>In order for local volumes to be used, the feature must be enabled for the
-          zone.</para>
-        <para>You can create a data disk offering for local storage. When a user creates a new VM,
-          they can select this disk offering in order to cause the data disk volume to be placed in
-          local storage.</para>
-        <para>You can not migrate a VM that has a volume in local storage to a different host, nor
-          migrate the volume itself away to a different host. If you want to put a host into
-          maintenance mode, you must first stop any VMs with local data volumes on that host.</para>
-        <para>Local storage support for volumes is available for XenServer, KVM, and VMware
-          hypervisors.</para>
-      </section>
-      <section id="tags">
-        <title>Tags</title>
-        <para>A tag is a key-value pair that stores metadata about a resource in the cloud. Tags are
-          useful for categorizing resources. For example, you can tag a user VM with a value that
-          indicates the user's city of residence. In this case, the key would be "city" and the
-          value might be "Toronto" or "Tokyo." You can then request CloudStack to find all resources
-          that have a given tag; for example, VMs for users in a given city.</para>
-        <para>You can tag a user virtual machine, volume, snapshot, guest network, template, ISO,
-          firewall rule, port forwarding rule, public IP address, security group, load balancer
-          rule, project, VPC, network ACL, or static route. You can not tag a remote access
-          VPN.</para>
-        <para>You can work with tags through the UI or through the new API commands createTags,
-          deleteTags, and listTags. You can define multiple tags for each resource. There is no
-          limit on the number of tags you can define. Each tag can be up to 255 characters long.
-          Users can define tags on the resources they own, and administrators can define tags on any
-          resources in the cloud.</para>
-        <para>A new optional input parameter, "tags," has been added to many of the list* API
-          commands. The following example shows how to use this new parameter to find all the
-          volumes having tag region=canada OR tag city=Toronto:</para>
-        <programlisting>command=listVolumes
-&amp;listAll=true
-&amp;tags[0].key=region
-&amp;tags[0].value=canada
-&amp;tags[1].key=city
-&amp;tags[1].value=Toronto</programlisting>
-        <para>The following API commands have the new "tags" input parameter:</para>
-        <itemizedlist>
-          <listitem>
-            <para>listVirtualMachines</para>
-          </listitem>
-          <listitem>
-            <para>listVolumes</para>
-          </listitem>
-          <listitem>
-            <para>listSnapshots</para>
-          </listitem>
-          <listitem>
-            <para>listNetworks</para>
-          </listitem>
-          <listitem>
-            <para>listTemplates</para>
-          </listitem>
-          <listitem>
-            <para>listIsos</para>
-          </listitem>
-          <listitem>
-            <para>listFirewallRules</para>
-          </listitem>
-          <listitem>
-            <para>listPortForwardingRules</para>
-          </listitem>
-          <listitem>
-            <para>listPublicIpAddresses</para>
-          </listitem>
-          <listitem>
-            <para>listSecurityGroups</para>
-          </listitem>
-          <listitem>
-            <para>listLoadBalancerRules</para>
-          </listitem>
-          <listitem>
-            <para>listProjects</para>
-          </listitem>
-          <listitem>
-            <para>listVPCs</para>
-          </listitem>
-          <listitem>
-            <para>listNetworkACLs</para>
-          </listitem>
-          <listitem>
-            <para>listStaticRoutes</para>
-          </listitem>
-        </itemizedlist>
-      </section>
-      <section id="aws-tags">
-        <title>AWS API Changes for Tags</title>
-        <para>Some changes have been made to the Amazon Web Services API compatibility support in
-          order to accommodate the new tagging feature.</para>
-        <para>New APIs:</para>
-        <informaltable>
-          <tgroup cols="2" align="left" colsep="1" rowsep="1">
-            <colspec colwidth="1.0*" colname="1" colnum="1"/>
-            <colspec colwidth="4.3*" colname="2" colnum="2"/>
-            <thead>
-              <row>
-                <entry>
-                  <para>New API</para>
-                </entry>
-                <entry>
-                  <para>Description</para>
-                </entry>
-              </row>
-            </thead>
-            <tbody>
-              <row>
-                <entry>
-                  <para>ec2-create-tags </para>
-                </entry>
-                <entry>
-                  <para>Add tags to one or more resources.</para>
-                </entry>
-              </row>
-              <row>
-                <entry>
-                  <para>ec2-delete-tags</para>
-                </entry>
-                <entry>
-                  <para>Remove tags from one or more resources.</para>
-                </entry>
-              </row>
-              <row>
-                <entry>ec2-describe-tags</entry>
-                <entry>
-                  <para>Show currently defined tags.</para>
-                </entry>
-              </row>
-            </tbody>
-          </tgroup>
-        </informaltable>
-        <para>Changed APIs:</para>
-        <informaltable>
-          <tgroup cols="2" align="left" colsep="1" rowsep="1">
-            <colspec colwidth="1" colname="1" colnum="1"/>
-            <colspec colwidth="2*" colname="2" colnum="2"/>
-            <thead>
-              <row>
-                <entry>
-                  <para>Changed API</para>
-                </entry>
-                <entry>
-                  <para>Description</para>
-                </entry>
-              </row>
-            </thead>
-            <tbody>
-              <row>
-                <entry>ec2-describe-images</entry>
-                <entry>
-                  <para>Output now shows tags defined for each image.</para>
-                </entry>
-              </row>
-              <row>
-                <entry>
-                  <para>ec2-describe-instances </para>
-                </entry>
-                <entry>
-                  <para>Output now shows tags defined for each image.</para>
-                  <para>The following filters can now be passed in to limit the output result set:
-                    tag-key, tag-value and tag:key</para>
-                </entry>
-              </row>
-              <row>
-                <entry>
-                  <para>ec2-describe-snapshots</para>
-                </entry>
-                <entry>
-                  <para>Output now shows tags defined for each image.</para>
-                  <para>The following filters can now be passed in to limit the output result set:
-                    tag-key, tag-value and tag:key</para>
-                </entry>
-              </row>
-              <row>
-                <entry>ec2-describe-volumes</entry>
-                <entry>
-                  <para>Output now shows tags defined for each image.</para>
-                  <para>The following filters can now be passed in to limit the output result set:
-                    tag-key, tag-value and tag:key</para>
-                </entry>
-              </row>
-            </tbody>
-          </tgroup>
-        </informaltable>
-      </section>
-      <section id="secure-console-access-on-xenserver">
-        <title>Secure Console Access on XenServer</title>
-        <para>With the addition of Secure Console feature, users can now securely access the VM
-          consoles on the XenServer hypervisor. You can either SSH or use the View Console option in
-          the Management Server to securely connect to the VMs on the XenServer host. The Management
-          Server uses the xapi API to stream the VM consoles. However, there is no change in the way
-          you can access the console of a VM. This feature is supported on XenServer 5.6 and 6.0
-          versions.</para>
-      </section>
-      <section id="release-note-stopped-vm">
-        <title>Stopped VM</title>
-        <para>This release supports creating VMs without starting them on the backend. You can
-          determine whether the VM needs to be started as part of the VM deployment. A VM can be
-          deployed in two ways: create and start a VM (the default method); create a VM and leave it
-          in the stopped state.</para>
-        <para>A new request parameter, startVM, is introduced in the deployVm API to support the
-          stopped VM feature. The possible values are:</para>
-        <itemizedlist>
-          <listitem>
-            <para>true - The VM starts as a part of the VM deployment</para>
-          </listitem>
-          <listitem>
-            <para>false - The VM is left in stopped state at the end of the VM deployment</para>
-          </listitem>
-        </itemizedlist>
-      </section>
-      <section id="release-note-upload-existing-volume-to-vm">
-        <title>Uploading an Existing Volume to a Virtual Machine</title>
-        <para>Existing data can now be made accessible to a virtual machine. This is called
-          uploading a volume to the VM. For example, this is useful to upload data from a local file
-          system and attach it to a VM. Root administrators, domain administrators, and end users
-          can all upload existing volumes to VMs. The upload is performed by using HTTP. The
-          uploaded volume is placed in the zone's secondary storage.</para>
-        <para>This functionality is supported for the following hypervisors:</para>
-        <itemizedlist>
-          <listitem>
-            <para>Hypervisor : Disk Image Format</para>
-          </listitem>
-          <listitem>
-            <para>XenServer : VHD</para>
-          </listitem>
-          <listitem>
-            <para>VMware : OVA</para>
-          </listitem>
-          <listitem>
-            <para>KVM : QCOW2</para>
-          </listitem>
-          <!--          <listitem>
-            <para>OVM : RAW</para>
-        </listitem> -->
-        </itemizedlist>
-      </section>
-      <section id="dedicated-ha-hosts">
-        <title>Dedicated High-Availability Hosts</title>
-        <para>One or more hosts can now be designated for use only by high-availability (HA) enabled
-          VMs that are restarted due to a host failure. Setting up a pool of such dedicated HA hosts
-          as the recovery destination for all HA-enabled VMs make it easier to determine which VMs
-          are restarted as part of the high-availability function. You can designate a host as a
-          dedicated-HA restart node only if the Dedicated HA Hosts feature is enabled by setting the
-          appropriate global configuration parameter.</para>
-      </section>
-      <section id="support-for-aws-api">
-        <title>Support for Amazon Web Services API</title>
-        <para>This release supports Amazon Web Services APIs, including Elastic Compute Cloud (EC2)
-          API. Fidelity with the EC2 API and the installation experience for this functionality are
-          both enhanced. In prior releases, users were required to install a separate component
-          called CloudBridge, in addition to installing the Management Server. For new installations
-          of CloudStack 4.0.0-incubating, this software is installed automatically along with
-          CloudStack and runs in a more closely integrated fashion. The feature is disabled by
-          default, but can be easily enabled by setting the appropriate global configuration
-          parameter and performing a few setup steps.</para>
-      </section>
-      <section id="nicira-nvp-plugin">
-        <title>The Nicira NVP Plugin</title>
-        <para>The Nicira NVP plug-in allows CloudStack to use the Nicira solution for virtualized
-          network as a provider for CloudStack networks and services. In CloudStack 4.0.0-incubating
-          this plug-in supports the Connectivity service. This service is responsible for creating
-          Layer 2 networks supporting the networks created by guests. When a tenant creates a new
-          network, instead of a traditional VLAN, a logical network will be created by sending the
-          appropriate calls to the Nicira NVP Controller. The plug-in has been tested with Nicira
-          NVP versions 2.1.0, 2.2.0 and 2.2.1.</para>
-      </section>
-      <section id="bigswitch-vns-plugin">
-        <title>The BigSwitch Controller Plugin</title>
-        <para>The BigSwitch Controller plug-in adds OpenFlow based solution for network virtualization
-          to CloudStack. The plugin supports both BigSwitch commercial controller and the opensource
-          Floodlight controller. The plugin functions as a provider for CloudStack networks and Connectivity
-          service. This service is responsible for creating Layer 2 networks supporting the networks
-          created by guests. When a tenant creates a new network, a virutal network segment will be
-          created by sending the appropriate calls to the BigSwitch Controller.</para>
-      </section>
-      <section id="castor-support">
-        <title>Support for CAStor Cluster</title>
-        <para>CloudStack 4.0.0-incubating supports using a CAStor cluster as the back-end storage
-          system for a CloudStack S3 front-end. The CAStor back-end storage for CloudStack extends
-          the existing storage classes and allows the storage configuration attribute to point to a
-          CAStor cluster. This feature makes use of the CloudStack server's local disk to spool
-          files before writing them to CAStor when handling the PUT operations. However, a file must
-          be successfully written into the CAStor cluster prior to the return of a success code to
-          the S3 client to ensure that the transaction outcome is correctly reported.</para>
-        <para>The S3 multipart file upload is not supported in this release. You are prompted with
-          proper error message if a multipart upload is attempted.</para>
-      </section>
-      <section id="clvm-support-kvm">
-        <title>Clustered Logical Volume Manager Support for KVM</title>
-        <para>This release adds Clustered Logical Volume Manager (CLVM) storage support for KVM
-          hosts. With this support, you can use CLVM as primary storage.</para>
-        <para>The CLVM support for KVM allows root and data disks (primary storage) to reside on
-          Linux logical volumes. The administrators are required to configure CLVM on the KVM hosts
-          independent of CloudStack. When the volume groups are available, an administrator can
-          simply add primary storage of type CLVM, providing the volume group name. Then CloudStack
-          creates and manages logical volumes as needed.</para>
-        <para>CLVM also supports Snapshots. CloudStack creates an LVM snapshot, copy the applicable
-          logical volume to the secondary storage in the qcow2 format, and then delete the LVM
-          snapshot. </para>
-      </section>
-      <section id="rbd-support-kvm">
-        <title>Rados Block Device Support for KVM</title>
-        <para>You can now use Rados Block Device (RBD) to run instances on Apache CloudStack
-          4.0.0-incubating. This can be done by adding a RBD pool as primary storage. Before using
-          RBD, ensure that Qemu is compiled with RBD enabled, and the libvirt version is at least
-          0.10 with RBD enabled on the KVM host </para>
-        <para>Create a disk offering for RBD so that you can ensure that StoragePoolAllocator
-          chooses the RBD pool to deploy instances.</para>
-      </section>
+  <chapter id="version-4.1">
+    <title>Version 4.1.0</title>
+    <section id="what-new-in-4.1">
+      <title>What’s New in 4.1</title>
+      <para>Apache CloudStack 4.1.0 includes many new features. This section covers the most prominent new features and changes.</para>
     </section>
     <section id="issues-fixed-4.0">
-      <title>Issues Fixed in 4.0.0-incubating</title>
-      <para>Many bugs include a defect number that reflects the bug number that was held in the bug
-        tracker run by Citrix (bugs.cloudstack.org). The Apache CloudStack project now uses <ulink
-          url="https://issues.apache.org/jira/browse/CLOUDSTACK">Jira</ulink> to manage its bugs, so
-        some of the bugs that are referenced here may not be available to view. However, we are
-        still including them for completeness.</para>
+        <title>Issues Fixed in 4.1.0</title>
+        <para>Apache CloudStack uses <ulink url="https://issues.apache.org/jira/browse/CLOUDSTACK">Jira</ulink>
+            to track its issues. All new features and bugs for 4.1.0 have been tracked in Jira, and have 
+            a standard naming convention of "CLOUDSTACK-NNNN" where "NNNN" is the issue number.</para>
+        <para>This section includes a summary of known issues against 4.0.0 that were fixed in 4.1.0.</para>
       <informaltable>
         <tgroup cols="2" align="left" colsep="1" rowsep="1">
           <colspec colwidth="1*" colname="1" colnum="1"/>
@@ -1354,1575 +1013,45 @@ Done restarting router(s).
           </thead>
           <tbody>
             <row>
-              <entry><para>Many</para></entry>
-              <entry><para>vSphere 5.0 now has GA support. Formerly only Beta support was
-                  provided.</para></entry>
-            </row>
-            <row>
               <entry><para>CS-16135</para></entry>
               <entry><para>Creating volumes after upgrading from snapshot taken in 2.2.14 no longer
                   deletes the snapshot physically from the secondary storage.</para></entry>
             </row>
+          </tbody>
+        </tgroup>
+      </informaltable>
+    </section>
+    <section id="known-issues-4.1">
+      <title>Known Issues in 4.0.0-incubating</title>
+      <informaltable>
+        <tgroup cols="2" align="left" colsep="1" rowsep="1">
+          <colspec colwidth="1*" colname="1" colnum="1"/>
+          <colspec colwidth="2*" colname="2" colnum="2"/>
+          <thead>
             <row>
-              <entry><para>CS-16122</para></entry>
-              <entry><para>In a site-to-site VPN setup, alerts are generated when the VPC virtual
-                  router is rebooted with multiple vpn connections.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-16022</para></entry>
-              <entry><para>If host connection fails due to a database error, host now disconnects
-                  and the Managerment Server id is removed.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-16011</para></entry>
-              <entry><para>Name of network offering is no longer truncated due to too-narrow field
-                  width in Add Guest Network dialog box. </para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15978</para></entry>
-              <entry><para>When the virtual router and its host go down, the high availability
-                  mechanism now works for the virtual router.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15921</para></entry>
-              <entry><para>The 2.2.x security group script now accounts for the VMs created in the
-                  version 2.1 timeframe.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15919</para></entry>
-              <entry><para>A level parameter is added to the listVolumes command; therefore queries
-                  return the response more quickly.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15904</para></entry>
-              <entry><para>Upgrade from version 2.2.14 to CloudStack-3.0.5-0.2944-rhel5 works as
-                  expected. The upgrade script,
-                  /usr/share/cloud/setup/db/schema-2214to30-cleanup.sql, works as
-                expected.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15879</para></entry>
-              <entry><para>The database upgrade from version 3.0.4 to 3.0.5 works as
-                  expected.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15807</para></entry>
-              <entry><para>Network label for OVM now available in UI.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15779</para></entry>
-              <entry><para>When the thumbnail is requested, the console session will not be
-                  terminated.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15778</para></entry>
-              <entry><para>Fetching a VM thumbnail now gets a thumbnail of appropriate visual
-                  dimensions.</para>
+              <entry>
+                <para>Issue ID</para>
               </entry>
-            </row>
-            <row>
-              <entry><para>CS-15734</para></entry>
-              <entry><para>KVM Snapshots no longer shows incorrect disk usage.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15733</para></entry>
-              <entry><para>The domainId parameter for the listNetworks command now lists the
-                  resources belonging to the domain specified.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15676</para></entry>
-              <entry><para>Stopping the router no longer fails with the null pointer
-                  exception.</para>
+              <entry>
+                <para>Description</para>
               </entry>
             </row>
+          </thead>
+          <tbody>
             <row>
-              <entry><para>CS-15648</para></entry>
-              <entry><para>If creating a volume from a snapshot fails, the error is reported on the
-                  UI but the volume is stuck in the creating state.</para>
+              <entry><para>CLOUDSTACK-301</para></entry>
+              <entry><para>Nexus 1000v DVS integration is not functional</para>
+                <para>This source code release includes some partial functionality to support the
+                  Cisco Nexus 1000v Distributed Virtual Switch within a VMware hypervisor
+                  environment. The functionality is not complete at this time.</para>
               </entry>
             </row>
-            <row>
-              <entry><para>CS-15646</para></entry>
-              <entry><para>createFirewallRule API no longer causes null pointer
-                exception.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15628</para></entry>
-              <entry><para>In a KVM host, the high availability mechanism no longer takes a long
-                  time to migrate VMs to another KVM host if there are multiple storage
-                  pools.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15627</para></entry>
-              <entry><para>Metadata instance-id and vm-id for existing VMs stays the same after
-                  upgrade.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15621</para></entry>
-              <entry><para>Solved difficulty with allocating disk volumes when running multiple VM
-                  deployment in parallel.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15603</para></entry>
-              <entry><para>CloudStack now stop the VMs when destroyVM command is
-                called.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15586</para></entry>
-              <entry><para>Public Vlan for an account no longer fails if multiple physical networks
-                  are present.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15582</para></entry>
-              <entry><para>The dns-name filter is now supported for ec2-describe-instances in the
-                  Amazon Web Services API compatibility commands. The filter maps to the name of a
-                  user VM.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15503</para></entry>
-              <entry><para>An IP address which has static NAT rules can now be released.
-                  Subsequently, restarting this network after it was shutdown can
-                succeed.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15464</para></entry>
-              <entry><para>Can now delete static route whose state is set to Revoke.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15443</para></entry>
-              <entry><para>Creating a firewall rule no longer fails with an internal server
-                  error.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15398</para></entry>
-              <entry><para>Corrected technique for programming DNS on the user VMs.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15356</para></entry>
-              <entry><para>Internal DNS 2 entry now correctly shown in UI.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15335</para></entry>
-              <entry><para>The CloudBridge S3 Engine now connects to the database by using the
-                  deciphered password in the db.properties file.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15318</para></entry>
-              <entry><para>UI now correctly prevents the user from stopping a VM that is in the
-                  Starting state.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15307</para></entry>
-              <entry><para>Fixed Japanese localization of instance statuses in the Instances
-                  menu.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15278</para></entry>
-              <entry><para>The deployment planner no longer takes long time to locate a suitable
-                  host to deploy VMs when large number of clusters are present.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15274</para></entry>
-              <entry><para>Creating a VLAN range using Zone ID without network ID now
-                  succeeds.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15243</para></entry>
-              <entry><para>Now check to be sure source NAT and VPN have same
-                provider.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15232</para></entry>
-              <entry><para>Ensure that networks using external load balancer/firewall in 2.2.14 or
-                  earlier can properly upgrade.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15200</para></entry>
-              <entry><para>No exception when trying to attach the same volume while attaching the
-                  first volume is in progress.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15173</para></entry>
-              <entry><para>Additional cluster can no longer be added with same VSM IP address as
-                  another cluster.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15167</para></entry>
-              <entry><para>AWS API calls now honor the admin account's ability to view or act on the
-                  resources owned by the regular users.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15163</para></entry>
-              <entry><para>The minimum limit is not honored when there is not enough capacity to
-                  deploy all the VMs and the ec2-run-instances command with the -n &gt;n1 -n2&gt;
-                  option is used to deploy multiple VMs.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15157</para></entry>
-              <entry><para>Can now add/enable service providers for multiple physical networks
-                  through the UI.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15145</para></entry>
-              <entry><para>AWS API call ec2-register has better error handling for negative
-                  cases.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15122</para></entry>
-              <entry><para>Filters now supported for AWS API call
-                  ec2-describe-availability-zones.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15120</para></entry>
-              <entry><para>Actions column in UI of Volume page now shows action
-                links.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15099</para></entry>
-              <entry><para>Buttons no longer overlap text on Account Deletion confirmation page in
-                  UI.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15095</para></entry>
-              <entry><para>Ensures you can not create a VM with a CPU frequency greater than the
-                  host CPU frequency.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15094</para></entry>
-              <entry><para>CPU cap now set properly in VMware.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15077</para></entry>
-              <entry><para>NullPointerException is no longer observed while executing the command to
-                  list the public IP in a basic zone created with the default shared NetScaler EIP
-                  and ELB network offering.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15044</para></entry>
-              <entry><para>UI now provides option to view the list of instances which are part of
-                  the guest network.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15026</para></entry>
-              <entry><para>UI in Deploy VM dialog now lists only templates or ISOs depending on
-                  which is selected in previous dialog.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14989</para></entry>
-              <entry><para>In KVM, the Create Instance wizard now shows only templates from the
-                  current (KVM) zone.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14986, CS-14985</para></entry>
-              <entry><para>Listing filters works as expected in the ec2-describe-volumes and
-                  ec2-describe-snapshots commands.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14964</para></entry>
-              <entry><para>Automatically starting the Console Proxy no longer fails due to its
-                  missing volume on the primary storage</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14907</para></entry>
-              <entry><para>User is now correctly prevented from trying to download an uploaded
-                  volume which has not yet been moved to primary storage.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14879</para></entry>
-              <entry><para>When a user VM is stopped or terminated, the static NAT associated with
-                  this VM is now disabled. This public IP address is no longer owned by this account
-                  and can be associated to any other user VM.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14854</para></entry>
-              <entry><para>Only the admin user can change the template permission to Public, so this
-                  option is removed from the UI for domain Admins and regular Users.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14817</para></entry>
-              <entry><para>While checking if network has any external provider, CloudStack will
-                  consider all providers in the network.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14796</para></entry>
-              <entry><para>When deploying a VM with ec2-run-instances, userdata is now
-                  encoded.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14770</para></entry>
-              <entry><para>The API returns the keypair information when a VM is deployed with
-                  sshkey. This affects the API commands related to virtual machines
-                  (deployVirtualMachine, listVirtualMachines, ... *VirtualMachine), as well as the
-                  corresponding AWS APIs.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14724</para></entry>
-              <entry><para>UI no longer displays the dropdown list of isolation method choices if
-                  sdn.ovs.controller is false.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14345</para></entry>
-              <entry><para>Logout API returns XML header.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14724</para></entry>
-              <entry><para>Host IPs now associated with appropriate IPs according to traffic
-                  type.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14253</para></entry>
-              <entry><para>Can now delete and re-create port forwarding rule on same
-                  firewall.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14724</para></entry>
-              <entry><para>UI no longer displays the dropdown list of isolation method choices if
-                  sdn.ovs.controller is false.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14452</para></entry>
-              <entry><para>Data disk volumes are now automatically copied from one cluster to
-                  another.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13539</para></entry>
-              <entry><para>Windows VM can get IP after reboot.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13537</para></entry>
-              <entry><para>When user tries to delete a domain that contains sub-domains, an error
-                  message is now sent to convey the reason for the delete failure.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13153</para></entry>
-              <entry><para>System VMs support HTTP proxy.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12642</para></entry>
-              <entry><para>Added Close button to Select Project list view popup in
-                UI.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12510</para></entry>
-              <entry><para>Deleting and reinserting host_details no longer causes
-                deadlocks.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12407</para></entry>
-              <entry><para>F5 and Netscaler - when dedicated is selected, capacity field is
-                  disabled.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12111</para></entry>
-              <entry><para>Email validation for edit user form.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-10928</para></entry>
-              <entry><para>Network read/write values now always positive numbers.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15376, CS-15373</para></entry>
-              <entry><para>The AWS APIs (EC2 and S3) now listen on the 7080 port and send request to
-                  CloudStack on the 8080 port just as any other clients of
-                CloudStack.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13944</para></entry>
-              <entry><para>The CloudStack 2.2.x to 3.0.x database upgrade for multiple physical
-                  networks is now supported.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15300</para></entry>
-              <entry><para>The admin accounts of a domain now honour the limits imposed on that
-                  domain just like the regular accounts do. A domain admin now is not allowed to
-                  create an unlimited number of instances, volumes, snapshots, and so
-                on.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15396</para></entry>
-              <entry><para>The CloudStack database now contain the UUD information after the 2.2.14
-                  to 3.0.4 upgrade.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15450</para></entry>
-              <entry><para>Upgrade from 2.2.14 to 3.0.4 no longer fails on a VMware
-                host.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15449</para></entry>
-              <entry><para>Running cloudstack-aws-api-register no longer fails with the "User
-                  registration failed with error: [Errno 113] No route to host"
-                error.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15455</para></entry>
-              <entry><para>The iptable rules are configured to open the awsapi port (7080) as part
-                  of the installation.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15429</para></entry>
-              <entry><para>While creating an instance with data volume, disk offering also is
-                  considered while checking the account limit on volume resources.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15414</para></entry>
-              <entry><para>After the 2.2.14 to 3.0.4 upgrade, the value of the global parameter
-                  xen.guest.network.device is now decrypted before setting the traffic
-                label.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15382</para></entry>
-              <entry><para>During 2.2.14 to 3.0.4 upgrade, the hosts no longer go to the Alert state
-                  if destroyed networks existed with non-existent tags prior to
-                upgrade.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15323</para></entry>
-              <entry><para>CloudStack supports the following Citrix XenServer hotfixes: XS602E003,
-                  XS602E004, and XS602E005.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15430</para></entry>
-              <entry><para>Create snapshot now fails if creating a snapshot exceeds the snapshot
-                  resource limit for a domain admin or a user account.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14256</para></entry>
-              <entry><para>Virtual Router no longer remains in starting state for subdomain or user
-                  on a KVM 3.0.1 prerlease host on RHEL 6.2.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-7495</para></entry>
-              <entry><para>Implemented a variety of Xen management host improvements.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-8105</para></entry>
-              <entry><para>NFS v4 for primary storage now works as expected on KVM
-                hosts.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-9989</para></entry>
-              <entry><para>The error messages returned during VM deployment failure will have much
-                  more details than before.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12584</para></entry>
-              <entry><para>You can no longer add security groups not supported by the hypervisor in
-                  use.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12705</para></entry>
-              <entry><para>When creating a Network offering by using SRX as the service provider for
-                  SourceNAT servcies, an option is given in the CloudStack UI now to set the
-                  source_nat type to "per Zone"/"per account". </para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12782</para></entry>
-              <entry><para>Assigning a VM from Basic to Advanced zone no longer ignores the network
-                  ID. A warning message is displayed for VM movements across zones.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12591</para></entry>
-              <entry><para>Broadcast Address on the Second Public IP NIC is now
-                corrected.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13272</para></entry>
-              <entry><para>When a user is deleted, all the associated properties, such as IPs and
-                  virtual routers, are now deleted.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13377</para></entry>
-              <entry><para>Creating template from a root disk of a stopped instance now provides an
-                  option to make it a "Featured template".</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13500</para></entry>
-              <entry><para>Reaching the first guest VM by using its public IP from the second guest
-                  VM no longer fails.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13853</para></entry>
-              <entry><para>The default gateway can no longer be 0.0.0.0 in the Secondary Storage VM
-                  (SSVM).</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13863</para></entry>
-              <entry><para>The queryAsyncJobResult command in XML format now returns the correct
-                  UUIDs.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13867</para></entry>
-              <entry><para>Corrected CSP xenserver-cloud-supp.tgz for XenServer 5.6 and
-                6.0.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13904</para></entry>
-              <entry><para>Labels and values for the service offerings CPU and memory are now
-                  consistent. </para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13998</para></entry>
-              <entry><para>The SSVM kernel panic issue is fixed on XenServer.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14090</para></entry>
-              <entry><para>The issue is fixed where running the VMware snapshots randomly fails with
-                  the ArrayIndexOutOfBoundsException error.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14021</para></entry>
-              <entry><para>The java.lang.OutOfMemoryError is fixed on the Management
-                Server.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14025</para></entry>
-              <entry><para>The Python Eggs are provided to easily package the test client for each
-                  branch of CloudStack.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14068</para></entry>
-              <entry><para>Resetting the VM password through the CloudStack UI no longer causes any
-                  error.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14156</para></entry>
-              <entry><para>The pod which has the administrator's virtual router is no longer
-                  selected while creating the virtual routers for guests.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14182</para></entry>
-              <entry><para>The users can now delete their ISOs as normal users.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14185</para></entry>
-              <entry><para>The listOSTypes API now filters out the types of operating system by
-                  using the keywords.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14204</para></entry>
-              <entry><para>The cloud-setup-bonding.sh command no longer generates the "command not
-                  found" error.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14214</para></entry>
-              <entry><para>The Specify VLAN option cannot be enabled now for an isolated Network
-                  offering with SourceNAT enabled.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14234</para></entry>
-              <entry><para>Sending project invite email to an account now requires SMTP configured
-                  in CloudStack.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14237</para></entry>
-              <entry><para>The garbage collector of the primary storage no longer fails when the
-                  first host in the cluster is not up.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14241</para></entry>
-              <entry><para>Custom Volume Disk Offering is now matching the Global configuration
-                  value.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14270</para></entry>
-              <entry><para>The listNetworks API no longer assumes that the broadcast type is always
-                  VLAN.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14319</para></entry>
-              <entry><para>The internal name of the VM is no longer present in the error message
-                  that is displayed to a domain administrator.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14321</para></entry>
-              <entry><para>The listVolumes API call now returns a valid value for the isExtractable
-                  parameter for the ISO-derived disk and data disk volumes.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14323</para></entry>
-              <entry><para>Invalid API calls will now give valid response in json/xml
-                format.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14339</para></entry>
-              <entry><para>Custom Disk Size will now allow values larger than 100GB.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14357</para></entry>
-              <entry><para>The ConsoleProxyLoadReportCommand is no longer fired
-                continuously.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14421</para></entry>
-              <entry><para>Fixed the issue of virtual router deployments. The DHCP entries can now
-                  be assigned to the router.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14555</para></entry>
-              <entry><para>Unzipped downloaded template MD5SUM will no longer override the zipped
-                  template MD5SUM in the database.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14598</para></entry>
-              <entry><para>The complete screen of the running VM is now displayed in the console
-                  proxy.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14600</para></entry>
-              <entry><para>Windows or Linux based consoles are no longer lost upon rebooting
-                  VMs.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14784</para></entry>
-              <entry><para>Multiple subnets with the same VLAN now work as expected.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13303, 14874, 13897, 13944, 14088, 14190</para></entry>
-              <entry><para>A variety of upgrade issues have been fixed in release
-                3.0.3.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15080</para></entry>
-              <entry><para>Setting a private network on a VLAN for VMWare environment is now
-                  supported.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15168</para></entry>
-              <entry><para>The console proxy now works as expected and no exception is shown in the
-                  log after upgrading from version 2.2.14 to 3.0.2.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15172</para></entry>
-              <entry><para>Version 3.0.2 now accepts the valid public key.</para></entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </informaltable>
-    </section>
-    <section id="known-issues-4.0">
-      <title>Known Issues in 4.0.0-incubating</title>
-      <informaltable>
-        <tgroup cols="2" align="left" colsep="1" rowsep="1">
-          <colspec colwidth="1*" colname="1" colnum="1"/>
-          <colspec colwidth="2*" colname="2" colnum="2"/>
-          <thead>
-            <row>
-              <entry>
-                <para>Issue ID</para>
-              </entry>
-              <entry>
-                <para>Description</para>
-              </entry>
-            </row>
-          </thead>
-          <tbody>
-            <row>
-              <entry><para>CLOUDSTACK-301</para></entry>
-              <entry><para>Nexus 1000v DVS integration is not functional</para>
-                <para>This source code release includes some partial functionality to support the
-                  Cisco Nexus 1000v Distributed Virtual Switch within a VMware hypervisor
-                  environment. The functionality is not complete at this time.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CLOUDSTACK-368</para></entry>
-              <entry><para>OVM - cannot create guest VM</para>
-                  <para>This source code release has regressed from the CloudStack 2.2.x code
-                      and is unable to support Oracle VM (OVM).</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CLOUDSTACK-279</para></entry>
-              <entry><para>Deleting a project fails when executed by the regular user. This works as
-                  expected for root/domain admin. To workaround, perform either of the
-                  following:</para><itemizedlist>
-                  <listitem>
-                    <para>Use the account cleanup thread which will eventually complete the project
-                      deletion.</para>
-                  </listitem>
-                  <listitem>
-                    <para>Execute the call as the root/domain admin on behalf of the regular
-                      user.</para>
-                  </listitem>
-                </itemizedlist>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-16067</para></entry>
-              <entry><para>The command=listTags&amp;key=city command does not work as expected. The
-                  command does not return tags for the resources of the account with the tag, city
-                </para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-16063</para></entry>
-              <entry><para>The current values of volumes and snapshots are incorrect when using KVM
-                  as a host. To fix this, the database upgrade codes, volumes.size and
-                  snapshots.size, should be changed to show the virtual sizes.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-16058</para></entry>
-              <entry><para>Null pointer Exception while deleting the host after moving the host to
-                  maintenance state.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-16045</para></entry>
-              <entry><para>Only the root administrator can handle the API keys. The domain
-                  administrators are not allowed to create, delete, or retrieve API keys for the
-                  users in their domain. </para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-16019</para></entry>
-              <entry><para>CIDR list in the Add VPN Customer Gateway dialog does not prompt the user
-                  that they can provide a comma separated CIDRs if multiple CIDRs have to be
-                  supplied.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-16015</para></entry>
-              <entry><para>Deleting a network is not supported when its network providers are
-                  disabled.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-16012</para></entry>
-              <entry><para>Unable to delete a zone in the UI because the necessary cleanup cannot be
-                  completed. When the hosts are removed, the expunge process fails to delete the
-                  volumes as no hosts are present to send the commands to. Therefore, the storage
-                  pool removal fails, and zone can't be cleaned and deleted.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-16011</para></entry>
-              <entry><para>Name of network offering might be truncated due to too-narrow field width
-                  in Add Guest Network dialog box.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15789</para></entry>
-              <entry><para>Invalid global setting prevents management server to restart. For
-                  example, if you configure the "project.invite.timeout" parameter to "300" and
-                  attempt to restart management server, it fails without throwing a warning or
-                  setting the value to the default.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15749</para></entry>
-              <entry><para>Restarting VPC is resulting in intermittent connection loss to the port
-                  forwarding and StaticNAT rules.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15690</para></entry>
-              <entry><para>The IpAssoc command failed as a part of starting the virtual router, but
-                  the final start result is reported as succes.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15672, CS-15635</para></entry>
-              <entry><para>The FQDN of the VM is not configured if it is deployed as a part of
-                  default shared network and isolated guest network
-                  (DefaultIsolatedNetworkOfferingWithSourceNatService).</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15634</para></entry>
-              <entry><para>The FQDN of a VM that is deployed as a part of both a shared network and
-                  default isolated guest network has the suffix of the shared network instead of the
-                  default isolated guest network.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15576</para></entry>
-              <entry><para>Stopping a VM on XenServer creates a backlog of API commands. For
-                  example, the Attach volume calls become delayed while waiting for the
-                  stopVirtualMachine command to be executed.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15569</para></entry>
-              <entry><para>Misleading error message in the exception when creating a StaticNAT rule
-                  fails in a VPC.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15566</para></entry>
-              <entry><para>External device such as Netscaler is not supported in VPC.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15557</para></entry>
-              <entry><para>Intermittent traffic loss in the VPN connection if Juniper is the remote
-                  router and the life time is 300 seconds.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15361</para></entry>
-              <entry><para>Egress rules are not working in NetScaler loadbalancer.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-15163</para></entry>
-              <entry><para>The minimum limit is not honored when there is not enough capacity to
-                  deploy all the VMs and the ec2-run-instances command with the -n &gt;n1 -n2&gt;
-                  option is used to deploy multiple VMs.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15105</para></entry>
-              <entry><para>The cloud-sysvmadm script does not work if the integration.api.port
-                  parameter is set to any port other than 8096.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15092</para></entry>
-              <entry><para>Connecting to the guest VMs through SSH is extremely slow, and it results
-                  in connection timeout.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15037</para></entry>
-              <entry><para>Hairpin NAT is not supported when NetScaler is used for
-                EIP.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15009</para></entry>
-              <entry><para>The port_profile table will not be populated with port profile
-                  information. In this release, CloudStack directly connects to the VSM for all the
-                  port profile operations; therefore, no port profile information is
-                cached.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14939</para></entry>
-              <entry><para>Adding a VMware cluster is not supported when the Management Network is
-                  migrated to the Distributed Virtual Switch environment.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14780</para></entry>
-              <entry><para>You are allowed to ping the elastic IP address of the VM even though no
-                  ingress rule is set that allows the ICMP protocol.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14756</para></entry>
-              <entry><para>Installing KVM on RHEL 6.2 will result in unreliable network performance.
-                  Workaround: blacklist vhost-net. Edit /etc/modprobe.d/blacklist-kvm.conf and
-                  include vhost-net.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14346</para></entry>
-              <entry><para>The UpdateVirtualMachine API call does not check whether the VM is
-                  stopped. Therefore, stop the VM manually before issuing this call.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14303 (was 14537)</para></entry>
-              <entry><para>The IP addresses for a shared network are still being consumed even if no
-                  services are defined for that network.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14296 (was 14530)</para></entry>
-              <entry><para>OVM: Network traffic labels are not supported.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14291 (was 14523)</para></entry>
-              <entry><para>The EIP/ELB network offering for basic zones does not support multiple
-                  NetScalers.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14275 (was 14506)</para></entry>
-              <entry><para>F5: Unable to properly remove a F5 device.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14201 (was 14430)</para></entry>
-              <entry><para>VMWare: Template sizes are being reported different depending on whether
-                  the primary storage is using ISCSI or NFS.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13758 (was 13963)</para></entry>
-              <entry><para>vSphere: template download from templates created off of the root volume
-                  does not work properly.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13733 (was 13935)</para></entry>
-              <entry><para>vSphere: detaching an ISO from a restored VM instance
-                fails.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13682 (was 13883)</para></entry>
-              <entry><para>Multiple NetScalers are not supported in Basic Networking.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13599 (was 13359)</para></entry>
-              <entry><para>Programming F5/NetScaler rules can be better optimized.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13337 (was 13518)</para></entry>
-              <entry><para>Security Groups are not supported in Advanced Networking</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-13173 (was 13336)</para></entry>
-              <entry><para>vSphere: cross cluster volume migration does not work
-                properly.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12714 (was 12840)</para></entry>
-              <entry><para>Capacity view is not available for pods or clusters.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-12624 (was 12741)</para></entry>
-              <entry><para>vSphere: maintenance mode will not live migrate system VM to another
-                  host.</para></entry>
-            </row>
-            <row>
-              <entry>
-                <para>CS-15476</para>
-              </entry>
-              <entry>
-                <para>The 2.2.14 to 4.0.0-incubating upgrade fails if multiple untagged physical
-                  networks exist before the upgrade.</para>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para>CS-15407</para>
-              </entry>
-              <entry>
-                <para>After the 2.2.14 to 4.0.0-incubating upgrade, VLAN allocation on multiple
-                  physical networks does not happen as expected.</para>
-                <para>To workaround this issue, follow the instructions given below:</para>
-                <orderedlist>
-                  <listitem>
-                    <para>Revert to your 2.2.14 setup.</para>
-                  </listitem>
-                  <listitem>
-                    <para>Stop all the VMs with the isolated virtual networks in your cloud
-                      setup.</para>
-                  </listitem>
-                  <listitem>
-                    <para> Run following query to find if any networks still have the NICs
-                      allocated:</para>
-                    <orderedlist numeration="loweralpha">
-                      <listitem>
-                        <para>Check if any virtual guest networks have the NICs allocated:</para>
-                        <programlisting>#SELECT DISTINCT op.id from `cloud`.`op_networks` op JOIN `cloud`.`networks` n on op.id=n.id WHERE nics_count != 0 AND guest_type = 'Virtual'; </programlisting>
-                      </listitem>
-                      <listitem>
-                        <para>If this returns any network IDs, then ensure the following:</para>
-                        <orderedlist numeration="lowerroman">
-                          <listitem>
-                            <para>All the VMs are stopped.</para>
-                          </listitem>
-                          <listitem>
-                            <para>No new VM is started.</para>
-                          </listitem>
-                          <listitem>
-                            <para>Shutdown the Management Server.</para>
-                          </listitem>
-                        </orderedlist>
-                      </listitem>
-                      <listitem>
-                        <para>Remove the NICs count for the virtual network IDs returned in step
-                          (a), and set the NIC count to 0:</para>
-                        <programlisting>UPDATE `cloud`.`op_networks` SET nics_count = 0 WHERE id = <replaceable>enter id of virtual network</replaceable></programlisting>
-                      </listitem>
-                      <listitem>
-                        <para>Restart the Management Server, and wait for all the networks to shut
-                          down.</para>
-                        <note>
-                          <para>Networks shutdown is determined by the network.gc.interval and
-                            network.gc.wait parameters.</para>
-                        </note>
-                      </listitem>
-                    </orderedlist>
-                  </listitem>
-                  <listitem>
-                    <para>Ensure that all the networks are shut down and all the guest VNETs are
-                      free.</para>
-                  </listitem>
-                  <listitem>
-                    <para>Run the upgrade script.</para>
-                    <para>This allocates all your guest VNET ranges to the first physical
-                      network.</para>
-                  </listitem>
-                  <listitem>
-                    <para>By using the updatePhysicalNetwork API, reconfigure the VNET ranges for
-                      each physical network as desired.</para>
-                  </listitem>
-                  <listitem>
-                    <para>Start all the VMs.</para>
-                  </listitem>
-                </orderedlist>
-              </entry>
-            </row>
-            <row>
-              <entry>
-                <para>CS-14680</para>
-              </entry>
-              <entry>
-                <para>CloudStack and LDAP user validation cannot happen simultaneously because the
-                  user password is hashed and stored in the database, and LDAP requires the
-                  passwords in plain text.</para>
-                <para>To work with the LDAP user, the MD5 hash should be disabled in the login
-                  process by commenting the following variable in sharedFunctions.js file available
-                  at /usr/share/cloud/management/webapps/client/scripts, and restart the
-                  cloud-management service.</para>
-                <programlisting>var md5HashedLogin = false;</programlisting>
-                <para>However, if md5HashedLogin is set to false, the end user can login with the
-                  LDAP credentials but not with the CloudStack user credentials.</para>
-              </entry>
-            </row>
-            <row>
-              <entry><para>CS-14346</para></entry>
-              <entry><para>The UpdateVirtualMachine API call does not check whether the VM is
-                  stopped. Therefore, stop the VM manually before issuing this call.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15130</para></entry>
-              <entry><para>Data disk volumes are not automatically copied from one cluster to
-                  another.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14780</para></entry>
-              <entry><para>You are allowed to ping the elastic IP address of the VM even though no
-                  ingress rule is set that allows the ICMP protocol.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-14939</para></entry>
-              <entry><para>Adding a VMware cluster is not supported when the Management Network is
-                  migrated to the Distributed Virtual Switch environment.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15009</para></entry>
-              <entry><para>The port_profile table will not be populated with port profile
-                  information. In this release, CloudStack directly connects to the VSM for all the
-                  port profile operations; therefore, no port profile information is
-                cached.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15037</para></entry>
-              <entry><para>Hairpin NAT is not supported when NetScaler is used for
-                EIP.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15092</para></entry>
-              <entry><para>Connecting to the guest VMs through SSH is extremely slow, and it results
-                  in connection timeout.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15105</para></entry>
-              <entry><para>The cloud-sysvmadm script does not work if the integration.api.port
-                  parameter is set to any port other than 8096.</para></entry>
-            </row>
-            <row>
-              <entry><para>CS-15163</para></entry>
-              <entry><para>The minimum limit is not honored when there is not enough capacity to
-                  deploy all the VMs and the ec2-run-instances command with the -n &gt;n1 -n2&gt;
-                  option is used to deploy multiple VMs.</para></entry>
-            </row>
-          </tbody>
-        </tgroup>
-      </informaltable>
-    </section>
-  </chapter>
-  <chapter id="api-changes-4.0">
-    <title>API Changes from 3.0.2 to 4.0.0-incubating</title>
-    <section id="new-api-commands-4.0">
-      <title>New API Commands in 4.0.0-incubating</title>
-      <itemizedlist>
-        <listitem>
-          <para>createCounter (Adds metric counter)</para>
-        </listitem>
-        <listitem>
-          <para>deleteCounter (Deletes a counter)</para>
-        </listitem>
-        <listitem>
-          <para>listCounters (List the counters)</para>
-        </listitem>
-        <listitem>
-          <para>createCondition (Creates a condition)</para>
-        </listitem>
-        <listitem>
-          <para>deleteCondition (Removes a condition)</para>
-        </listitem>
-        <listitem>
-          <para>listConditions (List Conditions for the specific user)</para>
-        </listitem>
-        <listitem>
-          <para>createTags. Add tags to one or more resources. Example:
-            <programlisting>command=createTags
-&amp;resourceIds=1,10,12
-&amp;resourceType=userVm
-&amp;tags[0].key=region
-&amp;tags[0].value=canada
-&amp;tags[1].key=city
-&amp;tags[1].value=Toronto</programlisting></para>
-        </listitem>
-        <listitem>
-          <para>deleteTags. Remove tags from one or more resources. Example:
-            <programlisting>command=deleteTags
-&amp;resourceIds=1,12
-&amp;resourceType=Snapshot
-&amp;tags[0].key=city</programlisting></para>
-        </listitem>
-        <listitem>
-          <para>listTags (Show currently defined resource tags)</para>
-        </listitem>
-        <listitem>
-          <para>createVPC (Creates a VPC)</para>
-        </listitem>
-        <listitem>
-          <para>listVPCs (Lists VPCs)</para>
-        </listitem>
-        <listitem>
-          <para>deleteVPC (Deletes a VPC)</para>
-        </listitem>
-        <listitem>
-          <para>updateVPC (Updates a VPC)</para>
-        </listitem>
-        <listitem>
-          <para>restartVPC (Restarts a VPC)</para>
-        </listitem>
-        <listitem>
-          <para>createVPCOffering (Creates VPC offering)</para>
-        </listitem>
-        <listitem>
-          <para>updateVPCOffering (Updates VPC offering)</para>
-        </listitem>
-        <listitem>
-          <para>deleteVPCOffering (Deletes VPC offering)</para>
-        </listitem>
-        <listitem>
-          <para>listVPCOfferings (Lists VPC offerings)</para>
-        </listitem>
-        <listitem>
-          <para>createPrivateGateway (Creates a private gateway)</para>
-        </listitem>
-        <listitem>
-          <para>listPrivateGateways (List private gateways)</para>
-        </listitem>
-        <listitem>
-          <para>deletePrivateGateway (Deletes a Private gateway)</para>
-        </listitem>
-        <listitem>
-          <para>createNetworkACL (Creates a ACL rule the given network (the network has to belong to
-            VPC))</para>
-        </listitem>
-        <listitem>
-          <para>deleteNetworkACL (Deletes a Network ACL)</para>
-        </listitem>
-        <listitem>
-          <para>listNetworkACLs (Lists all network ACLs)</para>
-        </listitem>
-        <listitem>
-          <para>createStaticRoute (Creates a static route)</para>
-        </listitem>
-        <listitem>
-          <para>deleteStaticRoute (Deletes a static route)</para>
-        </listitem>
-        <listitem>
-          <para>listStaticRoutes (Lists all static routes)</para>
-        </listitem>
-        <listitem>
-          <para>createVpnCustomerGateway (Creates site to site vpn customer gateway)</para>
-        </listitem>
-        <listitem>
-          <para>createVpnGateway (Creates site to site vpn local gateway)</para>
-        </listitem>
-        <listitem>
-          <para>createVpnConnection (Create site to site vpn connection)</para>
-        </listitem>
-        <listitem>
-          <para>deleteVpnCustomerGateway (Delete site to site vpn customer gateway)</para>
-        </listitem>
-        <listitem>
-          <para>deleteVpnGateway (Delete site to site vpn gateway)</para>
-        </listitem>
-        <listitem>
-          <para>deleteVpnConnection (Delete site to site vpn connection)</para>
-        </listitem>
-        <listitem>
-          <para>updateVpnCustomerGateway (Update site to site vpn customer gateway)</para>
-        </listitem>
-        <listitem>
-          <para>resetVpnConnection (Reset site to site vpn connection)</para>
-        </listitem>
-        <listitem>
-          <para>listVpnCustomerGateways (Lists site to site vpn customer gateways)</para>
-        </listitem>
-        <listitem>
-          <para>listVpnGateways (Lists site 2 site vpn gateways)</para>
-        </listitem>
-        <listitem>
-          <para>listVpnConnections (Lists site to site vpn connection gateways)</para>
-        </listitem>
-        <listitem>
-          <para>markDefaultZoneForAccount (Marks a default zone for the current account)</para>
-        </listitem>
-        <listitem>
-          <para>uploadVolume (Uploads a data disk)</para>
-        </listitem>
-      </itemizedlist>
-    </section>
-    <section id="changed-api-commands-4.0">
-      <title>Changed API Commands in 4.0.0-incubating</title>
-      <informaltable>
-        <tgroup cols="2" align="left" colsep="1" rowsep="1">
-          <colspec colwidth="1.0*" colname="1" colnum="1"/>
-          <colspec colwidth="2.28*" colname="2" colnum="2"/>
-          <thead>
-            <row>
-              <entry><para>API Commands</para></entry>
-              <entry><para>Description</para></entry>
-            </row>
-          </thead>
-          <tbody>
-            <row>
-              <entry>
-                <para>copyTemplate</para>
-                <para>prepareTemplate</para>
-                <para>registerTemplate</para>
-                <para>updateTemplate</para>
-                <para>createProject</para>
-                <para>activateProject</para>
-                <para>suspendProject</para>
-                <para>updateProject</para>
-                <para>listProjectAccounts</para>
-                <para>createVolume</para>
-                <para>migrateVolume</para>
-                <para>attachVolume</para>
-                <para>detachVolume</para>
-                <para>uploadVolume</para>
-                <para>createSecurityGroup</para>
-                <para>registerIso</para>
-                <para>copyIso</para>
-                <para>updateIso</para>
-                <para>createIpForwardingRule</para>
-                <para>listIpForwardingRules</para>
-                <para>createLoadBalancerRule</para>
-                <para>updateLoadBalancerRule</para>
-                <para>createSnapshot</para>
-              </entry>
-              <entry>
-                <para>The commands in this list have a single new response parameter, and no other
-                  changes.</para>
-                <para>New response parameter: tags(*)</para>
-                <note>
-                  <para>Many other commands also have the new tags(*) parameter in addition to other
-                    changes; those commands are listed separately.</para>
-                </note></entry>
-            </row>
-            <row>
-              <entry>
-                <para>rebootVirtualMachine</para>
-                <para>attachIso</para>
-                <para>det

<TRUNCATED>