...

            docker exec -it <CONTAINER ID> ransim bash

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

...

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

Notify Cell Modification tested with Netconf-console

Pre-Requisites:

1. ncclient must be present. If not, run pip install ncclient
2. pip install netconf-console

Command to establish session with device:

     netconf-console --host netconf-agent-ip --port netconf-agent-port --raw

     eg., netconf-console --host 10.143.125.163 --port 50000 --raw
 
Session will be established with an interactive shell. Run the following command to create subscription:

      create-subscription -x honeycomb

For testing,

1. Select "Modify" menu by right clicking any cell in Ransim-GUI.
2. Change the pcid value and click modify. Modified Successfully message displayed.
3. Verify the notification received as below in netconf-console shell. Any issue check honeycomb log. 
   hc_50000/var/log/honeycomb/honeycomb.log

Image Removed

2. RAN-Sim: Netconf-server(s) (agents) - Extended Honeycomb

This has the following steps:

A. Cloning and building Honeycomb (base) repository

B. Cloning and building enodebsim repository

A. HoneyComb Repository

   Clone using following URL:

   git clone https://gerrit.fd.io/r/honeycomb

    cd honeycomb/

Checkout using the following ChangeId which is part 08_10 version(current release):

    git checkout e9d3785d0603bf6e024affafc735641ee312b675

Note: Other versions has installation issues related to dependencies download.

Then do,

  mvn clean install

B. enodebsim Repository

This repository has the code we developed.

1. Clone and checkout the latest:

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

              git checkout master

              cd hcsim-content/

2. Copy ‘m2_settings.xml’ from ‘<YOURFOLDER>/honeycombsim/’ to <HOME>/.m2/ folder as settings.xml file after updating environment specific configurations. 

     If the file already exists in <HOME>/.m2/ folder, then merge this file content into the existing file appropriately.

3. Copy the enodebsim folder to honeycomb folder mentioned in the previous step.

                cp –r  enodebsim/ <Your_Folder>/honeycomb/

4. Copy & paste below entry in honeycomb/pom.xml, under <modules>

                <module>enodebsim</module>

 5. Do the foll. next:

                cd <Your_Folder>/honeycomb/

                mvn -Dcheckstyle.skip clean install

      Note: checkstyle skipped because its not accepting the proposed LICENSE text format in the java source file header comment.

      Build should be successful for the following artifacts

                 enodebsim-api

                 enodebsim-impl

                 enodebsim-distribution

                 enodebsim-aggregator

6. Copy the below folder to a new location:

                 <Your_Folder>/honeycomb/enodebsim/enodebsim-distribution/target/enodebsim-distribution-1.18.10-hc/enodebsim-distribution-1.18.10

7. Rename it to hc_50001(any appropriate name)

                cp –R <Your_Folder>/honeycomb/enodebsim/enodebsim-distribution/target/enodebsim-distribution-1.18.10-hc/enodebsim-distribution-1.18.10  <NewLocation>/hc_50001/

Example repository after executing steps (A) and (B):

1. Single instance of HoneyComb Simulator(configured with port 50000) created for our reference and committed in the below repository path.

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

      cd Netconf-Agents/hc_50000   

       it has few configuration files intended to be modified with current environment configuration settings (details given below).

2. Copy below folders from hc_50000, to this new simulator instance(50001):

                modules/

                config/

                yang-mapping/

                var/

              cp <Your_Folder>/hc_50000/ransom.properties <Your_Folder>/hc_50001/

3. Modify below property file,

             <Your_Folder>/hc_50001/ransim.properties,

       based on the environment setup and port could be 50001 in this case(Run any number of simulators with different ports).

       1. enodebsimIp

               Simulator Ip Address, where the HoneyComb instance(hc_50001) is running. eg., 10.143.125.163

        2. enodebsimPort

                Port number in which Simulator instance to be started. eg., 50001

        3. ransimCtrlrIp

                Ran-Sim controller Ip Address, to communicate cell topology details. eg.,10.143.125.147

         4. ransimCtrlrPort

                 Port number in which ran-sim controller is started. eg.,8081

4. Similarly, edit the port number(netconf-ssh-binding-port) in the following configuration file to be in sync with ransim properties file.

     <Your_Folder>/hc_50001/config/ netconf.json

Start HoneyComb Simulator

                cd <Your_Folder>/hc_50001/

                ./honeycomb

For multiple instance,

Copy the EnodebSimSetup.py, start.sh and stop.sh from <Your_Folder>/Netconf-Agents/ folder to the folder in which hc_50000 is copied,

2. RAN-Sim: Netconf-server(s) (agents) - Extended Honeycomb

This has the following steps:

A. Cloning and building Honeycomb (base) repository

B. Cloning and building enodebsim repository

A. HoneyComb Repository

   Clone using following URL:

   git clone https://gerrit.fd.io/r/honeycomb

    cd honeycomb/

Checkout using the following ChangeId which is part 08_10 version(current release):

    git checkout e9d3785d0603bf6e024affafc735641ee312b675

Note: Other versions has installation issues related to dependencies download.

Then do,

  mvn clean install

B. enodebsim Repository

This repository has the code we developed.

1. Clone and checkout the latest:

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

              git checkout master

              cd hcsim-content/

2. Copy ‘m2_settings.xml’ from ‘<YOURFOLDER>/honeycombsim/’ to <HOME>/.m2/ folder as settings.xml file after updating environment specific configurations. 

     If the file already exists in <HOME>/.m2/ folder, then merge this file content into the existing file appropriately.

3. Copy the enodebsim folder to honeycomb folder mentioned in the previous step.

                cp –r  enodebsim/ <Your_Folder>/honeycomb/

