Update to nJAMS Server 5.0, while upgrading Elasticsearch 5 to 6

Update to nJAMS Server 5.0, while upgrading Elasticsearch 5 to 6#

Assume you are on nJAMS Server 4.4, the following steps have to be executed in order to update to nJAMS Server 5.0, while upgrading Elasticsearch 5.5.1 to 6.4.1:

  1. Stop Indexer and stop Data Provider(s) of your current nJAMS Server 4.4 instance

  2. Upgrade Elasticsearch cluster 5.5.1 to version 6.4.1

  3. Deploy nJAMS Server 4.4 ES 6 package. This step is required to have a valid running nJAMS Server 4.4 instance with ES 6.

  4. Optional - Re-index Elasticsearch Indexes from format v5 to v6

  5. Update to nJAMS Server 5.0 by using nJAMS installer

Upgrade procedure step by step:

(A) Stop Indexer and Data Provider(s):

  1. Login to nJAMS GUI as nJAMS Administrator

  2. Go to Administration > System Control > Message Processing and stop all Data Providers

  3. Go to Administration > Connections > Indexer and stop Indexer

(B) Upgrade Elasticsearch Cluster to version 6.4.1:

  1. Refer to Elasticsearch documentation to learn about upgrading Elasticsearch

  2. Download Elasticsearch 6.4.1

  3. Upgrade Elasticsearch 5.5.1 to Elasticsearch 6.4.1

(C) Deploy nJAMS Server 4.4 ES 6 package:

  1. Enter Administration > System Control > Deployment and upload njams_server_es6_<version>.war package file.

  2. Restart nJAMS Server

Your nJAMS Server 4.4 instance is now running with upgraded Elasticsearch cluster.

(D) Optional - Re-index existing indexes:

This step is optional. You can re-index the indexes from Elasticsearch format v5 into v6. If you just want to search for process executions, filtered by time or domain object, you can skip this step. If you want to be able to search for event data of the past like payload, stacktrace, activity duration, etc., you have to re-index all existing indexes.

Please refer to chapter How to re-index existing indexes for more informaton.

(E) Update to nJAMS Server 5.0:

  1. Start nJAMS installer and use update option

  2. Once nJAMS Server is updated and up again, Login with your nJAMS administrator account

  3. Make sure Indexer and Data Provider(s) are started

nJAMS Server 5.0 is ready to continue processing log messages.