From 4d4e2f11b8ef3180dd01f7891e0e86bde195c7f5 Mon Sep 17 00:00:00 2001 From: "jose.lausuch" Date: Tue, 23 Feb 2016 09:58:45 +0100 Subject: Create troubleshooting guide as a separate .rst Change-Id: I2d5a1544e7c07dbc164b5d7403318ccafe75e5c1 Signed-off-by: jose.lausuch (cherry picked from commit a931c6fe03313fac0cb1374acad2d753670328bf) --- docs/userguide/index.rst | 121 +----------------------------------- docs/userguide/troubleshooting.rst | 122 +++++++++++++++++++++++++++++++++++++ 2 files changed, 123 insertions(+), 120 deletions(-) create mode 100644 docs/userguide/troubleshooting.rst diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst index 727acfcdf..35eb99b63 100644 --- a/docs/userguide/index.rst +++ b/docs/userguide/index.rst @@ -379,127 +379,8 @@ Based on results collected in CI, a test dashboard is dynamically generated. The URL of this dashboard is TODO LF -Troubleshooting -=============== +.. include:: ./troubleshooting.rst -VIM ---- - -vPing_SSH -^^^^^^^^^ - -vPing should work on all the scenarios. In case of timeout, check your network -connectivity. The test case creates its own security group to allow SSH access, -check your network settings and your security rules. - - -vPing_userdata -^^^^^^^^^^^^^^ - -Cloud-init in not supported on scenario dealing with ONOS. - -Tempest -^^^^^^^ - -In the upstream OpenStack CI all the Tempest test cases are supposed to pass. -If some test cases fail in an OPNFV deployment, the reason is very probably one -of the following:: - - +-----------------------------+------------------------------------------------+ - | Error | Details | - +=============================+================================================+ - | Resources required for test | Such resources could be e.g. an external | - | case execution are missing | network and access to the management subnet | - | | (adminURL) from the Functest docker container. | - +-----------------------------+------------------------------------------------+ - | OpenStack components or | Check running services in the controller and | - | services are missing or not | compute nodes (e.g. with "systemctl" or | - | configured properly | "service" commands). Configuration parameters | - | | can be verified from related .conf files | - | | located under /etc/ directories. | - +-----------------------------+------------------------------------------------+ - | Some resources required for | The tempest.conf file, automatically generated | - | execution test cases are | by Rally in Functest, does not contain all the | - | missing | needed parameters or some parameters are not | - | | set properly. | - | | The tempest.conf file is located in /home/opnfv| - | | /.rally/tempest/for-deployment- in | - | | Functest container | - | | Use "rally deployment list" command in order to| - | | check UUID of current deployment. | - +-----------------------------+------------------------------------------------+ - - -When some Tempest test case fails, captured traceback and possibly also related -REST API requests/responses are output to the console. -More detailed debug information can be found from tempest.log file stored into -related Rally deployment folder. - - -Rally -^^^^^ - -Same error causes than for Tempest mentioned above may lead to error in Rally. - -Controllers ------------ - -ODL -^^^ -2 versions are supported in Brahmaputra depending on the scenario: - * Lithium - * Berylium - -The upstream test suites have not been adapted, so you may get 18 or 15 tests -passed on 18 depending on your configuration. The 3 testcases are partly failed -due to wrong return code. - -ONOS -^^^^ - -TODO - -OpenContrail -^^^^^^^^^^^^ - - -Feature -------- - -vIMS -^^^^ -vIMS deployment may fail for several reasons, the most frequent ones are -described in the following table: - -+===================================+====================================+ -| Error | Comments | -+-----------------------------------+------------------------------------+ -| Keystone admin API not reachable | Impossible to create vIMS user and | -| | tenant | -+-----------------------------------+------------------------------------+ -| Impossible to retrieve admin role | Impossible to create vIMS user and | -| id | tenant | -+-----------------------------------+------------------------------------+ -| Error when uploading image from | impossible to deploy VNF | -| OpenStack to glance | | -+-----------------------------------+------------------------------------+ -| Cinder quota cannot be updated | Default quotas not sufficient, they| -| | are adapted in the script | -+-----------------------------------+------------------------------------+ -| Impossible to create a volume | VNF cannot be deployed | -+-----------------------------------+------------------------------------+ -| SSH connection issue between the | if vPing test fails, vIMS test will| -| Test container and the VM | fail... | -+-----------------------------------+------------------------------------+ -| No Internet access from a VM | the VMs of the VNF must have an | -| | external access to Internet | -+-----------------------------------+------------------------------------+ - - -Promise -^^^^^^^ - -TODO References ========== diff --git a/docs/userguide/troubleshooting.rst b/docs/userguide/troubleshooting.rst new file mode 100644 index 000000000..f669025ff --- /dev/null +++ b/docs/userguide/troubleshooting.rst @@ -0,0 +1,122 @@ + +Troubleshooting +=============== + +VIM +--- + +vPing_SSH +^^^^^^^^^ + +vPing should work on all the scenarios. In case of timeout, check your network +connectivity. The test case creates its own security group to allow SSH access, +check your network settings and your security rules. + + +vPing_userdata +^^^^^^^^^^^^^^ + +Cloud-init in not supported on scenario dealing with ONOS. + +Tempest +^^^^^^^ + +In the upstream OpenStack CI all the Tempest test cases are supposed to pass. +If some test cases fail in an OPNFV deployment, the reason is very probably one +of the following:: + + +-----------------------------+------------------------------------------------+ + | Error | Details | + +=============================+================================================+ + | Resources required for test | Such resources could be e.g. an external | + | case execution are missing | network and access to the management subnet | + | | (adminURL) from the Functest docker container. | + +-----------------------------+------------------------------------------------+ + | OpenStack components or | Check running services in the controller and | + | services are missing or not | compute nodes (e.g. with "systemctl" or | + | configured properly | "service" commands). Configuration parameters | + | | can be verified from related .conf files | + | | located under /etc/ directories. | + +-----------------------------+------------------------------------------------+ + | Some resources required for | The tempest.conf file, automatically generated | + | execution test cases are | by Rally in Functest, does not contain all the | + | missing | needed parameters or some parameters are not | + | | set properly. | + | | The tempest.conf file is located in /home/opnfv| + | | /.rally/tempest/for-deployment- in | + | | Functest container | + | | Use "rally deployment list" command in order to| + | | check UUID of current deployment. | + +-----------------------------+------------------------------------------------+ + + +When some Tempest test case fails, captured traceback and possibly also related +REST API requests/responses are output to the console. +More detailed debug information can be found from tempest.log file stored into +related Rally deployment folder. + + +Rally +^^^^^ + +Same error causes than for Tempest mentioned above may lead to error in Rally. + +Controllers +----------- + +ODL +^^^ +2 versions are supported in Brahmaputra depending on the scenario: + * Lithium + * Berylium + +The upstream test suites have not been adapted, so you may get 18 or 15 tests +passed on 18 depending on your configuration. The 3 testcases are partly failed +due to wrong return code. + +ONOS +^^^^ + +TODO + +OpenContrail +^^^^^^^^^^^^ + + +Feature +------- + +vIMS +^^^^ +vIMS deployment may fail for several reasons, the most frequent ones are +described in the following table: + ++===================================+====================================+ +| Error | Comments | ++-----------------------------------+------------------------------------+ +| Keystone admin API not reachable | Impossible to create vIMS user and | +| | tenant | ++-----------------------------------+------------------------------------+ +| Impossible to retrieve admin role | Impossible to create vIMS user and | +| id | tenant | ++-----------------------------------+------------------------------------+ +| Error when uploading image from | impossible to deploy VNF | +| OpenStack to glance | | ++-----------------------------------+------------------------------------+ +| Cinder quota cannot be updated | Default quotas not sufficient, they| +| | are adapted in the script | ++-----------------------------------+------------------------------------+ +| Impossible to create a volume | VNF cannot be deployed | ++-----------------------------------+------------------------------------+ +| SSH connection issue between the | if vPing test fails, vIMS test will| +| Test container and the VM | fail... | ++-----------------------------------+------------------------------------+ +| No Internet access from a VM | the VMs of the VNF must have an | +| | external access to Internet | ++-----------------------------------+------------------------------------+ + + +Promise +^^^^^^^ + +TODO -- cgit 1.2.3-korg