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.7 | Elasticsearch 6.4, 6.8, 7.7 |
| RDBMS | Internal DB | Oracle DB, MS SQL Server, PostgreSQL [1] |
| JMS Provider | Apache ActiveMQ | Apache ActiveMQ, TIBCO EMS |
| [1] | Support for external databases is deprecated and will be removed in next nJAMS Server release, |
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 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, and 7.7 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.7.0-amd64.deb dpkg -i elasticsearch-7.7.0-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:
| [2] | With limitations: nJAMS installer fails with Postgres 10 or later when using the option to clean the installation target schema. |
| [3] | For using Oracle 19 or higher the WildFly configuration must be updated to use db.dialect “org.hibernate.dialect.Oracle12cDialect”. See more information in nJAMS toolbox at GitHub. |
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.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 81 Best Fast Microsoft Edge 81 Best Fast Mozilla Firefox 76 Good Good Microsoft Internet Explorer 11 [4] Good Moderate
| [4] | Make sure most recent update is installed for Internet Explorer 11. Earlier versions may have compatibility issues. |
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 For Oracle 12c:
|
|
| 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
|
|
| 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:
|
|
| 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:
For secure connections to TIBCO EMS you need the following libraries additionally:
Check your TIBCO EMS installation for those files. Typically they can be found in:
or alternatively in:
For example:
|
|