Page History

Request access to VM

• Login to  https://selfservice-dev.est.tech/login to create a 'booking' for OpenVPN
• Read through the instructions and tips to get familiar with the process (also make sure, that you generate an RSA keypair, seem like that's the only one they accept)
• Request Andrew Fenner and/or Robert Tomczyk for a new account on 'our' VM' (172.16.3.229^{Image Added})

After you are able to log in you can check the kube config file on the VM. Its recommended to merge that file with your computer's local kube config file. This way you will be able to work from your computer, so you only have to connect to the VPN.

You can use this command to connect from the same directory where your .ovpn is located:

sudo openvpn --config YOUR_USERNAME.xerces.onap.ovpn --auth-nocache

Uninstall CPS

To unistall CPS from a given namespace use this command:

helm uninstall $ONAP_INSTALL_RELEASE_NAME --namespace $ONAP_INSTALL_NAMESPACE

Optionally we can delete the namespace as well

kubectl delete $NAMESPACE

Install (minimal) CPS

First of all we should create a namespace within Kubernetes:

kubectl create namespace $NAMESPACE

Add Xerces Helm repository:

helm repo add xerces http://172.16.3.229/local

(note: the IP address might change. This value worked for us, but if it's not reachable contact Andrew Fenner)

Install the chart with the following command:

helm install $ONAP_INSTALL_RELEASE_NAME xerces/onap -i -f values.yaml -f $ONAP_INSTALL_VALUES_YAML --namespace $ONAP_INSTALL_NAMESPACE --set global.masterPassword=$ONAP_INSTALL_MASTER_PASSWORD --debug

The value of $ONAP_INSTALL_VALUES_YAML must be a relative path from the oom/kubernetes/onap/Chart.yaml to the configuration YAML file that we place under the overrides folder (eg ./resources/overrides/cps-minimal.yaml ).

When the installation is complete we must provide an Ingress srevice to expose CPS to the wider world.

kubectl expose service cps-core --port 9001 --target-port=8080 --name=cps-http-api -n cps --type=NodePort

Update CPS

Upgrade the installment:

helm upgrade $ONAP_INSTALL_RELEASE_NAME xerces/onap -i -f values.yaml -f $ONAP_INSTALL_VALUES_YAML --namespace $ONAP_INSTALL_NAMESPACE --set global.masterPassword=$ONAP_INSTALL_MASTER_PASSWORD --debug

Override YAML

This basic .yaml information should be enough to deploy a CPS instance. Check the comments for explanations.

# we can set pull policy for every image under the global key
global:
  pullPolicy: IfNotPresent

cps:
  # enable certain services under their respective keys (here we enable CPS etc.)
  enabled: true
  cps-temporal:
    enabled: false
  cps-core:
    config:
      # under the additional section we can affect certain configurations of the Spring Boot application (new prefix for the REST endpoints)
      additional:
        rest:
          api:
            cps-base-path: /kiscica
    postgres:
      config:
        pgUserExternalSecret: '{{ .Release.Name }}-postgres-{{ include "common.postgres.secret.userCredentialsUID" . }}'
    postgres-init:
      config:
        # add external secrets to the deployments
        pgUserExternalSecret: '{{ .Release.Name }}-postgres-{{ include "common.postgres.secret.userCredentialsUID" . }}'

sdnc:
  enabled: false
strimzi:
  enabled: true
  # set the running number of replicas
  replicaCount: 1

Compile onap chart

When you modify the deployment yaml you need to recompile the onap chart (it is not necessary for installation or when you just modify the values.yaml)

compile onap

navigate to the <git>/oom/kubernetes folder

helm package ./onap --dependency-update

upload onap

helm cm-push onap-<version>.tgz xerces -f

missing dependencies

When you run this compilation first you must compile every dependency as well.

First you need to start a local chartmuseum

docker run -p 8879:8080 bitnami/chartmuseum:latest 

add local repository to helm

helm repo add local http://localhost:8879/

after that you can compile the whole onap project. It has a make file so it is quiet easy, but take a long time ca. an hour 

make build

then you can continue with the second step

Pnf-simulator

Open pnf-simulator's directory in your terminal. Compile and upload must be run once for each cluster.

compile pnf-simulator

helm package ./pnfsim --dependency-update

upload pnf-simulator

helm cm-push pnfsim-0.1.0.tgz xerces -f

install pnf-simulator

helm install pnfsim xerces/pnfsim -f ./pnfsim/values.yaml --namespace <your-namespace> --set global.masterPassword=mySec --debug

uninstall pnf-simulator

helm uninstall pnfsim --namespace <your-namespace>

Troubleshooting

helm repository unreachable on xerces

restart charmuseum on xerces as root:

chartmuseum --storage local --storage-local-rootdir /root/helm3-storage -port 8879 &

EOF Exception

sometimes when you start an install you can see an error message

install.go:192: [debug] Original chart version: ""
Error: INSTALLATION FAILED: unexpected EOF
helm.go:84: [debug] unexpected EOF
INSTALLATION FAILED
main.newInstallCmd.func2
	helm.sh/helm/v3/cmd/helm/install.go:141
github.com/spf13/cobra.(*Command).execute
	github.com/spf13/cobra@v1.5.0/command.go:872
github.com/spf13/cobra.(*Command).ExecuteC
	github.com/spf13/cobra@v1.5.0/command.go:990
github.com/spf13/cobra.(*Command).Execute
	github.com/spf13/cobra@v1.5.0/command.go:918
main.main
	helm.sh/helm/v3/cmd/helm/helm.go:83
runtime.main
	runtime/proc.go:250
runtime.goexit
	runtime/asm_386.s:1326

It is a bug in helm, not necessary to do anything, just rerun the installation

Strimzi-kafka can not start

You can run only one strimzi-kafka per cluster. When your strimzi-kafka can not start, maybe there is another one on the cluster in a different namespace. Uninstall the other and then restart your strimzi-kafka

Misc

Cps images:

registry.nordix.org/onaptest/cps-and-ncmp:3.1.1-SNAPSHOT-20221013T094139Z
registry.nordix.org/onaptest/cps-and-ncmp:3.1.1-SNAPSHOT-20221013T121804Z

Expose services:

kubectl expose service cps-core --port 9001 --target-port=8080 --name=cps-core-loop-back -n onap --type=NodePort
kubectl expose service pnfsim --port 9001 --target-port=6513 --name=pnfsim-loop-back -n onap --type=NodePort
kubectl expose service ncmp-dmi-plugin --port 9001 --target-port=8080 --name=ncmp-dmi-plugin-loop-back -n onap --type=NodePort

Install helm-push plugin:

helm plugin install https://github.com/chartmuseum/helm-push

Compile pnp-simulator:

docker build --tag registry.nordix.org/onaptest/netconf-pnp-simulator:2.8.6-mocked .
docker run -ti -p 6513:6513 registry.nordix.org/onaptest/netconf-pnp-simulator:2.8.6-mocked
docker push registry.nordix.org/onaptest/netconf-pnp-simulator:2.8.6-mocked

Install pnfsim:

helm package ~/git/cps/pnfsim --dependency-update
helm cm-push pnfsim-0.1.0.tgz xerces -f
helm uninstall pnfsim --namespace cps
helm install pnfsim xerces/pnfsim -f ~/git/cps/pnfsim/values.yaml --namespace cps --set global.masterPassword=mySec --debug

...