We recommend to install Sahara in a way that will keep your system in a consistent state. We suggest the following options:
$ yum install openstack-sahara
$ sahara-db-manage --config-file /etc/sahara/sahara.conf upgrade head
$ service openstack-sahara-api start
$ sudo apt-get install python-setuptools python-virtualenv python-dev
For Fedora:
$ sudo yum install gcc python-setuptools python-virtualenv python-devel
For CentOS:
$ sudo yum install gcc python-setuptools python-devel
$ sudo easy_install pip
$ sudo pip install virtualenv
$ virtualenv sahara-venv
This will install python virtual environment into sahara-venv directory in your current working directory. This command does not require super user privileges and could be executed in any directory current user has write permission.
$ sahara-venv/bin/pip install sahara
Or you can get Sahara archive from http://tarballs.openstack.org/sahara/ and install it using pip:
$ sahara-venv/bin/pip install 'http://tarballs.openstack.org/sahara/sahara-master.tar.gz'
Note that sahara-master.tar.gz contains the latest changes and might not be stable at the moment. We recommend browsing http://tarballs.openstack.org/sahara/ and selecting the latest stable release.
$ mkdir sahara-venv/etc
$ cp sahara-venv/share/sahara/sahara.conf.sample-basic sahara-venv/etc/sahara.conf
Make the necessary changes in sahara-venv/etc/sahara.conf. For details see Sahara Configuration Guide
...
[mysqld]
...
max_allowed_packet = 256M
and restart mysql server.
$ sahara-venv/bin/sahara-db-manage --config-file sahara-venv/etc/sahara.conf upgrade head
$ sahara-venv/bin/sahara-api --config-file sahara-venv/etc/sahara.conf
One of the Sahara Features, Anti-Affinity, requires a Nova adjustment. See Enabling Anti-Affinity for details. But that is purely optional.
Make sure that your operating system is not blocking Sahara port (default: 8386). You may need to configure iptables in CentOS and some other operating systems.
To get the list of all possible options run:
$ sahara-venv/bin/python sahara-venv/bin/sahara-api --help
Further consider reading Getting Started for general Sahara concepts and Provisioning Plugins for specific plugin features/requirements.