ActiveMQ Gateway Configuration

The ActiveMQ Gateway must be enabled to support the MATRIXX Notification Framework and MATRIXX Pay Now. If you are using an LDAP service, you must also configure ActiveMQ connections to the LDAP Gateway. Details are provided below for configuring the create_config.py parameters for the ActiveMQ Gateway.

For more information about the MATRIXX Notification Framework and Pay Now, see MATRIXX Integration. In addition, ActiveMQ Gateway Configuration is used as part of the setup for separate DR sites and the sub-domains in the sites. For an example of ActiveMQ configuration for multiple sites and sub-domains, see the discussion about naming and grouping in MATRIXX Installation and Upgrade.
Note: In cloud native MATRIXX installations, ActiveMQ configuration is provided by default and rarely needs to be modified. For more information, see the discussion about configuration image contents in MATRIXX Installation and Upgrade.

ActiveMQ Gateway Configuration Parameters lists the information required to configure the ActiveMQ Gateway.

Table 1. ActiveMQ Gateway Configuration Parameters
Parameter Description Default Value
ActiveMQ — Enable ActiveMQ Gateway Enables the ActiveMQ Gateway to communicate with the Integration Framework.

create_config.info question: ActiveMQ Gateway:Do you want to enable the ActiveMQ Gateway (y/n)?

Note: If you answer y, you must answer the following questions to configure the gateway.
n
ActiveMQ — ActiveMQ Group IDs The ActiveMQ group IDs. You associate each engine with a single ActiveMQ group. For more than one ActiveMQ group, separate each ID with a semi-colon(;).

create_config.info question: ActiveMQ Gateway:What are your ActiveMQ group IDs?

For each group ID, you must enter the number of ActiveMQ brokers.

Note: For each engine, you must answer the ActiveMQ Engine Group ID.
primary
ActiveMQ — ActiveMQ Brokers The number of ActiveMQ brokers that are in this group. Each ActiveMQ group consists of one or more ActiveMQ brokers.

create_config.info question: ActiveMQ Gateway:ActiveMQ Group groupID:How many ActiveMQ brokers are in this group?

For each ActiveMQ broker, you must enter the ActiveMQ broker URI.

1
ActiveMQ — ActiveMQ Broker URI The ActiveMQ URI for the current broker.

create_config.info question: ActiveMQ Gateway:ActiveMQ Group groupID:Broker <number>:What is the ActiveMQ broker URI?

Specify the timeout value in milliseconds; 1000 milliseconds = 1 second.

Note: This must match the value specified for the Payment Service in payment-service.yaml. For more information, see the discussion about configuring the Payment Service.
failover:​//(tcp://127.0.0.1:​61616​?wireFormat​=openwire)​?timeout=1000
ActiveMQ — Message Handler IDs The ActiveMQ message handler ID. For more than one ActiveMQ message handler, separate each message handler ID with a semi-colon(;). For example, enter the following: payments;notification

create_config.info question: ActiveMQ Gateway:ActiveMQ Group groupID:Session sessionID:What are your message handler IDs?

For each message handler ID, you must define the producer type.

  • Pay Now — payments
  • Notification Framework — notification
  • USSD notifications — ussd
  • LDAP Gateway — ldap
  • CHF Charging Data Notify — chf_chargingdatanotify
  • CHF Spending Limit Notify — chf_spendinglimitnotify
ActiveMQ — Producer Type The ActiveMQ message producer destination type.

create_config.info question: ActiveMQ Gateway:ActiveMQ Group groupID:Session <sessionId>:MessageHandler messageHandlerId:What is the producer's type?

Possible producer type values are:
  • queue
  • topic

For each ActiveMQ producer you must specify the producer destination type.

queue
ActiveMQ — Producer Name The ActiveMQ message producer destination name.

create_config.info question: ActiveMQ Gateway:ActiveMQ Group groupID:Session <sessionId>:MessageHandler messageHandlerId:What is the producer's name?

Note: This must match the name specified for the Integration Framework in mtx_notifier_camel.yaml.
No Default
ActiveMQ — Consumer Type The ActiveMQ consumer destination type.

create_config.info question: ActiveMQ Gateway:ActiveMQ Group groupID:Session <sessionId>:MessageHandler messageHandlerId:What is the consumer's type?

Possible destination type values are:
  • queue
  • topic
queue
ActiveMQ — Consumer Name The ActiveMQ consumer destination name.

create_config.info question: ActiveMQ Gateway:ActiveMQ Group groupID:Session <sessionId>:MessageHandler messageHandlerId:What is the consumer's name?

Note: This must match the name specified for the Integration Framework mtx_notifier_camel.yaml.
No Default
ActiveMQ — Engine Group ID The current engine's ActiveMQ group ID. Each engine can specify only one ActiveMQ group ID.

create_config.info question: Engine engineID:What ActiveMQ group ID does this engine use?

 The first ActiveMQ group defined.
ActiveMQ — Initialization The time to wait in seconds before retrying a failed ActiveMQ initialization.

create_config.info question: How long (in seconds) should elapse before retrying a failed ActiveMQ initialization?

 5