Veryx PktBlaster User manual

SDN Controller Test
Version 1.4
Installation Guide
For
Performance Benchmarking & Network Emulator
Part Number: T / IG –PKTBLASTER-SDN-CTR-TEST-1.4 –0117/2.0

Copyright Veryx Technologies Pvt. Ltd.
Copyright© Veryx Technologies Pvt. Ltd. All rights reserved.
Veryx™, ATTEST, PktBlaster™, SAMTEST™, vTAP, vProbe, RETINA are trademarks or registered
trademarks of Veryx Technologies Pvt. Ltd. All other trademarks of respective owners are
acknowledged.
This document may not be copied either in whole or in part by any means or media without the
permission of Veryx Technologies Pvt. Ltd.
THE PROGRAMS FURNISHED ARE PROVIDED ON AN "AS IS" BASIS, WITHOUT ANY WARRANTIES
OR REPRESENTATIONS EXPRESS, IMPLIED, OR STATUTORY; INCLUDING, WITHOUT LIMITATION,
WARRANTIES OF QUALITY, PERFORMANCE, NONINFRINGEMENT, MERCHANTABILITY, OR
FITNESS FOR A PARTICULAR PURPOSE. NOR ARE THERE ANY WARRANTIES CREATED BY A
COURSE OF DEALING, COURSE OF PERFORMANCE, OR TRADE USAGE. LICENSOR DOES NOT
WARRANT THAT THE PRODUCTS WILL MEET LICENSEE'S NEEDS OR BE FREE FROM ERRORS, OR
THAT THE OPERATION OF THE PRODUCTS WILL BE UNINTERRUPTED.

Copyright Veryx Technologies Pvt. Ltd.
TABLE OF CONTENTS
1. Introduction.......................................................................................................................................... 1
2. Installation ...........................................................................................................................................3
2.1. VM Deployment............................................................................................................................ 3
2.1.1. Pre-requisites ........................................................................................................................3
2.1.1.1. Platform Requirements.................................................................................................3
2.1.2. Deployment........................................................................................................................... 3
2.2. Docker Deployment ...................................................................................................................... 3
2.2.1. Pre-requisites ........................................................................................................................3
2.2.1.1. Platform Requirements.................................................................................................3
2.2.1.2. Software Requirements ................................................................................................ 4
2.2.2. Run Docker Image................................................................................................................. 4
2.3. Installation in Bare-Metal Servers.................................................................................................5
2.3.1. Pre-requisites ........................................................................................................................5
2.3.1.1. Platform Requirements.................................................................................................5
2.3.1.2. Software Requirements ................................................................................................ 5
2.3.1.3. Installation of Pre-requisite Software........................................................................... 5
2.3.2. Installation of PktBlaster-SDN Controller Test......................................................................7
3. Accessing PktBlaster SDN................................................................................................................9
4. Licensing Information....................................................................................................................... 11
4.1. License Activation Procedure......................................................................................................11
4.1.1. License Activation for Lite................................................................................................... 11
4.1.1.1. Online License Activation............................................................................................12
4.1.1.2. Offline License Activation ...........................................................................................12
4.1.2. License Activation for Premium ..........................................................................................13
4.1.3. Upgrade License from Lite to Premium ..............................................................................13
4.1.4. Extend License Period .........................................................................................................13

Copyright Veryx Technologies Pvt. Ltd.
This page is intentionally left blank

Copyright Veryx Technologies Pvt. Ltd.
1
1. INTRODUCTION
This guide provides the steps for installing PktBlaster SDN Controller Test.
PktBlaster SDN Controller Test is available as Lite and Premium versions. Lite version is
available with limited features for trials. Whereas Premium version is available with complete
features enabled. These are available as pre-installed VM and Docker images and as a RPM
package which can be installed in bare-metal commodity servers. PktBlaster SDN Controller
Test consists of the following components that are licensed separately:
Performance Benchmarking
Network Emulator
The installation procedure is common for both the product components.
Once installation is completed, the product can be accessed remotely from a workstation that
supports the following browser:
Browser
Firefox 45.0.0 or higher version

PktBlaster SDN Controller Test
Installation Guide
Copyright Veryx Technologies Pvt. Ltd.
2
This page is intentionally left blank

