Vagrant

Install Open Baton

This tutorial will guide towards the installation of an Open Baton environment checking out the source code from the github repositories, building and starting the individual components.

A minimal version comprises the following components:

  • The NFVO implemented in java using the spring.io framework. For more details about the NFVO architecture, you can refer to the next sections
  • Test VIM Driver for being able to execute the hello world tutorial without needing an OpenStack instance.
  • RabbitMQ as messaging system

A complete version includes those additional components:

  • OpenStack VIM Driver for deploying VNFs on OpenStack
  • Generic VNFM for the instantiation of VNFs part of the Open Baton ecosystem
  • Fault Management System for the support to detection and recovery of VNF faults
  • Auto Scaling Engine for the automatic creation and termination of VNF instances due to performance requirements
  • Network Slicing Engine for ensuring a specific QoS for your NS
  • MySQL as a mean to enable the persistence when using Open Baton

Requirements

To facilitate the installation procedures we provide a bootstrap script which will install the desired components and configure them for running a hello world VNF out of the box. To execute the bootstrap procedure you need to have curl installed (see http://curl.haxx.se/). This command should work on any linux system:

apt-get install curl

NOTE - We assume that you are performing the installation on top of a clean installation of Ubuntu 16.04. To install Open Baton either on Ubuntu 14.04 or Debian Jessy you need first to manually install the JDK 8. In other cases we suggest to install the components one by one. You can checkout the bootstrap repository and see the installation procedures which are executed by the bootstrap script.

Open Baton can be installed on any kind of environment (physical hosts, virtual machines, containers, etc.). Suggested requirements in terms of CPUs, Memory, and disk space are:

  • minimal version: > 2GB of RAM, and > 2CPUs, 10GB of disk space
  • complete version: > 8GB of RAM, and > 8CPUs, 10GB of disk space

In general, you may be able to get a working environment also with less perfomant hardware, especially tuning the JVM startup options (i.e -Xms and -Xmx).

Installation guide

To start the bootstrap procedure of the development Open Baton environment you can type the following command:

sh <(curl -s http://get.openbaton.org/bootstrap) develop

Alternatively, you can have a non-interactive installation using a configuration file. Specifically, you need to have the configuration file locally available and to pass it to the bootstrap command as a parameter. You can download this example of configuration file, modify it accordingly and execute the bootstrap typing the following command:

sh <(curl -s http://get.openbaton.org/bootstrap) develop --config-file=<absolute path to your configuration file>

NOTE - If you need support, get in contact with us at: info@openbaton.org

VERY IMPORTANT NOTE - By default RabbitMQ is installed on the host of the NFVO. Be aware of the fact that during the installation you will be prompted for entering the RabbitMQ IP and Port. Please make sure that this IP can be reached by external components (VMs, or host where will run other VNFMs) otherwise you will have runtime issues. If you are installing Open Baton on a VM running in OpenStack, the best is that you put here the floating IP.

During the bootstrap procedure you will be prompted for inputs. For instance you can choose to install or not the Generic VNFM as well as other additional components, or enable or not SSL. For each additional component, you can choose if install a specific TAG of a component or if install the "develop" version of the source code (the default). At the end of the bootstrap procedure, if there are no errors, the dashboard should be reachable at: localhost:8080. Depending on which additional component you decided to add to the Open Baton installation then you should have the following structure:

/opt/openbaton/
├── nfvo
├── generic-vnfm
├── fm-system
├── autoscaling
└── nse

Where:

  • nfvo contains the source code and scripts of the NFVO
  • generic-vnfm contains the source code and scripts required for dealing with the Generic VNFM
  • fm-system contains the source code and scripts required for dealing with the Fault Management System (FMS)
  • autoscaling contains the source code and scripts required for dealing with the Auto Scaling Engine (ASE)
  • nse contains the source code and scripts required for dealing with the Network Slicing Engine (NSE)

At this point the NFVO is ready to be used. Please refer to the Introduction on how to start using it or step into the hello world tutorial immediately.

Starting and stopping the NFVO

After the installation procedure the NFVO is running. If you want to stop it, enter this command:

cd /opt/openbaton/nfvo
./openbaton.sh stop

To start the nfvo, enter the command:

cd /opt/openbaton/nfvo
./openbaton.sh start

Starting and stopping the Generic VNFM (and the other additional components)

If you are also using the Generic VNFM remember you can stop it with the following command:

cd /opt/openbaton/generic-vnfm
./generic-vnfm.sh stop

and start it with the following command:

cd /opt/openbaton/generic-vnfm
./generic-vnfm.sh start

NOTE - For all the other additional components the commands above still apply just adapted to the specific component (e.g.: for the Fault Management System you can use the 'fm-system.sh' script, etc.)

Configure it

For specific configuration refer to the configuration