Update quickstart guide 98/91098/2
authorMike Elliott <mike.elliott@amdocs.com>
Tue, 9 Jul 2019 14:47:08 +0000 (10:47 -0400)
committerMike Elliott <mike.elliott@amdocs.com>
Tue, 9 Jul 2019 16:28:45 +0000 (12:28 -0400)
It has been determined that, in certain environments, readiness and liveness probe values need to be increased.
This improves reliability on the initial deployment of ONAP.

Addressed documentation feedback.

Issue-ID: OOM-1959
Signed-off-by: Mike Elliott <mike.elliott@amdocs.com>
Change-Id: I8cfb30b52e4bdbd6bab7756ec247c9574efcb503

docs/oom_quickstart_guide.rst

index ed71c97..a641fab 100644 (file)
@@ -129,24 +129,42 @@ single command
   The --timeout 900 is currently required in Dublin to address long running initialization tasks
   for DMaaP and SO. Without this timeout value both applications may fail to deploy.
 
- To deploy all ONAP applications use this command::
+To deploy all ONAP applications use this command::
 
     > cd oom/kubernetes
     > helm deploy dev local/onap --namespace onap -f onap/resources/overrides/onap-all.yaml -f onap/resources/overrides/environment.yaml -f onap/resources/overrides/openstack.yaml --timeout 900
 
- All override files may be customized (or replaced by other overrides) as per needs.
+All override files may be customized (or replaced by other overrides) as per needs.
 
+onap-all.yaml
 
-**Step 9.** Commands to interact with the OOM installation
+  Enables the modules in the ONAP deployment. As ONAP is very modular, it is possible to customize ONAP and disable some components through this configuration file.
 
-Use the following to monitor your deployment and determine when ONAP is
-ready for use::
+environment.yaml
+
+  Includes configuration values specific to the deployment environment.
+
+  Example: adapt readiness and liveness timers to the level of performance of your infrastructure
+
+openstack.yaml
+
+  Includes all the Openstack related information for the default target tenant you want to use to deploy VNFs from ONAP and/or additional parameters for the embedded tests.
+
+**Step 9.** Verify ONAP installation
+
+Use the following to monitor your deployment and determine when ONAP is ready for use::
 
   > kubectl get pods -n onap -o=wide
 
-Undeploying onap can be done using the following command::
+.. note::
+  While all pods may be in a Running state, it is not a guarantee that all components are running fine.
+
+  Launch the healthcheck tests using Robot to verify that the components are healthy.
+
+  > ~/oom/kubernetes/robot/ete-k8s.sh onap health
 
-  > helm undeploy dev --purge
+**Step 10.** Undeploy ONAP
 
+> helm undeploy dev --purge
 
 More examples of using the deploy and undeploy plugins can be found here: https://wiki.onap.org/display/DW/OOM+Helm+%28un%29Deploy+plugins