CLOUDSTACK-772 release notes IDREF issues fixed, dvSwitch comments

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

Branch: refs/heads/4.2
Commit: 36fade1c169059e73a6e96d2200598da3363c68b
Parents: d9aa97c
Author: radhikap <[email protected]>
Authored: Mon Aug 26 16:37:45 2013 +0530
Committer: radhikap <[email protected]>
Committed: Mon Aug 26 16:38:21 2013 +0530

----------------------------------------------------------------------
 docs/en-US/Release_Notes.xml                  |  94 ++++++++++-----------
 docs/en-US/images/vds-name.png                | Bin 0 -> 64739 bytes
 docs/en-US/vmware-cluster-config-dvswitch.xml |  94 +++++++++------------
 docs/en-US/vmware-install.xml                 |   2 +-
 4 files changed, 90 insertions(+), 100 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cloudstack/blob/36fade1c/docs/en-US/Release_Notes.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/Release_Notes.xml b/docs/en-US/Release_Notes.xml
index ca1e192..8fde51c 100644
--- a/docs/en-US/Release_Notes.xml
+++ b/docs/en-US/Release_Notes.xml
@@ -369,7 +369,7 @@ under the License.
         </tgroup>
       </informaltable>
     </section>
-    <section id="known-issues-4.1">
+    <section id="known-issues-4.2">
       <title>Known Issues in 4.2.0</title>
       <informaltable>
         <tgroup cols="2" align="left" colsep="1" rowsep="1">
@@ -544,7 +544,7 @@ under the License.
       </informaltable>
     </section>
   </chapter>
-  <chapter id="upgrade-instructions">
+  <chapter id="upgrade-instruction">
     <title>Upgrade Instructions</title>
     <para>This section contains upgrade instructions from prior versions of 
CloudStack to Apache
       CloudStack 4.2.0. We include instructions on upgrading to Apache 
CloudStack from pre-Apache
@@ -552,7 +552,7 @@ under the License.
       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
       [email protected] or [email protected].</para>
-    <section id="upgrade-from-4.0-to-4.1">
+    <section id="upgrade-from-4.0-to-4.2">
       <title>Upgrade from 4.x.x to 4.2.0</title>
       <para>This section will guide you from &PRODUCT; 4.0.x versions to 
&PRODUCT; 4.2.0.</para>
       <para>Any steps that are hypervisor-specific will be called out with a 
note.</para>
@@ -579,7 +579,7 @@ under the License.
               url="http://cloudstack.apache.org/downloads.html";
               >http://cloudstack.apache.org/downloads.html</ulink> for package 
repositories supplied
             by community members. You will need them for step <xref 
linkend="upgrade-deb-packages"/>
-            or step <xref linkend="upgrade-rpm-packages"/>.</para>
+            or step <xref linkend="upgrade-rpm-package"/>.</para>
           <para>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>
@@ -630,7 +630,7 @@ under the License.
         </listitem>
         <listitem id="upgrade-deb-packages">
           <para>If you are using Ubuntu, follow this procedure to upgrade your 
packages. If not,
-            skip to step <xref linkend="upgrade-rpm-packages"/>.</para>
+            skip to step <xref linkend="upgrade-rpm-package"/>.</para>
           <note>
             <title>Community Packages</title>
             <para>This section assumes you're using the community supplied 
packages for &PRODUCT;.
@@ -656,7 +656,7 @@ under the License.
               <para>Now update your apt package list:</para>
               <programlisting language="Bash">$ sudo apt-get 
update</programlisting>
             </listitem>
-            <listitem id="deb-master">
+            <listitem id="debmaster">
               <para>Now that you have the repository configured, it's time to 
install the
                   <filename>cloudstack-management</filename> package. This 
will pull in any other
                 dependencies you need.</para>
@@ -780,7 +780,7 @@ service cloudstack-agent restart
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="upgrade-rpm-packages">
+        <listitem id="upgrade-rpm-package">
           <para>If you are using CentOS or RHEL, follow this procedure to 