Copyright Veryx Technologies Pvt. Ltd.
3
2. INSTALLATION
2.1. VM DEPLOYMENT
2.1.1. Pre-requisites
Currently VM images are available in ova and qcow2 formats. Refer the requirements given
below for deploying the VM images.
2.1.1.1. Platform Requirements
vCPU
8 cores
Memory
8 GB or above
Disk Space
16 GB or above
2.1.2. Deployment
ova and qcow2 formats of VM images can be deployed using tools Oracle VM VirtualBox and
Virtual Machine Manager respectively.
Following credentials should be used to login to the VMs.
Super-User Login Information:
Username: root
Password: rootroot
By default, DHCP is enabled in network ports of VM images. However, the IP address of test
port should be set manually as per your test setup. Since the VM has CentOS 7.1 64 Bit Minimal
OS, answers for questions 2 and 4 in CentOS7 FAQ (refer: https://wiki.centos.org/FAQ/CentOS7)
can be referred to set IP address statically.
2.2. DOCKER DEPLOYMENT
2.2.1. Pre-requisites
2.2.1.1. Platform Requirements
CPU
i7 or above
Memory
8 GB or above
Disk Space
16 GB or above

PktBlaster SDN Controller Test
Installation Guide
Copyright Veryx Technologies Pvt. Ltd.
4
2.2.1.2. Software Requirements
It is required to have Docker software installed in platform to run Docker image of PktBlaster
SDN. Refer https://docs.docker.com/engine/getstarted/step_one/ for the procedure to
download and install Docker software.
2.2.2. Run Docker Image
Docker image of PktBlaster SDN is available in tarball.
Download the tarball PBSDN1.4R4.tar and transfer to the platform. Follow below procedure to
run image of PktBlaster SDN. Use an account with administrative privileges to install packages.
Either run the commands as the root user or configure the sudo utility.
To load PktBlaster SDN image:
1. Execute the following command in terminal to load PktBlaster SDN image to the container.
# docker load -i PBSDN1.4R4.tar
2. Execute the following command to list the images created.
# docker images pbsdn1.4r4
If pbsdn1.4r4 is listed in the repository as below, then the image is loaded to the container
successfully.
REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE
pbsdn1.4r4 latest 9e9f876451dc 2 weeks ago 1.27 GB
To run PktBlaster SDN image:
1. Execute the following command to run PktBlaster SDN image and start tomcat server.
# docker run -it --privileged pbsdn1.4r4 /bin/bash -c
"/etc/init.d/tomcat6 start";"b"a"s"h"
2. Execute the following command to start MySQL server in Docker.
# /usr/bin/mysqld_safe &
The above command runs image with default network configurations. To run with user-
defined network configuration, refer
https://docs.docker.com/engine/userguide/networking/work-with-networks/

Installation
Copyright Veryx Technologies Pvt. Ltd.
5
2.3. INSTALLATION IN BARE-METAL SERVERS
2.3.1. Pre-requisites
2.3.1.1. Platform Requirements
CPU
i7 or above
Memory
8 GB or above
Disk Space
16 GB or above
Operating System
CentOS 7.1 64 Bit Minimal
url: http://archive.kernel.org/centos-
vault/7.1.1503/isos/x86_64/CentOS-7-x86_64-Minimal-1503-
01.iso
2.3.1.2. Software Requirements
MySQL Client
5.6
MySQL Server
5.6
GNU C Compiler
4.5.8
Python
2.7 or above
Automake
1.13 or above
Autoconf
2.69 or above
Libtool
2.4.2 or above
2.3.1.3. Installation of Pre-requisite Software
Use an account with administrative privileges to install packages. Either run the commands as
the root user or configure the sudo utility.
For package installation, ensure that the server is connected to the internet while installing
the above packages. If the server is not directly connected to the internet use the following
commands to configure the proxy.
$ export http_proxy=http://Your Proxy IP:port
(E.g., export http_proxy=http://192.168.12.6:3128)
To install MySQL:
1. Install yum package using the following command.
# yum -y install yum-utils.noarch
2. Edit the /etc/yum.repos.d/mysql-community.repo file and add the following
for your environment:

PktBlaster SDN Controller Test
Installation Guide
Copyright Veryx Technologies Pvt. Ltd.
6
# Enable to use MySQL 5.6
[mysql56-community]
name=MySQL 5.6 Community Server
baseurl=http://repo.mysql.com/yum/mysql-5.6-
community/el/6/$basearch/
enabled=1
gpgcheck=0
3. Enable MySQL package repository using the following command.
# yum-config-manager --enable mysql-community.repo
4. Install MySQL server and start it by executing the following commands in sequence.
# yum install mysql-community-server
# mysql_install_db
# chown mysql:mysql /var/lib/mysql/*
# chown mysql:mysql /var/lib/mysql/mysql/*
# mysqld_safe --skip-grant-tables&
5. Configure user and password for creating database using following command.
# mysql -uroot
mysql> FLUSH PRIVILEGES;
mysql> UPDATE mysql.user SET Password=PASSWORD('ATTEST') WHERE
User='root';
mysql> QUIT;
To install other packages:
Execute the following command in terminal.
# yum -y install psmisc telnet net-tools mlocate sudo curl \
openssl gcc make python-devel openssl-devel kernel-devel graphviz \
kernel-debug-devel autoconf automake libtool xorg-x11-xauth \
python-six