summaryrefslogtreecommitdiffstats
path: root/docs/configguide
diff options
context:
space:
mode:
authorRyota Mibu <r-mibu@cq.jp.nec.com>2016-02-02 15:27:24 +0000
committerGerrit Code Review <gerrit@172.30.200.206>2016-02-02 15:27:25 +0000
commitb84ebeaf66a3da4fc1d72f87c9be3f52f211b2ad (patch)
treeaa6f93b9293c1d31054f6d28b250455ebd7e9777 /docs/configguide
parent7437f0783c95f448851217b85faf4ddafa1498b1 (diff)
parentdd65aa3b5cf38a7ae22f2aa551c78582cdf4d009 (diff)
Merge "Added config guide for Promise JIRA: PROMISE-65"
Diffstat (limited to 'docs/configguide')
-rw-r--r--docs/configguide/featureconfig.rst54
-rwxr-xr-xdocs/configguide/images/screenshot_promise.pngbin0 -> 101419 bytes
2 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.
diff --git a/docs/configguide/images/screenshot_promise.png b/docs/configguide/images/screenshot_promise.png
new file mode 100755
index 0000000..4a0cbe3
--- /dev/null
+++ b/docs/configguide/images/screenshot_promise.png
Binary files differ