upgrade your packages. If
             not, skip to step <xref linkend="restart-system-vms"/>.</para>
           <note>
@@ -789,7 +789,7 @@ service cloudstack-agent restart
               If you've created your own packages and yum repository, 
substitute your own URL for
               the ones used in these examples.</para>
           </note>
-          <orderedlist id="rpmsteps">
+          <orderedlist id="rpmstep">
             <listitem>
               <para>The first order of business will be to change the yum 
repository for each system
                 with &PRODUCT; packages. This means all management servers, 
and any hosts that have
@@ -811,7 +811,7 @@ gpgcheck=0
               <para>If you're using your own package repository, change this 
line to read as
                 appropriate for your 4.2.0 repository.</para>
             </listitem>
-            <listitem id="rpm-master">
+            <listitem id="rpmmaster">
               <para>Now that you have the repository configured, it's time to 
install the
                   <filename>cloudstack-management</filename> package by 
upgrading the older
                   <filename>cloud-client</filename> package.</para>
@@ -889,7 +889,7 @@ Done restarting router(s).
         </listitem>
       </orderedlist>
     </section>
-    <section id="upgrade-from-3.0.2-to-4.0">
+    <section id="upgrade-from-3.0.2-to-4.2">
       <title>Upgrade from 3.0.2 to 4.2.0</title>
       <para>This section will guide you from Citrix CloudStack 3.0.2 to Apache 
CloudStack 4.2.0.
         Sections that are hypervisor-specific will be called out with a 
note.</para>
@@ -898,7 +898,7 @@ Done restarting router(s).
           <note>
             <para>The following upgrade instructions apply only if you're 
using VMware hosts. If
               you're not using VMware hosts, skip this step and move on to 
<xref
-                linkend="stopping-usage-servers"/>.</para>
+                linkend="stopping-usageservers"/>.</para>
           </note>
           <para>In each zone that includes VMware hosts, you need to add a new 
system VM template. </para>
           <orderedlist numeration="loweralpha">
@@ -984,7 +984,7 @@ Done restarting router(s).
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="stopping-usage-servers">
+        <listitem id="stoppingusage-servers">
           <para>Stop all Usage Servers if running. Run this on all Usage 
Server hosts.</para>
           <programlisting language="Bash"><prompt>#</prompt> service 
cloud-usage stop</programlisting>
         </listitem>
@@ -1483,7 +1483,7 @@ service cloudstack-agent start
           issues are seen, try clearing your browser cache and reloading the 
UI page.</para>
       </note>
     </section>
-    <section id="upgrade-from-2.2.x-to-4.1">
+    <section id="upgrade-from-2.2.x-to-4.2">
       <title>Upgrade from 2.2.14 to 4.2.0</title>
       <orderedlist>
         <listitem>
@@ -1707,7 +1707,7 @@ service cloudstack-agent restart
         </listitem>
         <listitem id="upgrade-rpm-packages-22">
           <para>If you are using CentOS or RHEL, follow this procedure to 
upgrade your packages. If
-            not, skip to step <xref 
linkend="correct-components-xml-22"/>.</para>
+            not, skip to step <xref 
linkend="correct-components-xml-23"/>.</para>
           <note>
             <title>Community Packages</title>
             <para>This section assumes you're using the community supplied 
packages for &PRODUCT;.
@@ -1770,7 +1770,7 @@ service cloudstack-agent start
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="correct-components-xml-22">
+        <listitem id="correct-components-xml-23">
           <para>If you have made changes to your existing copy of the file 
components.xml in your
             previous-version CloudStack installation, the changes will be 
preserved in the upgrade.
             However, you need to do the following steps to place these changes 
in a new version of
@@ -6755,7 +6755,7 @@ service cloudstack-agent start
             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. You will need them for step <xref 
linkend="upgrade-deb-packages"/>
+            by community members. You will need them for step <xref 
linkend="upgrade-debpackages"/>
             or step <xref linkend="upgrade-rpm-packages"/>.</para>
           <para>Instructions for creating packages from the &PRODUCT; source 
