DS RabbitMQ User Guide

Target Audience

  • If you want to use (asynchronous) Pub/Sub communication to publish messages to the Data Spine Message Bus (DS RabbitMQ), or you want to subscribe to the topics/queues to consume the messages published by others, this guide is for you.

Connection Details

Steps for Getting a New User Account and/or Vhost

TEST & DEV Environments

  • To get a new RabbitMQ user account and/or vhost for your company/organisation, send an email to the EFPF Support Team mentioning your email id (which is linked with the EFS account) and the name of your company/organisation

PROD Environment

  • To get a RabbitMQ user account and/or vhost for your company/organisation, visit the Pub/Sub Security Service Dashboard. Upon arrival, a new RabbitMQ account and company vhost will be created for the user, if one does not exist already. Otherwise the user will be assigned access to the existing company vhost.

Steps for Getting Pub/Sub Access

TEST & DEV Environments

  • If you already have a user account and vhost for your company/organisation and you need access to pub/sub to a particular topic, send an email to the EFPF Support Team mentioning your email/user id, name of the vhost, the topic to which access is required and the type of access that is required i.e. pub or sub.

PROD Environment

  • Follow the Pub Sub Security Quickstart Guide to create and manage topics and topics permissions, and request the credentials/configuration details needed to publish or subscribe to RabbitMQ.

Pub/Sub Using MQTTS

Examples:

Custom vhost (e.g. ‘custom_vhost’)

mosquitto_pub -h efpf.smecluster.com -p 8883 -u 'custom_vhost:username' -P 'password' -t 'tests/test1' -m 'test1' --cafile /c/Users/user1/Downloads/cacert-2020-07-22.pem

mosquitto_sub -h efpf.smecluster.com -p 8883 -u 'custom_vhost:username' -P 'password' -t 'tests/test1' --cafile /c/Users/user1/Downloads/cacert-2020-07-22.pem

Default vhost ‘/’

mosquitto_pub -h efpf.smecluster.com -p 8883 -u 'username' -P 'password' -t 'tests/test1' -m 'test1' --cafile /c/Users/user1/Downloads/cacert-2020-07-22.pem

mosquitto_sub -h efpf.smecluster.com -p 8883 -u 'username' -P 'password' -t 'tests/test1' --cafile /c/Users/user1/Downloads/cacert-2020-07-22.pem

You can download the CA certificates bundle extracted from Mozilla (cacert-2020-07-22.pem) here: https://curl.haxx.se/docs/caextract.html

Data Spine RabbitMQ Documentation

Previous