You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cloudstack.apache.org by ra...@apache.org on 2013/07/05 12:39:27 UTC
git commit: updated refs/heads/master to c56a75d
Updated Branches:
refs/heads/master 0d7d34533 -> c56a75da9
CLOUDSTACK-2763
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/c56a75da
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/c56a75da
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/c56a75da
Branch: refs/heads/master
Commit: c56a75da9c0c38dc1d9d5fbaa4ba21371d3d17d6
Parents: 0d7d345
Author: Radhika PC <ra...@citrix.com>
Authored: Fri Jul 5 16:07:04 2013 +0530
Committer: Radhika PC <ra...@citrix.com>
Committed: Fri Jul 5 16:07:42 2013 +0530
----------------------------------------------------------------------
docs/en-US/add-loadbalancer-rule-vpc.xml | 317 +++++++++++++++++---------
docs/en-US/add-vm-tier-sharednw.xml | 2 +-
docs/en-US/add-vpc.xml | 7 +-
docs/en-US/images/add-vpc.png | Bin 16597 -> 20392 bytes
4 files changed, 217 insertions(+), 109 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/c56a75da/docs/en-US/add-loadbalancer-rule-vpc.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/add-loadbalancer-rule-vpc.xml b/docs/en-US/add-loadbalancer-rule-vpc.xml
index 82e8702..0f2a83d 100644
--- a/docs/en-US/add-loadbalancer-rule-vpc.xml
+++ b/docs/en-US/add-loadbalancer-rule-vpc.xml
@@ -35,113 +35,216 @@
received at a public IP to one or more VMs that belong to a network tier that provides load
balancing service in a VPC. A user creates a rule, specifies an algorithm, and assigns the
rule to a set of VMs within a tier.</para>
- <orderedlist>
- <listitem>
- <para>Log in to the &PRODUCT; UI as an administrator or end user.</para>
- </listitem>
- <listitem>
- <para>In the left navigation, choose Network.</para>
- </listitem>
- <listitem>
- <para>In the Select view, select VPC.</para>
- <para>All the VPCs that you have created for the account is listed in the page.</para>
- </listitem>
- <listitem>
- <para>Click the Configure button of the VPC, for which you want to configure load balancing
- rules.</para>
- <para>The VPC page is displayed where all the tiers you created listed in a diagram.</para>
- <para>For each tier, the following options are displayed:</para>
- <itemizedlist>
- <listitem>
- <para>Internal LB</para>
- </listitem>
- <listitem>
- <para>Public LB IP</para>
- </listitem>
- <listitem>
- <para>Static NAT</para>
- </listitem>
- <listitem>
- <para>Virtual Machines</para>
- </listitem>
- <listitem>
- <para>CIDR</para>
- </listitem>
- </itemizedlist>
- <para>The following router information is displayed:</para>
- <itemizedlist>
- <listitem>
- <para>Private Gateways</para>
- </listitem>
- <listitem>
- <para>Public IP Addresses</para>
- </listitem>
- <listitem>
- <para>Site-to-Site VPNs</para>
- </listitem>
- <listitem>
- <para>Network ACL Lists</para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para>In the Router node, select Public IP Addresses.</para>
- <para>The IP Addresses page is displayed.</para>
- </listitem>
- <listitem>
- <para>Click the IP address for which you want to create the rule, then click the
- Configuration tab.</para>
- </listitem>
- <listitem>
- <para>In the Load Balancing node of the diagram, click View All.</para>
- </listitem>
- <listitem>
- <para>Select the tier to which you want to apply the rule.</para>
- </listitem>
- <listitem>
- <para>Specify the following:</para>
- <itemizedlist>
- <listitem>
- <para><emphasis role="bold">Name</emphasis>: A name for the load balancer rule.</para>
- </listitem>
- <listitem>
- <para><emphasis role="bold">Public Port</emphasis>: The port that receives the incoming
- traffic to be balanced.</para>
- </listitem>
- <listitem>
- <para><emphasis role="bold">Private Port</emphasis>: The port that the VMs will use to
- receive the traffic.</para>
- </listitem>
- <listitem>
- <para><emphasis role="bold">Algorithm</emphasis>. Choose the load balancing algorithm
- you want &PRODUCT; to use. &PRODUCT; supports the following well-known
- algorithms:</para>
- <itemizedlist>
- <listitem>
- <para>Round-robin</para>
- </listitem>
- <listitem>
- <para>Least connections</para>
- </listitem>
- <listitem>
- <para>Source</para>
- </listitem>
- </itemizedlist>
- </listitem>
- <listitem>
- <para><emphasis role="bold">Stickiness</emphasis>. (Optional) Click Configure and choose
- the algorithm for the stickiness policy. See Sticky Session Policies for Load Balancer
- Rules.</para>
- </listitem>
- <listitem>
- <para><emphasis role="bold">Add VMs</emphasis>: Click Add VMs, then select two or more
- VMs that will divide the load of incoming traffic, and click Apply.</para>
- </listitem>
- </itemizedlist>
- </listitem>
- </orderedlist>
- <para>The new load balancing rule appears in the list. You can repeat these steps to add more
- load balancing rules for this IP address.</para>
+ <section id="enable-vpc-public-lb">
+ <title>Enabling NetScaler as the LB Provider on a VPC Tier</title>
+ <orderedlist>
+ <listitem>
+ <para>Add and enable Netscaler VPX in dedicated mode.</para>
+ <para>Netscaler can be used in a VPC environment only if it is in dedicated mode.</para>
+ </listitem>
+ <listitem>
+ <para>Create a network offering, as given in <xref linkend="ext-lb-offering"/>.</para>
+ </listitem>
+ <listitem>
+ <para>Create a VPC with Netscaler as the Public LB provider.</para>
+ <para>For more information, see <xref linkend="add-vpc"/>.</para>
+ </listitem>
+ <listitem>
+ <para>For the VPC, acquire an IP.</para>
+ </listitem>
+ <listitem>
+ <para>Create an external load balancing rule and apply, as given in <xref
+ linkend="ext-lb-vpc"/>.</para>
+ </listitem>
+ </orderedlist>
+ </section>
+ <section id="ext-lb-offering">
+ <title>Creating a Network Offering for External LB</title>
+ <para>To have internal LB support on VPC, create a network offering as follows: </para>
+ <orderedlist>
+ <listitem>
+ <para>Log in to the &PRODUCT; UI as a user or admin.</para>
+ </listitem>
+ <listitem>
+ <para>From the Select Offering drop-down, choose Network Offering.</para>
+ </listitem>
+ <listitem>
+ <para>Click Add Network Offering.</para>
+ </listitem>
+ <listitem>
+ <para>In the dialog, make the following choices:</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="bold">Name</emphasis>: Any desired name for the network
+ offering.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Description</emphasis>: A short description of the
+ offering that can be displayed to users.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Network Rate</emphasis>: Allowed data transfer rate in MB
+ per second.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Traffic Type</emphasis>: The type of network traffic that
+ will be carried on the network.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Guest Type</emphasis>: Choose whether the guest network is
+ isolated or shared.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Persistent</emphasis>: Indicate whether the guest network
+ is persistent or not. The network that you can provision without having to deploy a
+ VM on it is termed persistent network. </para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">VPC</emphasis>: This option indicate whether the guest
+ network is Virtual Private Cloud-enabled. A Virtual Private Cloud (VPC) is a
+ private, isolated part of &PRODUCT;. A VPC can have its own virtual network topology
+ that resembles a traditional physical network. For more information on VPCs, see
+ <xref linkend="vpc"/>.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Specify VLAN</emphasis>: (Isolated guest networks only)
+ Indicate whether a VLAN should be specified when this offering is used.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Supported Services</emphasis>: Select Load Balancer.
+ Select <code>InternalLbVM</code> from the provider list.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Load Balancer Type</emphasis>: Select external LB from the
+ drop-down. Use Netscaler</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">System Offering</emphasis>: Choose the system service
+ offering that you want virtual routers to use in this network.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Conserve mode</emphasis>: Indicate whether to use conserve
+ mode. In this mode, network resources are allocated only when the first virtual
+ machine starts in the network.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>Click OK and the network offering is created.</para>
+ </listitem>
+ </orderedlist>
+ </section>
+ <section id="ext-lb-vpc">
+ <title>Creating an External LB Rule</title>
+ <orderedlist>
+ <listitem>
+ <para>Log in to the &PRODUCT; UI as an administrator or end user.</para>
+ </listitem>
+ <listitem>
+ <para>In the left navigation, choose Network.</para>
+ </listitem>
+ <listitem>
+ <para>In the Select view, select VPC.</para>
+ <para>All the VPCs that you have created for the account is listed in the page.</para>
+ </listitem>
+ <listitem>
+ <para>Click the Configure button of the VPC, for which you want to configure load
+ balancing rules.</para>
+ <para>The VPC page is displayed where all the tiers you created listed in a
+ diagram.</para>
+ <para>For each tier, the following options are displayed:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Internal LB</para>
+ </listitem>
+ <listitem>
+ <para>Public LB IP</para>
+ </listitem>
+ <listitem>
+ <para>Static NAT</para>
+ </listitem>
+ <listitem>
+ <para>Virtual Machines</para>
+ </listitem>
+ <listitem>
+ <para>CIDR</para>
+ </listitem>
+ </itemizedlist>
+ <para>The following router information is displayed:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Private Gateways</para>
+ </listitem>
+ <listitem>
+ <para>Public IP Addresses</para>
+ </listitem>
+ <listitem>
+ <para>Site-to-Site VPNs</para>
+ </listitem>
+ <listitem>
+ <para>Network ACL Lists</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para>In the Router node, select Public IP Addresses.</para>
+ <para>The IP Addresses page is displayed.</para>
+ </listitem>
+ <listitem>
+ <para>Click the IP address for which you want to create the rule, then click the
+ Configuration tab.</para>
+ </listitem>
+ <listitem>
+ <para>In the Load Balancing node of the diagram, click View All.</para>
+ </listitem>
+ <listitem>
+ <para>Select the tier to which you want to apply the rule.</para>
+ </listitem>
+ <listitem>
+ <para>Specify the following:</para>
+ <itemizedlist>
+ <listitem>
+ <para><emphasis role="bold">Name</emphasis>: A name for the load balancer rule.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Public Port</emphasis>: The port that receives the
+ incoming traffic to be balanced.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Private Port</emphasis>: The port that the VMs will use to
+ receive the traffic.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Algorithm</emphasis>. Choose the load balancing algorithm
+ you want &PRODUCT; to use. &PRODUCT; supports the following well-known
+ algorithms:</para>
+ <itemizedlist>
+ <listitem>
+ <para>Round-robin</para>
+ </listitem>
+ <listitem>
+ <para>Least connections</para>
+ </listitem>
+ <listitem>
+ <para>Source</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Stickiness</emphasis>. (Optional) Click Configure and
+ choose the algorithm for the stickiness policy. See Sticky Session Policies for Load
+ Balancer Rules.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Add VMs</emphasis>: Click Add VMs, then select two or more
+ VMs that will divide the load of incoming traffic, and click Apply.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </orderedlist>
+ <para>The new load balancing rule appears in the list. You can repeat these steps to add more
+ load balancing rules for this IP address.</para>
+ </section>
</section>
<section id="acros-tiers-lb">
<title>Load Balancing Across Tiers</title>
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/c56a75da/docs/en-US/add-vm-tier-sharednw.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/add-vm-tier-sharednw.xml b/docs/en-US/add-vm-tier-sharednw.xml
index 411b943..a688604 100644
--- a/docs/en-US/add-vm-tier-sharednw.xml
+++ b/docs/en-US/add-vm-tier-sharednw.xml
@@ -43,7 +43,7 @@
<para>Ensure that the hardware you have allows starting the selected service offering.</para>
</listitem>
<listitem>
- <para>Under Networks, select networks for the VM you are launching.</para>
+ <para>Under Networks, select the desired networks for the VM you are launching.</para>
<para>You can deploy a VM to a VPC tier and multiple shared networks.</para>
<mediaobject>
<imageobject>
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/c56a75da/docs/en-US/add-vpc.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/add-vpc.xml b/docs/en-US/add-vpc.xml
index 8c088a0..b8034c4 100644
--- a/docs/en-US/add-vpc.xml
+++ b/docs/en-US/add-vpc.xml
@@ -67,9 +67,14 @@
assign a special domain name, specify the DNS suffix. This parameter is applied to all
the tiers within the VPC. That implies, all the tiers you create in the VPC belong to
the same DNS domain. If the parameter is not specified, a DNS domain name is generated
- automatically. </para>
+ automatically.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Public Load Balancer Provider</emphasis>: You have two
+ options: VPC Virtual Router and Netscaler.</para>
</listitem>
</itemizedlist>
</listitem>
+ <listitem><para>Click OK.</para></listitem>
</orderedlist>
</section>
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/c56a75da/docs/en-US/images/add-vpc.png
----------------------------------------------------------------------
diff --git a/docs/en-US/images/add-vpc.png b/docs/en-US/images/add-vpc.png
index 6b9c637..f334862 100644
Binary files a/docs/en-US/images/add-vpc.png and b/docs/en-US/images/add-vpc.png differ