are in the <ulink
               
url="http://cloudstack.apache.org/docs/en-US/index.html";>Installation
@@ -6805,7 +6805,7 @@ service cloudstack-agent start
           <para>PlainTextUserAuthenticator works the same way 
MD5UserAuthenticator worked prior to
             4.1.</para>
         </listitem>
-        <listitem id="upgrade-deb-packages">
+        <listitem id="upgrade-debpackages">
           <para>If you are using Ubuntu, follow this procedure to upgrade your 
packages. If not,
             skip to step <xref linkend="upgrade-rpm-packages"/>.</para>
           <note>
@@ -6814,7 +6814,7 @@ service cloudstack-agent start
               If you've created your own packages and APT repository, 
substitute your own URL for
               the ones used in these examples.</para>
           </note>
-          <orderedlist id="debsteps">
+          <orderedlist id="debstep">
             <listitem>
               <para>The first order of business will be to change the sources 
list for each system
                 with &PRODUCT; packages. This means all management servers, 
and any hosts that have
@@ -6839,7 +6839,7 @@ service cloudstack-agent start
                 dependencies you need.</para>
               <programlisting language="Bash">$ sudo apt-get install 
cloudstack-management</programlisting>
             </listitem>
-            <listitem id="kvm-agent-deb">
+            <listitem id="kvm-agentdeb">
               <para>You will need to manually install the 
<filename>cloudstack-agent</filename>
                 package:</para>
               <programlisting language="Bash">$ sudo apt-get install 
cloudstack-agent</programlisting>
@@ -6886,7 +6886,7 @@ service cloudstack-agent restart
         </listitem>
         <listitem id="upgrade-rpm-packages">
           <para>If you are using CentOS or RHEL, follow this procedure to 
upgrade your packages. If
-            not, skip to step <xref linkend="restart-system-vms"/>.</para>
+            not, skip to step <xref linkend="restart-systemvms"/>.</para>
           <note>
             <title>Community Packages</title>
             <para>This section assumes you're using the community supplied 
packages for &PRODUCT;.
@@ -6920,7 +6920,7 @@ gpgcheck=0
                   <filename>cloud-client</filename> package.</para>
               <programlisting language="Bash">$ sudo yum upgrade 
cloud-client</programlisting>
             </listitem>
-            <listitem id="kvm-agent-rpm">
+            <listitem id="kvm-agentrpm">
               <para>For KVM hosts, you will need to upgrade the 
<filename>cloud-agent</filename>
                 package, similarly installing the new version as
                   <filename>cloudstack-agent</filename>.</para>
@@ -6949,7 +6949,7 @@ service cloudstack-agent start
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="restart-system-vms">
+        <listitem id="restart-systemvms">
           <para>Once you've upgraded the packages on your management servers, 
you'll need to restart
             the system VMs. Make sure port 8096 is open in your local host 
firewall to do
             this.</para>
@@ -6979,7 +6979,7 @@ Done restarting router(s).
         </listitem>
       </orderedlist>
     </section>
-    <section id="upgrade-from-3.0.2-to-4.0">
+    <section id="upgrade-from-3.0.2-to-4.1">
       <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>
@@ -6988,7 +6988,7 @@ Done restarting router(s).
           <note>
             <para>The following upgrade instructions apply only if you're 
using VMware hosts. If
               you're not using VMware hosts, skip this step and move on to 
<xref
-                linkend="stopping-usage-servers"/>.</para>
+                linkend="stopping-usageservers"/>.</para>
           </note>
           <para>In each zone that includes VMware hosts, you need to add a new 
system VM template. </para>
           <orderedlist numeration="loweralpha">
@@ -7074,7 +7074,7 @@ Done restarting router(s).
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="stopping-usage-servers">
+        <listitem id="stopping-usageservers">
           <para>Stop all Usage Servers if running. Run this on all Usage 
Server hosts.</para>
           <programlisting language="Bash"><prompt>#</prompt> service 
