Prepare installation

Prepare installation#

Requirements#

Please make sure the following requirements are covered before you begin with the installation:

  1. nJAMS Client for Mule4 requires MuleSoft Runtime Engine 4.5.x, 4.6.x or 4.7.x . You can either use MuleSoft CloudHub or MuleSoft Runtime Engine installed on-premise.

  2. Make sure to install nJAMS Server and configure an nJAMS instance on-premise. Enter https://download.integrationmatters.com/software/ to download the installation package of nJAMS Server.

Prerequisites#

  • Prepare an nJAMS instance based on nJAMS Server. To use all recent features, please use nJAMS Server version 6.0+ . Alternatively, it is also possible to work with versions 4.4 and 5.0+ .

  • We recommend to use JMS for communication. For that prepare an JMS provider for communication between nJAMS Client for Mule4 and nJAMS Server. You can use Apache ActiveMQ 5.13, 5.15, or TIBCO EMS 8.4, 8.5.

    Create these destinations on your ActiveMQ and grant authorizations as follows:

    Destination

    Type

    Required privilege

    Description

    <prefix>.event

    queue

    read, write

    nJAMS Client for Mule4 sends log messages to this destination, received by nJAMS Server

    <prefix>.error

    queue

    read, write

    Keeps invalid log messages that could not be processed by nJAMS Server

    <prefix>.commands

    topic

    read, write

    nJAMS Client for Mule4 receives commands from nJAMS Server by using this destination

    The <prefix> can be specified individually, the default prefix is njams. Make sure the prefix corresponds to the setting used in the JMS Connection of nJAMS Server.

You can find alternative communcation methods in chapter “Installation and configuration using Connector”.