1. RAN-Controller

Steps to build the RAN Controller setup:

1.  Clone and Checkout Ransim Controller

            git clone https://github.com/onap-oof-pci-poc/ran-sim/ransim/

     checkout latest master branch.

2.  Copy ‘settings.xml’ from ‘<YOURFOLDER>/ransim/ransimctrlr/packages/base/src/files/m2’ to ~/.m2/ folder after updating environment specific configurations. 

     If the file already exists in ~/.m2/ folder,  then copy content of this file to the existing file.

     Note: settings.xml entries are mandatory to include dependencies.

3. Open the console and navigate to the '<YOURFOLDER>/ransim/ransimctrlr'

4.  Run the following command in the terminal

                        mvn clean install

5.  The following capabilities can be modified in the 'ransim.properties' file based on user capabilities and configurations.

        File directory:

           <YOURFOLDER>/ransim/ransimctrlr/packages/base/src/files/install/servers/ransim/bin/ransim.properties

            a) serverIdPrefix :

                        Netconf server comman prefix (use default value)

            b) numberOfCellsPerNCServer :

                        Maximum number of cells that can be handled in a single netconf server(use          default value).

            c) numberOfProcessPerMc :

                        Maximum number of netconf servers that can run in a single machine(use default value)(A single netconf server uses approximately 350MB).

            d) numberOfMachines :

                        Maximum number of machines available(use default value).

            e) GridSize :

                        The number of cells that can be accomodated along one side of the cluster for an autogenerated layout.

                         Eg: A gridsize of 10 will have a 10x10 cluster dimension. Use default value as 1 for random simulation.

            f) strictValidateRansimAgentsAvailability :

                        A boolean value to check if any Ransim agents are running(use default value).

            g) sdnrServerIp :

                        SDNR server IP address (change the value).

            h) sdnrServerPort :

                        SDNR server port number (change the value).

            i) sdnrServerUserid :

                        SDNR server user ID (change the value).

            j) sdnrServerPassword :

                        SDNR server password (change the value).

            k) maxPciValueAllowed :

                        maximum value of the physical cell Id. (Default is 503).

6. To form the cluster from dump file( random simulation ) update the cell details in 'SIM_Ran_config.json'.

     File directory:

            <YOURFOLDER>/ransim/ransimctrlr/packages/base/src/files/install/servers/ransim/bin/SIM_Ran_config.json

7. After successful build navigate to '<YOURFOLDER>/ransim/docker' directory.

8. Run the following three commands in the terminal -

                        'mvn prepare-package'

                        'docker build -t onap/ransim ransim-docker'

                        'docker-compose up'

            Once the docker and mariadb is built simillar commands as shown in the image will be displayed.

9. Access the GUI using the following url in the web browser -

                         ‘http://<yourIP>:8081/ransimui/index.html’

10. Access the swagger ui using the following url -

                        ‘http://<yourIP>:8081/ransim/api/swagger-ui.html’

11. Try the following url in Websocket client extension in the web browser to verify the connectivity

                        ‘ws://<yourIP>:8081/ransim/RansimAgent/hai’

Steps to check the ransim controller logs

1. Open the console and enter the following command -

            'docker ps'

2. Once the container details is displayed enter the following command -

            docker exec -it <CONTAINER ID> bash

3. Navigate to '/opt/app/policy/servers/ransim/logs' using the cd command

4. Execute the following command to check the logs -

            'tail -f ransim-rest.log'

Steps to access the tables in mysql and check table contents

1. Enter the following command in console to access mysql -

            'mysql --user=root --password=secret --host=127.0.0.1 --port=43306 ransim_db'

2. Type 'show tables;' to check the and access the tables.

2. RAN-Simulator

3. PCI-Micro service

Cloning the chart repository  

The kubernetes chart can be cloned from <>

    git clone <>

Setting Configuration parameters

The environment variables for the microservice must be set in values.yaml file. The following parameters must be set in the values.yaml before deploying the microservice.

Note : The dns will be <service name>: <namespace>

Build the helm chart

Navigate to the cloned repository and run the following command

    make all

Deploying the microservice

DMaaP, Policy, OOF and SDNR must be running before starting the PCI-Microservice. To deploy the microservice, Run the following command

 helm install pci-handler/ -n pci-handler --namespace onap