cloud-usage stop</programlisting>
         </listitem>
@@ -7097,16 +7097,16 @@ Done restarting router(s).
             the community provided yum/apt repositories to gain access to the 
&PRODUCT;
             binaries.</para>
         </listitem>
-        <listitem id="upgrade-deb-packages-302">
+        <listitem id="upgrade-deb-packages-303">
           <para>If you are using Ubuntu, follow this procedure to upgrade your 
packages. If not,
-            skip to step <xref linkend="upgrade-rpm-packages-302"/>.</para>
+            skip to step <xref linkend="upgrade-rpm-packages-303"/>.</para>
           <note>
             <title>Community Packages</title>
             <para>This section assumes you're using the community supplied 
packages for &PRODUCT;.
               If you've created your own packages and APT repository, 
substitute your own URL for
               the ones used in these examples.</para>
           </note>
-          <orderedlist id="debsteps-302">
+          <orderedlist id="debsteps-303">
             <listitem>
               <para>The first order of business will be to change the sources 
list for each system
                 with &PRODUCT; packages. This means all management servers, 
and any hosts that have
@@ -7125,13 +7125,13 @@ Done restarting router(s).
               <para>Now update your apt package list:</para>
               <programlisting language="Bash">$ sudo apt-get 
update</programlisting>
             </listitem>
-            <listitem id="deb-master-302">
+            <listitem id="deb-master-303">
               <para>Now that you have the repository configured, it's time to 
install the
                   <filename>cloudstack-management</filename> package. This 
will pull in any other
                 dependencies you need.</para>
               <programlisting language="Bash">$ sudo apt-get install 
cloudstack-management</programlisting>
             </listitem>
-            <listitem id="kvm-agent-deb-302">
+            <listitem id="kvm-agent-deb-303">
               <para>You will need to manually install the 
<filename>cloudstack-agent</filename>
                 package:</para>
               <programlisting language="Bash">$ sudo apt-get install 
cloudstack-agent</programlisting>
@@ -7176,16 +7176,16 @@ service cloudstack-agent restart
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="upgrade-rpm-packages-302">
+        <listitem id="upgrade-rpm-packages-303">
           <para>If you are using CentOS or RHEL, follow this procedure to 
upgrade your packages. If
-            not, skip to step <xref 
linkend="correct-components-xml-302"/>.</para>
+            not, skip to step <xref 
linkend="correct-components-xml-303"/>.</para>
           <note>
             <title>Community Packages</title>
             <para>This section assumes you're using the community supplied 
packages for &PRODUCT;.
               If you've created your own packages and yum repository, 
substitute your own URL for
               the ones used in these examples.</para>
           </note>
-          <orderedlist id="rpmsteps-302">
+          <orderedlist id="rpmsteps-303">
             <listitem>
               <para>The first order of business will be to change the yum 
repository for each system
                 with &PRODUCT; packages. This means all management servers, 
and any hosts that have
@@ -7206,13 +7206,13 @@ gpgcheck=0
               <para>If you're using your own package repository, change this 
line to read as
                 appropriate for your 4.1.0 repository.</para>
             </listitem>
-            <listitem id="rpm-master-302">
+            <listitem id="rpm-master-303">
               <para>Now that you have the repository configured, it's time to 
install the
                   <filename>cloudstack-management</filename> package by 
upgrading the older
                   <filename>cloud-client</filename> package.</para>
               <programlisting language="Bash">$ sudo yum upgrade 
cloud-client</programlisting>
             </listitem>
-            <listitem id="kvm-agent-rpm-302">
+            <listitem id="kvm-agent-rpm-303">
               <para>For KVM hosts, you will need to upgrade the 
<filename>cloud-agent</filename>
                 package, similarly installing the new version as
                   <filename>cloudstack-agent</filename>.</para>
@@ -7241,7 +7241,7 @@ service cloudstack-agent start
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="correct-components-xml-302">
+        <listitem id="correct-components-xml-303">
           <para>If you have made changes to your copy of
               <filename>/etc/cloud/management/components.xml</filename> the 
