StorPerf Installation Guide

StorPerf Installation Guide

OpenStack Prerequisites

If you do not have an Ubuntu 16.04 image in Glance, you will need to add one. There are scripts in storperf/ci directory to assist, or you can use the follow code snippets:

# Put an Ubuntu Image in glance
wget -q
openstack image create "Ubuntu 16.04 x86_64" --disk-format qcow2 --public \
    --container-format bare --file ubuntu-16.04-server-cloudimg-amd64-disk1.img

# Create StorPerf flavor
openstack flavor create storperf \
    --id auto \
    --ram 8192 \
    --disk 4 \
    --vcpus 2


StorPerf is delivered as a Docker container. There are two possible methods for installation in your environment:

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

Running StorPerf on Jump Host


  • Docker must be installed
  • Jump Host must have access to the OpenStack Controller API
  • Jump Host must have internet connectivity for downloading docker image
  • Enough floating IPs must be available to match your agent count

Running StorPerf in a VM


  • VM has docker installed
  • VM has OpenStack Controller credentials and can communicate with the Controller API
  • VM has internet connectivity for downloading the docker image
  • Enough floating IPs must be available to match your agent count

VM Creation

The following procedure will create the VM in your environment

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

nova boot --nic net-id=$ADMIN_NET_ID --flavor m1.small --key-name=StorPerf --image 'Ubuntu 14.04' 'StorPerf Master'

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

VM Docker Installation

The following procedure will install Docker on Ubuntu 14.04.

sudo apt-key adv --keyserver hkp:// --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
cat << EOF | sudo tee /etc/apt/sources.list.d/docker.list
deb ubuntu-trusty main

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

Pulling StorPerf Container


The tag for the latest stable Danube will be:

docker pull opnfv/storperf:danube.0.1


The tag for the latest stable Colorado release is:

docker pull opnfv/storperf:colorado.0.1


The tag for the latest stable Brahmaputra release is:

docker pull opnfv/storperf:brahmaputra.1.2


The tag for the latest development version is:

docker pull opnfv/storperf:master