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 |
Elasticsearch |
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, 32 Bit or 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 on x86-64 SUSE Linux Enterprise Server (SLES) 11.x, 12.x on x86-64 Red Hat Enterprise Linux (RHEL) 5.x, 6.x, 7.x on x86-64
Windows:
Microsoft Windows 7, 8, 10 64-bit on x86-64 Microsoft Windows Server 2008 R2, 2012, 2012 R2, 2016 64-bit on x86-64 including most recent updates
Others:
Please contact Faiz & Siegeln Software GmbH
Indexing Engine Requirements#
Elasticsearch:
Elasticsearch 5.5.1 and 6.4.1 are the only supported version of Elasticsearch with this nJAMS Server version.
Database Requirements#
Whereas earlier versions of nJAMS Server required a database system, nJAMS Server 5 uses a build-in database for storing meta data.
Nevertheless, you can alternatively use one of the following RDBMS:
PostgreSQL 9.4, 10.6
Oracle Database 12.1, 12.2 (XE edition may have limited performance)
Microsoft SQL Server 2012, 2014, 2016, 2017
JMS Provider#
nJAMS Server requires a JMS Provider to communicate with nJAMS Clients. The following JMS Providers are supported:
Apache ActiveMQ 5.15
TIBCO EMS 8.3, 8.4, 8.5
other: Please contact Integration Matters for other supported JMS providers
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
70.0
Best
Fast
Mozilla Firefox
63.0
Good
Good
Microsoft Edge
42
Good
Good
Microsoft Internet Explorer
11
Good
Moderate
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
orojdbc9.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
- 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
For secure connections to TIBCO EMS you need the following libraries additionally:
tibcrypt.jar
jsse.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.4/client