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 https://cloud-images.ubuntu.com/releases/16.04/release/ubuntu-16.04-server-cloudimg-amd64-disk1.img
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
Planning¶
StorPerf is delivered as a Docker container. There are two possible methods for installation in your environment:
- Run container on Jump Host
- Run container in a VM
Running StorPerf on Jump Host¶
Requirements:
- 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¶
Requirements:
- 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://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 -y docker-engine
sudo usermod -aG docker ubuntu