Managing clusters

The Manage clusters page displays all the Kafka clusters you have added to Event Endpoint Management. You can add new clusters, edit cluster details, and delete the clusters.

To access the Manage clusters page:

1. Log in to the Event Endpoint Management UI.
2. In the navigation pane, click Manage > Clusters.

Adding a cluster

To add a cluster, complete the following steps.

1. Click Add cluster.
2. In the Add cluster window, provide a unique name for the cluster in the Cluster name field, then click Next.

3. Enter a bootstrap server URL for the Kafka cluster.

   If your cluster has multiple bootstrap server URLs, then click Add URL to add more URLs.

   After you click Next, the Event Manager validates the entered bootstrap server URLs. If any of the bootstrap server URLs use untrusted certificates, then you are asked to confirm that you trust these certificates.

   If your Event Manager cannot make a network connection to the Kafka cluster, then a No connection warning message is displayed. If you see this warning message, then follow these steps to add the Kafka cluster without Event Manager verification:

   a. Click Add servers manually.

   b. Configure TLS for your Event Gateway to Kafka cluster connection, then click Next.

   • If your Kafka cluster is secured with custom or self-signed CA certificates, then upload the cluster’s CA certificate so that your Event Gateways trust the Kafka cluster.

   • If your Kafka cluster requires mTLS, then upload the certificate and private key that your Event Gateways must use to connect to the cluster. If you do not have these files, then contact the Kafka cluster administrator. The keys must be in PEM format.

   c. Select the Security protocol that your Kafka cluster requires, and provide the required credentials.

   d. Provide the details for your selected security type, then continue to step 6.

   Note: The No connection scenario occurs in situations where your Event Manager is in a different environment from your Kafka clusters. If your Event Gateways are able to reach the Kafka cluster, then they validate the connection to the cluster and pull the topic information. The Event Gateway validation of Kafka clusters is an asynchronous operation and can take a few minutes to complete.

4. If the Kafka cluster requires mTLS, then upload the certificate and private key that your Event Gateways must use to connect to the cluster. If you do not have these files, then contact the Kafka cluster administrator. The keys must be in PEM format.
5. If your Kafka cluster requires SASL credentials to authenticate, then you are prompted to provide the credentials. Select the Security protocol, and set the required SASL credential fields.

6. If a Cluster maintainers group exists, then in the Maintainers pane, select the users groups that you want to maintain this cluster.

   If the user group is not displayed, click Add user group to add one from your organization.

   Note: Any user groups that you add must exist within the organization that is provided by your OAuth provider.

7. Click Add cluster.

   If the credentials you supplied are valid, then the Kafka cluster is added to Event Endpoint Management.

   If only your Event Gateways have network access to the Kafka cluster, then the Gateway visibility state shows as Pending validation for a few minutes until your gateways complete validation of the Kafka cluster connection.

Editing a cluster

To edit the details of a cluster, complete the following steps.

1. Click the edit icon for the cluster that you want to edit. The Edit cluster window is displayed, where you can edit the following cluster properties:

   • Information: Click Information to edit the cluster name. The cluster name must be unique, and has a maximum length of 200 characters.
   • Server: Click Server to edit the bootstrap URLs and TLS configuration.
   • Credentials: Click Credentials to edit the security credentials that are used to access the cluster.
   • Maintainers: If a Cluster maintainers group exists, then click Maintainers to manage the user groups that can maintain the cluster.

2. Click Save when you are finished editing the cluster.

Deleting a cluster

Clusters can be deleted from Event Endpoint Management if they are no longer in use. Before you can delete a cluster, you must delete all topics that were added from the cluster.

To delete a cluster from Event Endpoint Management, complete the following steps.

1. Click the delete icon in the Manage clusters page.
2. Confirm the cluster that you want to delete by entering the cluster name.
3. Click Delete.

Cluster validation states

The Gateway visibility column in the Manage clusters page displays the status of the Event Gateway to Kafka cluster connection. The following table describes the different connection states.