Red Hat Training

A Red Hat training course is available for Red Hat AMQ

Chapter 3. Deploying AMQ Interconnect on OpenShift Container Platform

You can deploy AMQ Interconnect in your OpenShift environment by using the templates that are provided in the OpenShift catalog. Each template deploys one or more AMQ Interconnect routers, which you can scale up to a mesh topology.

Note

As an alternative to using the OpenShift web UI, you can use the oc command line tool to deploy the templates and set their parameters. For more information, see your OpenShift documentation.

Prerequisites

Procedure

  1. In the OpenShift web UI, in your project, select Add to ProjectBrowse Catalog.
  2. Search for interconnect, and then select one of the following templates:

    Red Hat AMQ Interconnect Router 1.x
    A single router with a basic, default configuration and no security.
    Red Hat AMQ Interconnect Router 1.x with TLS authentication
    A router mesh of two routers in which client and inter-router traffic is secured with SSL/TLS authentication.
    Red Hat AMQ Interconnect Router 1.x with SASL
    A router mesh of two routers in which the inter-router traffic is secured with SSL/TLS authentication, and the clients are authenticated against user name and password pairs stored in a SASL database.
  3. Click Next and review the configuration.

    You can change the default values for any of the parameters.

  4. Click Create and then confirm the creation.

    AMQ Interconnect is deployed with each router running in a separate pod.

  5. Verify that each pod was deployed successfully, and that each router is operational.

    1. Navigate to ApplicationsDeployments, and then click the most recent version.

      The deployment details are displayed. The pods should have a status of Running.

    2. Click Logs to verify that each router is operational.

      At the top of log terminal, the log entries indicate that the router is operational:

      2018-09-12 16:37:50.922166 +0000 SERVER (info) Container Name: amq-interconnect-1-6pj98
      2018-09-12 16:37:50.922346 +0000 ROUTER (info) Router started in Interior mode, area=0 id=amq-interconnect-1-6pj98
      2018-09-12 16:37:50.922375 +0000 ROUTER (info) Version: Red Hat AMQ Interconnect 1.4.0 (qpid-dispatch 1.4.0)
      2018-09-12 16:37:50.923860 +0000 ROUTER_CORE (info) Router Core thread running. 0/amq-interconnect-1-6pj98
      ...
      2018-09-12 16:37:51.006921 +0000 SERVER (notice) Operational, 4 Threads Running (process ID 1)