a23e2e2d7e
Tenks has a dependency on ansible. We need to make sure this is installed before we run `ansible-galaxy install`. `pip install .` was therefore moved above `ansible-galaxy install` in the installation steps.
2.0 KiB
Installation
Assumptions
Some assumptions that are made about the configuration of your system are noted below.
It is assumed that...
...you already have an OpenStack cloud deployed, for which...
- ...the host from which Tenks is executed (localhost) has access to the OpenStack APIs. These are used for Ironic node enrolment and Nova flavor registration.
- ...the OpenStack OS_* authentication variables are present in localhost's environment. These can typically be sourced from your openrc file.
... a distinct network device (interface or bridge) is present for each physical network that a hypervisor is connected to.
Pre-Requisites
Currently, Tenks supports CentOS 7.5.
To avoid conflicts with Python packages installed by the system
package manager it is recommended to install Tenks in a virtualenv.
Ensure that the virtualenv Python module is available. For
cloning and working with the Tenks source code repository, Git is
required. These pre-requisites can be installed with a command such
as:
$ yum install --assumeyes python-virtualenv gitTenks Installation
Create a virtualenv for Tenks. For example:
$ virtualenv tenksActivate the virtualenv and update pip:
$ source tenks/bin/activate
(tenks) $ pip install --upgrade pipObtain the Tenks source code and change into the directory. For example:
(tenks) $ git clone https://github.com/stackhpc/tenks.git
(tenks) $ cd tenksInstall Tenks and its requirements using the source code checkout:
(tenks) $ pip install .Tenks has dependencies on Ansible roles that are hosted by Ansible Galaxy. These can be installed by a command such as:
(tenks) $ ansible-galaxy install --role-file=requirements.yml --roles-path=ansible/roles/If you now wish to run Tenks (see run), keep your virtualenv active. If not, deactivate
it:
(tenks) $ deactivate