blob: f01fe0606c77097bbf5ac7d35acbd92532d0e9db (
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
|
.. This work is licensed under a Creative Commons Attribution 4.0 International License.
.. http://creativecommons.org/licenses/by/4.0
.. (c) OPNFV, Intel Corporation, AT&T and others.
=============================
StorPerf Test Execution Guide
=============================
Planning
========
There are some ports that the container can expose:
* 22 for SSHD. Username and password are root/storperf. This is used for CLI access only
* 5000 for StorPerf ReST API.
* 8000 for StorPerf's Graphite Web Server
OpenStack Credentials
~~~~~~~~~~~~~~~~~~~~~
You must have your OpenStack Controller environment variables defined and passed to
the StorPerf container. The easiest way to do this is to put the rc file contents
into a clean file the looks similar to this:
.. code-block:: console
OS_AUTH_URL=http://10.13.182.243:5000/v2.0
OS_TENANT_ID=e8e64985506a4a508957f931d1800aa9
OS_TENANT_NAME=admin
OS_PROJECT_NAME=admin
OS_USERNAME=admin
OS_PASSWORD=admin
OS_REGION_NAME=RegionOne
Additionally, if you want your results published to the common OPNFV Test Results
DB, add the following:
.. code-block:: console
TEST_DB_URL=http://testresults.opnfv.org/testapi
Running StorPerf Container
==========================
You might want to have the local disk used for storage as the default size of the docker
container is only 10g. This is done with the -v option, mounting under
/opt/graphite/storage/whisper
.. code-block:: console
mkdir -p ~/carbon
sudo chown 33:33 ~/carbon
Container with SSH
~~~~~~~~~~~~~~~~~~
Running the StorPerf Container with all ports open and a local disk for the result
storage. This is not recommended as the SSH port is open.
.. code-block:: console
docker run -t --env-file admin-rc -p 5022:22 -p 5000:5000 -p 8000:8000 -v ~/carbon:/opt/graphite/storage/whisper --name storperf opnfv/storperf
This will then permit ssh to localhost port 5022 for CLI access.
Docker Exec
~~~~~~~~~~~
Instead of exposing port 5022 externally, you can use the exec method in docker. This
provides a slightly more secure method of running StorPerf container without having to
expose port 22.
.. code-block:: console
docker run -t --env-file admin-rc -p 5000:5000 -p 8000:8000 -v ~/carbon:/opt/graphite/storage/whisper --name storperf opnfv/storperf
If needed, the container can be entered with docker exec. This is not normally required.
.. code-block:: console
docker exec -it
|
