CLOUDSTACK-3236, CLOUDSTACK-892
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/7d8a9e95 Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/7d8a9e95 Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/7d8a9e95 Branch: refs/heads/vmsync Commit: 7d8a9e95d4cebf2cfb115d369c7471327a5684ed Parents: f96442a Author: Radhika PC <radhika.puthiyet...@citrix.com> Authored: Thu Jun 27 16:57:14 2013 +0530 Committer: Radhika PC <radhika.puthiyet...@citrix.com> Committed: Thu Jun 27 16:57:57 2013 +0530 ---------------------------------------------------------------------- docs/en-US/acquire-new-ip-address.xml | 38 +++++++--- docs/en-US/portable-ip | 109 +++++++++++++++++++++++++++++ docs/en-US/portable-ip.xml | 94 ++++++++++++++++++++++--- 3 files changed, 222 insertions(+), 19 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7d8a9e95/docs/en-US/acquire-new-ip-address.xml ---------------------------------------------------------------------- diff --git a/docs/en-US/acquire-new-ip-address.xml b/docs/en-US/acquire-new-ip-address.xml index 8af130c..3dbd79e 100644 --- a/docs/en-US/acquire-new-ip-address.xml +++ b/docs/en-US/acquire-new-ip-address.xml @@ -21,16 +21,32 @@ specific language governing permissions and limitations under the License. --> - <section id="acquire-new-ip-address"> - <title>Acquiring a New IP Address</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>Click the name of the network where you want to work with.</para></listitem> - <listitem><para>Click View IP Addresses.</para></listitem> - <listitem><para>Click Acquire New IP, and click Yes in the confirmation dialog.</para> - <para>You are prompted for confirmation because, typically, IP addresses are a limited resource. Within a few moments, the new IP address should appear with the state Allocated. You can now use the IP address in port forwarding or static NAT rules.</para> - </listitem> - </orderedlist> + <title>Acquiring a New IP Address</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>Click the name of the network where you want to work with.</para> + </listitem> + <listitem> + <para>Click View IP Addresses.</para> + </listitem> + <listitem> + <para>Click Acquire New IP.</para> + <para>The Acquire New IP window is displayed.</para> + </listitem> + <listitem> + <para>Specify whether you want cross-zone IP or not.</para> + <para>If you want Portable IP click Yes in the confirmation dialog. If you want a normal + Public IP click No.</para> + <para>For more information on Portable IP, see <xref linkend="portable-ip"/>.</para> + <para>Within a few moments, the new IP address should appear with the state Allocated. You can + now use the IP address in port forwarding or static NAT rules.</para> + </listitem> + </orderedlist> </section> http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7d8a9e95/docs/en-US/portable-ip ---------------------------------------------------------------------- diff --git a/docs/en-US/portable-ip b/docs/en-US/portable-ip new file mode 100644 index 0000000..6dfb526 --- /dev/null +++ b/docs/en-US/portable-ip @@ -0,0 +1,109 @@ +<?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="portable-ip"> + <title>Portable IPs</title> + <section id="about-pip"> + <title>About Portable IP</title> + <para>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 use 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="config-pip"> + <title>Configuring Portable IPs</title> + <orderedlist> + <listitem> + <para>Log in to the &PRODUCT; UI as an administrator or end user.</para> + </listitem> + <listitem> + <para>In the left navigation, click Regions.</para> + </listitem> + <listitem> + <para>Choose the Regions that you want to work with.</para> + </listitem> + <listitem> + <para>Click View Portable IP.</para> + </listitem> + <listitem> + <para>Click Portable IP Range.</para> + <para>The Add Portable IP Range window is displayed.</para> + </listitem> + <listitem> + <para>Specify the following:</para> + <itemizedlist> + <listitem> + <para><emphasis role="bold">Start IP/ End IP</emphasis>: A range of IP addresses that + are accessible from the Internet and will be allocated to guest VMs. Enter the first + and last IP addresses that define a range that &PRODUCT; can assign to guest + VMs.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Gateway</emphasis>: The gateway in use for the Portable IP + addresses you are configuring.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Netmask</emphasis>: The netmask associated with the Portable + IP range.</para> + </listitem> + <listitem> + <para><emphasis role="bold">VLAN</emphasis>: The VLAN that will be used for public + traffic.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem> + <para>Click OK.</para> + </listitem> + </orderedlist> + </section> + <section id="acquire-pip"> + <title>Acquiring a Portable IP</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>Click the name of the network where you want to work with.</para> + </listitem> + <listitem> + <para>Click View IP Addresses.</para> + </listitem> + <listitem> + <para>Click Acquire New IP.</para> + <para>The Acquire New IP window is displayed.</para> + </listitem> + <listitem> + <para>Specify whether you want cross-zone IP or not.</para> + </listitem> + <listitem> + <para>Click Yes in the confirmation dialog.</para> + <para>Within a few moments, the new IP address should appear with the state Allocated. You + can now use the IP address in port forwarding or static NAT rules.</para> + </listitem> + </orderedlist> + </section> +</section> http://git-wip-us.apache.org/repos/asf/cloudstack/blob/7d8a9e95/docs/en-US/portable-ip.xml ---------------------------------------------------------------------- diff --git a/docs/en-US/portable-ip.xml b/docs/en-US/portable-ip.xml index ec1035e..81590df 100644 --- a/docs/en-US/portable-ip.xml +++ b/docs/en-US/portable-ip.xml @@ -19,12 +19,90 @@ under the License. --> <section id="portable-ip"> - <title>About Portable IP</title> - <para>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 use - 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> + <title>Portable IPs</title> + <section id="about-pip"> + <title>About Portable IP</title> + <para>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 use 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="config-pip"> + <title>Configuring Portable IPs</title> + <para/> + <orderedlist> + <listitem> + <para>Log in to the &PRODUCT; UI as an administrator or end user.</para> + </listitem> + <listitem> + <para>In the left navigation, click Regions.</para> + </listitem> + <listitem> + <para>Choose the Regions that you want to work with.</para> + </listitem> + <listitem> + <para>Click View Portable IP.</para> + </listitem> + <listitem> + <para>Click Portable IP Range.</para> + <para>The Add Portable IP Range window is displayed.</para> + </listitem> + <listitem> + <para>Specify the following:</para> + <itemizedlist> + <listitem> + <para><emphasis role="bold">Start IP/ End IP</emphasis>: A range of IP addresses that + are accessible from the Internet and will be allocated to guest VMs. Enter the first + and last IP addresses that define a range that &PRODUCT; can assign to guest + VMs.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Gateway</emphasis>: The gateway in use for the Portable IP + addresses you are configuring.</para> + </listitem> + <listitem> + <para><emphasis role="bold">Netmask</emphasis>: The netmask associated with the Portable + IP range.</para> + </listitem> + <listitem> + <para><emphasis role="bold">VLAN</emphasis>: The VLAN that will be used for public + traffic.</para> + </listitem> + </itemizedlist> + </listitem> + <listitem><para>Click OK.</para></listitem> + </orderedlist> + </section> + <section id="acquire-pip"> + <title>Acquiring a Portable IP</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>Click the name of the network where you want to work with.</para> + </listitem> + <listitem> + <para>Click View IP Addresses.</para> + </listitem> + <listitem> + <para>Click Acquire New IP.</para> + <para>The Acquire New IP window is displayed.</para> + </listitem> + <listitem> + <para>Specify whether you want cross-zone IP or not.</para> + </listitem> + <listitem> + <para>Click Yes in the confirmation dialog.</para> + <para>Within a few moments, the new IP address should appear with the state Allocated. You + can now use the IP address in port forwarding or static NAT rules.</para> + </listitem> + </orderedlist> + </section> </section>
