Modifying an Event Mesh

You can modify an existing event mesh. To do so, you require the Mesh Manager Editor role assigned to your user account. 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 re-created. This means that events/data no longer travel across the event mesh temporarily while the mesh is re-established, however the existing event broker service remain 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.

  2. Select Mesh Manager from the navigation bar.
  3. On the Event Meshes page, on the card of the event mesh to which you want to add an event broker service, 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 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, and click Add 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, and click Add Service. Note that the list can be long and for that reason, we recommend using the previous method to find the name of your event broker service.

    Optionally, you can click the Switch Initiatorlink 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, but if the one of the event broker services is in a Virtual Private Cloud or Virtual Network (VPC/VNet) and the other service is not, you must change the initiating service must be the one in the VPC/VNet. For more information about what choosing the initiating service, see Switch the Initiator for a Link on the Event Mesh.

  6. Repeat the steps 3-4 as often as required to add your additional event broker services.

  7. When you return to the Edit Mesh page, the event broker services you added appear in the Services in Mesh list. You can optionally click Mesh Actions beside the name of the event broker service( including the ones you just added), and select:

  8. Review the in the Links pane that summarizes the changes, modify as required, and then click Save Changes. For example, here we've added an additional event broker service to the event mesh:

A pop-up notification appears that starts to modify the event mesh. When the changes are complete, another notification appears. If you have navigated to another page, you can check the progress of the modification. For more information, see Checking the Progress of an Event Mesh.

Switch the Initiator for a Link on the Event Mesh

You can specify which service initiates the creation of 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 side that is the initiator for the link. In some cases, the node that initiates the link creation is important. For example, when one of the event broker services in the event mesh is deployed in a private network [Virtual Private Cloud/Virtual Network (VPC/VNet) and the other is not, the initiating service must always be the event broker service deployed in a VPC/VNet.

To switch the link initiator, perform the following steps.

  1. Log in to PubSub+ Cloud Console if you haven't done so yet.

  2. Select Mesh Manager from the navigation bar.

  3. In Mesh Manager, click Mesh Actions and select Edit.

  4. On the Edit Mesh page, beside the name service, click Mesh Actions and select Edit.

  5. On the Edit Links dialog, you can click Switch Initiatorto switch the initiator for any of the services.

  6. Click Apply when you are completed and then click Cancel to close the dialog.

  7. Review the in the Links pane that summarizes the changes, modify as required, and then click Save Changes.

Removing an Even from an Event Mesh

You can remove an event broker service from an existing mesh. After you specify the event broker service to remove, the event mesh is re-created provided it's not the second last one that you removed from the event mesh. If you remove the second last event broker service from event mesh, the event mesh is deleted. For more information, see Deleting a Mesh using Mesh Manager. In addition, the event broker service you removed from the event mesh is not deleted and remains active.

When the mesh is recreated, events/data no longer travel across the mesh temporarily while the event mesh is re-established, however the existing event broker service remain running with no service impact.

  1. Log in to the PubSub+ Cloud Console if you have not done so yet.

  2. Select Mesh Manager from the navigation bar.
  3. In Mesh Manager, click Mesh Actions and select Edit.
  4. On the Edit page page, beside the name of each event broker service that you want to remove, click Mesh Actions, and select Remove Service.
  5. Review the in the Links pane that summarizes the changes, modify as required, and then click Save Changes.

The event broker services you selected are deleted.

When process to update your event mesh starts, a notification appears. Another notification appears after the event broker service is deleted. You can also see the progress of updating your event mesh at any time. For more information, see Checking the Progress of an Event Mesh.

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 may include any alphanumeric, dashes, and underscores.

  1. Log in to the PubSub+ Cloud Console if you have not done so yet.

  2. Select Mesh Manager from the navigation bar.
  3. In Mesh Manager, click Mesh Actions and select Edit.
  4. Click in the Mesh Name field and change the text in the field.
  5. Click Save Changes.

The name of your event mesh is changed. You can also see the name change to your event mesh. For more information, see Checking the Progress of an Event Mesh 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.