diff options
| author |   mbeierl <mark.beierl@dell.com> | 2017-02-21 13:23:42 -0500 |
|---|---|---|
| committer | mbeierl <mark.beierl@dell.com> | 2017-02-23 13:20:02 -0500 |
| commit | 176b0ff44e6e5b8e3133a5b2fc652fa3850779d8 (patch) | |
| tree | bd4d4f10d8a1df9ec3a7e5c84f8c89cb13fd3957 /docs/userguide/execution.rst | |
| parent | 2994748e8112feccf870ff9db923040346dfee60 (diff) | |
Documentation Update
Adds documentation for Danube.
Change-Id: I2755cb00b769cd0668e5c956d0b70c33d328d882
JIRA: STORPERF-81
Signed-off-by: mbeierl <mark.beierl@dell.com>
Diffstat (limited to 'docs/userguide/execution.rst')
| -rw-r--r-- | docs/userguide/execution.rst | 82 |
1 files changed, 0 insertions, 82 deletions
diff --git a/docs/userguide/execution.rst b/docs/userguide/execution.rst deleted file mode 100644 index f01fe06..0000000 --- a/docs/userguide/execution.rst +++ /dev/null @@ -1,82 +0,0 @@ -.. 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 - |