aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDileep Ranganathan <dileep.ranganathan@intel.com>2019-05-29 18:31:58 -0700
committerGary Wu <gwu@futurewei.com>2019-05-30 14:13:19 +0000
commitfd2de7f7bc953a7436d448e5fcebbfd34abaca36 (patch)
tree34d86aa8cc6837f85a5b0c888db3f86b37df58ce
parentf3c04d861a585c9ae9138ea1e93aae24deeb46bf (diff)
Readme for Distributed Analytics
Initial readme for distributed analytics. Change-Id: I53ad9296711207685891340adcaf6d6210858412 Issue-ID: ONAPARC-280 Signed-off-by: Dileep Ranganathan <dileep.ranganathan@intel.com>
-rw-r--r--vnfs/DAaaS/README.md85
1 files changed, 85 insertions, 0 deletions
diff --git a/vnfs/DAaaS/README.md b/vnfs/DAaaS/README.md
new file mode 100644
index 00000000..b0838d54
--- /dev/null
+++ b/vnfs/DAaaS/README.md
@@ -0,0 +1,85 @@
+# Distributed Analytics Framework
+## Install
+
+#### Pre-requisites
+| Required | Version |
+|------------|---------|
+| Kubernetes | 1.12.3+ |
+| Docker CE | 18.09+ |
+| Helm | 2.12.1+ |
+#### Download Framework
+```bash
+git clone https://github.com/onap/demo.git
+DA_WORKING_DIR=$PWD/demo/vnfs/DAaaS
+cd $DA_WORKING_DIR
+```
+
+#### Install Rook-Ceph for Persistent Storage
+Note: This is unusual but Flex volume path can be different than the default value. values.yaml has the most common flexvolume path configured. In case of errors related to flexvolume please refer to the https://rook.io/docs/rook/v0.9/flexvolume.html#configuring-the-flexvolume-path to find the appropriate flexvolume-path and set it in values.yaml
+```bash
+cd 00-init/rook-ceph
+helm install -n rook . -f values.yaml --namespace=rook-ceph-system
+```
+Check for the status of the pods in rook-ceph namespace. Once all pods are in Ready state move on to the next section.
+```bash
+$ kubectl -n rook-ceph get pod
+NAME READY STATUS RESTARTS AGE
+rook-ceph-agent-4zkg8 1/1 Running 0 140s
+rook-ceph-mgr-a-d9dcf5748-5s9ft 1/1 Running 0 77s
+rook-ceph-mon-a-7d8f675889-nw5pl 1/1 Running 0 105s
+rook-ceph-mon-b-856fdd5cb9-5h2qk 1/1 Running 0 94s
+rook-ceph-mon-c-57545897fc-j576h 1/1 Running 0 85s
+rook-ceph-osd-0-7cbbbf749f-j8fsd 1/1 Running 0 25s
+rook-ceph-osd-1-7f67f9646d-44p7v 1/1 Running 0 25s
+rook-ceph-osd-2-6cd4b776ff-v4d68 1/1 Running 0 25s
+rook-ceph-osd-prepare-vx2rz 0/2 Completed 0 60s
+rook-discover-dhkb8 1/1 Running 0 140s
+```
+
+#### Install Operator package
+```bash
+cd $DA_WORKING_DIR/operator
+helm install -n operator . -f values.yaml --namespace=operator
+```
+Check for the status of the pods in operator namespace. Check if Prometheus operator pods are in Ready state.
+```bash
+kubectl get pods -n operator
+NAME READY STATUS RESTARTS
+m3db-operator-0 1/1 Running 0 -etcd-operator-etcd-backup-operator-6cdc577f7d-ltgsr 1/1 Running 0
+op-etcd-operator-etcd-operator-79fd99f8b7-fdc7p 1/1 Running 0
+op-etcd-operator-etcd-restore-operator-855f7478bf-r7qxp 1/1 Running 0
+op-prometheus-operator-operator-5c9b87965b-wjtw5 1/1 Running 1
+op-sparkoperator-6cb4db884c-75rcd 1/1 Running 0
+strimzi-cluster-operator-5bffdd7b85-rlrvj 1/1 Running 0
+```
+
+#### Install Collection package
+Note: Collectd.conf is avaliable in $DA_WORKING_DIR/collection/charts/collectd/resources/config directory. Any valid collectd.conf can be placed here.
+```bash
+Default (For custom collectd skip this section)
+=======
+cd $DA_WORKING_DIR/collection
+helm install -n cp . -f values.yaml --namespace=edge1
+
+Custom Collectd
+===============
+Build the image and set the image name with tag to COLLECTD_IMAGE_NAME
+Push the image to docker registry using the command
+docker push dcr.default.svc.local:32000/${COLLECTD_IMAGE_NAME}
+Edit the values.yaml and change the image name as the value of COLLECTD_IMAGE_NAME
+place the collectd.conf in $DA_WORKING_DIR/collection/charts/collectd/resources/config directory
+
+cd $DA_WORKING_DIR/collection
+helm install -n cp . -f values.yaml --namespace=edge1
+```
+
+#### Verify Collection package
+```
+TODO
+1. Check if all pods are up uin edge1 namespace
+2. Check the prometheus UI using the port 30090
+```
+#### Onboard an Inference Application
+```
+TODO
+``` \ No newline at end of file