changes will be
             preserved in the upgrade. However, you need to do the following 
steps to place these
@@ -7693,16 +7693,16 @@ service cloudstack-agent start
             the community provided yum/apt repositories to gain access to the 
&PRODUCT; binaries.
           </para>
         </listitem>
-        <listitem id="upgrade-deb-packages-22">
+        <listitem id="upgrade-deb-packages-23">
           <para>If you are using Ubuntu, follow this procedure to upgrade your 
packages. If not,
-            skip to step <xref linkend="upgrade-rpm-packages-22"/>.</para>
+            skip to step <xref linkend="upgrade-rpm-packages-23"/>.</para>
           <note>
             <title>Community Packages</title>
             <para>This section assumes you're using the community supplied 
packages for &PRODUCT;.
               If you've created your own packages and APT repository, 
substitute your own URL for
               the ones used in these examples.</para>
           </note>
-          <orderedlist id="debsteps-22">
+          <orderedlist id="debsteps-23">
             <listitem>
               <para>The first order of business will be to change the sources 
list for each system
                 with &PRODUCT; packages. This means all management servers, 
and any hosts that have
@@ -7721,13 +7721,13 @@ service cloudstack-agent start
               <para>Now update your apt package list:</para>
               <programlisting language="Bash">$ sudo apt-get 
update</programlisting>
             </listitem>
-            <listitem id="deb-master-22">
+            <listitem id="deb-master-23">
               <para>Now that you have the repository configured, it's time to 
install the
                   <filename>cloudstack-management</filename> package. This 
will pull in any other
                 dependencies you need.</para>
               <programlisting language="Bash">$ sudo apt-get install 
cloudstack-management</programlisting>
             </listitem>
-            <listitem id="kvm-agent-deb-22">
+            <listitem id="kvm-agent-deb-23">
               <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>
@@ -7772,16 +7772,16 @@ service cloudstack-agent restart
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="upgrade-rpm-packages-22">
+        <listitem id="upgrade-rpm-packages-23">
           <para>If you are using CentOS or RHEL, follow this procedure to 
upgrade your packages. If
-            not, skip to step <xref 
linkend="correct-components-xml-22"/>.</para>
+            not, skip to step <xref 
linkend="correct-components-xml-24"/>.</para>
           <note>
             <title>Community Packages</title>
             <para>This section assumes you're using the community supplied 
packages for &PRODUCT;.
               If you've created your own packages and yum repository, 
substitute your own URL for
               the ones used in these examples.</para>
           </note>
-          <orderedlist id="rpmsteps-22">
+          <orderedlist id="rpmsteps-24">
             <listitem>
               <para>The first order of business will be to change the yum 
repository for each system
                 with &PRODUCT; packages. This means all management servers, 
and any hosts that have
@@ -7802,13 +7802,13 @@ gpgcheck=0
               <para>If you're using your own package repository, change this 
line to read as
                 appropriate for your 4.1.0 repository.</para>
             </listitem>
-            <listitem id="rpm-master-22">
+            <listitem id="rpm-master-23">
               <para>Now that you have the repository configured, it's time to 
install the
                   <filename>cloudstack-management</filename> package by 
upgrading the older
                   <filename>cloud-client</filename> package.</para>
               <programlisting language="Bash">$ sudo yum upgrade 
cloud-client</programlisting>
             </listitem>
-            <listitem id="kvm-agent-rpm-22">
+            <listitem id="kvm-agent-rpm-24">
               <para>For KVM hosts, you will need to upgrade the 
<filename>cloud-agent</filename>
                 package, similarly installing the new version as
                   <filename>cloudstack-agent</filename>.</para>
@@ -7837,7 +7837,7 @@ service cloudstack-agent start
             </listitem>
           </orderedlist>
         </listitem>
-        <listitem id="correct-components-xml-22">
+        <listitem id="correct-components-xml-24">
           <para>If you have made changes to your existing copy of the file 
