Chapter 3. Deploying AMQ Broker on OpenShift Container Platform

Procedure

1. Navigate to the OpenShift web console and log in.
2. Select the amq-demo project space, or another, existing project in which you want to deploy a broker.
3. Click Add to Project > Browse Catalog to list all of the default image streams and templates.
4. Use the Filter search bar to find results that match amq. You might need to click See all to show the desired application template.
5. Select the amq-broker-73-basic template, which is labeled Red Hat AMQ Broker 7.3 (Ephemeral, no SSL).

6. Set the following environment variables in the configuration and click Create.

   Expand

   Table 3.1. Example template

   Environment variable	Display Name	Value	Description
   AMQ_PROTOCOL	AMQ Protocols	openwire,amqp,stomp,mqtt,hornetq	The protocols to be accepted by the broker
   AMQ_QUEUES	Queues	demoQueue	Creates an anycast queue called demoQueue
   AMQ_ADDRESSES	Addresses	demoTopic	Creates a multicast address (or topic) called demoTopic
   AMQ_USER	AMQ Username	amq-demo-user	The username the client uses
   AMQ_PASSWORD	AMQ Password	password	The password the client uses with the username

   Show more

   You can also deploy the image from the command line:

   $ oc new-app --template=amq-broker-73-basic \
      -e AMQ_PROTOCOL=openwire,amqp,stomp,mqtt,hornetq \
      -e AMQ_QUEUES=demoQueue \
      -e AMQ_ADDRESSES=demoTopic \
      -e AMQ_USER=amq-demo-user \
      -e ADMIN_PASSWORD=password \

Procedure

1. After the deployment has been created, choose Deployments from the Applications menu.
2. Click the broker-amq deployment.

3. Click Deploy to deploy the application.

   Note

   If the application does not deploy, you can check the configuration by clicking the Events tab. If something is incorrect, edit the configuration by clicking the Action button.

4. After the deployment has appeared on the list, click on it to view the state of the pods. Click on the pod and then click the Logs tab to view the broker logs and verify its state. You should see the queue previously created.

5. Click the Terminal tab to access a shell where you can use the CLI to test sending and consuming messages.

   sh-4.2$ ./broker/bin/artemis producer
   Producer ActiveMQQueue[TEST], thread=0 Started to calculate elapsed time ...
   
   Producer ActiveMQQueue[TEST], thread=0 Produced: 1000 messages
   Producer ActiveMQQueue[TEST], thread=0 Elapsed time in second : 4 s
   Producer ActiveMQQueue[TEST], thread=0 Elapsed time in milli second : 4584 milli seconds
   sh-4.2$ ./broker/bin/artemis consumer
   Consumer:: filter = null
   Consumer ActiveMQQueue[TEST], thread=0 wait until 1000 messages are consumed
   Received 1000
   Consumer ActiveMQQueue[TEST], thread=0 Consumed: 1000 messages
   Consumer ActiveMQQueue[TEST], thread=0 Consumer thread finished

   You can also use the OpenShift client to access the shell by using the pod name, as shown in the following example.

   oc rsh broker-amq-1-9x89r