summaryrefslogtreecommitdiffstats
path: root/docs/userguide/08-yardstick_plugin.rst
diff options
context:
space:
mode:
authorDeepak S <deepak.s@linux.intel.com>2017-02-13 00:35:33 -0800
committerDeepak S <deepak.s@linux.intel.com>2017-02-18 17:31:21 +0530
commit754c1b2e6c66de99e1c1faa00fa76256bbf37e99 (patch)
tree3c3191ee43f64febfaac50db2531dd8b20802cdb /docs/userguide/08-yardstick_plugin.rst
parent882a8d361414a64263ca634c26a6898f7525dd24 (diff)
Docs: Adding preliminary documentation for Network Service Benchmarking.
This patch adds overview & installation instruction to get started on VNF testing. Change-Id: I73c9616d7154f701f542ff9a49c32a9516902ff4 Signed-off-by: Deepak S <deepak.s@linux.intel.com>
Diffstat (limited to 'docs/userguide/08-yardstick_plugin.rst')
-rw-r--r--docs/userguide/08-yardstick_plugin.rst144
1 files changed, 0 insertions, 144 deletions
diff --git a/docs/userguide/08-yardstick_plugin.rst b/docs/userguide/08-yardstick_plugin.rst
deleted file mode 100644
index f16dedd02..000000000
--- a/docs/userguide/08-yardstick_plugin.rst
+++ /dev/null
@@ -1,144 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International
-.. License.
-.. http://creativecommons.org/licenses/by/4.0
-.. (c) OPNFV, Ericsson AB, Huawei Technologies Co.,Ltd and others.
-
-===================================
-Installing a plug-in into yardstick
-===================================
-
-Abstract
-========
-
-Yardstick currently provides a ``plugin`` CLI command to support integration
-with other OPNFV testing projects. Below is an example invocation of yardstick
-plugin command and Storperf plug-in sample.
-
-
-Installing Storperf into yardstick
-==================================
-
-Storperf is delivered as a Docker container from
-https://hub.docker.com/r/opnfv/storperf/tags/.
-
-There are two possible methods for installation in your environment:
-
-* Run container on Jump Host
-* Run container in a VM
-
-In this introduction we will install Storperf on Jump Host.
-
-
-Step 0: Environment preparation
->>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
-
-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
-
-Before installing Storperf into yardstick you need to check your openstack
-environment and other dependencies:
-
-1. Make sure docker is installed.
-2. Make sure Keystone, Nova, Neutron, Glance, Heat are installed correctly.
-3. Make sure Jump Host have access to the OpenStack Controller API.
-4. Make sure Jump Host must have internet connectivity for downloading docker image.
-5. You need to know where to get basic openstack Keystone authorization info, such as
- OS_PASSWORD, OS_TENANT_NAME, OS_AUTH_URL, OS_USERNAME.
-6. To run a Storperf container, you need to have OpenStack Controller environment
- variables defined and passed to Storperf container. The best way to do this is to
- put environment variables in a "storperf_admin-rc" file. The storperf_admin-rc
- should include credential environment variables at least:
-
-* OS_AUTH_URL
-* OS_TENANT_ID
-* OS_TENANT_NAME
-* OS_PROJECT_NAME
-* OS_USERNAME
-* OS_PASSWORD
-* OS_REGION_NAME
-
-For this storperf_admin-rc file, during environment preparation a "prepare_storperf_admin-rc.sh"
-script can be used to generate it.
-::
-
- #!/bin/bash
- AUTH_URL=${OS_AUTH_URL}
- USERNAME=${OS_USERNAME:-admin}
- PASSWORD=${OS_PASSWORD:-console}
- TENANT_NAME=${OS_TENANT_NAME:-admin}
- VOLUME_API_VERSION=${OS_VOLUME_API_VERSION:-2}
- PROJECT_NAME=${OS_PROJECT_NAME:-$TENANT_NAME}
- TENANT_ID=`keystone tenant-get admin|grep 'id'|awk -F '|' '{print $3}'|sed -e 's/^[[:space:]]*//'`
- rm -f ~/storperf_admin-rc
- touch ~/storperf_admin-rc
- echo "OS_AUTH_URL="$AUTH_URL >> ~/storperf_admin-rc
- echo "OS_USERNAME="$USERNAME >> ~/storperf_admin-rc
- echo "OS_PASSWORD="$PASSWORD >> ~/storperf_admin-rc
- echo "OS_TENANT_NAME="$TENANT_NAME >> ~/storperf_admin-rc
- echo "OS_VOLUME_API_VERSION="$VOLUME_API_VERSION >> ~/storperf_admin-rc
- echo "OS_PROJECT_NAME="$PROJECT_NAME >> ~/storperf_admin-rc
- echo "OS_TENANT_ID="$TENANT_ID >> ~/storperf_admin-rc
-
-
-Step 1: Plug-in configuration file preparation
-++++++++++++++++++++++++++++++++++++++++++++++
-
-To install a plug-in, first you need to prepare a plug-in configuration file in
-YAML format and store it in the "plugin" directory. The plugin configration file
-work as the input of yardstick "plugin" command. Below is the Storperf plug-in
-configuration file sample:
-::
-
- ---
- # StorPerf plugin configuration file
- # Used for integration StorPerf into Yardstick as a plugin
- schema: "yardstick:plugin:0.1"
- plugins:
- name: storperf
- deployment:
- ip: 192.168.23.2
- user: root
- password: root
-
-In the plug-in configuration file, you need to specify the plug-in name and the
-plug-in deployment info, including node ip, node login username and password.
-Here the Storperf will be installed on IP 192.168.23.2 which is the Jump Host
-in my local environment.
-
-Step 2: Plug-in install/remove scripts preparation
-++++++++++++++++++++++++++++++++++++++++++++++++++
-
-Under "yardstick/resource/scripts directory", there are two folders: a "install"
-folder and a "remove" folder. You need to store the plug-in install/remove script
-in these two folders respectively.
-
-The detailed installation or remove operation should de defined in these two scripts.
-The name of both install and remove scripts should match the plugin-in name that you
-specified in the plug-in configuration file.
-For example, the install and remove scripts for Storperf are both named to "storperf.bash".
-
-
-Step 3: Install and remove Storperf
-+++++++++++++++++++++++++++++++++++
-
-To install Storperf, simply execute the following command
-::
-
- # Install Storperf
- yardstick plugin install plugin/storperf.yaml
-
-removing Storperf from yardstick
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-To remove Storperf, simply execute the following command
-::
-
- # Remove Storperf
- yardstick plugin remove plugin/storperf.yaml
-
-What yardstick plugin command does is using the username and password to log into the deployment target and then execute the corresponding install or remove script.