...

For the terms used in this project together with their meanings, see https://docs.community.firstwave.com/wiki/spaces/opHA/pages/edit-v2/3164408853#Terminology.

...

Software Installation

Upgrade to opHA-MB 5.1.0 can be done from infrastructure

...

cd /usr/local/omk/install
sudo sh ./install_message_bus.sh -y

...

1.5 NATS Setup

This configuration should be applied to the Main Primary server ONLY.

...

server_name: "opha-primary1.opmantek.net"  #The local server  
http_port: 8222 
listen: 4222 
jetstream: enabled 

#tls {
#    cert_file: "<path>"
#    key_file:  "<path>"
#    #ca_file:   "<path>"
#    verify: true
#}

log_file: "/var/log/nats-server.log"

accounts { 
  $SYS { 
    users: [ 
      { user: "admin",
        pass: "password" 
      } 
    ] 
  } 
  ophad: { 
    users: [ 
        { user: "omkadmin", password: "op42opha42" } 
    ] 
    jetstream: enabled 
  } 
} 

jetstream { 
  store_dir: "/opt/nats/storage" 
  max_memory_store: 1028M 
  max_file_store: 1028M 
} 

...

1.6 MongoDB Setup (Main Primary Only)

The following steps should be performed on all the servers. only on the Main Primary MongoDB instance.

...

Initialize MongoDB Replica Set

Connect to MongoDB using the mongosh command:

...

systemctl restart mongod

...

1.7 Common opCommon.json Configuration for All Servers

...

1.7.1 Update /usr/local/omk/conf/opCommon.json

1. Backup Configuration: Make a backup copy of the opCommon.json file before making any changes.

2. Add NATS Server Configuration: Ensure the following configuration is included in opCommon.json on all servers. In the below example we have added the Main Primary FQDN and port to be utilized in the nats_server attribute, you can find this in the database section.

   Code Block
   language json
   "nats_server": "opha-primary1.opmantek.net"

   IMPORTANT

   Delete the following line from the opCommon.json file.

3. Code Block
   language json
   "db_mongo_cluster": [],

...

1.8 Starting Services

...

1.8.1 Start NATS (on Main Primary Only)

Start the NATS service on the Main Primary server ONLY:

sudo systemctl start nats-server

...

1.8.

...

2 Restart FirstWave daemons on all servers

After configuration changes have been made, you will need to restart the relevant FirstWave module daemons applicable to your server.

...

sudo systemctl restart nmis9d opchartsd opeventsd omkd ophad

...

1.

...

9 Discover the Peers

Click on Peers in opHA-MB portal on the Main Primary (http://<fqdn of Main Primary>/en/omk/opHA/peers)

...

Proceed to next step after discovering all the Peers.

...

1.10 Restart opHA service on the Main Primary

sudo systemctl restart ophad

...

1.11 Start the Poller and Mirrors

Execute the following command on the poller and mirror servers.

sudo /usr/local/omk/bin/ophad cmd producer start

...

1.12 Final Steps

1. Accept EULAs: Make sure when you login to each server to confirm that all End User License Agreements (EULAs) are accepted.

...

server_name: "opha-primary1.opmantek.net"  #The local server  
http_port: 8222 
listen: 4222 
jetstream: enabled 

#tls {
#    cert_file: "<path>"
#    key_file:  "<path>"
#    #ca_file:   "<path>"
#    verify: true
#}

log_file: "/var/log/nats-server.log"

accounts { 
  $SYS { 
    users: [ 
      { user: "admin",
        pass: "password" 
      } 
    ] 
  } 
  ophad: { 
    users: [ 
        { user: "omkadmin", password: "op42opha42" } 
    ] 
    jetstream: enabled 
  } 
} 

jetstream { 
  store_dir: "/opt/nats/storage" 
  max_memory_store: 1028M 
  max_file_store: 1028M 
} 

4. MongoDB Setup (Main Primary Only)

The following steps should be performed only on the Main Primary MongoDB instance.

4.1 Initialize MongoDB Replica Set

Connect to MongoDB using the mongosh command:

...

3. Common Configuration for All Servers

3.1 Update /usr/local/omk/conf/opCommon.json

1. Backup Configuration: Make a backup copy of the opCommon.json file before making any changes.

2. Add NATS Server Configuration: Ensure the following configuration is included in opCommon.json on all servers. In the below example we have added the Main Primary FQDN and port to be utilized in the nats_server attribute, you can find this in the database section.

   Code Block
   language json
   "nats_server": "opha-primary1.opmantek.net"

   IMPORTANT

   Delete the following line from the opCommon.json file.

3. Code Block
   language json
   "db_mongo_cluster": [],

5. Starting Services

5.1 Start NATS (on Main Primary Only)

Start the NATS service on the Main Primary server ONLY:

...

sudo systemctl restart mongod

5.3 Restart FirstWave daemons on all servers

After configuration changes have been made, you will need to restart the relevant FirstWave module daemons applicable to your server.

...

Proceed to the next step.

7. Restart opHA service on the Main Primary

sudo systemctl restart ophad

8. Start the Poller and Mirrors

Execute the following command on the poller and mirror servers.

sudo /usr/local/omk/bin/ophad cmd producer start

9. Final Steps

1. Accept EULAs: Make sure when you login to each server to confirm that all End User License Agreements (EULAs) are accepted.

...