StorPerf is delivered as a Docker container from https://hub.docker.com/r/opnfv/storperf/tags/. There are two possible methods for installation in your environment:

1. Run container on Jump Host
2. Run container in a VM

Requirements:

• Docker must be installed
• Jump Host must have access to the OpenStack Controller API
• Jump Host must be able to access StorPerf subnet

Requirements:

• VM is in the same OpenStack environment as the Cinder volumes under test
• VM is attached to a dedicated, private subnet called StorPerf
• VM has OpenStack Controller credentials and can communicate with the Controller API
• VM has docker installed
• VM has internet connectivity for downloading the docker image

The following procedure will create the VM in your environment

# Put an Ubuntu Image in glance
wget https://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-disk1.img
glance image-create --name 'StorPerf Ubuntu 14.04' --is-public=true --disk-format=qcow2 \
--container-format=bare --file=trusty-server-cloudimg-amd64-disk1.img

# Create the StorPerf network
neutron net-create StorPerf-net
neutron subnet-create StorPerf-net 192.168.0.0/16 --name StorPerf-subnet --gateway 192.168.0.1

# Create the StorPerf Flavor - Depending on how much data you are collecting, you may want to make
# the disk larger.
nova flavor-create StorPerf auto 8192 60 8

# (Optional) Create a keypair for your StorPerf master
nova keypair-add StorPerf > StorPerf.pem

# Create the StorPerf VM itself.  Here we use the network ID generated by OPNFV FUEL.
NET04_ID=`neutron net-list | grep 'net04 ' | awk '{print $2}'`
STORPERF_ID=`neutron net-list | grep 'StorPerf-net ' | awk '{print $2}'`

nova boot --nic net-id=$NET04_ID --nic net-id=$STORPERF_ID --flavor StorPerf --key-name=StorPerf \
--image 'StorPerf Ubuntu 14.04' 'StorPerf Master'

At this point, you may associate a floating IP with the StorPerf master VM.

The following procedure will install Docker on Ubuntu 14.04.

sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
cat << EOF | sudo tee /etc/apt/sources.list.d/docker.list
deb https://apt.dockerproject.org/repo ubuntu-trusty main
EOF

sudo apt-get update
sudo apt-get install docker-engine
sudo usermod -aG docker ubuntu

Start StorPerf Container

docker run -t -i opnfv/storperf /bin/bash