From e57c73d3bfe331df7d9b1b3fbf84392a3e606b17 Mon Sep 17 00:00:00 2001
From: Deepti Navale <dnavale@redhat.com>
Date: Tue, 25 Feb 2014 15:51:03 +1000
Subject: [PATCH] Included new section to add floating IPs using dashboard

Updated the 'Configure access and security for instances' section in the
dashboard chapter of the End User Guide to include a new section 'Allocating
floating IP addresses to instances'.
Closes-Bug: #1280926

Change-Id: Id273e9bca078006679dc9b0273634d1220c02ac9
---
 .../section_dashboard_access_and_security.xml | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/doc/user-guide/section_dashboard_access_and_security.xml b/doc/user-guide/section_dashboard_access_and_security.xml
index b64df80390..b97baae687 100644
--- a/doc/user-guide/section_dashboard_access_and_security.xml
+++ b/doc/user-guide/section_dashboard_access_and_security.xml
@@ -194,4 +194,89 @@
         <para>The dashboard lists the keypair in the <guilabel>Access
                 &amp; Security</guilabel> category.</para>
     </section>
+    <section xml:id="add_floating_ip">
+      <title>Allocating floating IP addresses to instances</title>
+      <para>When an instance is created in OpenStack, it is
+         automatically assigned a fixed IP address in the network to
+         which the instance is assigned. This IP address is
+         permanently associated with the instance until the instance
+         is terminated.
+      </para>
+      <para>However, in addition to the fixed IP address, a floating
+         IP address can also be attached to an instance. Unlike fixed
+         IP addresses, floating IP addresses are able to have their
+         associations modified at any time, regardless of the state of
+         the instances involved. This procedure details the
+         reservation of a floating IP address from an existing pool of
+         addresses and the association of that address with a specific
+         instance.
+      </para>
+      <procedure>
+        <step>
+          <para>Log in to the dashboard, choose a project, and
+            click the <guilabel>Access &amp; Security</guilabel> category.
+          </para>
+        </step>
+        <step>
+          <para>The <guilabel>Access &amp; Security</guilabel> window opens to
+             the <guilabel>Security Groups</guilabel> tab by default.
+          </para>
+          <para>Click on the <guilabel>Floating IPs</guilabel> tab. The
+             <guilabel>Floating IPs</guilabel> tab shows the floating
+             IP addresses allocated to instances.
+          </para>
+        </step>
+        <step>
+          <para>Click the <guibutton>Allocate IP to Project</guibutton> button.
+          </para>
+      </step>
+      <step>
+        <para>Choose the <guilabel>Pool</guilabel> from which the IP address
+        should be picked.</para>
+      </step>
+      <step>
+        <para>Click the <guibutton>Allocate IP</guibutton> button.</para>
+      </step>
+      <step>
+        <para>In the <guilabel>Floating IPs</guilabel> list, click the
+           <guibutton> Associate</guibutton> button. The <guilabel>Manage
+           Floating IP Associations</guilabel> window opens.
+        </para>
+      </step>
+      <step>
+        <para>In the <guilabel>Manage Floating IP
+           Associations</guilabel> window, choose the following options:
+          <orderedlist>
+            <listitem>
+              <para>The <guilabel>IP Address</guilabel> field is
+                 filled automatically.
+              </para>
+              <para>You can choose to add a new IP address by using the
+                <guibutton>+</guibutton> button.</para>
+            </listitem>
+            <listitem>
+              <para>In the <guilabel>Ports to be associated</guilabel> field,
+              select a port from the dropdown list.</para>
+              <para>The dropdown lists all the instances with their respective
+                fixed IP addresses.
+              </para>
+            </listitem>
+          </orderedlist>
+        </para>
+      </step>
+      <step>
+        <para>Click the <guibutton>Associate</guibutton> button.
+        </para>
+      </step>
+      </procedure>
+      <note>
+        <para>To disassociate the IP address from an instance, click the
+          <guibutton>Disassociate</guibutton> button.</para>
+        <para>To release the floating IP address back into the pool of
+           addresses, click the <guibutton>More</guibutton> dropdown
+           button and select <guilabel>Release Floating IP</guilabel>
+           option.
+        </para>
+      </note>
+    </section>
 </section>