Return-Path: 
 <commits-return-28461-apmail-cloudstack-commits-archive=cloudstack.apache.org@cloudstack.apache.org>
X-Original-To: apmail-cloudstack-commits-archive@www.apache.org
Delivered-To: apmail-cloudstack-commits-archive@www.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id 7F60C104E0
	for <apmail-cloudstack-commits-archive@www.apache.org>;
 Thu,  1 Aug 2013 09:00:25 +0000 (UTC)
Received: (qmail 53707 invoked by uid 500); 1 Aug 2013 09:00:25 -0000
Delivered-To: apmail-cloudstack-commits-archive@cloudstack.apache.org
Received: (qmail 53689 invoked by uid 500); 1 Aug 2013 09:00:25 -0000
Mailing-List: contact commits-help@cloudstack.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@cloudstack.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@cloudstack.apache.org>
List-Post: <mailto:commits@cloudstack.apache.org>
List-Id: <commits.cloudstack.apache.org>
Reply-To: dev@cloudstack.apache.org
Delivered-To: mailing list commits@cloudstack.apache.org
Received: (qmail 53682 invoked by uid 99); 1 Aug 2013 09:00:24 -0000
Received: from tyr.zones.apache.org (HELO tyr.zones.apache.org)
 (140.211.11.114)
    by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 01 Aug 2013 09:00:24 +0000
Received: by tyr.zones.apache.org (Postfix, from userid 65534)
	id C2CCA8B59F0; Thu,  1 Aug 2013 09:00:23 +0000 (UTC)
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: radhika@apache.org
To: commits@cloudstack.apache.org
Message-Id: <ddf5cdd07d5c4208ab0fd3ee8aef143c@git.apache.org>
X-Mailer: ASF-Git Admin Mailer
Subject: git commit: updated refs/heads/master to 085dc71
Date: Thu,  1 Aug 2013 09:00:23 +0000 (UTC)

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 <radhika.puthiyetath@citrix.com>
Authored: Thu Aug 1 14:27:44 2013 +0530
Committer: Radhika PC <radhika.puthiyetath@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&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>