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/08/01 11:00:23 UTC
git commit: updated refs/heads/master to 085dc71
Updated Branches:
refs/heads/master 871e3bb27 -> 085dc7126
CLOUDSTACK-3236
Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/085dc712
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/085dc712
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/085dc712
Branch: refs/heads/master
Commit: 085dc7126638b00b2b50a97147c0670112956adc
Parents: 871e3bb
Author: Radhika PC <ra...@citrix.com>
Authored: Thu Aug 1 14:27:44 2013 +0530
Committer: Radhika PC <ra...@citrix.com>
Committed: Thu Aug 1 14:28:20 2013 +0530
----------------------------------------------------------------------
docs/en-US/portable-ip.xml | 34 ++++++++++++++++++++++------------
1 file changed, 22 insertions(+), 12 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cloudstack/blob/085dc712/docs/en-US/portable-ip.xml
----------------------------------------------------------------------
diff --git a/docs/en-US/portable-ip.xml b/docs/en-US/portable-ip.xml
index 83d5b43..68b759b 100644
--- a/docs/en-US/portable-ip.xml
+++ b/docs/en-US/portable-ip.xml
@@ -24,10 +24,10 @@
<title>About Portable IP</title>
<para>Portable IPs in &PRODUCT; are region-level pool of IPs, which are elastic in nature, 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 services in basic zones. </para>
+ provision a pool of portable public IPs at region level and are available for user
+ consumption. The users can acquire portable IPs if admin has provisioned portable 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 services in basic zones. </para>
<para>The salient features of Portable IP are as follows:<itemizedlist>
<listitem>
<para>IP is statically allocated </para>
@@ -42,19 +42,17 @@
<para>IP is transferable across both Basic and Advanced zones </para>
</listitem>
<listitem>
- <para>IP is transferable across VPC, non-VPC Isolated and Shared networks </para>
- </listitem>
- <listitem>
- <para/>
- </listitem>
- <listitem>
- <para/>
+ <para>IP is transferable across VPC, non-VPC isolated and shared networks </para>
</listitem>
</itemizedlist></para>
+ <formalpara>
+ <title>Guidelines</title>
+ <para>Before transferring to another network, ensure that no network rules (Firewall, Static
+ NAT, Port Forwarding, and so on) exist on that portable IP.</para>
+ </formalpara>
</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>
@@ -129,4 +127,16 @@
</listitem>
</orderedlist>
</section>
+ <section id="transfer-pip">
+ <title>Transferring Portable IP</title>
+ <para>An IP can be transferred from one network to another only if Static NAT is enabled.
+ However, when a portable IP is associated with a network, you can use it for any service in
+ the network. </para>
+ <para>To transfer a portable IP across the networks, execute the following API:</para>
+ <programlisting>http://localhost:8096/client/api?command=enableStaticNat&response=json&ipaddressid=a4bc37b2-4b4e-461d-9a62-b66414618e36&virtualmachineid=a242c476-ef37-441e-9c7b-b303e2a9cb4f&networkid=6e7cd8d1-d1ba-4c35-bdaf-333354cbd49810 </programlisting>
+ <para>Replace the UUID with appropriate UUID. For example, if you want to transfer a portable IP
+ to network X and VM Y in a network, execute the following:</para>
+ <programlisting>http://localhost:8096/client/api?command=enableStaticNat&response=json&ipaddressid=a4bc37b2-4b4e-461d-9a62-b66414618e36&virtualmachineid=Y&networkid=X
+ </programlisting>
+ </section>
</section>