From 5741ee70d1daf4cc49d6c02aee0dd738c780a5b5 Mon Sep 17 00:00:00 2001
From: Jeremy Stanley <fungi@yuggoth.org>
Date: Tue, 13 Nov 2012 22:35:45 +0000
Subject: [PATCH] Clarify server launch documentation.

* launch/README: Note that commands are assumed to be run in a full root
environment, mention existence of 'nova list' for determining server
details, get happy with variables in the DNS examples and also adjust
examples for a recent change in RackSpace's DNS API which assumes a
lower-case version of the region name.

Change-Id: I6a80893379acf573e04fefd39d98965c7b873ad5
Reviewed-on: https://review.openstack.org/16112
Reviewed-by: James E. Blair <corvus@inaugust.com>
Reviewed-by: Paul Belanger <paul.belanger@polybeacon.com>
Approved: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Tested-by: Jenkins
---
 launch/README | 24 ++++++++++++++++++------
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/launch/README b/launch/README
index 82eb5c0666..ddc81bd1ab 100644
--- a/launch/README
+++ b/launch/README
@@ -1,3 +1,8 @@
+Note that these instructions assume commands will be run in a full
+root environment::
+
+  sudo su -
+
 To launch a node in the OpenStack CI account (production servers)::
 
   . openstackci-rs-nova.sh
@@ -26,16 +31,23 @@ DNS
 There are no scripts to handle DNS at the moment due to a lack of
 library support for the new Rackspace Cloud DNS (with IPv6).  To
 manually update DNS, you will need the hostname, v4 and v6 addresses
-of the host, as well as the UUID.  The environment variables used in
-the URL should be satisfied by sourcing the "openstackci-rs-nova.sh"
+of the host, as well as the UUID (these can all be found by running
+the ''nova list'' command).  The environment variables used in the
+URL should be satisfied by sourcing the "openstackci-rs-nova.sh"
 script (or jenkins, as appropriate).
 
   . ~/rackdns-venv/bin/activate
   . openstackci-rs-nova.sh
 
-  rackdns rdns-create --name HOSTNAME.openstack.org --data IPV6ADDR --server-href https://$OS_REGION_NAME.servers.api.rackspacecloud.com/v2/$OS_TENANT_NAME/servers/UUID --ttl 300
-  rackdns rdns-create --name HOSTNAME.openstack.org --data IPV4ADDR --server-href https://$OS_REGION_NAME.servers.api.rackspacecloud.com/v2/$OS_TENANT_NAME/servers/UUID --ttl 300
+  export SERVERNAME=server
+  nova list | grep "| $SERVERNAME\.openstack\.org "
+  export IPV6ADDR=dead:beef::cafe
+  export IPV4ADDR=123.45.67.89
+  export UUID=fedcba98-7654-3210-0123-456789abcdef
+
+  rackdns rdns-create --name $SERVERNAME.openstack.org --data $IPV6ADDR --server-href https://$os_region_name.servers.api.rackspacecloud.com/v2/$OS_TENANT_NAME/servers/$UUID --ttl 300
+  rackdns rdns-create --name $SERVERNAME.openstack.org --data $IPV4ADDR --server-href https://$os_region_name.servers.api.rackspacecloud.com/v2/$OS_TENANT_NAME/servers/$UUID --ttl 300
 
   . openstack-rs-nova.sh
-  rackdns record-create --name HOSTNAME.openstack.org --type AAAA --data IPV6ADDR --ttl 300 openstack.org
-  rackdns record-create --name HOSTNAME.openstack.org --type A --data IPV4ADDR --ttl 300 openstack.org
+  rackdns record-create --name $SERVERNAME.openstack.org --type AAAA --data $IPV6ADDR --ttl 300 openstack.org
+  rackdns record-create --name $SERVERNAME.openstack.org --type A --data $IPV4ADDR --ttl 300 openstack.org