Configure multitenant AMQP

Owned by MS (Unlicensed)
Jan 17, 2023
2 min read

The aim of this guide is to explain how to configure multi-tenant AMQP for multiple datacenters.

For a distributed platform, Abiquo you will create a virtual host for the API and watchtower, and then separate virtual hosts for each datacenter.

 

Properties

Property name

Description

Context

abiquo.rabbitmq.multitenant

True if multitenant is enabled. By default it is disabled (false)

API

abiquo.rabbitmq.virtualHost

Logical separation where the configured Abiquo service manages AMQP entities. The default virtual host is '/'

API + RS

abiquo.rabbitmq.username

Username to connect to broker + virtualHost

API + RS

abiquo.rabbitmq.password

Password to connect to broker + virtualHost

API + RS

abiquo.datacenter.id

Unique datacenter ID. For a complete description see Abiquo configuration properties#datacenter

RS

API configuration

To configure the API:

  1. Set "abiquo.rabbitmq.multitenant" to true

  2. Create an API virtual host, the default virtual host is "/" and this is fine to use if this is not a monolithic setup (see below for monolithic configuration)

Create an Abiquo API user with full access to the configured virtual host

rabbitmqctl add_user admin admin rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"

Watchtower configuration

The virtual host to use must be the same one configured and used by the API and the user can also be the same.

Watchtower uses the properties defined in the abiquo.properties file, so be sure to configure the properties:

  • abiquo.rabbitmq.virtualHost

  • abiquo.rabbitmq.username

  • abiquo.rabbitmq.password

See Abiquo configuration properties#rabbitmq

How to add a new data center

Each datacenter in Abiquo has a unique ID configured with the "abiquo.datacenter.id" property and the value of this property will be used as name of a new virtual host.

  1. Create a new virtual host named with the value of the "abiquo.datacenter.id" property value

    rabbitmqctl add_vhost dc2

  2. Add a new user for the new datacenter

    rabbitmqctl add_user dc2_user dc2_password

  3. Configure access to the new virtual host for the Abiquo API user

  4. Configure access to the new virtual host for the datacenter user

     

Permissions on virtual hosts can be listed (note that only the API user has access to its own API virtual host):


Check that properties on remote services match the configured values:

  • abiquo.datacenter.id = dc2

  • abiquo.rabbitmq.virtualHost = dc2

  • abiquo.rabbitmq.username = dc2_user

  • abiquo.rabbitmq.password= dc2_password

How to run a monolithic Abiquo with multi-tenant enabled

To configure the monolithic installation:

  • Configure the API virtual host as the same as the monolithic datacenter (value of property "abiquo.datacenter.id")

  • Configure access to the datacenter virtual host for Abiquo API user

  • Note that you do not need a separate user for the datacenter

You can add any other datacenters (non-monolithic) as described in the previous section

Copyright © 2006-2024, Abiquo Holdings SL. All rights reserved