70 lines
1.8 KiB
ReStructuredText
70 lines
1.8 KiB
ReStructuredText
.. _tobiko-installation-guide:
|
|
|
|
=========================
|
|
Tobiko Installation Guide
|
|
=========================
|
|
|
|
|
|
Document Overview
|
|
-----------------
|
|
|
|
This document describes how to install Tobiko inside a
|
|
`Python virtualenv <https://virtualenv.pypa.io/en/latest/>`__.
|
|
|
|
.. sidebar:: See also
|
|
|
|
For a quick and simpler start you can jump to the
|
|
:ref:`tobiko-quick-start-guide`.
|
|
|
|
To configure Tobiko please read :ref:`tobiko-configuration-guide`.
|
|
|
|
To run Tobiko scenario test cases please look at
|
|
:ref:`tobiko-test-case-execution-guide`.
|
|
|
|
Install Tobiko Using virtualenv
|
|
-------------------------------
|
|
|
|
Make sure gcc, Git and base Python packages are installed on your system.
|
|
|
|
For instance on a RHEL7 or CentOS 7 machine you could type::
|
|
|
|
sudo yum install -y gcc git python python-devel wget
|
|
|
|
For instance on a RHEL8 or CentOS 8 machine you could type::
|
|
|
|
sudo dnf install -y gcc git python3 python3-devel wget
|
|
sudo alternatives --set python /usr/bin/python3
|
|
|
|
Make sure pip is installed and up-to-date::
|
|
|
|
wget https://bootstrap.pypa.io/get-pip.py
|
|
sudo python get-pip.py
|
|
PIP=$(which pip)
|
|
|
|
Make sure setuptools, virtualenv, and wheel are installed and up-to-date::
|
|
|
|
sudo $PIP install --upgrade setuptools virtualenv wheel
|
|
|
|
Get Tobiko source code using Git and enter into Tobiko source folder::
|
|
|
|
git clone https://opendev.org/x/tobiko.git
|
|
cd tobiko
|
|
|
|
To install Tobiko and its dependencies it's safest to create a clean virtualenv
|
|
to install it. Create a virtualenv and activate it::
|
|
|
|
virtualenv .tobiko-env
|
|
source .tobiko-env/bin/activate
|
|
|
|
Install Tobiko and its requirements::
|
|
|
|
pip install \
|
|
-c https://opendev.org/openstack/requirements/raw/branch/master/upper-constraints.txt \
|
|
.
|
|
|
|
|
|
What's Next
|
|
-----------
|
|
|
|
To know how to configure Tobiko please read :ref:`tobiko-configuration-guide`.
|