PubSub+ Broker Manager

Broker Manager is a browser-based administration console packaged with PubSub+ software event brokers and appliances. It's a next generation user interface (UI) for configuring, viewing, and troubleshooting your event broker.

Accessing Broker Manager

To access and begin using Broker Manager follow the instructions for either Appliance and Software Event Broker or PubSub+ Cloud, below.

Appliance and Software Event Broker

  1. Open a browser and enter one of the following URLs (the ports listed are the defaults; your settings may differ):

    • To connect using HTTP, enter: http://<host>:8080 (port 80 for an appliance).

    • To connect using HTTPS, enter: https://<host>:1943 (port 443 for an appliance).

    Where <host> is the IP address or hostname of your event broker.

  2. Log in as a CLI user with an admin global access level.

If both HTTP and HTTPS ports are configured and operationally Up, the event broker redirects all HTTP requests to the secure HTTPS port. To learn how you can enable or disable this feature, refer to Configuring HTTP-to-HTTPS Redirect for Broker Manager.

Broker Manager does not support the use of multi-byte UTF-8 sequences as part of the username or password during login. If you attempt to use a multi-byte UTF-8 sequence as part of a username or password, the login will fail as if the username or password were incorrect.

PubSub+ Cloud

  1. On the PubSub+ Cloud Console, select Cluster Manager on the left navigation bar.

  2. Click an event broker service of your choice.

  3. Click Open PubSub+ Broker Manager located on the top-right corner of the event broker service. The PubSub+ Broker Manager web interface opens in another tab within your browser. It's important to note that this interface is separate from the Cloud Console.

Accessing Broker Manager Using OAuth

You can configure OAuth to enable users of Broker Manager to log in via an OAuth provider.

When OAuth is configured and enabled, an additional button displays on the login screen. You can have multiple login buttons depending on how many providers you have configured. Clicking the button will redirect the user to the OAuth provider's login page. If the user is already logged with the provider, they will be immediately redirected back to Broker Manager. If the users have multiple accounts with the OAuth provider and wish to switch accounts, they can log out and then log back in.

To learn how to enable OAuth authentication for Broker Manager, see Configuring OAuth Authentication.

Sending and Receiving Test Messages

Broker Manager includes an integrated publisher and subscriber that you can use to test your event broker operation and configuration by sending and receiving test messages.

To send and receive a test message from your event broker, select a Message VPN and then click Try Me!.

On the Try Me! page, do the following:

  1. Click Connect to connect the Publisher to your event broker.

  2. Click Connect to connect the Subscriber to your event broker.

  3. In the Subscriber pane, click Subscribe to subscribe to the default try-me topic.

  4. In the Publisher pane, click Publish to publish a "Hello World" message to the try-me topic. The message you published is displayed under Messages in the Subscriber pane.