Package: ravstack
Ravstack is a toolkit that make it easy to run OpenStack onRavello Systems.
It focuses on OpenStack distributions that are installed byTripleObased
installers, such asRDO-Manager. Ravstack offers:Ironicpower control for Ravello.Commands to create new “virtual bare metal” nodes and create an instack
compatibleinstackenv.jsonfile for them.Commands to do certain post-install fixups requires because of the split
inside/outside network offered by Ravello.InstallationThe recommended way is to download an already pre-configured undercloud VM from
theRavello Repo. The VM contains an installed RDO-Manager with pre-built
bare metal images and has ravstack installed and configured.Installing from the Ravello RepoFirst step is to get the required images and create a new Ravello application:Go to theManageIQ pageon the Ravello Repo.Copy the VM named “RDO Manager” into your account.Copy the ISO named “ipxe.iso” into your account.Create a new application.Add the RDO Manager VM to the application.Give the VM a shorter, easier name (I suggest “undercloud”).Configure an SSH keypair for the VM.Publish the application.Once the VM is up and running, log on via SSH as the “stack” user. Note that
the undercloud VM is set up to use port mapping and so its ssh service will run
on a non-standard port somewhere in the range of 10000. The exact address and
port number of the SSH service are available from Ravello web UI in the
“summary” pane of the undercloud VM.On the undercloud VM, edit the file/etc/ravstack/ravstack.conf. Change the[ravello]usernameand[ravello]passwordsettings to match your Ravello
username and password. Ravstack needs access to your account so that it can
create new nodes and perform power control operations.Now create the nodes and add them to Ironic. You can create as many nodes are
you want. The default networking range configured in RDO-Manager allows up to
100 IPs for the nodes, and in addition 40 IPs for introspection (see below).
The example below creates 3 nodes:$ ravstack node-create -n 3
Created 3 nodes: node1, node2, node3.
$ ravstack node-dump
Wrote 3 nodes to `~/instackenv.json`.
Wrote 6 mac addresses to `/etc/ethers`.
$ source ~/stackrc
$ openstack baremetal import --json instackenv.jsonThe nodes should now be visible in Ironic (output abridged):$ ironic node-list
+--------------------------------------+-------------+-----------------+-------------+
| UUID                                 | Power State | Provision State | Maintenance |
+--------------------------------------+-------------+-----------------+-------------+
| cf30c3ba-7294-44cd-b835-664069289228 | power off   | available       | False       |
| e8f715b1-8c07-4361-8bb6-74dbe66dc134 | power off   | available       | False       |
| a12beebc-7e04-42e6-9f70-9fe9b585454f | power off   | available       | False       |
+--------------------------------------+-------------+-----------------+-------------+Configure the boot order for the nodes and start introspection. The following
commands might issue a few warnings that nodes are locked. This is OK and
expected. The operation will retry automatically. Introspection should take
less than 10 minutes to complete:$ openstack baremetal configure boot
$ openstack baremetal introspection bulk startWe are now ready to deploy the overcloud. The following command may take up to
an hour to complete:$ openstack overcloud deploy --plan overcloud --compute-scale 2After the installation is done, you should see the overcloud in a state ofCREATE_COMPLETE(output abridged):$ heat stack-list
+--------------------------------------+------------+-----------------+
| id                                   | stack_name | stack_status    |
+--------------------------------------+------------+-----------------+
| 8e53c52f-8a02-4a7a-9ef8-4de530e37ff4 | overcloud  | CREATE_COMPLETE |
+--------------------------------------+------------+-----------------+A post install step is required. The VMs in a Ravello application are connected
by an isolated network, and they communicate with the outside through one of
the available NAT options. The following command will set up the required port
mappings and makes sure that Horizon and the VNC proxy have the correct
configuration:$ ravstack fixup
Fixed Ravello config for 3 nodes.
Fixed OS config for 3 nodes.That’s it! You now have a working undercloud and overcloud.To access the undercloud from the CLI, source the file~/stackrcon the
undercloud VM, and use any of the available OpenStack commands.To access the overcloud from the CLI, source the file~/overcloudrcon
the undercloud VM, and use any of the available OpenStack commands.To access the overcloud Horizon, go to the Ravello web UI, and open the
“http” service on the “overcloud-controller-1” VM.NOTE: the following post-installation steps still remain to be done to make
the installation useful. These will be automated soon:Create an image in Glance:$ glance image-create --name fedora --file fedora-user.qcow2 \
      --disk-format qcow2 --container-format bareSetup overcloud networking. The following creates a simple provider network. It
will allow you to start up an instance, but not yet have it communicate to the
outside world. TBD:$ neutron net-create nova --router:external
$ neutron subnet-create --name nova --disable-dhcp \
      --allocation-pool start=192.168.2.100,end=192.168.2.200 \
      --gateway 192.168.2.1 nova 192.168.2.0/24Enable the undercloud Horizon for remote access. The image does not have the
undercloud Horizon service exposed because it contains a pre-installed
undercloud with fixed passwords. To enable this service, either we need to
change all password (can this be done easily?) or maybe more simply, install a
unique random password at the Apache level.Installing from ScratchIf you want to RDO-Manager yourself then that is possible as well. You need to
start by installing a new CentOS VM in Ravello, and after that you need to
following the RDO-Managerinstallation instructions. Also make sure you read
theRavello NotesandRDO-Manager Notes. Installation of ravstack
itself:$ sudo pip3 install ravstack
$ sudo ravstack config-create
Created config file `/etc/ravstack/ravstack.conf`.
$ sudo mkdir /var/log/ravstack
$ sudo chown stack:stack /var/log/ravstack
$ ravstack proxy-create
Private key created as: `~/.ssh/id_ravstack`.
Proxy created at: `~/bin/ironic-proxy`.Note that you need to have a working Python3 environment. Ravstack does not
work with Python 2.x. The easiest is to use thepython34package fromEPEL.Once you’ve installed ravstack, follow the instructions for installing from the
Ravello Repo above.DocumentationIn addition to this README, the following documents exist:Ravello Notes- Some notes on working with Ravello.RDO-Manager Notes- Some notes on working with RDO Manager.CommentsFeel free to report issues on Github or mail me atgeertj@gmail.com.