x/tobiko
Code Issues Proposed changes
1929871d16
tobiko/doc/source/user/install.rst
Federico Ressi 144f50fe01 Document how to configure Tobiko and run scenario test cases 
This also improve other documentation pages and add many
cross section references.

This guide has been tested on CentOS 7 (Python 2.7) and
RHEL8 (Python 3.6).

Change-Id: I827dcf7237792ab94286c960968df405c7e548b9
2019-05-07 17:00:34 +02:00

1.8 KiB
Raw Blame History

Tobiko Installation Guide

Document Overview

This document describes how to install Tobiko inside a Python Virtualenv.

See also

For a quick and simpler start you can jump to the tobiko-quick-start-guide.

To configure Tobiko please read tobiko-configuration-guide.

To run Tobiko scenario test cases please look at 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 RHEL Linux 7.6 or CentOS 7 you could type:

sudo yum install -y gcc git python python-devel wget

For instance on RHEL Linux 8 or CentOS 8 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 soruce folder:

git clone https://opendev.org/x/tobiko.git
cd tobiko

To install Tobiko and its dependencies is safer to create a clean Virtualenv where 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 tobiko-configuration-guide.