Attention: This version of Event Streams has reached End of Support. For more information about supported versions, see the support matrix.

Post-installation tasks

Consider the following tasks after installing Event Streams.

Verifying your installation

To verify that your Event Streams installation deployed successfully, check the status of your release as follows.

  1. Log in to your IBM Cloud Private cluster management console from a supported web browser by using the URL https://<Cluster Master Host>:<Cluster Master API Port>. The master host and port for your cluster are set during the installation of IBM Cloud Private. For more information, see the IBM Cloud Private documentation.
  2. Enter an IBM Cloud Private administrator user name and password.
  3. From the navigation menu, click Workloads > Helm Releases.
  4. Locate your installation in the NAME column, and ensure the STATUS column for that row states Deployed.
  5. Optional: Click the name of your installation to check further details of your Event Streams installation. For example, you can check the ConfigMaps used, or check the logs for your pods.
  6. Log in to your Event Streams UI to get started.

Installing the command-line interface

The Event Streams command-line interface (CLI) is a plugin for the IBM Cloud Private CLI. You can use the Event Streams CLI to manage your Event Streams instance from the command line, such as creating, deleting, and updating topics.

To install the Event Streams CLI:

  1. Ensure you have the IBM Cloud Private CLI installed.
  2. Log in to the Event Streams as an administrator.
  3. Click the Toolbox tab.
  4. Go to the Event Streams command-line interface section and click Find out more.
  5. Download the Event Streams CLI plug-in for your system by using the appropriate link.
  6. Install the plugin using the following command:
    cloudctl plugin install <full_path>/es-plugin

To start the Event Streams CLI and check all available command options in the CLI, use the cloudctl es command. To get help on each command, use the --help option.

To use the Event Streams CLI against a deployed IBM Cloud Private cluster, run the following commands, replacing <master_ip_address> with your master node IP address, <master_port_number> with the master node port number, and <my_cluster> with your cluster name:

cloudctl login -a https://<master_ip_address>:<master_port_number> -c <my_cluster>
cloudctl es init

Firewall settings

In your firewall settings, ensure you enable communication for the node ports that Event Streams services use. To find out what ports need to be opened, follow these steps:

  1. Log in to your IBM Cloud Private cluster management console from a supported web browser by using the URL https://<Cluster Master Host>:<Cluster Master API Port>. The master host and port for your cluster are set during the installation of IBM Cloud Private. For more information, see the IBM Cloud Private documentation.
  2. From the navigation menu, click Workloads > Helm Releases.
    Menu > Workloads > Helm releases
  3. Locate the release name of your Event Streams installation in the NAME column, and click the name.
  4. Scroll down to the Service table. The table lists information about the Event Streams services.
  5. In the Service table, look for NodePort in the TYPE column.
    In each row that has NodePort as type, look in the PORT(S) column to find the port numbers you need to ensure are open to communication.
    The port numbers are paired as <internal_number:external_number> (for example, 32000:30553). For your firewall settings, ensure the external numbers are open.
    The following image provides an example of the table:
    Service table

Connecting clients

You can set up external client access during installation. After installation, clients can connect to the Kafka cluster by using the externally visible IP address for the Kubernetes cluster. The port number for the connection is allocated automatically and varies between installations. To look up this port number after the installation is complete:

  1. Log in to your IBM Cloud Private cluster management console from a supported web browser by using the URL https://<Cluster Master Host>:<Cluster Master API Port>. The master host and port for your cluster are set during the installation of IBM Cloud Private. For more information, see the IBM Cloud Private documentation.
  2. Enter an IBM Cloud Private administrator user name and password.
  3. From the navigation menu, click Workloads > Helm Releases.
  4. In the NAME column, locate and click the release name used during installation.
  5. Scroll down through the sections and locate the Service section.
  6. In the NAME column, locate and click the <releasename>-ibm-es-proxy-svc NodePort entry.
  7. In the Type column, locate the list of Node port links.
  8. Locate the top entry in the list named bootstrap <bootstrap port>/TCP.
  9. If no external hostname was specified when Event Streams was installed, this is the IP address and port number that external clients should connect to.
  10. If an external hostname was specified when Event Streams was installed, clients should connect to that external hostname using this bootstrap port number.

Before connecting a client, ensure the necessary certificates are configured within your client environment. Use the TLS and CA certificates if you provided them during installation, or export the self-signed public certificate from the browser.

Event Streams 2018.3.1 icon In Event Streams 2018.3.1, use the following steps:

  1. Log in to your Event Streams UI.
  2. Click Connect to this cluster on the right.
  3. On the Connect a client tab, copy the address from the Bootstrap server section. This gives the bootstrap address for Kafka clients.
  4. From the Certificates section, download the server certificate. If you are using a Java client, use the Java truststore. Otherwise, use the PEM certificate.

Event Streams 2018.3.0 icon In Event Streams 2018.3.0, use the following steps:

  1. Log in to your Event Streams UI.
  2. Click the Topics tab to view the topic list.
  3. Click the topic you want to connect the client to.
  4. Click the Connection information tab.
  5. Copy the broker information. This gives the bootstrap address for Kafka clients.
  6. From the Certificates section, download the server certificate. If you are using a Java client, use the JKS truststore. Otherwise, use the PEM certificate.

Setting up access

Secure your installation by managing the access your users and applications have to your Event Streams resources.

For example, associate your IBM Cloud Private teams with your Event Streams instance to grant access to resources based on roles.

Scaling

Depending on the size of the environment that you are installing, consider scaling and sizing options. You might also need to change scale and size settings for your services over time. For example, you might need to add additional Kafka brokers over time.

See how to scale your environment

Considerations for GDPR readiness

Consider the requirements for GDPR, including encrypting your data for protecting it from loss or unauthorized access.