system-config/launch
Jeremy Stanley 5741ee70d1 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
2012-11-16 00:44:28 +00:00
..
launch-node.py Add a launch script. 2012-10-13 16:49:55 +00:00
README Clarify server launch documentation. 2012-11-16 00:44:28 +00:00
sshclient.py Add a launch script. 2012-10-13 16:49:55 +00:00
utils.py Add a launch script. 2012-10-13 16:49:55 +00:00

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

To launch a node in the OpenStack Jenkins account (slave nodes)::

  . openstackjenkins-rs-nova.sh

Then::

  puppet cert generate servername.openstack.org
  ./launch-node.py servername.openstack.org --cert servername.openstack.org.pem

If you are launching a replacement server, you may skip the generate
step and specify the name of an existing puppet cert (as long as the
private key is on this host).

The server name and cert names may be different.

Manually add the hostname to DNS (the launch script does not do so
automatically).

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 (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

  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 $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