Installation

OOCRAN is developed in Python using the Django framework, therefore it can be installed into a virtualenv or into a physical computer.

Moreover, we provide a DockerFile in order to launch OOCRAN into a Docker container.

OOCRAN into Docker Container

This repository has a DockerFile that can be used to create a container that builds and starts up OOCRAN. You will need Linux with a working Docker installation to use it.

To build the container:

git clone https://github.com/oocran/oocran.git
cd oocran
docker build -t oocran/oocran .

To start it:

docker run -d -p 8000:8000 --name oocran oocran/oocran

Once the container is running you can interact with OOCRAN. Please refer to the subsection Interact with OOCRAN.

Download

Download the source code from github:

git clone https://github.com/oocran/oocran.git

Dependencies

In both cases the following dependencies are required:

• RabbitMQ for the queue management.
• MySQL as a database for storage (other databases are compatible, too).
• Vagrant for the VM ceation.

Technical Requirements

In order to execute OOCRAN it is necessary at least one Virtualized Infrastructure Manager (VIM). OOCRAN provides APIs for the interaction with OpenStack (>= release Mitaka). The installation of OpenStack can be done following the OpenStack manual or using OPNFV.

Installation

Once dependencies are correctly installed you can proceed to install OOCRAN. If you are interested in installing it on a virtualenv please follow these steps, otherwise skip the first instructions:

$ virtualenv oocran
$ source bin/active

Download the OOCRAN source code into the virtualenv or your path of choice and execute the following commands:

$ cd oocran/
$ python setup.py install

Launch

Then you can launch OOCRAN by executing:

$ oocran start localhost:8000

Interact with OOCRAN

On your browser of choice introduce the following url http://localhost:8000 where the default credentials are:

username: admin
password: admin

Once OOCRAN is running you can start to test it! Follow the instructions on the Get started page!