Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

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

enodebsim Repository

This repository has the code we developed.

Clone and checkout the latest:

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

              git checkout master

              cd honeycombsim/

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

                cp –r  enodebsim/ <Your_Folder>/honeycomb/

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

                <module>enodebsim</module>

 And then,

                cd <Your_Folder>/honeycomb/

                mvn clean install

Build should be successful for the following artifacts

                 enodebsim-api

                 enodebsim-impl

                 enodebsim-distribution

                 enodebsim-aggregator

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

And 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/

git clone and checking out hc_50000,

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/hc_50000

      cd Netconf-Agents/hc_50000   

it has few configuration files intended to be modified with current environment configuration settings.

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/

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

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


Check the honeycomb.log in the below folder

       <Your_Folder>/hc_50001/var/log/honeycomb/

        tail -f honeycomb.log

Successful start yield below log entries,

     2018-10-16 14:02:19.975 IST [main] INFO  i.f.h.i.d.i.InitializerRegistryAdapter - Honeycomb initialized

     2018-10-16 14:02:19.975 IST [main] INFO  io.fd.honeycomb.infra.distro.Main - Configuration initialized successfully

     2018-10-16 14:02:19.975 IST [main] INFO  io.fd.honeycomb.infra.distro.Main - Honeycomb started successfully!

And search for below keyword, to make sure the successful connectivity with Ransim Controller:

      “Message received: SetConfigTopology:”

This line of log will print the configuration topology of RAN network pulled from Ransim Controller.

 

Connecting to device from console:

ssh admin@localhost -p 50001 -s netconf

password: admin

After capabilities listed, enter the following command input to connect to device.

<hello xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">

    <capabilities>

        <capability>urn:ietf:params:netconf:base:1.0</capability>

                                <capability>urn:ietf:params:netconf:capability:candidate:1.0</capability>

    </capabilities>

</hello>

]]>]]>


Netconf commands validation:

get:

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

    <get/>

</rpc>

]]>]]>

This should show the complete topology dumped or simulated from Ransim Controller.

edit-config:

<rpc

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

    <edit-config>

        <target>

            <candidate/>

        </target>

        <config>

            <radio-access

                xmlns="urn:onf:otcc:wireless:yang:radio-access">

                    <fap-service>

                            <alias>60</alias>

                            <x-0005b9-lte>

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

                        <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.

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.

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  

...