Skip to main content
Versa Networks

Configure AMQP Notifications

  1. Last updated
  2. Save as PDF

Versa-logo-release-icon.pngFor supported software information, click here.

Versa Director publishes object change and event Advanced Message Queuing Protocol (AMQP) notifications when you enable event and object notifications and when you configure and connect to an AMQP server. This article describes how to set up a RabbitMQ AMQP server, and it describes the AMQP notifications.

Set Up RabbitMQ AMQP Server

To set up a RabbitMQ AMQP server, you do the following:

  1. Install the RabbitMQ AMQP server on an Ubuntu VM.
  2. Integrate the AMQP connector with Versa Director.
  3. Configure the RabbitMQ AMQP server to receive AMQP notifications.
  4. Verify RabbitMQ AMQP server connectivity.

Install RabbitMQ AMQP Server on Ubuntu VM

  1. On the webpage https://computingforgeeks.com/how-to-install-latest-rabbitmq-server-on-ubuntu-linux/, follow the steps to install the Rabbit MQ AMQP server on an Ubuntu VM.
  2. Add a new user to the Rabbit MQ AMQP server, and provide the user with administrator permissions:
sudo rabbitmqctl add_user test test123
sudo rabbitmqctl set_user_tags test administrator
sudo rabbitmqctl set_permissions -p / test".*" ".*" ".*"
  1. Log in to the RabbitMQ AMQP server and verify the user credentials created in Step 2:
http://<RabbitMQ-server-ip-address>:15672/

Integrate AMQP Connector with Versa Director

  1. Log in to Versa Director.
  2. Select the Administration tab.
  3. In the left navigation bar, select Connectors > AMQP.
  4. In the top bar, click the add-icon.png Add icon. The Add AMQP Connector popup window displays:

    1.png
  5. Enter information in the following fields:
Field Description
Name Enter the name of the AMQP connector.
AMQP IP Address Enter the IP address of the server on which the AMQP server is installed.
AMQP Port Enter the port number on which the AMQP server is listening. The default AMQP port is 5672. If this port was changed when the RabbitMQ AMQP server was installed, enter that number.
Exchange Enter a unique exchange name, which is used by the AMQP server.
vHost Enter a name of the vHost. The default name is “/”.
Username Enter the login name to access the AMQP server.
Password Enter the password to access the AMQP server.
Enable Event Notifications Check to enable event notification.

Configure RabbitMQ AMQP Server To Receive AMQP Notifications

  1. Log in to the RabbitMQ AMQP server.
  2. In the top bar, select the Exchanges tab.
  3. In the Exchanges table, locate the systemExchangeUser exchange that you created in the previous section. If this exchange is present, skip to Step 5.
  4. If the systemExchangeUser exchange is not listed in the table:
    1. Click Add a New Exchange.
    2. Enter the name you specified for the Name field of the Add AMQP Connector popup.
    3. Click Add Exchange.

      2.png
  5. In the top bar, select the Queues tab:
    1. Select Add a New Queue.
    2. Enter a name for the queue.
    3. Click Add Queue.

      3.png
  6. In the Queues table, click the queue that you just created.
  7. In the Queues tab:
    1. Select Queue User > Bindings > Add Binding to this Queue.
    2. Enter information in the following fields:
Field Description
From Exchange Enter the same exchange name you used for the AMQP connector.
Routing Key Enter the routing key.
  1. Click Bind. The Bindings table then displays the binding information.

    5.png

Verify Rabbit MQ AMQP Server Connectivity

  1. Log in to Versa Director.
  2. In the top bar, select the Administration tab.
  3. In the left navigation bar, select Connectors > Syslog.
  4. In the top bar, click the add-icon.png Add icon. The Add Syslog Connector popup window displays:

    6.png
  5. Enter information in the following fields:
Field Description
IP Address/FQDN Enter the IP address or the fully qualified domain name of the syslog server. 
Port Enter the port number used to connect to the syslog server. The default port number is 514.
Enabled Check to enable the syslog connector.
  1. Click OK.
  2. Log in to the RabbitMQ AMQP server.
  3. In the top bar, select the Queues tab.
  4. Select Queue User > Get Messages.
    1. Enter a number in the Messages field to specify the number of messages to retrieve from Versa Director.
    2. Click Get Messages.

      7.png

 

Display AMQP Notifications

To display the AMQP notifications, use the following commands:

select * from amqp_object_event
select * from amqp_event

 

Supported Software Information

Releases 20.2 and later support all content described in this article.