cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From radh...@apache.org
Subject git commit: updated refs/heads/master to 1108aa7
Date Tue, 20 Aug 2013 08:12:37 GMT
Updated Branches:
  refs/heads/master 7cc27e887 -> 1108aa7d4


added a new chapter for 4.2


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

Branch: refs/heads/master
Commit: 1108aa7d4c7a512768ac494fb956afc3e5e84ce9
Parents: 7cc27e8
Author: radhikap <radhika.puthiyetath@citrix.com>
Authored: Tue Aug 20 13:42:03 2013 +0530
Committer: radhikap <radhika.puthiyetath@citrix.com>
Committed: Tue Aug 20 13:42:03 2013 +0530

----------------------------------------------------------------------
 docs/en-US/Release_Notes.xml | 520 ++++++++++++++++++++++++++++++++++++--
 1 file changed, 499 insertions(+), 21 deletions(-)
----------------------------------------------------------------------


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


Mime
View raw message