IBM Event Streams


1. Get your Lenses license key 

Sign up with Lenses and download your license key.

2. Create a service credentials with Manager in the IBM cloud portal. 

The service credentials contains the bootstap brokers and the access credentails to connect with via SASL_PLAINTEXT.

3. Run Lenses with Docker 

Run the following in a terminal:

docker run --name lenses \
  -e LENSES_PORT=9991 \
  -e LENSES_SECURITY_USER=admin \
  -e LENSES_SECURITY_PASSWORD=sha256:8c6976e5b5410415bde908bd4dee15dfb167a9c873fc4bb8a81f6f2ab448a918 \
  -p 9991:9991 --add-host=host.docker.internal:host-gateway lensesio/lenses

Wait for Lenses to start up.

4. Login 

Head to http://localhost:9991.

Login as admin:

  • User: admin
  • Password: admin
Lenses login page

5. Wizard Setup 

In the Lenses startup wizard:

  1. Enter the value from bootstrap_endpoints for the brokers from the service credential
  2. Select SASL_SSL as the security protocol
  3. Select PLAIN as the security mechnaism
  4. Enter token as the username and the value of the apikey from the service credential as the passowrd in the jaas settings section
  5. Test the connection.

6. License 

Add your Lenses license. Copy and paste the JSON file you downloaded from your email. Lenses will check that the license is valid.

License Validation

7. Boot 

Click on Save & Boot Lenses. Lenses will finish configuring itself.

Wizard Validation

Once complete you can login with admin/admin at http://locahost:9991.

Next steps 

--
Last modified: July 3, 2024