From 6958e4085f956d7025a109b643d17f70f8bf4835 Mon Sep 17 00:00:00 2001
From: Daryl Walleck <daryl.walleck@rackspace.com>
Date: Thu, 3 Jul 2014 02:48:21 -0500
Subject: [PATCH] Updates the Ironic on Devstack dev documentation

The current devstack configuration in the dev documentation
is out of date and will not successfully spin up a
Nova with Ironic driver environment. One of the critical
changes necessary is to set the IRONIC_VM_SPECS_RAM to 1024,
as that is now the minimum size for a virtual Ironic node.

This change also updates the configurations to more closely match
the ones being used for the virtual ironic Devstack job and
explicitly sets file logging to make debugging easier.

Change-Id: Ifbe0af9759483ccd80e74b24d45eaa4726c4b101
---
 doc/source/dev/dev-quickstart.rst | 45 ++++++++++++++++++++++---------
 1 file changed, 33 insertions(+), 12 deletions(-)

diff --git a/doc/source/dev/dev-quickstart.rst b/doc/source/dev/dev-quickstart.rst
index a896854cca..efe994fdd0 100644
--- a/doc/source/dev/dev-quickstart.rst
+++ b/doc/source/dev/dev-quickstart.rst
@@ -224,15 +224,25 @@ station.
 
     https://devstack.org
 
-Prepare the system (Ubuntu 12.04)::
+Install the basic dependencies::
 
     sudo apt-get update
     sudo apt-get install python-software-properties git
-    sudo add-apt-repository cloud-archive:havana
+
+If you are using Ubuntu 12.04, use the latest Cloud Archive repository::
+
+    sudo add-apt-repository cloud-archive:icehouse
     sudo apt-get update
 
-Clone DevStack::
+Devstack will no longer create the user 'stack' with the desired
+permissions, but does provide a script to perform the task::
 
+    git clone https://github.com/openstack-dev/devstack.git devstack
+    sudo ./devstack/tools/create-stack-user.sh
+
+Switch to the stack user and clone DevStack::
+
+    sudo su stack
     cd ~
     git clone https://github.com/openstack-dev/devstack.git devstack
 
@@ -240,6 +250,13 @@ Create devstack/localrc with minimal settings required to enable Ironic::
 
     cd devstack
     cat >localrc <<END
+    # Credentials
+    ADMIN_PASSWORD=password
+    DATABASE_PASSWORD=password
+    RABBIT_PASSWORD=password
+    SERVICE_PASSWORD=password
+    SERVICE_TOKEN=password
+
     # Enable Ironic API and Ironic Conductor
     enable_service ironic
     enable_service ir-api
@@ -254,13 +271,15 @@ Create devstack/localrc with minimal settings required to enable Ironic::
     enable_service q-meta
     enable_service neutron
 
-    # Create 3 virtual machines with 512M memory and 10G disk to
-    # pose as Ironic's baremetal nodes.
-    IRONIC_BAREMETAL_BASIC_OPS=True
+    # Create 3 virtual machines to pose as Ironic's baremetal nodes.
     IRONIC_VM_COUNT=3
-    IRONIC_VM_SPECS_RAM=512
-    IRONIC_VM_SPECS_DISK=10
     IRONIC_VM_SSH_PORT=22
+    IRONIC_BAREMETAL_BASIC_OPS=True
+
+    # The parameters below represent the minimum possible values to create
+    # functional nodes.
+    IRONIC_VM_SPECS_RAM=1024
+    IRONIC_VM_SPECS_DISK=10
 
     # Size of the ephemeral partition in GB. Use 0 for no ephemeral partition.
     IRONIC_VM_EPHEMERAL_DISK=0
@@ -274,8 +293,11 @@ Create devstack/localrc with minimal settings required to enable Ironic::
     FIXED_RANGE=10.1.0.0/24
     FIXED_NETWORK_SIZE=256
 
-    # Log all devstack output to a log file
+    # Log all output to files
     LOGFILE=$HOME/devstack.log
+    SCREEN_LOGDIR=$HOME/logs
+    IRONIC_VM_LOG_DIR=$HOME/ironic-bm-logs
+
 
     END
 
@@ -283,13 +305,12 @@ Run stack.sh::
 
     ./stack.sh
 
-Source credentials, create a key, spawn an instance::
+Source credentials, create a key, and spawn an instance::
 
     source ~/devstack/openrc
 
     # query the image id of the default cirros-0.3.1-x86_64-uec image
-    nova image-list
-    image=21eef080-e562-4586-ba80-3fc57de25fd2
+    image=$(nova image-list | egrep "cirros-.*.-x86_64-uec[^-]" | awk '{ print $2 }')
 
     # create keypair
     ssh-keygen