docs/installationprocedure/feature.configuration.rst

   1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
   2 .. http://creativecommons.org/licenses/by/4.0
   3
   4 Manual testing
   5 ==============
   6
   7 Promise installation
   8 --------------------
   9
  10 Install nodejs, npm and promise
  11
  12 .. code-block:: bash
  13
  14     curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
  15     sudo apt-get install -y nodejs
  16     sudo npm -g install npm@latest
  17     git clone https://gerrit.opnfv.org/gerrit/promise
  18     cd promise/source
  19     npm install
  20
  21 Please note that the last command 'npm install' will install all needed dependencies
  22 for promise (including yangforge and mocha)
  23
  24 .. figure:: images/screenshot_promise_install.png
  25    :name: figure1
  26       :width: 90%
  27
  28
  29 Validation
  30 ----------
  31 Please perform the following preparation steps:
  32
  33 1. Set OpenStack environment parameters properly (e.g. source openrc admin demo
  34    in DevStack)
  35 2. Create OpenStack tenant (e.g. promise) and tenant user (e.g. promiser)
  36 3. Create a flavor in Nova with 1 vCPU and 512 MB RAM
  37 4. Create a private network, subnet and router in Neutron
  38 5. Create an image in Glance
  39
  40 Once done, the promise test script can be invoked as follows (as a single line
  41 command):
  42
  43 .. code-block:: bash
  44
  45    NODE_ENV=mytest \
  46    OS_TENANT_NAME=promise \
  47    OS_USERNAME=promiser \
  48    OS_PASSWORD=<user password from Step 2> \
  49    OS_TEST_FLAVOR=<flavor ID from Step 3> \
  50    OS_TEST_NETWORK=<network ID from Step 4> \
  51    OS_TEST_IMAGE=<image ID from Step 5> \
  52    npm run -s test -- --reporter json > promise-results.json
  53
  54 The results of the tests will be stored in the promise-results.json file.
  55
  56 The results can also be seen in the console ("npm run -s test")
  57
  58 .. figure:: images/screenshot_promise.png
  59    :name: figure2
  60    :width: 90%
  61
  62 All 33 tests passing?!
  63 Congratulations, promise has been successfully installed and configured.