Creating Your First Event Broker Service
To start integrating your applications with PubSub+ Cloud, you must first create an event broker service. Once your event broker service is created, you can connect your applications with it by using a client library compatible with the Solace PubSub+ event broker. This tutorial will walk you through creating an account on PubSub+ Cloud, creating your first messaging service, and obtaining the connection information necessary to get your applications connected to PubSub+ Cloud.
If you are new to messaging, see What is Messaging? for a brief overview of how messaging works in PubSub+ event brokers.
If you already have a PubSub+ Cloud user account, you can skip to Step 2: Create an Event Broker Service.
The following video shows you how fast and easy it is to get a PubSub+ Cloud account and create an event broker service.
This tutorial will show you:
- How to sign up for PubSub+ Cloud.
- How to create an event broker service.
- How to find your event broker service's connection information.
To sign up for a Free Trial PubSub+ Cloud account , visit the New Account page. Creating an account takes just two minutes and requires only a web browser. The Free Trial account is sufficient for this tutorial, but you can use a Starter, Professional, or Enterprise account as well.
After you have submitted your details, you will receive a confirmation email like the following illustration. Click the Activate button or click the link in the email to finalize your account.
To access the the PubSub+ Cloud, go to the Solace PubSub+ Cloud login page, enter in your email and password that you used when you signed up, and then click Sign in.
After you have logged into the console, you start at the PubSub+ Console as shown here:
On the left-most pane, click Cluster Manager and then the Services page appears. This page shows you the event broker services that are available. Since this is your first service, there aren't any available. To create your first event broker service, do the following:
- Click the Create Servicebutton located in right corner of the page or click the icon with the plus sign on it as shown here:
- In the Select Service Type step, select the type of service to use.
For your first event broker service, select any available service type. PubSub+ Cloud offers service types providing various levels of messaging performance. Some of these service types may be inaccessible prior to configuring a billing method for your account. Later, you can request access to additional service types. For more information, see PubSub+ Event Broker: Cloud Pricing. For now, select Developer.
- In the Select Cloud step, select a cloud provider from the drop-down menu. For example, select Amazon Web Services.
- In the Select Region step, you choose where the you want the service to run. To do this, click the map and choose a region for the provider you selected and then click OK. For your first messaging service, choose the region closest to where your application will run. For example, we will choose Canada Central (Montreal).
- In the Service Details step, enter a name for the event broker service. A event broker service is identified in the console by its name.
- Optional: If you are creating a event broker service on a dedicated infrastructure (see Frequently Asked Questions for a list), you have the option of setting the message VPN name, as shown below. This VPN name is the identifier used to connect to your service, and may include any of the following characters: alphanumeric, dashes, and underscores. To edit the system-generated VPN name, click Show Advanced Connection Options, click the pencil icon on the right of the Message VPN Name box, and then enter a valid VPN name.
Create the event broker service with the Message VPN setting
Click Start Service.
Create the event broker service
To see these steps in action, watch the Overview Video.
After you've clicked the Start Service button, your event broker service takes a few minutes to start.
Once your service has started, you can see the following information on the tabs across the top of the screen:
- Status: View the overall status and health of your event broker service.
- Connect: See the connection information for your event broker service by selecting your language or protocol of choice.
- Manage: Perform tasks such as configuring queues or managing clients.
- Configuration: View the details of the event broker service that you created, such as the cloud provider, region, and connection limits.
- Try Me!: Try your event broker service using embedded CodePen examples.
To find yourevent broker service's connection information:
- Click the Connect tab and choose the messaging protocol your application will be using. If you're not sure, you can also change the View by drop-down to Language so you can see the connection details for the language your client application is written in. For example, we have selected Solace Messaging.
- Based on the connection information you have chosen, select the client library you would like to use. The connection information for that library is shown.
For example, we have selected the Solace Java API.
The following information is summarized on this page:
- Get API — Information about how to get and use the client library.
- Connect to Service — Code snippets about how to connect to the service.
- Learn More — Explore links to tutorials and API documentation.
Step 4: Learn More
Well done. You have now signed up and created your first event broker service. Want to learn more?
Try exchanging some messages with your new event broker service in the next tutorial: Trying Out Your Event Broker Service.