blob: ae3b3f80b2af752ce0aa234fbc14553477d9215a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. (c) OPNFV, Dell EMC and others.
===========================
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:
.. code-block:: bash
# 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
<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
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
.. code-block:: console
# 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.
.. code-block:: console
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
Pulling StorPerf Container
==========================
Danube
~~~~~~
The tag for the latest stable Danube will be:
.. code-block:: bash
docker pull opnfv/storperf:danube.0.1
Colorado
~~~~~~~~
The tag for the latest stable Colorado release is:
.. code-block:: bash
docker pull opnfv/storperf:colorado.0.1
Brahmaputra
~~~~~~~~~~~
The tag for the latest stable Brahmaputra release is:
.. code-block:: bash
docker pull opnfv/storperf:brahmaputra.1.2
Development
~~~~~~~~~~~
The tag for the latest development version is:
.. code-block:: bash
docker pull opnfv/storperf:master
|
