Update to nJAMS Server 6.0, while upgrading to Elasticsearch 8

Update to nJAMS Server 6.0, while upgrading to Elasticsearch 8#

Follow these steps, when you plan to update to nJAMS Server 6.0, while additionally upgrading to Elasticsearch 8, respectively AWS OpenSearch 2.

Caution

Before starting, make sure that your current Elasticsearch 7 cluster is ready to be updated to version 8, i.e., that all indexes are version 7 indexes.

These instructions explain the procedure for Elasticsearch 8, but apply just as well to AWS OpenSearch 2:

  1. Update nJAMS Server from 5.x to 6.0 using nJAMS installer while being on Elasticsearch 7

  2. Stop Indexer and stop Data Provider(s) of your updated nJAMS Server 6.0 instance

  3. Upgrade Elasticsearch cluster 7.x to version 8.7

  4. Deploy nJAMS Server 6.0 ES 8 package.

  5. Optional - Re-index Elasticsearch Indexes from format v7 to v8

Upgrade procedure step by step:

(A) Update nJAMS Server 5.x to 6.0:

  1. Start nJAMS installer and use update option

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

(B) 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

(C) Upgrade Elasticsearch Cluster to version 8.7:

  1. Refer to Elasticsearch documentation to learn about upgrading Elasticsearch

  2. Download Elasticsearch 8.7

  3. Perform upgrading your cluster to Elasticsearch 8.7

(D) Deploy nJAMS Server 6.0 ES 8 package:

  1. Login to nJAMS GUI and go to Administration > System Control > Deployment

  2. UPLOAD file nJAMS Server 6.0 update package of Elasticsearch 8 njams_server_es8_6.0.x.war.

  3. Click on RESTART to deploy the update package and restart nJAMS Server

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

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

(E) Optional - Re-index existing indexes:

This step is optional. You can re-index the indexes from Elasticsearch format v7 into v8. 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.