diff options
| author |   Yujun Zhang <zhang.yujunz@zte.com.cn> | 2017-05-28 11:19:39 +0800 |
|---|---|---|
| committer | Yujun Zhang <zhang.yujunz@zte.com.cn> | 2017-05-29 22:49:24 +0800 |
| commit | 5e1a84abafbbb222e2e032af4891a567a86d6687 (patch) | |
| tree | 4539dd9b55cb8cab74c5fdc08399d7c44bdef4ef /docs | |
| parent | acd3778e3d3ede9828408b67adef374a76493238 (diff) | |
Update getting started guide
Change-Id: Ic40c9f30dc2d803e047a5f39aa0b20de24b6a60b
Signed-off-by: Yujun Zhang <zhang.yujunz@zte.com.cn>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/testing/user/userguide/getting-started.rst | 60 | ||||
| -rw-r--r-- | docs/testing/user/userguide/index.rst | 2 |
2 files changed, 41 insertions, 21 deletions
diff --git a/docs/testing/user/userguide/getting-started.rst b/docs/testing/user/userguide/getting-started.rst index 8289a9c2..0f60f13f 100644 --- a/docs/testing/user/userguide/getting-started.rst +++ b/docs/testing/user/userguide/getting-started.rst @@ -5,10 +5,29 @@ Getting started with QTIP ************************* -Overview -======== +.. code-block:: + + pip install qtip + eval $(ssh-agent) + + qtip create <project_name> + cd <project_name> + + qtip setup + qtip run + qtip teardown + +Installation +============ + +Refer to `installation and configuration guide`_ for details + +.. _installation and configuration guide:../configguide/ -Create a new project to hold the neccessary configurations and test results +Create +====== + +Create a new project to hold the necessary configurations and test results :: qtip create <project_name> @@ -29,32 +48,33 @@ The user would be prompted for OPNFV installer, its hostname etc **OPNFV Scenario [unknown]: os-nosdn-nofeature-ha** Depends on the OPNFV scenario deployed -With the framework generated, user should now proceed on to setting up testing environment. In this step, information related to OPNFV cluster would -be generated, such as getting the IP addresses of the nodes in System Under Test (SUT). -:: +Setup +===== + +With the project is created, user should now proceed on to setting up testing environment. In this step, ssh connection +to hosts in SUT will be configured automatically:: cd <project_name> $ qtip setup -QTIP uses `ssh-agent` for authentication. It is critical that it started and stopped in the correct way. - +Run +=== -ssh-agent -========= +QTIP uses ``ssh-agent`` for authentication of ssh connection to hosts in SUT. It must be started correctly before +running the tests:: -ssh-agent is used to hold the private keys for RSA, DCA authentication. In order to start the process -:: + eval $(ssh-agent) - $ eval $(ssh-agent) +Then run test with ``qtip run`` -This would start the agent in background. One must now be able to execute QTIP -:: +Teardown +======== - $ qtip run +Clean up the temporary folder on target hosts. -However, if QTIP is not working because of `ssh-agent`, one should kill the process as follows -:: +.. note:: The installed packages for testing won't be uninstalled. - $ eval $(ssh-agent -k) +One more thing +============== -Then start the agent again as described above. +You may use ``-v`` for verbose output (``-vvv`` for more, ``-vvvv`` to enable connection debugging) diff --git a/docs/testing/user/userguide/index.rst b/docs/testing/user/userguide/index.rst index 9b6ab888..e6eaea59 100644 --- a/docs/testing/user/userguide/index.rst +++ b/docs/testing/user/userguide/index.rst @@ -12,7 +12,7 @@ QTIP User Guide :maxdepth: 2 overview.rst + getting-started.rst cli.rst api.rst compute.rst - getting-started.rst |