Introduction

Introduction#

Planning your installation#

nJAMS Server requires several software products either to be installed by nJAMS Server Installer or to be provided by customer in advance. The following table lists the required software components that belong to an nJAMS instance.

You can decide to install these components by nJAMS Server Installer or to use already installed software:

Required software:

Software provided by installer:

Support of pre-installed software:

nJAMS Server

WildFly, nJAMS Server

Elasticsearch

Elasticsearch 7.16

Elasticsearch 6.4, 6.8, 7.16

RDBMS

Internal DB

Oracle DB, MS SQL Server, PostgreSQL

JMS Provider

Apache ActiveMQ

Apache ActiveMQ, TIBCO EMS

Hardware requirements#

  • Computer and processor: A computer with Intel x86, 64 Bit, 2 GHz, multi-core recommended or divergent architecture with comparable performance characteristics.

  • Memory: 4 GB RAM minimum, required RAM capacity depends on the setup of the nJAMS instance. For production setup we strongly recommend to distribute all components on separate machines. For development or demonstration purposes it might be possible to install all components on the same machine.

Supported Platforms#

Linux:

  • Ubuntu Server 16.04 on x86-64

  • CentOS 6.x, 7.x, 8.x on x86-64

  • SUSE Linux Enterprise Server (SLES) 11.x, 12.x on x86-64

  • Red Hat Enterprise Linux (RHEL) 6.x, 7.x, 8.x on x86-64

Windows:

  • Microsoft Windows 7, 8, 10, 11 64-bit on x86-64 including most recent updates

  • Microsoft Windows Server 2008 R2, 2012, 2012 R2, 2016 64-bit on x86-64 including most recent updates

Others:

Please contact Integration Matters

Indexing Engine Requirements#

Elasticsearch:

Elasticsearch 6.4, 6.8, 7.7, 7.10.2, 7.13, and 7.16 are supported by this nJAMS Server version.

If you plan to use a separate Elasticsearch cluster for nJAMS Server, you should use the Elastisearch installer. Although you can use nJAMS installer to install a single Elasticsearch node, it is not suitable for the installation of a larger cluster.

Note

If you install Elasticsearch separately, make sure to only use supported versions of Elasticsearch.

This is an example for a separate installation of Elasticsearch on Linux, explicitly using version 7.7.0:

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.16.3-amd64.deb
dpkg -i elasticsearch-7.16.3-amd64.deb

Database Requirements#

Whereas earlier versions of nJAMS Server required a database system, nJAMS Server 5 uses a build-in database for storing meta data. If you plan a new installation of an nJAMS Server instance, it is recommended to use the internal database instead of an external RDBMS.

Note

Support of external database system is deprecated with this release of nJAMS Server.

Nevertheless, you can alternatively still use one of the following RDBMS:

  • PostgreSQL 9.4, 10.6 [1]

  • Oracle Database 12.2, 19 (XE edition may have limited performance)

  • Microsoft SQL Server 2012, 2014, 2016, 2017, 2019

JMS Provider#

nJAMS Server supports JMS to communicate with nJAMS Clients. The following JMS Providers are supported:

  • Apache ActiveMQ 5.15

  • TIBCO EMS 8.4, 8.5, 8.6

  • other: Please contact Integration Matters for other supported JMS providers

Kafka#

nJAMS Server supports Kafka to communicate with nJAMS Clients:

  • Apache Kafka 3.0

LDAP (optional)#

nJAMS Server optionally makes use of the following supported LDAP servers:

  • Microsoft Active Directory 2008, 2008 R2, 2012, 2012 R2, 2016

  • other: Please contact Integration Matters for other supported LDAP servers.

Web Browser Support#

Web Browser

Tested version

Compatibility

Performance

Google Chrome

100

Best

Fast

Microsoft Edge

100

Best

Fast

Mozilla Firefox

99

Good

Good

Java Requirements#

nJAMS Server 5 comes with OpenJDK 11. That means all used 3rd party libraries must be Java 11 compatible. If you want to use nJAMS Server with your own relational database system, make sure the jdbc driver is Java 11 compatible.

Optional Software requirements#

The following Java libraries must be available in the WildFly classpath. Please check the WildFly manual for further information.

JDBC Driver for Oracle:

In case you want to use Oracle RDBMS you have to make sure Oracle JDBC driver is available. The JDBC Driver for Oracle is not part of nJAMS Distribution Package. Please go to the Oracle website for downloading ojdbc8.jar, ojdbc9.jar, ojdbc11.jar. Oracle JDBC driver download: http://www.oracle.com/technetwork/database/features/jdbc/index-091264.html The following JDBC driver versions are supported with this release of nJAMS Server:

For Oracle 12c:

  • 12.1.0.1.0

For Oracle 19c:

  • 19.14.0.0

JDBC Driver for Microsoft SQL Server:

In case you want to use Microsoft SQL Server you have to make sure SQL Server JDBC driver is available. The JDBC Driver for Microsoft SQL Server is not part of the nJAMS Server Distribution Package. Please go to the Microsoft website for downloading mssql-jdbc-7.4.1.jre11.jar. Microsoft JDBC driver download: http://www.microsoft.com/en-us/download/details.aspx?id=11774 The following JDBC driver version is supported with this release of nJAMS Server:

  • mssql-jdbc-7.4.1.jre11.jar

JDBC Driver for PostgreSQL:

Please enter PostgreSQL download page at https://jdbc.postgresql.org/download.html and download the JDBC driver. The following JDBC driver version is supported with this release of nJAMS Server:

  • postgresql-42.2.8.jar

TIBCO EMS Client libraries:

In case you want to use TIBCO Enterprise Messaging Service make sure TIBCO EMS libraries are available. The following TIBCO EMS client libraries are required by the nJAMS Server to communicate with the TIBCO EMS server:

  • tibjmsadmin.jar

  • tibjms.jar

Check your TIBCO EMS installation for those files. Typically they can be found in:

<TIBCO_EMS_HOME>/<VERSION>/client

or alternatively in:

<TIBCO_EMS_HOME>/<VERSION>/lib

For example:

/opt/tibco/ems/8.6/client