Preparing for installation

This chapter lists prerequisites for the istallation.

Preparing TIBCO BusinessWorks™ 6

nJAMS Client for BW6 requires TIBCO BusinessWorks 6 to be installed. For installing TIBCO BusinessWorks 6 please follow the instructions of the installation manual that comes with TIBCO BusinessWorks 6. Furthermore TIBCO EMS support is required for the TIBCO BusinessWorks 6 environment. Please make sure to install the TIBCO EMS support libraries.

Preparing TIBCO Enterprise Message Service™

nJAMS Client for BW6 can use TIBCO EMS for communication with on-premise nJAMS Server. TIBCO EMS has to be up and running and available on your network/subnet. nJAMS Client for BW6 uses several destinations on your TIBCO EMS Server for communication with 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
  • TIBCO EMS Account (Username, Password)
  • Permissions send, receive on queues <prefix>.event, <prefix>.error, <prefix>.metrics
  • 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.

nJAMS Client for BW6 requires to use JNDI, so 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 Kafka instance

nJAMS Client for BW6 can use TIBCO EMS for communication with on-premise nJAMS Server. For using your own corporate Kafka instance, create a separate user for nJAMS Client for BW6 that is authorized to the following topics:

Destinations: Type: Privileges:
<prefix>.event topic read, write, describe
<prefix>.project topic read, write, describe
<prefix>.error topic read, write, describe
<prefix>.metrics topic read, write, describe
<prefix>.commands topic read, write, describe

This user also needs permission for the prefix of the consumer group of the connection.

Preparing network security

If you want to use the Cloud Data Provider of nJAMS Client for BW6, your network must allow HTTPS for external communication. nJAMS Client for BW6 uses HTTPS transport based on certificates to communicate with your nJAMS Cloud Instance.

Preparing nJAMS Server®

nJAMS Client for BW6 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 BW6, but at the latest before the first use of nJAMS Client for BW6.