Modifying an Event Mesh

To modify an event mesh, you require the Mission Control Manager role. For more information about the role requirements, see Considerations for Working with Event Meshes in PubSub+ Cloud.

You can perform any of the following tasks to modify an existing event mesh:

As part of the changes you make, the event mesh is validated to ensure that it's healthy.

Before you modify an event mesh, we recommend that you review the considerations when you work with event meshes. For this information, see Considerations for Working with Event Meshes in PubSub+ Cloud.

Adding an Event Broker Service to an Existing Event Mesh

You can add an existing event broker service to an event mesh. After you specify the event broker service to add, the event mesh is recreated. As a result, events stop traveling across the event mesh while the mesh is reestablished. The event broker services themselves keep running with no service impact.

To add an event broker services to an existing mesh, follow these steps:

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. Select Mesh Manager from the navigation bar.

  3. On the Mesh Manager: Event Meshes page, on the tile of an event mesh, click Mesh Actions, and then select Edit.

  4. On the Edit Mesh page, click Add Service.

  5. On the Add Service: Full Mesh dialog, select the service to add to the event mesh and click Add Service.

    • Select the service using one of the following methods:

      • Enter the first few letters of the name of your service that you want to add to the mesh in the Select services to add to a full mesh topology field to filter the list, when you see your service appear, select your service.

      • Click in the Select services to add to a full mesh topology and then scroll and select the name of your service in the drop-down menu. Note that the list can be long and for that reason, Solace recommends using the previous method to find the name of your event broker service.

    • (Optional) Click the Remote Service Endpoint and select the an endpoint. Connectivity between your private endpoints is your responsibility (or your organization's) if the services are deployed in a Customer-Controlled Regions.

    • (Optional) Click the Switch Initiator to set which event broker service initiates the creation of the link before you click Add Service. In most cases, you can accept the suggested initiating links. These are the situations where you may be required to change the initiating link:

      • If the one of the event broker services has a private endpoint and the other service has a public endpoint, you must change the initiating service to be the one with the private endpoint.

      • If the one of the event broker services is a private endpoint and the other service is a public endpoint, you must change the initiating service to be the one with the private endpoint.

      • On the remote endpoint of the event broker service, if you have more than one endpoint available, otherwise the one that is configured appears.

  6. Repeat the steps 4-5 until you have added all event broker services you want to add to the event mesh. When you return to the Edit Mesh page, the event broker services you added appear in the Services in Mesh list.

    You can review the changes to the event mesh in the Links and Map panes For example, here we've added an additional event broker service and the blue links on the Map pane show the new links created in the event mesh. The Links pane summarizes that two new links will be created:

  8. (Optional) Click Mesh Actions beside the name of the event broker service (including the ones you just added), and select:

  9. After you add all the event broker services you want to the event mesh, click Save Changes.

    You return to the Mesh Manager: Event Meshes page and the tile for the event mesh shows an Updating Event Mesh message. When the changes complete, the tile refreshes, showing information about the updated event mesh. For more information, see Checking the Progress of Event Mesh Updates.

Switch the Initiator for a Link on the Event Mesh

You can specify which event broker service (called the initiator) starts the process to create the external DMR link to the other event broker service. While messages are exchanged in both directions over the link, the underlying TCP connection is only established by the side that is the initiator for the link.

If you have event broker services in private regions, or Customer-Controlled Regions, they must be the initiator when: 

  • the event broker service connects to the public internet (Public Regions)

  • the event broker service to connect has Secured Broker Management (SEMP) port enabled on the public endpoint

Connectivity between private networks (Customer-Controlled Regions) is the responsibility of the customer.

To switch the link initiator, perform the following steps.

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. On the navigation bar, select Mesh Manager.

  3. On the tile for an event mesh, click Mesh Actions and select Edit.

  4. On the Edit Mesh page, beside the name of an event broker service, click Mesh Actions and select Edit.

  5. On the Edit Mesh dialog, click Switch Initiatorto switch the initiator for any event broker service.

  6. Click Save Links.

  7. Review the summary of changes in the Links pane and then click Save Changes.

    A Traffic Disruption Across the Event Mesh May Occur dialog opens.

  8. Click Confirm Changes.

    You return to the Mesh Manager: Event Meshes page and the tile for the event mesh shows an Updating Event Mesh message. When the changes complete, the tile refreshes, showing information about the updated event mesh. For more information, see Checking the Progress of Event Mesh Updates.

Removing an Event Broker Service from an Event Mesh

You must remove event broker service from an event mesh if is part of one before you can delete the event broker service.

You can remove an event broker service from an existing event mesh as long as it isn't the second last one in the event mesh. If you want to delete an event mesh, you must do so explicitly. For more information, see Deleting an Event Mesh.

After you specify the event broker service to remove, the event mesh is re-created if the configuration is valid. A valid mesh must have at least two event broker services. Any event broker services that you removed from the event mesh are not deleted and remain active.

When the event mesh is recreated, events stop traveling across the event mesh while the mesh is reestablished. The event broker services themselves keep running with no service impact.

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. Select Mesh Manager from the navigation bar.
  3. On the tile for an event mesh, click Mesh Actions and select Edit.
  4. On the Edit Mesh page, beside the name of each event broker service that you want to remove, click Mesh Actions, and select Remove Service.

  5. Review the summary of changes in the Links pane and then click Save Changes.

    A Traffic Disruption Across the Event Mesh May Occur dialog opens.

  6. Click Confirm Changes.

You return to the Mesh Manager: Event Meshes page and the tile for the event mesh shows an Updating Event Mesh message. When the changes complete, the tile refreshes, showing information about the updated event mesh. For more information, see Checking the Progress of Event Mesh Updates.

Changing the Event Mesh Name

You can change the name of your event mesh. The name can be up to 32 characters in length, and can include any alphanumeric characters, dashes, and underscores.

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. Select Mesh Manager from the navigation bar.
  3. On the tile for an event mesh, click Mesh Actions and select Edit.
  4. Click in the Mesh Name field and change the text in the field.
  5. Click Save Changes.

You can see the changed name of your event mesh. For more information, see Checking the Progress of Event Mesh Updates You may need to rescan for changes or refresh your browser after a few minutes to see the name change appear. For more information about rescanning your event mesh, see Refreshing the View for an Event Mesh.