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

Installation
Copyright Veryx Technologies Pvt. Ltd.
7
To stop firewall:
1. Execute the following commands in sequence.
# iptables -F
# systemctl disable firewalld
2. Restart the server.
# restart
2.3.2. Installation of PktBlaster-SDN Controller Test
1. Download the package PBSDN-1.4.4.0-1.el7.centos.x86_64.rpm and transfer to the server.
2. Install the package using the following command.
# rpm -ivh PBSDN-1.4.4.0-1.el7.centos.x86_64.rpm

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

Copyright Veryx Technologies Pvt. Ltd.
9
3. ACCESSING PKTBLASTER SDN
To start the GUI, at the client PC, open the browser and provide the IP address of the VM,
Docker or the server in which PktBlaster installer package is installed.
Refer User guides of Performance and Emulation modules to configure the controller, create a
traffic profile and execute performance and emulation tests.

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

Copyright Veryx Technologies Pvt. Ltd.
11
4. LICENSING INFORMATION
PktBlaster SDN Controller Test has two types of licenses:
Lite: Available freely with limited features. By default, this type of license will be active for
30 days, but it can be extended based on request. To extend Lite license, e-mail to
[email protected].
Premium: Available after purchasing the tool. To get Premium license, e-mail to
[email protected].
4.1. LICENSE ACTIVATION PROCEDURE
4.1.1. License Activation for Lite
When you access the tool, you are prompted to choose the licensing type in License Activation
Wizard (see Figure 1: License Selection). On choosing Lite Version and clicking “Next” button, the
tool will opt you to obtain license by online or offline method (see Figure 2: Method Selection).
Figure 1: License Selection

PktBlaster SDN Controller Test
Installation Guide
Copyright Veryx Technologies Pvt. Ltd.
12
Figure 2: Method Selection
4.1.1.1. Online License Activation
To obtain activation license online, choose Activate Online and click “Next” button. To activate
online, the PktBlaster SDN Controller Test installed VM should have internet access. If it does not
have internet access, suggest to choose Activate Offline.
4.1.1.2. Offline License Activation
To obtain activation license offline, follow two steps mentioned below.
Step 1: Click “Generate system.zip” button (see Figure 3: Offline License Activation) and e-mail
the generated system.zip file to [email protected].
Figure 3: Offline License Activation

Licensing Information
Copyright Veryx Technologies Pvt. Ltd.
13
Step 2: Browse and select the license file (license.zip) got from [email protected] and click
“Next” button.
4.1.2. License Activation for Premium
Choose Premium Version and click on “Next” button. The tool will opt you to obtain license by
offline method.
To obtain activation license offline, follow two steps mentioned in section Offline License
Activation
4.1.3. Upgrade License from Lite to Premium
If you want to upgrade the license from Lite to Premium, you can do it by clicking the license
management icon in top right of PktBlaster SDN Controller Test web page (see Figure 4: License
Upgrade) and following the procedure mentioned in section Offline License Activation.
Figure 4: License Upgrade
4.1.4. Extend License Period
If you wish to extend the period of license, you can do it by following the procedure mentioned in
section Offline License Activation

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

© Veryx Technologies. All rights reserved. Specifications subject to change.
About Veryx Technologies
Veryx Technologies provides innovative Test and Measurement solutions for the global communications industry. Our long
standing testing expertise in the communications industry combined with our focus on the latest technology standards enables our
customers to achieve significant enhancement of their Product Quality and Testing Efficiency, with simultaneous reduction on
investments. Veryx delivers superior value to its customers through the design, development and deployment of comprehensive,
high quality, flexible products in the testing domain. Our unique product design and architecture coupled with intuitive and easy to
use GUI provides a very capable test platform.
www.veryxtech.com
INDIA
Veryx Technologies Pvt. Ltd.
Floor 1, RR Tower 4
Thiru-Vi-Ka Industrial Estate
Guindy
Chennai 600032 INDIA
Phone: [phone]
Email: [e-mail]
USA
Veryx Technologies Inc.
1 International Plaza, Suite 550
Philadelphia
PA 19113
USA
Phone: [phone]
Email: [e-mail]