From dd65aa3b5cf38a7ae22f2aa551c78582cdf4d009 Mon Sep 17 00:00:00 2001 From: Bertrand Souville Date: Mon, 1 Feb 2016 16:33:20 +0100 Subject: Added config guide for Promise JIRA: PROMISE-65 Change-Id: I09c1f50483aa08586acc112ca3aa7da75f73b988 Signed-off-by: Bertrand Souville --- docs/configguide/featureconfig.rst | 54 ++++++++++++++++++++++++- docs/configguide/images/screenshot_promise.png | Bin 0 -> 101419 bytes 2 files changed, 52 insertions(+), 2 deletions(-) create mode 100755 docs/configguide/images/screenshot_promise.png (limited to 'docs') diff --git a/docs/configguide/featureconfig.rst b/docs/configguide/featureconfig.rst index 44e7a3a..ea3dc8f 100644 --- a/docs/configguide/featureconfig.rst +++ b/docs/configguide/featureconfig.rst @@ -1,5 +1,55 @@ -====================================== Promise Feature Configuration Overview ====================================== -Overview of Promise configuration. +Promise installation +-------------------- + +Install nodejs, npm and promise + +.. code-block:: bash + + curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash - + sudo apt-get install -y nodejs + sudo npm -g install npm@latest + git clone https://github.com/opnfv/promise.git + cd promise + npm install + +Please note that the last command 'npm install' will install all needed dependencies +for promise (including yangforge and mocha) + +Testing +------- +Please perform the following preparation steps: + +1. Set OpenStack environment parameters properly (e.g. source openrc admin demo + in DevStack) +2. Create OpenStack tenant (e.g. promise) and tenant user (e.g. promiser) +3. Create a flavor in Nova with 1 vCPU and 512 MB RAM +4. Create a private network, subnet and router in Neutron +5. Create an image in Glance + +Once done, the promise test script can be invoked as follows (as a single line +command): + +.. code-block:: bash + + NODE_ENV=mytest \ + OS_TENANT_NAME=promise \ + OS_USERNAME=promiser \ + OS_PASSWORD= \ + OS_TEST_FLAVOR= \ + OS_TEST_NETWORK= \ + OS_TEST_IMAGE= \ + npm run -s test -- --reporter json > promise-results.json + +The results of the tests will be stored in the promise-results.json file. + +The results can also be seen in the console ("npm run -s test") + +.. figure:: images/screenshot_promise.png + :name: figure1 + :width: 90% + +All 33 tests passing?! +Congratulations, promise has been successfully installed and configured. diff --git a/docs/configguide/images/screenshot_promise.png b/docs/configguide/images/screenshot_promise.png new file mode 100755 index 0000000..4a0cbe3 Binary files /dev/null and b/docs/configguide/images/screenshot_promise.png differ -- cgit 1.2.3-korg