From 78aa63af02df682b3c8d825c1bec9cec6cd3b207 Mon Sep 17 00:00:00 2001 From: Gerald Kunzmann Date: Thu, 9 Feb 2017 09:36:29 +0000 Subject: Update docs structure according to new guidelines in https://wiki.opnfv.org/display/DOC Change-Id: I69e6536d9044dd9db2ed3cd698059aa3a800c318 Signed-off-by: Gerald Kunzmann --- docs/release/configguide/feature.configuration.rst | 63 +++++++++++++++++++++ docs/release/configguide/images/LICENSE | 14 +++++ .../configguide/images/screenshot_promise.png | Bin 0 -> 101419 bytes .../images/screenshot_promise_install.png | Bin 0 -> 77709 bytes docs/release/configguide/index.rst | 13 +++++ 5 files changed, 90 insertions(+) create mode 100644 docs/release/configguide/feature.configuration.rst create mode 100644 docs/release/configguide/images/LICENSE create mode 100755 docs/release/configguide/images/screenshot_promise.png create mode 100644 docs/release/configguide/images/screenshot_promise_install.png create mode 100644 docs/release/configguide/index.rst (limited to 'docs/release/configguide') diff --git a/docs/release/configguide/feature.configuration.rst b/docs/release/configguide/feature.configuration.rst new file mode 100644 index 0000000..10696e0 --- /dev/null +++ b/docs/release/configguide/feature.configuration.rst @@ -0,0 +1,63 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + +Manual testing +============== + +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://gerrit.opnfv.org/gerrit/promise + cd promise/source + npm install + +Please note that the last command 'npm install' will install all needed dependencies +for promise (including yangforge and mocha) + +.. figure:: images/screenshot_promise_install.png + :name: figure1 + :width: 90% + + +Validation +---------- +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: figure2 + :width: 90% + +All 33 tests passing?! +Congratulations, promise has been successfully installed and configured. diff --git a/docs/release/configguide/images/LICENSE b/docs/release/configguide/images/LICENSE new file mode 100644 index 0000000..6a84dd4 --- /dev/null +++ b/docs/release/configguide/images/LICENSE @@ -0,0 +1,14 @@ +Copyright 2016 Open Platform for NFV Project, Inc. and its contributors + +Open Platform for NFV Project Documentation Licence +=================================================== +Any documentation developed by the "Open Platform for NFV Project" +is licensed under a Creative Commons Attribution 4.0 International License. +You should have received a copy of the license along with this. If not, +see . + +Unless required by applicable law or agreed to in writing, documentation +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/docs/release/configguide/images/screenshot_promise.png b/docs/release/configguide/images/screenshot_promise.png new file mode 100755 index 0000000..4a0cbe3 Binary files /dev/null and b/docs/release/configguide/images/screenshot_promise.png differ diff --git a/docs/release/configguide/images/screenshot_promise_install.png b/docs/release/configguide/images/screenshot_promise_install.png new file mode 100644 index 0000000..2cb27d9 Binary files /dev/null and b/docs/release/configguide/images/screenshot_promise_install.png differ diff --git a/docs/release/configguide/index.rst b/docs/release/configguide/index.rst new file mode 100644 index 0000000..41bc079 --- /dev/null +++ b/docs/release/configguide/index.rst @@ -0,0 +1,13 @@ +.. This work is licensed under a Creative Commons Attribution 4.0 International License. +.. http://creativecommons.org/licenses/by/4.0 + .. (c) + +************************************** +Promise installation and configuration +************************************** + +.. toctree:: + :numbered: + :maxdepth: 2 + + feature.configuration.rst -- cgit 1.2.3-korg