OpenVIM installation to be used with OSM release 0

VM creation

• Requirements:
  • 1 vCPU (2 recommended)
  • 2GB RAM (4 recommended)
  • 40GB disk
  • 3 network interfaces to:
    • OSM network (to interact with RO)
    • DC intfrastructure network (to interact with the compute servers and switches)
    • Telco/VNF management network (to provide IP addresses via DHCP to the VNFs)
• Base image: ubuntu-14.04.4-server-amd64

Installing required packages and libraries

• Install required packages

sudo apt-get install mysql-server git screen wget python-yaml python-libvirt python-bottle \
  python-mysqldb python-jsonschema python-paramiko python-argcomplete python-requests

• Configure python-argcomplete

activate-global-python-argcomplete --user
echo ". /home/${USER}/.bash_completion.d/python-argcomplete.sh" >> ~/.bashrc

Building and installing the module

Openvim is still part of the github openmano repository. These instructions download all components, but just configure the openvim-related aspects.

• Clone the git repository:

git clone https://github.com/nfvlabs/openmano.git openmano

• Database creation

mysqladmin -u root -p create vim_db

• Grant access privileges from localhost. Go to mysql console and use the following commands to create user vim and grant privileges to the databases:

mysql> CREATE USER 'vim'@'localhost' identified by 'vimpw';
mysql> GRANT ALL PRIVILEGES ON vim_db.* TO 'vim'@'localhost';

• Initialize database

openmano/openvim/database_utils/init_vim_db.sh -uvim -pvimpw

• Add openvim client and scripts to the PATH. It is enough to create the /home/${USER}/bin/ folder and add there the appropriate links:

mkdir /home/${USER}/bin/
ln -s ${PWD}/openmano/openvim/openvim /home/${USER}/bin/openvim
ln -s ${PWD}/openmano/scripts/service-openmano.sh /home/${USER}/bin/service-openmano

Configuring

Configuring openvim server

• Go to openvim folder and edit openvimd.cfg.
• Start openvim server

service-openmano openvim start
#it creates a screen with name "vim" and starts inside the "./openvim/openvimd.py" program
screen -x vim                             # goes into openvim screen
[Ctrl+a , d]                              # goes out of the screen (detaches the screen)
less openvim/logs/openvim.0