cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From radh...@apache.org
Subject git commit: updated refs/heads/4.2 to f7555c1
Date Thu, 01 Aug 2013 09:12:34 GMT
Updated Branches:
  refs/heads/4.2 f74461476 -> f7555c1ec


CLOUDSTACK-3236


Project: http://git-wip-us.apache.org/repos/asf/cloudstack/repo
Commit: http://git-wip-us.apache.org/repos/asf/cloudstack/commit/f7555c1e
Tree: http://git-wip-us.apache.org/repos/asf/cloudstack/tree/f7555c1e
Diff: http://git-wip-us.apache.org/repos/asf/cloudstack/diff/f7555c1e

Branch: refs/heads/4.2
Commit: f7555c1ec10de0d4ac297a04440d8c4d98b540a7
Parents: f744614
Author: Radhika PC <radhika.puthiyetath@citrix.com>
Authored: Thu Aug 1 14:41:07 2013 +0530
Committer: Radhika PC <radhika.puthiyetath@citrix.com>
Committed: Thu Aug 1 14:42:13 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/f7555c1e/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&amp;response=json&amp;ipaddressid=a4bc37b2-4b4e-461d-9a62-b66414618e36&amp;virtualmachineid=a242c476-ef37-441e-9c7b-b303e2a9cb4f&amp;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&amp;response=json&amp;ipaddressid=a4bc37b2-4b4e-461d-9a62-b66414618e36&amp;virtualmachineid=Y&amp;networkid=X
+      </programlisting>
+  </section>
 </section>


Mime
View raw message