RANPM Installation Guide
Introduction
This document describes the installation of RANPM, configuration of pm-log jobs and finally pushing PM report using RANPM
Setting Up Kubernetes Environment
Deploy kubernetes cluster v1.24
sudo kind create cluster --config - << EOF
kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
extraPortMappings:
- containerPort: 31784
hostPort: 31784
protocol: TCP
- containerPort: 31823
hostPort: 31823
protocol: TCP
- containerPort: 31767
hostPort: 31767
protocol: TCP
image: kindest/node:v1.24.17@sha256:bad10f9b98d54586cba05a7eaa1b61c6b90bfc4ee174fdc43a7b75ca75c95e51
EOF
# Enable k8s cluster to be ascessed by normal user
sudo cp -r /root/.kube $HOME/
sudo chown -R $USER $HOME/.kube
Deploy Istio v1.23.2
curl -L https://istio.io/downloadIstio | ISTIO_VERSION=1.23.2 sh -
cd istio-1.23.2/
export PATH=$PWD/bin:$PATH
istioctl install
Build & Load Local Images
# Clone RANPM
git clone "https://gerrit.o-ran-sc.org/r/nonrtric/plt/ranpm"
cd ranpm/
# Build & Load 'pm-https-server' Image
cd https-server/
./build.sh no-push
kind load docker-image pm-https-server:latest
# Build & Load 'pm-rapp' Image
cd pm-rapp/
./build.sh no-push
kind load docker-image pm-rapp:latest
Note: For More Build Options, refer to Readme of both components
Deploying RANPM
Make sure the following dependencies are installed:
# Helm, jq, openssl
curl https://baltocdn.com/helm/signing.asc | gpg --dearmor | sudo tee /usr/share/keyrings/helm.gpg > /dev/null
sudo apt-get install apt-transport-https --yes
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/helm.gpg] https://baltocdn.com/helm/stable/debian/ all main" | sudo tee /etc/apt/sources.list.d/helm-stable-debian.list
sudo apt-get update
sudo apt-get install helm jq openssl
# For Keytool (Install java)
sudo apt install openjdk-21-jre-headless
# Confirm the installations
type openssl helm jq envsubst keytool
Deploying RANPM
cd ./ranpm/install
nano helm/global-values.yaml # Edit to change any default parameter
sudo bash ./install-ranpm.sh
Verify Deployment
~$ kubectl get pods -n nonrtric
NAME READY STATUS RESTARTS AGE
bundle-server-7f5c4965c7-bqzt6 1/1 Running 0 18m
controlpanel-7f94bd9d6-c8qjx 1/1 Running 0 16m
dfc-0 2/2 Running 0 15m
influxdb2-0 1/1 Running 0 18m
informationservice-68b5f655f-cwjnd 1/1 Running 0 15m
kafka-1-entity-operator-77c545f9cc-nmwjz 2/2 Running 0 17m
kafka-1-kafka-0 1/1 Running 0 17m
kafka-1-zookeeper-0 1/1 Running 0 18m
kafka-client 1/1 Running 0 20m
kafka-producer-pm-json2influx-0 1/1 Running 0 15m
kafka-producer-pm-json2kafka-0 1/1 Running 0 15m
kafka-producer-pm-xml2json-0 1/1 Running 0 15m
keycloak-597d95bbc5-6w5kl 1/1 Running 0 20m
keycloak-proxy-57f6c97984-kxxwz 1/1 Running 3 (19m ago) 20m
message-router-7d977b5554-pddtf 1/1 Running 3 (17m ago) 18m
minio-0 1/1 Running 0 18m
minio-client 1/1 Running 0 18m
nonrtricgateway-864bf4bb55-llq77 1/1 Running 0 17m
opa-ics-54fdf87d89-2lv7c 1/1 Running 0 15m
opa-kafka-6665d545c5-68x5p 1/1 Running 0 18m
opa-minio-5d6f5d89dc-b9cxn 1/1 Running 0 18m
pm-producer-json2kafka-0 2/2 Running 0 15m
pm-rapp 1/1 Running 0 14m
pmlog-0 2/2 Running 0 10h
redpanda-console-b85489cc9-rkfj9 1/1 Running 2 (17m ago) 18m
strimzi-cluster-operator-68c8d8b774-jqnj5 1/1 Running 0 19m
ves-collector-bd756b64c-pzjfs 1/1 Running 0 18m
zoo-entrance-85878c564d-7qn2h 1/1 Running 0 18m
~$ kubectl get pods -n ran
NAME READY STATUS RESTARTS AGE
pm-https-server-0 1/1 Running 0 18m
pm-https-server-1 1/1 Running 0 18m
pm-https-server-2 1/1 Running 0 18m
pm-https-server-3 1/1 Running 0 18m
pm-https-server-4 1/1 Running 0 18m
pm-https-server-5 1/1 Running 0 18m
pm-https-server-6 1/1 Running 0 18m
pm-https-server-7 1/1 Running 0 18m
pm-https-server-8 1/1 Running 0 18m
pm-https-server-9 1/1 Running 0 18m
Troubleshooting RANPM Deployment
Deployment stuck waiting for Kafka-client
Update ‘quorumListenOnAllIPs: true’ at Zookeeper config & then Reinstall
--- a/install/helm/nrt-base-1/charts/strimzi-kafka/templates/app-kafka.yaml
+++ b/install/helm/nrt-base-1/charts/strimzi-kafka/templates/app-kafka.yaml
@@ -63,6 +63,9 @@ spec:
replicas: 1
storage:
type: ephemeral
+ config:
+ # new - config
+ quorumListenOnAllIPs: true
entityOperator:
topicOperator: {}
userOperator: {}
Pushing PM Reports
Configure JobDefination of influxlogger
Configure the default filter in jobDefinition.json as
--- a/install/helm/nrt-pm-log/config/jobDefinition.json
+++ b/install/helm/nrt-pm-log/config/jobDefinition.json
@@ -9,7 +9,15 @@
{
"measuredObjClass": "NRCellDU",
"measTypes": [
- "pmCounterNumber101"
+ "throughput",
+ "x",
+ "y",
+ "availPrbDl",
+ "availPrbUl",
+ "measPeriodPrb",
+ "pdcpBytesUl",
+ "pdcpBytesDl",
+ "measPeriodPdcpBytes"
]
}
],
Reinstall pm-log
cd ./ranpm/install
# Re-install PM-Log
sudo bash ./uninstall-pm-log.sh
sudo bash ./install-pm-log.sh
Clone and run script to Push data
# Clone the aimlfw-dep
git clone "https://gerrit.o-ran-sc.org/r/aiml-fw/aimlfw-dep"
cd aimlfw-dep/demos/hrelease/scripts
Execute below script to push qoe data into ranpm setup
./push_qoe_data.sh <source name mentioned when creating feature group> <Number of rows> <Cell Identity>
The Following script downloads cells.csv , filters the data based on Cell Identity,
For each PM report, the script convert the PM-report to XML documents, uploads it to one of ‘pm-https-server’, and sends a File-Ready event on Kafka-topic signifying that the PM report is ready to be processed by RANPM
Example for executing above script
./push_qoe_data.sh gnb300505 30 c4/B2
Confirm if data is uploaded correctly
kubectl exec -it influxdb2-0 -n nonrtric -- influx query 'from(bucket: "pm-logg-bucket") |> range(start: -1000000000000000000d)' |grep pdcpBytesDl
Steps to clear data in InfluxDB
kubectl exec -it influxdb2-0 -n nonrtric -- influx delete --bucket pm-logg-bucket --start 1801-01-27T05:00:22.305309038Z --stop 2023-11-14T00:00:00Z
Uninstalling RANPM
cd ./ranpm/install
sudo bash ./uninstall-ranpm.sh