Deployment

Deployment instructions

Build RANPM and O1 Simulator

1. Start docker registry2. Instruction is available here
2. cd $RANPM_DIR
3. Build pm-https-server
   1. cd https-server
   2. ./build.sh localhost:5000
4. Build pm-rapp
   1. cd ../pm-rapp
   2. ./build.sh localhost:5000
5. Build es-rapp
   1. cd ../es-rapp
   2. ./build.sh localhost:5000
6. Build O1 Simulator
   1. cd ../o1-sim
   2. ./build.sh localhost:5000

Install everything

1. Install SDRAN
   1. cd $SDRAN_DIR
   2. make riab OPT=rimedots VER=v1.4.0
2. (optional) Install ransim-api-demo
   1. cd $RANSIM_API_DEMO_DIR
   2. make install-xapp
   3. open web/index.html in a web browser
3. Install RANPM and O1 - keep order shown below!
   1. cd $RANPM_DIR/install
   2. ./install-nrt.sh
   3. ./install-rapps.sh
   4. ./install-o1-sim.sh

If install-nrt.sh fails after istio verification, install istio using this instruction

Verification

If everything worked fine, PM reports should be dumped to pm-rapp log:

kubectl logs rapps -n nonrtric -c pm-rapp
...
time="2023-08-31T22:02:41Z" level=debug msg=" Nothing to consume on topic: rapp-topic"
{
 "event": {
  "commonEventHeader": {
   "domain": "",
   "eventId": "",
   "sequence": 0,
   "eventName": "",
   "sourceName": "ran-o1-sim",
   "reportingEntityName": "",
   "priority": "",
   "startEpochMicrosec": 1693519361204427,
   "lastEpochMicrosec": 1693519361204427,
   "version": "",
   "vesEventListenerVersion": "",
   "timeZoneOffset": "+00:00"
  },
  "perf3gppFields": {
   "perf3gppFieldsVersion": "1.0",
   "measDataCollection": {
    "granularityPeriod": 900,
    "measuredEntityUserName": "",
    "measuredEntityDn": "NODE_NAME",
    "measuredEntitySoftwareVersion": "SMaRT-5G-v0.0.1",
    "measInfoList": [
     {
      "measInfoId": {
       "sMeasInfoId": "PM=1,PmGroup=NRCellDU_GNBDU"
      },
      "measTypes": {
       "sMeasTypesList": [
        "prb_usage"
       ]
      },
      "measValuesList": [
       {
        "measObjInstId": "ManagedElement=NODE_NAME,GNBDUFunction=1,NRCellDU=1",
        "suspectFlag": "false",
        "measResults": [
         {
          "p": 1,
          "sValue": "0.54"
         }
        ]
       },
       {
        "measObjInstId": "ManagedElement=NODE_NAME,GNBDUFunction=1,NRCellDU=2",
        "suspectFlag": "false",
        "measResults": [
         {
          "p": 1,
          "sValue": "0.20"
         }
        ]
       }
      ]
     }
    ]
   }
  }
 }
}
Number of received json msgs: 10

ES-rApp should report PRB usage and other operations

kubectl logs rapps -n nonrtric -c es-rapp
...
2023-09-01 17:24:18,333 - INFO - PRB usage: [1: 54.000, 2: 20.000] avg: 37.000 (energy consumption: 0.45/0.90 W; per day: 10.80 Wh; per day savings: 10.80 Wh)
2023-09-01 17:24:19,335 - INFO - PRB usage: [1: 54.000, 2: 20.000] avg: 37.000 (energy consumption: 0.45/0.90 W; per day: 10.80 Wh; per day savings: 10.80 Wh)
2023-09-01 17:24:19,335 - INFO - Making decision...
2023-09-01 17:24:19,335 - INFO - Current average PRB usage: 37.0
2023-09-01 17:24:19,335 - INFO - At least one PRB usage higher than 1.0 - trying to enable one cell.
2023-09-01 17:24:19,335 - INFO - There are no cells that could be enabled...

Optional - ransim-api-demo

TBD

Uninstallation

RANPM should be uninstalled in a following order:

./uninstall-o1-sim.sh
./uninstall-rapps.sh
./uninstall-nrt.sh