From 5757300194e1b16476fd71e271feea087ff6eccd Mon Sep 17 00:00:00 2001
From: Jay Faulkner <jay@jvf.cc>
Date: Tue, 25 Nov 2014 08:57:26 -0800
Subject: [PATCH] Improve docs for running IPA in Devstack

Documented what the settings are in the localrc, as well as adding the
credentials for swift so when your localrc is setup as documented,
devstack runs without prompting.

Change-Id: Ie965a6c3b4f97b14e97e78e8cf77c789a891a387
---
 doc/source/dev/dev-quickstart.rst | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/doc/source/dev/dev-quickstart.rst b/doc/source/dev/dev-quickstart.rst
index 624c2d898d..416778fbb5 100644
--- a/doc/source/dev/dev-quickstart.rst
+++ b/doc/source/dev/dev-quickstart.rst
@@ -312,12 +312,25 @@ or the agent driver, not both.::
 If running with the agent driver::
 
     cat >>localrc <<END
-    enable_service s-proxy s-object s-container s-account
+    # Agent driver requires swift with tempurls
+    # Enable swift services
+    enable_service s-proxy
+    enable_service s-object
+    enable_service s-container
+    enable_service s-account
+
+    # Enable tempurls and set credentials
+    SWIFT_HASH=password
+    SWIFT_TEMPURL_KEY=password
     SWIFT_ENABLE_TEMPURLS=True
+
+    # Enable agent driver
     IRONIC_ENABLED_DRIVERS=fake,agent_ssh,agent_ipmitool
-    IRONIC_BUILD_DEPLOY_RAMDISK=False
     IRONIC_DEPLOY_DRIVER=agent_ssh
 
+    # To build your own IPA ramdisk from source, set this to True
+    IRONIC_BUILD_DEPLOY_RAMDISK=False
+
     END
 
 Run stack.sh::