Getting started¶
Made to be as simple as possible, but not too simple...
Prerequisites¶
RTFM¶
Read the great documentation for developers/admins at
This will vastly help you understand what the configurations and options do when ANVIL configures them.
Linux¶
One of the tested distributions.
- RHEL 6.2+
- CentOS 6.2+
- Oracle Enteprise Linux 6.2+
You can get CentOS 6.2+ (64-bit is preferred) from https://www.centos.org/
Installation¶
Pre-setup¶
Since RHEL requires a tty to perform sudo
commands we need
to disable this so sudo
can run without a tty. This seems needed
since nova and other components attempt to do sudo
commands. This
isn’t possible in RHEL unless you disable this (since those
instances won’t have a tty).
$ sudo visudo
Then comment out line
Default requiretty
Also disable selinux:
$ sudo vi /etc/sysconfig/selinux
Change SELINUX=enforcing to SELINUX=disabled then reboot.
$ sudo reboot
Create specifc user to isolate all the Anvil processes from root user
$ sudo useradd <username>
$ sudo passwd <username>
Set user as sudoer
$ sudo visudo
Add <username> ALL=(ALL) ALL
Make all the rest of actions as <username> user
$ sudo su - <username>
Get git!¶
$ sudo yum install git -y
Download¶
We’ll grab the latest version of ANVIL via git:
$ git clone https://git.openstack.org/openstack/anvil.git
$ cd anvil
Configuration¶
Any configuration to be updated should now be done.
Please edit the corresponding yaml files in conf/components/
or
conf/components/personas
to fit your desired configuration of nova/glance
and the other OpenStack components.
Note
You can use -p <conf/components/required_file.yaml>
to specify a
different persona.
To specify which versions of OpenStack components you want to install select
or edit an origins configuration file from <conf/origins/>
.
Note
You can use -o <conf/origins/origins_file.yaml>
to specify this
different origins file.
Respository notes for those with RedHat subscriptions¶
To enable the needed repositories for various requirements please also run:
sudo subscription-manager repos --enable rhel-6-server-optional-rpms
You can also include the RDO repositories (which has even more of the needed requirements). This will ensure that anvil has to build less dependencies overall.
Pre-installing¶
In order to ensure that anvil will have its correct dependencies you need to first run the bootstrapping code that will setup said dependencies for your operating system.
sudo ./smithy --bootstrap
Preparing¶
Now prepare OpenStacks components by running the following:
./smithy -a prepare
You should see a corresponding OpenStack repositories getting downloaded using git, python setups occurring and configuration files being written as well as source rpm packages being built and a repository setup from those components [1].
Building¶
Now build OpenStacks components by running the following:
sudo ./smithy -a build
You should see a corresponding OpenStack components and dependencies at this stage being packaged into rpm files and two repositories being setup for you [1]. One repository will be the dependencies that the OpenStack components need to run and th other will be the OpenStack components themselves.
Issues¶
Please report issues/bugs to https://launchpad.net/anvil. Much appreciated!
[1] | (1, 2) If you desire more informational output add a -v or a -vv to the command. |