Test the connection to Hermes through the ADCv2 gateway

Verify the keystore and truststore have been correctly generated by testing the connection to Hermes through the ADCv2 gateway.

Before you begin

• Role required: integration_hub_admin
• This page is part of the Stream Connect quick start guide.
• This document covers how to test a connection to Hermes. To create the connection, see Set up a secure connection to the Hermes Messaging Service.

Procedure

1. Download and install Apache Kafka.
   1. Download the Apache Kafka binaries.
   2. Unzip the Kafka package by running the following command:

      tar -zxvf kafka_2.13-3.1.2.tgz

2. Navigate to the Kafka directory by running the following command:

   cd kafka_2.13-3.1.2

3. Configure a producer.
   1. Open the config/producer.properties file.
   2. Configure the following SSL properties:

      security.protocol=SSL
      
      ssl.truststore.password=<truststore password>
      
      ssl.truststore.location=<path to truststore.p12>
      
      ssl.truststore.type=PKCS12
      
      ssl.keystore.password=<keystore password>
      
      ssl.keystore.location=<path to keystore.p12>
      
      ssl.keystore.type=PKCS12
      
      ssl.key.password=<keystore password>

      Replace the following placeholder variables:

      • <truststore password> with your truststore password.
      • <path to truststore.p12> with the path to your truststore file.
      • <keystore password> with your keystore password.
      • <path to keystore.p12> with the path to your keystore file.
   After following steps 1 through 3, you should have downloaded Apache Kafka and configured the producer.properties correctly. All the commands given in next steps should run within the Apache Kafka home directory.
4. Copy the config/producer.properties file to config/bootcamp.properties.
   This example uses bootcamp as a generic name.

   cp config/producer.properties config/bootcamp.properties

5. Use the following command to list the topics.

   bin/kafka-topics.sh --list --command-config config/bootcamp.properties  --bootstrap-server <instance name>.service-now.com:4000,<instance name>.service-now.com:4001,<instance name>.service-now.com:4002,<instance name>.service-now.com:4003

   Be sure to replace <instance name> with the name of your instance.
   If there are topics in the instance, they should be listed here.

What to do next

Use the Kafka Message trigger and Script consumer to consume messages.