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/17 07:19:04 UTC
git commit: updated refs/heads/4.2 to 7234bb3
Updated Branches:
refs/heads/4.2 1fc8991d6 -> 7234bb347
CLOUDSTACK-2763
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/7234bb34
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/7234bb34
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/7234bb34
Branch: refs/heads/4.2
Commit: 7234bb347e99e35751767fa24cd3f126fb121813
Parents: 1fc8991
Author: radhikap <ra...@citrix.com>
Authored: Wed Jul 17 10:48:43 2013 +0530
Committer: radhikap <ra...@citrix.com>
Committed: Wed Jul 17 10:48:43 2013 +0530
----------------------------------------------------------------------
docs/en-US/add-loadbalancer-rule-vpc.xml | 317 +++++++++++++++++---------
docs/en-US/add-vm-tier-sharednw.xml | 62 +++++
docs/en-US/add-vpc.xml | 7 +-
docs/en-US/images/add-vpc.png | Bin 16597 -> 20392 bytes
4 files changed, 278 insertions(+), 108 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7234bb34/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/7234bb34/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
new file mode 100644
index 0000000..a688604
--- /dev/null
+++ b/docs/en-US/add-vm-tier-sharednw.xml
@@ -0,0 +1,62 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+<!-- 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.
+-->
+<section id="add-vm-tier-sharednw">
+ <title>Deploying VMs to VPC Tier and Shared Networks</title>
+ <para>&PRODUCT; allows you deploy VMs on a VPC tier and one or more shared networks. With this
+ feature, VMs deployed in a multi-tier application can receive monitoring services via a shared
+ network provided by a service provider.</para>
+ <orderedlist>
+ <listitem>
+ <para>Log in to the &PRODUCT; UI as an administrator.</para>
+ </listitem>
+ <listitem>
+ <para>In the left navigation, choose Instances.</para>
+ </listitem>
+ <listitem>
+ <para>Click Add Instance.</para>
+ </listitem>
+ <listitem>
+ <para>Select a zone.</para>
+ </listitem>
+ <listitem>
+ <para>Select a template or ISO, then follow the steps in the wizard. </para>
+ </listitem>
+ <listitem>
+ <para>Ensure that the hardware you have allows starting the selected service offering.</para>
+ </listitem>
+ <listitem>
+ <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>
+ <imagedata fileref="./images/addvm-tier-sharednw.png"/>
+ </imageobject>
+ <textobject>
+ <phrase>addvm-tier-sharednw.png: adding a VM to a VPC tier and shared network.</phrase>
+ </textobject>
+ </mediaobject>
+ </listitem>
+ <listitem>
+ <para>Click Next, review the configuration and click Launch.</para>
+ <para>Your VM will be deployed to the selected VPC tier and shared network.</para>
+ </listitem>
+ </orderedlist>
+</section>
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7234bb34/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/7234bb34/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