Setup execution platform (vim emu)

This guide describes how to setup a vim-emu-based execution platform to be used as execution target by tng-sdk-benchmark. The entire setup process in completely automated using Ansible and assumes to be executed against a fresh Ubuntu 16.04 installation.

Overview

A typical setup looks like this:

TODO figure

Requirements and Assumptions

• Machine 1:
  • Ansible installed
  • Git installed
  • tng-sdk-benchmark installed (TODO add link to installation instructions)
• Machine 2 (installation target):
  • Ubuntu 16:04 LTS (fresh!)
  • SSH access

NOTE 1: Do not install on a machine that is already in use for other stuff! The installation does some system reconfigurations, e.g., firewall, that might terribly break Machine 2.

NOTE 2: Only install on machines in a privat network/lab environment. The vim-emu test execution machine will open control ports to the public without any authentication mechanisms, e.g., Docker. It will also run the emulator as root user. All this can cause security risks! Only use it if you know what you are doing.

Installation

1. Preparations

Make sure Machine 1 can connect to Machine 2 via SSH. And that git and ansible are installed on Machine 1.

2. Clone tng-sdk-benchmark

# on Machine 1 do:
git clone https://github.com/sonata-nfv/tng-sdk-benchmark.git

3. Configure Ansible

Check the Ansible Documentation to learn how to properly configure target hosts in ansible.

# on Machine 1 do:
cd tng-sdk-benchmark/node-installers
# add your target (Machine 2) to the hosts.yml
vim hosts.yml

4. Run Ansible installer

# on Machine 1 do:
ansible-playbook --ask-become-pass -i hosts.yml node-vim-emu.yml

The installation might take 30 minutes.

5. Verify your installation

To check the installation, use SSH to connect to your target machine on which the platform was installed (Machine 2).

# on Machine 2 do:
sudo screen -r  # (the tng-bench-emusrv server is running in a screen session)

You should see something like:

2018-11-28 15:38:39 testvm tngsdk.benchmark.pdriver.vimemu.server[10391] INFO Starting tng-bench-emusrv server ... CTRL+C to exit.

Done!

Configuration

TODO How to configure tng-bench to use the target platform.

Usage and Test

TODO small usage example

FAQ