summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRoger Maitland <Roger.Maitland@amdocs.com>2018-04-05 16:18:11 -0400
committerRoger Maitland <Roger.Maitland@amdocs.com>2018-04-05 16:18:11 -0400
commitbb8adda7030097ce99d68902ce1e86520b71bde8 (patch)
treefe3fbcad69315552c1023c35d220eb9584ae277f
parent95dd46311f15e3d004e821496e135e7b43faee4e (diff)
Added kubectl and helm install to user guide
Change-Id: I44edef3b6225c94717fa804ffec7644e95be12c4 Signed-off-by: Roger Maitland <Roger.Maitland@amdocs.com> Issue-ID: OOM-822
-rw-r--r--docs/oom_user_guide.rst47
1 files changed, 45 insertions, 2 deletions
diff --git a/docs/oom_user_guide.rst b/docs/oom_user_guide.rst
index 97b2fde01a..1b9a3eaef3 100644
--- a/docs/oom_user_guide.rst
+++ b/docs/oom_user_guide.rst
@@ -48,7 +48,48 @@ The OOM team with assistance from the ONAP project teams, have built a
comprehensive set of Helm charts, yaml files very similar to TOSCA files, that
describe the composition of each of the ONAP components and the relationship
within and between components. Using this model Helm is able to deploy all of
-ONAP this simple command::
+ONAP with a few simple commands.
+
+Pre-requisites
+--------------
+Your environment must have both the Kubernetes `kubectl` and Helm setup as a one time activity.
+
+Install Kubectl
+~~~~~~~~~~~~~~~
+Enter the following to install kubectl (on Ubuntu, there are slight differences on other O/Ss), the Kubernetes command line interface used to manage a Kubernetes cluster::
+
+ > curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.8.6/bin/linux/amd64/kubectl
+ > chmod +x ./kubectl
+ > sudo mv ./kubectl /usr/local/bin/kubectl
+ > mkdir ~/.kube
+
+Paste kubectl config from Rancher (see the :ref:`cloud-setup-guide-label` for alternative Kubenetes environment setups) into the `~/.kube/config` file.
+
+Verify that the Kubernetes config is correct::
+
+ > kubectl get pods --all-namespaces
+
+At this point you should see six Kubernetes pods running.
+
+Install Helm
+~~~~~~~~~~~~
+Helm is used by OOM for package and configuration management. To install Helm, enter the following::
+
+ > wget http://storage.googleapis.com/kubernetes-helm/helm-v2.6.1-linux-amd64.tar.gz
+ > tar -zxvf helm-v2.6.1-linux-amd64.tar.gz
+ > sudo mv linux-amd64/helm /usr/local/bin/helm
+
+Verify the Helm version with::
+
+ > helm version
+
+Install the Helm Tiller application and initialize with::
+
+ > helm init
+
+Install the Helm Repo
+---------------------
+Once kubectl and Helm are setup, one needs to setup a local Helm server to server up the ONAP charts::
> helm install osn/onap
@@ -68,10 +109,12 @@ stable which should be removed to avoid confusion::
To prepare your system for an installation of ONAP, you'll need to::
> git clone http://gerrit.onap.org/r/oom
- > cd kubernetes
+ > cd oom/kubernetes
+
To setup a local Helm server to server up the ONAP charts::
+ > helm init
> helm serve &
Note the port number that is listed and use it in the Helm repo add as follows::