Deploying onos-uenib

This guide deploys onos-uenib through its Helm chart assumes you have a Kubernetes cluster running with an atomix controller deployed in a namespace. onos-uenib Helm chart is based on Helm 3.0 version, with no need for the Tiller pod to be present. If you don’t have a cluster running and want to try on your local machine please follow first the Kubernetes setup steps outlined in deploy with Helm. The following steps assume you have the setup outlined in that page, including the micro-onos namespace configured.

Installing

To install the onos-topo published chart in the micro-onos namespace run:

$ helm -n micro-onos install onos-uenib sdran/onos-uenib

Note, that this assumes that https://sdrancharts.onosproject.org was added as sdran Helm repo.

Alternately, you can deploy your own version of the chart from the root directory of the sdran-helm-charts repo via the following:

$ helm install -n micro-onos onos-uenib onos-uenib

In either case, the output of the helm install command should look similar to the following:

NAME: onos-uenib
LAST DEPLOYED: Wed Jul 14 14:41:16 2021
NAMESPACE: micro-onos
STATUS: deployed
REVISION: 1
TEST SUITE: None

helm install assigns a unique name to the chart and displays all the k8s resources that were created by it. To list the charts that are installed and view their statuses, run helm ls:

$ helm -n micro-onos ls
NAME     	NAMESPACE 	REVISION	UPDATED                            	STATUS  	CHART           	APP VERSION
onos-uenib	micro-onos	1       	2021-07-14 14:41:16.860966 -0700 PDT	deployed	onos-uenib-1.0.3	v0.0.3

Partition Set

The onos-uenib chart also deploys a custom Atomix PartitionSet resource to store all the topology information in a replicated and fail-safe manner. In the following example there is only one partition set deployed onos-uenib-consensus-store-1-0.

$ kubectl -n micro-onos get pods
NAME                            READY   STATUS    RESTARTS   AGE
onos-uenib-5d49c8d8b6-wbkl2      2/3     Running   0          3m8s
onos-uenib-consensus-store-1-0   1/1     Running   0          3m6s

One can customize the number of partitions and replicas by modifying, in values.yaml, under store/raft the values of

partitions: 1
partitionSize: 1

Uninstalling

To uninstall the onos-uenib chart, run the following:

 helm delete -n micro-onos onos-uenib

Troubleshooting

Helm offers two flags to help you debug your chart. This can be useful if your chart does not install, the pod is not running for some reason, or you want to trouble-shoot custom configuration values,

• --dry-run check the chart without actually installing the pod.

• --debug prints out more information about your chart

helm install -n micro-onos onos-uenib --debug --dry-run onos-uenib/