HAAS engine (Sahara version)
Being another service for Openstack, Sahara has no sense without other Openstack services such as Nova, Horizon or Keystone. Despite it is not the goal of this guide to show you how to install Openstack, here are some pointers:
- Using Fuel, the Mirantis installer.
- Using RDO Manager, from RDO, the community of people using and deploying OpenStack on Red Hat Enterprise Linux/Fedora/CentOS/Scientific Linux.
If using any of the above methods, Sahara's installation wiki will tell you how to add the Sahara plugin. In the case of Fuel, Sahara is enabled during the installation, but in the case of RDO Manager, Sahara must be installed after installing Openstack.
Nevertheless, the preferred method for installing both Openstack and Sahara is Devstack. Typically, Openstack is installed in an infrastructure comprising several nodes; but you can test it on a single machine).
Independently of the amount of infrastructure used, Sahara can be installed at the same time than the other services by simply adding this line to the
Once the installation has finished, a message similar to the following one must appear:
This is your host ip: 10.95.217.148 Horizon is now available at http://10.95.217.148/ Keystone is serving at http://10.95.217.148:5000/ The default users are: admin and demo The password: xxxxxxxx
As you may observe, two Openstack users (admin and demo) have been created. The admin user is a privileged user allowed to administrate Openstack; the demo user is just a "normal" dummy user.
Please refer to the configuration section of Devstack if setting up a multi-node deployment.
Please refer to the configuration section of Devstack if setting up a single-machine deployment.
Sahara (and all the other Openstack services) starts once installed with
unstack.sh will shut down all the Openstack services, freeing up any resource they may have been consuming; in order to restart the environment, do not stack again, but run
Rejoining the stack will print the output of a "parent"
screen process that encapsulates the per-service
screen process Devstack starts. This is because Devstack do not uses any init script, the services are run in foreground as standalone daemons and thus you will have to interact with them through the
You can navigate through the parent screen by using
ctrl + a + n (next) or
ctrl + a + n (previous). In order to stop a service, simply do
ctrl + c and run the last command for that screen (it will appear after pressing the up key).
The best option for administrating Openstack (including Sahara) is to install the different command-line clients. These are Python-based CLIs wrapping the Openstack REST APIs, thus Python and some other tools (setuptools and PIP) must be installed if you plan to use the CLIs; all the details can be found here. For instance, if you want to install the CLI for Sahara, do the following:
$ sudo pip install python-sahara
Independently of the CLIs you decide to install or not, it is very convenient you install the Openstack Client (also known as Unified CLI):
$ sudo pip install python-openstackclient
As said, the above clients wrap the Openstack REST APIs; you could also use the REST APIs for administrating Openstack, but the CLI is easier to use since most of the configuration has not to be given each time an operation is performed, but configured in a file or added as environment variables. For instance, this configuration is valid for the admin user when using the Openstack Client:
$ export OS_IDENTITY_API_VERSION=3 $ export OS_AUTH_URL=`[`http://localhost:5000/v3`](http://localhost:5000/v3) $ export OS_DEFAULT_DOMAIN=default $ export OS_USERNAME=admin $ export OS_PASSWORD=xxxxxxxx $ export OS_PROJECT_NAME=admin
Example of usage:
$ openstack user list --os-auth-url http://localhost:5000/v3 --os-username admin --os-project-name admin --debug --os-user-domain-name default --os-project-domain-name default --os-identity-api-version 3 --os-password xxxxxxxx