Preparing for installation

In this section you will prepare your environment by installing and configuring all software prerequisites.

Preparing TIBCO ActiveMatrix BusinessWorks™

nJAMS Client for BW requires TIBCO BusinessWorks to be installed. For installing TIBCO BusinessWorks please follow the instructions of the installation manual that comes with TIBCO BusinessWorks.

When using nJAMS Client for BW 4.1.4 or higher with TIBCO BusinessWorks 5.15, it is required to modify TIBCO’s “log4j2.properties” file in order to enable logging of nJAMS Client in bwengine’s log file.

The file log4j2.properties is located at <TIBCO_HOME>/bw/<VERSION>/lib/.

There are basically two options. Please choose one of these options that is best for you:

  1. Copy or move the following section of log4j2.properties to the bottom of the file:

    # TIBCO BusinessWorks Logger.  The logger level is "INFO" and the appender
    # is "tibco_bw_log".
    logger.tibco_bw_log.name = bw.logger
    logger.tibco_bw_log.level = INFO
    logger.tibco_bw_log.appenderRef.bw_log.ref = tibco_bw_log
    
  2. Alternatively, add this section to log4j2.properties:

    # nJAMS Logger.  The logger level is "INFO" and the appender is set to the
    # TIBCO BusinessWorks Appender.
    logger.njams.name = com.faizsiegeln
    logger.njams.level = INFO
    logger.njams.appenderRef.bw_log.ref = tibco_bw_log
    

    Furthermore, refer to this logger in the nJAMS global variable “tibco.clientVar.nJAMS/logger” of your TIBCO BW project, e.g.

    in TRA file: tibco.clientVar.nJAMS/logger=com.faizsiegeln

    in TIBCO Designer:

    TIBCO Designer global variable nJAMS logger

Note

Both options are NOT required, if your are using nJAMS Client for BW with prior versions 5.13 or 5.14 of TIBCO BusinessWorks.

Preparing TIBCO Enterprise Message Service™

If you want to use the JMS Data Provider of nJAMS Client for BW, TIBCO EMS has to be up and running and available on your network/subnet, where you want to use TIBCO BusinessWorks. nJAMS Client for BW uses three destinations on your TIBCO EMS Server in order to communicate with an nJAMS Server Instance. These destinations must correspond to the Data Provider settings of your nJAMS Server Instance.

You need the following information about your TIBCO EMS Server:

  • IP-Address / Servername, Port Number
  • Account (Username, Password)
  • Permissions send, receive on queues <prefix>.event, <prefix>.error
  • Permissions publish, subscribe on topic <prefix>.commands

Tip

It is recommended to add an expiration time of e.g. 5 seconds to the <prefix>.commands destination.

If you plan to use JNDI for looking up connection factories, the following information is required also:

  • IP-Address / Servername, Port Number of JNDI server
  • JNDI Account (Username, Password)
  • Name of ConnectionFactory (e.q. QueueConnectionFactory)

Preparing network security

If you want to use the Cloud Data Provider of nJAMS Client for BW, your network must allow HTTPS for external communication. nJAMS Client for BW uses secure HTTPS transport based on certificates to communicate with your nJAMS Cloud Instance. Furthermore, you have to make sure the TIBCO BusinessWorks engine is using TLS 1.2. This can be done by adding the following properties to bwengine.tra file, respectively designer.tra file:

java.property.TIBCO_SECURITY_VENDOR=j2se
java.property.jdk.tls.client.protocols=TLSv1.2

Preparing nJAMS Server®

nJAMS Client for BW requires a running nJAMS Instance, either on-premise (nJAMS Server), oder in the cloud (nJAMS Cloud). However, the nJAMS Instance is not required during installation of nJAMS Client for BW, but at the latest before the first use of nJAMS Client for BW.