Connection properties

This section explains the properties you can specify on the Connection tab of a message queue connection point.

You are prompted to select the external JMS type that you want ION to connect to. Select one of the pre-registered JMS vendors.

There are some common properties irrespective of the selected JMS vendor and there are some vendor specific properties.

The vendor independent properties of the connection point correspond to the sample implementation that are provided in this folder:

JMSClientBundleWrapper/examples

Sometimes, different samples are supplied for the same vendor depending on the protocols used. For example, there are several samples for TIBCO EMS to connect using SSL, SSL-JNDI and TCP. Registering a driver for one of these protocols does not enable other protocols to communicate with TIBCO EMS server. Each protocol support must be treated as a separate JMS client registration.

See Registering JMS Vendors with ION.

The samples that are provided are meant to be used as a reference. The configuration details and customizations that are required for the actual registration of a JMS client driver can differ from the samples provided. This depends on the deployment requirements of the JMS server.

This table shows the vendor independent properties of the connection point:

Property Description
Default queue for Reading: This property is used for reading one or more documents from the JMS queue on the external JMS server and use them in ION. Specify the name of the queue that is used for reading those messages that do not have a specific queue. On the Documents tab you can select the Use Default Queue for all documents option. ION does not poll any other queue and uses this queue to read all documents. Confirm BODs that are published by the external JMS servers are also expected in this queue. Ensure that this queue is unique to this connection point and is not used as a read queue in any other connection point.
Default queue for Writing: This property is required to write one or more documents from ION to the JMS queue. Specify the name of the queue on the external JMS server that is used for writing those messages that do not have a specific queue. On the Documents tab, you can select the Use Default Queue for all documents option. ION writes all incoming documents of this connection point to this queue.
Authentication None: no authentication is required for the message queues. Basic: a user name and password are required for the message queues.
User Name: If basis authentication is used, specify the user name to be used for the queues. These credentials are used by ION to read or write the message queues.
Password: If basis authentication is used, specify the password to be used to connect to the message queues.

This table shows the vendor specific properties of the connection point:

Table 1. Active MQ 5.5.1
Property Description
URL

Specify the URL of the address of the external JMS server. The format is: tcp://MachineName:portNumber

Note that the machine name is the name of the external JMS server. If this is a remote host, ensure to specify the correct host name and test if the port is accessible.

Administration Port: The JMX port that is used by the Active MQ server. This is used by ION to retrieve the metrics that are related to the Manage pages of ION Desk. You can find this port number from the activemq.xml file available under this folder: activemq Install Dir/conf
Table 2. IBM MQ 7.1.0
Property Description
Host Specify the machine name of the IBM MQ server.

The machine name is the name of the external JMS server. If this is a remote host then ensure to specify the correct host name.

Port Port of the IBM MQ server. Ensure that the port is accessible.
Queue Manager Queue Manager of the chosen IBM MQ service
Channel Channel of the chosen IBM MQ service
Table 3. Tibco 6.3.0 (TCP based connection without using JNDI)
Property Description
URL Specify the URL of the address of the Tibco server. The format is:

tcp://MachineName:PortNumber

The machine name is the name of the external JMS server. If this is a remote host, ensure to specify the correct host name and test if the port is accessible.

Table 4. Oracle AQ 11.2.0.1
Property Description
URL Specify the URL of the address of the Oracle AQ JMS server. The format is:

jdbc:oracle:thin:@//HostName:PortNumber/SystemID

The machine name is the name of the external JMS server. If this is a remote host then ensure to specify the correct host name and test if the port is accessible.

Internal Logon This is the role used while making connection. This can be either default or sysdba.
Queue Table Table where the queues are stored

To use the Tibco EMS 8.2.0 (JNDI with SSL security) option, the TIbco Enterprise Message Service Server must be configured to support SSL. See the official Tibco EMS documentation and sample files: https://docs.tibco.com/pub/activematrix_businessworks_plugin_for_microsoft_sharepoint/6.0.0/doc/html/GUID-18028D0D-02E9-411F-A5B0-FA3011FCDF71.html

Afterwards you must import the server certificate of the Tibco EMS server into ION.

  • Ask your TIbco EMS administrator for the correct server certificate. This corresponds to the configurations that are specified in the tibemsd.conf and factories.conf file of TIBCO EMS server. Verify the certificate. The extensions cer, der and crt are supported byION. Rename the certificate file with one of these extensions before proceeding.
  • Ensure that the certificate file does not contain the private key.
  • When you agree on the authenticity of the certificate, click Import and Trust Certificate.
  • A window is displayed. Browse to the location of your certificate and select it. Click Open.
  • The certificate is imported in the ION trust store.

ION is tested with TIBCO EMS as the JNDI provider. Continue with specifying the remaining TIBCO EMS specific properties that are shown in this table:

Table 5. Tibco EMS 8.2.0 (JNDI with SSL security)
Property Description
JNDI URL Specify the provider URL of the TIBCO EMS JNDI server. The format is: tibjmsnaming://<HOST>:<PORT>
JNDI Username Specify the JNDI username. Note that this is different than the username required to connect to the JMS queues.
JNDI Password Specify the password for the JNDI user.
Factory Name Specify the Queue connection factory set in the factories.conf file of TIBCO EMS in the Queue Connection Factory field. For example: SSLQueueConnectionFactory
Factory Context Specify the Initial context factory to be used for the JNDI lookup. For example: com.tibco.tibjms.naming.TibjmsInitialContextFactory
URL Package Prefixes Specify the package that provides the context class user to perform JNDI and SSL operations. For example: com.tibco.tibjms.naming
SSL Client Identity: Import Client Certificate
  • Ask your TIbco EMS administrator for the correct client identity certificate. This corresponds to the configurations that are specified in the factories.conf file of TIBCO EMS server. Verify the certificate. The formats PKCS12 , JKS and JCEKS are supported by ION. The Related extensions are:
    • .p12
    • .pfx
    • .jks
    • .jceks
  • When you agree on the authenticity of the certificate, click Import Client Certificate.
  • A window is displayed. Browse to the location of your certificate and select it. Click Open.
SSL Client Keystore Password Specify the password for the client certificate.

The Tibco 8.2.0 (Plain SSL connection without JNDI) option uses SSL channel to connect to TIBCO EMS. It requires SSL enabling on the TIBCO side. The server certificate must be imported into ION. Ask your TIbco EMS administrator for the correct server certificate. This corresponds to the configurations that are specified in the tibemsd.conf and factories.conf file of TIBCO EMS server. Verify the certificate. The extensions cer, der and crt are supported byION. Rename the certificate file with one of these extensions before proceeding.

  • Log on to ION Desk.
  • Select Configure > ION Service.
  • Click the Configuration Files tab.
  • Click Import Certificate in the Certificate Store.
  • A window is displayed. Browse to the location of your certificate and select it. Click Open.

Continue with specifying the remaining TIBCO 8.2.0 specific properties that are shown in this table:

Table 6. Tibco 8.2.0 (Plain SSL connection without JNDI)
Property Description
URL Specify the SSL URL of the address of the Tibco server. The format is: ssl://MachineName:PortNumber

If you chose another JMS vendor that is registered by you, the connection properties that you defined are shown. Specify appropriate values.

Click Test to verify whether the connection details are correct. You are informed whether the test is successful.