Versions Compared

Key

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

...

    • Device Event
      Describes infrastructure device event.
    • Port Event
      Describes infrastructure port event.
    • Link Event
      Describes infrastructure link event.
    • Topology Event
      Describes network topology event.
    • Packet Event
      Describes inbound packet received with raw payload.

MQ Configuration

        To configure Rabbit MQ event notification from ONOS the following components needs to be configured:

...

Code Block
$ cd ~/onos/apps/rabbitmq
$ mci
    • Run ONOS
Code Block
$ ok clean

    • Install bundle
Code Block
$ export OC1=<ONOS running ipAddress>
$ onos-app $OC1 install ~/apps/rabbitmq/target/onos-app-rabbitmq-1.7.0-SNAPSHOT.oar
    • Run ONOS
Code Block
$ ok clean
    • Activate rabbitmq app
Code Block
$ app activate org.onosproject.rabbitmq  

...

    • Rabbit MQ Server (External to ONOS)

      1. The latest release of RabbitMQ server can be available at https://www.rabbitmq.com/download.html
      2. Please refer the server documentation at administrator's guide
      3. You can access the user-management with rabbitmqctl and use the command:

      Code Block
      rabbitmqctl add_vhost <vhost>
      rabbitmqctl add_user <username> <password>
      rabbitmqctl set_permissions -p <vhost> <username> ".*" ".*" ".*"
      rabbitmqctl set_user_tags <username> management

      4. Please refer the /resources/rabbitmq.properties file for sample mq properties.

    • Rabbit MQ Client (External to ONOS)

      Please follow below steps to setup MQ consumer application.
      1. Extract below attached message-consumer-app.tar.gz
      2. Refer MQConstants.java for sample MQ server consumer configuration.
      3. Build and generate the jar using command :- mvn clean install
      4. Run the consumer application using command :- java -jar MessageConsumer-jar-with-dependencies.jar
      5. The consumed messages from the MQ server will be displayed on console.
      message-consumer-app.tar.gz

MQ ONOS event json attributes, definitions and structures

For example device event message structure as below

Code Block
{
"switch_id": "of:0000000000000001",
"infra_device_name": "SWITCH",
"event_type": "DEVICE_EVENT",
"sub_event_type": "DEVICE_UPDATED",
"hwVersion": "Open vSwitch",
"mfr": "Nicira, Inc.",
"serial": "None",
"sw_version": "2.5.0",
"chassis_id": 1,
"occurrence_time": "Tue Aug 23 15:40:59 IST 2016"
}

Please refer below attached document for complete set of json message structures, attributes and their definitions,

mq_message_definition_&_structures.docx

What next?

Enhance this application to support more ONOS events and publish them on to MQ server.