4. Copy & paste below entry in honeycomb/pom.xml, under <modules>

                <module>enodebsim</module>

 5. Do the foll. next:

                cd <Your_Folder>/honeycomb/

                mvn -Dcheckstyle.skip clean install

      Note: checkstyle skipped because its not accepting the proposed LICENSE text format in the java source file header comment.

      Build should be successful for the following artifacts

                 enodebsim-api

                 enodebsim-impl

                 enodebsim-distribution

                 enodebsim-aggregator

6. Copy the below folder to a new location:

                 <Your_Folder>/honeycomb/enodebsim/enodebsim-distribution/target/enodebsim-distribution-1.18.10-hc/enodebsim-distribution-1.18.10

7. Rename it to hc_50001(any appropriate name)

                cp –R <Your_Folder>/honeycomb/enodebsim/enodebsim-distribution/target/enodebsim-distribution-1.18.10-hc/enodebsim-distribution-1.18.10  <NewLocation>/hc_50001/

Example repository after executing steps (A) and (B):

1. Single instance of HoneyComb Simulator(configured with port 50000) created for our reference and committed in the below repository path.

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

      cd Netconf-Agents/hc_50000   

       it has few configuration files intended to be modified with current environment configuration settings (details given below).

2. Copy below folders from hc_50000, to this new simulator instance(50001):

                modules/

                config/

                yang-mapping/

                var/

              cp <Your_Folder>/hc_50000/ransom.properties <Your_Folder>/hc_50001/

3. Modify below property file,

             <Your_Folder>/hc_50001/ransim.properties,

       based on the environment setup and port could be 50001 in this case(Run any number of simulators with different ports).

       1. enodebsimIp

               Simulator Ip Address, where the HoneyComb instance(hc_50001) is running. eg., 10.143.125.163

        2. enodebsimPort

                Port number in which Simulator instance to be started. eg., 50001

        3. ransimCtrlrIp

                Ran-Sim controller Ip Address, to communicate cell topology details. eg.,10.143.125.147

         4. ransimCtrlrPort

                 Port number in which ran-sim controller is started. eg.,8081

4. Similarly, edit the port number(netconf-ssh-binding-port) in the following configuration file to be in sync with ransim properties file.

     <Your_Folder>/hc_50001/config/ netconf.json

Start HoneyComb Simulator

                cd <Your_Folder>/hc_50001/

                ./honeycomb

For multiple instance,

Copy the EnodebSimSetup.py, start.sh and stop.sh from <Your_Folder>/Netconf-Agents/ folder to the folder in which hc_50000 is copied,

1. Run EnodebSimSetup.py with the number of instances required.
   ./EnodebSimSetup.py 24 (for 24 instances)
   
   
2. Run EnodebSimSetup.py with the number of instances required.
   ./EnodebSimSetup.py 24 (for 24 instances)
   Then run start.sh, which will start all the honeycomb servers in the folder(in this case all 24 agents will be started)
   
   
3. Use stop.sh, to stop all the netconf servers.

...

                        <phy-cell-id-in-use>40</phy-cell-id-in-use>

                    </x-0005b9-lte>

                </fap-service>

                <fap-service>

                    <alias>71</alias>

                    <x-0005b9-lte>

                        <pnf-name>ncserver1001</pnf-name>

                        <phy-cell-id-in-use>60</phy-cell-id-in-use>

                    </x-0005b9-lte>

                </fap-service>

            </radio-access>

        </config>

        <default-operation>merge</default-operation>

    </edit-config>

</rpc>

]]>]]>

<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="101">

    <commit>

                <target>

            <candidate/>

        </target>                   

    </commit>

</rpc>

]]>]]>

Successful execution of this command should update the pcid value to 60 and the same should be viewed from Ransim GUI.

/x-0005b9-lte>

                </fap-service>

                <fap-service>

                    <alias>71</alias>

                    <x-0005b9-lte>

                        <pnf-name>ncserver1001</pnf-name>

                        <phy-cell-id-in-use>60</phy-cell-id-in-use>

                    </x-0005b9-lte>

                </fap-service>

            </radio-access>

        </config>

        <default-operation>merge</default-operation>

    </edit-config>

</rpc>

]]>]]>

<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="101">

    <commit>

                <target>

            <candidate/>

        </target>                   

    </commit>

</rpc>

]]>]]>

Successful execution of this command should update the pcid value to 60 and the same should be viewed from Ransim GUI.

Edit or delete operation on different cells in the topology of the agent will notify the Ransim Controller which will update GUI & DB to be in Sync.

Notify Cell Modification tested with Netconf-console

Pre-Requisites:

1. ncclient must be present. If not, run pip install ncclient
2. pip install netconf-console

Command to establish session with device:

     netconf-console --host netconf-agent-ip --port netconf-agent-port --raw

     eg., netconf-console --host 10.143.125.163 --port 50000 --raw
 
Session will be established with an interactive shell. Run the following command to create subscription:

      create-subscription -x honeycomb

For testing,

1. Select "Modify" menu by right clicking any cell in Ransim-GUI.
2. Change the pcid value and click modify. Modified Successfully message displayed.
3. Verify the notification received as below in netconf-console shell. Any issue check honeycomb log. 
   hc_50000/var/log/honeycomb/honeycomb.log

Image AddedEdit or delete operation on different cells in the topology of the agent will notify the Ransim Controller which will update GUI & DB to be in Sync.

Additional information

To run each instance of HoneyComb it requires ~353 MB of memory. Still we are working on optimizing the simulator configuration to run only required processes for ONAP setup. 

3. PCI-Micro service

Cloning the chart repository  

...