diff options
author | 2016-02-02 15:27:24 +0000 | |
---|---|---|
committer | 2016-02-02 15:27:25 +0000 | |
commit | b84ebeaf66a3da4fc1d72f87c9be3f52f211b2ad (patch) | |
tree | aa6f93b9293c1d31054f6d28b250455ebd7e9777 /docs/configguide/featureconfig.rst | |
parent | 7437f0783c95f448851217b85faf4ddafa1498b1 (diff) | |
parent | dd65aa3b5cf38a7ae22f2aa551c78582cdf4d009 (diff) |
Merge "Added config guide for Promise JIRA: PROMISE-65"
Diffstat (limited to 'docs/configguide/featureconfig.rst')
-rw-r--r-- | docs/configguide/featureconfig.rst | 54 |
1 files changed, 52 insertions, 2 deletions
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=<user password from Step 2> \ + OS_TEST_FLAVOR=<flavor ID from Step 3> \ + OS_TEST_NETWORK=<network ID from Step 4> \ + OS_TEST_IMAGE=<image ID from Step 5> \ + 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. |