CLOUDSTACK-3236, CLOUDSTACK-892

This commit is contained in:
Radhika PC 2013-06-27 16:57:14 +05:30
parent f96442a45b
commit 7d8a9e95d4
3 changed files with 222 additions and 19 deletions

View File

@ -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>

109
docs/en-US/portable-ip Normal file
View File

@ -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>

View File

@ -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>