components.xml in your
             previous-version CloudStack installation, the changes will be 
preserved in the upgrade.
             However, you need to do the following steps to place these changes 
in a new version of

http://git-wip-us.apache.org/repos/asf/cloudstack/blob/36fade1c/docs/en-US/images/vds-name.png
----------------------------------------------------------------------
diff --git a/docs/en-US/images/vds-name.png b/docs/en-US/images/vds-name.png
new file mode 100644
index 0000000..bf5b4fc
Binary files /dev/null and b/docs/en-US/images/vds-name.png differ

http://git-wip-us.apache.org/repos/asf/cloudstack/blob/36fade1c/docs/en-US/vmware-cluster-config-dvswitch.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/vmware-cluster-config-dvswitch.xml 
b/docs/en-US/vmware-cluster-config-dvswitch.xml
index a3250f4..98bee0e 100644
--- a/docs/en-US/vmware-cluster-config-dvswitch.xml
+++ b/docs/en-US/vmware-cluster-config-dvswitch.xml
@@ -20,11 +20,11 @@
  under the License.
 -->
 <section id="vmware-cluster-config-dvswitch">
-  <title>Configuring a vSphere Cluster with VMware Distributed Virtual 
Switch</title>
-  <para>&PRODUCT; supports VMware vNetwork Distributed Switch (VDS) for 
virtual network configuration
-    in a VMware vSphere environment. This section helps you configure VMware 
VDS in a &PRODUCT;
-    deployment. Each vCenter server instance can support up to 128 VDS 
instances and each VDS
-    instance can manage up to 500 VMware hosts.</para>
+  <title>Configuring a VMware Datacenter with VMware Distributed Virtual 
Switch</title>
+  <para>&PRODUCT; supports VMware vNetwork Distributed Switch (VDS) for 
virtual network
+    configuration in a VMware vSphere environment. This section helps you 
configure VMware VDS in a
+    &PRODUCT; deployment. Each vCenter server instance can support up to 128 
VDS instances and each
+    VDS instance 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.
@@ -41,9 +41,7 @@
     <title>Prerequisites and Guidelines</title>
     <itemizedlist>
       <listitem>
-        <para>Do not attempt to configure VDS by altering VMware traffic label 
when configuring
-          physical networks. This will only work for Standard Virtual Switch 
and should not be
-          distributed.</para>
+        <para>VMware VDS is supported only on Public and Guest traffic in 
&PRODUCT;.</para>
       </listitem>
       <listitem>
         <para>VMware VDS does not support multiple VDS per traffic type. If a 
user has many VDS
@@ -51,20 +49,47 @@
           traffic.</para>
       </listitem>
       <listitem>
+        <para>Additional switches of any type can be added for each cluster in 
the same zone. While
+          adding the clusters with different switch type, traffic labels is 
overridden at the
+          cluster level.</para>
+      </listitem>
+      <listitem>
         <para>Management and Storage network does not support VDS. Therefore, 
use Standard Switch
           for these networks.</para>
       </listitem>
+      <listitem>
+        <para>When you remove a guest network, the corresponding dvportgroup 
will not be removed on
+          the vCenter. You must manually delete them on the vCenter.</para>
+      </listitem>
     </itemizedlist>
   </section>
+  <section id="preconfig-checklist-vds">
+    <title>Preparation Checklist</title>
+    <para>For a smoother configuration of VMware VDS, note down the VDS name 
you have added in the
+      datacenter before you start:</para>
+    <mediaobject>
+      <imageobject>
+        <imagedata fileref="./images/vds-name.png"/>
+      </imageobject>
+      <textobject>
+        <phrase>vds-name.png: Name of the dvSwitch as specified in the 
vCenter.</phrase>
+      </textobject>
+    </mediaobject>
+    <para>Use this VDS name when you specify the switch name in the traffic 
label while creating the
+      zone. Traffic label format is [["Name of 
vSwitch/dvSwitch/EthernetPortProfile"][,"VLAN
+      ID"[,"vSwitch Type"]]]</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 given in the 
AddClusterCmd 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>
+      VDS, and &PRODUCT; ignores the VDS-specific parameters that you specify. 
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. Another
+      global parameter that defines VDS configuration is 
vmware.ports.per.dvportgroup. This is the
+      default number of ports per VMware dvPortGroup in a VMware environment. 
This number directly
+      associated with the number of guest network you can create.</para>
     <para>&PRODUCT; supports orchestration of virtual networks in a deployment 
with a mix of Virtual
       Distributed Switch, Standard Virtual Switch and Nexus 1000v Virtual 
Switch. </para>
   </section>
@@ -97,12 +122,12 @@
           <row>
             <entry><para>Cluster Name</para></entry>
             <entry><para>Enter the name of the cluster you created in vCenter. 
For example,
-                &quot;cloud.cluster&quot;.</para></entry>
+                &quot;cloudcluster&quot;.</para></entry>
           </row>
           <row>
             <entry><para>vCenter Host</para></entry>
-            <entry><para>Enter the name or the IP address of the vCenter host 
where you have deployed the VMware
-                VDS.</para></entry>
+            <entry><para>Enter the name or the IP address of the vCenter host 
where you have
+                deployed the VMware VDS.</para></entry>
           </row>
           <row>
             <entry><para>vCenter User name</para></entry>
@@ -116,7 +141,7 @@
           <row>
             <entry><para>vCenter Datacenter</para></entry>
             <entry><para>Enter the vCenter datacenter that the cluster is in. 
For example,
-                &quot;cloud.dc.VM&quot;.</para></entry>
+                &quot;clouddcVM&quot;.</para></entry>
           </row>
           <row>
             <entry><para>Override Public Traffic</para></entry>
@@ -154,40 +179,5 @@
       </tgroup>
     </informaltable>
   </section>
-  <section id="vmware-dvswitch-remove">
-    <title>Removing VMware Virtual Switch</title>
-    <orderedlist>
-      <listitem>
-        <para>In the vCenter datacenter that is served by the VDS, ensure that 
you delete all the
-          hosts in the corresponding cluster.</para>
-      </listitem>
-      <listitem>
-        <para>Log in with Admin permissions to the &PRODUCT; administrator 
UI.</para>
-      </listitem>
-      <listitem>
-        <para>In the left navigation bar, select Infrastructure.</para>
-      </listitem>
-      <listitem>
-        <para>In the Infrastructure page, click View all under Clusters.</para>
-      </listitem>
-      <listitem>
-        <para>Select the cluster where you want to remove the virtual 
switch.</para>
-      </listitem>
-      <listitem>
-        <para>In the VMware dvSwitch tab, click the name of the virtual 
switch.</para>
-      </listitem>
-      <listitem>
-        <para> In the Details page, click Delete VMware dvSwitch icon. 
<inlinemediaobject>
-            <imageobject>
-              <imagedata fileref="./images/delete-button.png"/>
-            </imageobject>
-            <textobject>
-              <phrase>DeleteButton.png: button to delete dvSwitch</phrase>
-            </textobject>
-          </inlinemediaobject>
-        </para>
-        <para>Click Yes in the confirmation dialog box.</para>
-      </listitem>
-    </orderedlist>
-  </section>
+  
 </section>

http://git-wip-us.apache.org/repos/asf/cloudstack/blob/36fade1c/docs/en-US/vmware-install.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/vmware-install.xml b/docs/en-US/vmware-install.xml
index fd88fc7..282cf2e 100644
--- a/docs/en-US/vmware-install.xml
+++ b/docs/en-US/vmware-install.xml
@@ -406,7 +406,7 @@ esxcfg-firewall -o 59000-60000,tcp,out,vncextras
           before you start:</para>
         <itemizedlist>
           <listitem>
-            <para>vCenter Credentials</para>
+            <para>vCenter credentials</para>
           </listitem>
           <listitem>
             <para>Nexus 1000v VSM IP address</para>

Reply via email to