Upgrade Guide: Version 8.2.0

note

It is crucial to have Motadata AIOps baseline version of 8.1.3 to upgrade to Motadata AIOps version 8.2.0.

note

Before performing Agent bulk upgrade, ensure that Motadata AIOps version 8.1.3 is installed.

Latest Motadata AIOps Installation Links

Motadata AIOps	Link
Ubuntu 24.04 (.iso)	Download
Ubuntu 24.04 (.ova)	Download
RHEL 9.4 (.tar)	Download
Windows (.exe)	Download

MotaAgent Installation Links

Operating System	Version	Link
Linux	All	Download
Windows	All	Download
IBM-AIX	7.x	Download

Upgrade Patches for 8.2.0

Operating System	Link
Ubuntu/RHEL	Download
Windows	Download

Motadata Agent Upgrade Patches for 8.2.0

Operating System	Version	Link
Windows and Linux	All	Download

note

After upgrading the Motadata Agent Manager using the link above, the system will wait for 30 seconds before automatically initiating the Agent upgrade.

Prerequisites for upgrading DB serverEnsure the Motadata AIOps service is not running before you perform this step.

1. Take a VM Snapshot/Backup: Before proceeding with the upgrade, ensure you take a VM snapshot or backup of all servers.
2. Contact Motadata: If the AIOPS version is 8.0.4 or below, please contact the Engineering team for assistance with the upgrade.
3. Free Disk Space: Ensure at least 60% free disk space on the /motadata partition to perform the patch. (Very Important)
4. Disk IOPS Verification: Verify that the disk IOPS are greater than 250 Mbps before starting the server using the following command:

   sudo dd if=/dev/mapper/vg0-motadata of=test1.img bs=1G count=1 oflag=dsync

Upgrade Steps

The upgrade steps varies for each deployment type. Please view the steps for your respective deployment architecture mentioned below.

Standalone Deployment

Linux

note

Kindly refer Upgrade Guide in case you need to upgrade Ubuntu 20 to Ubuntu 24.

1. Take a VM Snapshot/Backup: Before proceeding with the upgrade, ensure you take a VM snapshot or backup of all servers.

2. Stop Motadata Services: Stop the motadata services for the Observer server, Primary server, Secondary server, Database server, and Collectors.

   service motadata stop

3. Download AIOPS_UPGRADE.zip: Download and place the AIOPS_UPGRADE.zip file in the /motadata directory on all servers.

4. Unzip the Upgrade Patch:

   unzip AIOPS_UPGRADE.zip

5. Run the Upgrade Script: After unzipping the patch, run the upgrade script:

   sudo ./aiops-upgrade.sh
   note

   If the application and database are on the same server, proceed directly to Step 7. Otherwise, follow Step 6 first, and then move on to Step 7.

6. Master App Server Patch:

   • Start the motadata service for the master application server.
   • Wait for the patch to be applied.
   • Verify the patch application by checking the patch-related logs.
   • Ensure the GUI screen for the master server is accessible.

7. Final Steps:

   • Start the motadata service for the database server.
   • Start the motadata service for each collector, one by one.
   • Verify that data is visible on the monitoring screen.

Windows

1. Take a VM Snapshot/Backup: Before proceeding with the upgrade, ensure you take a VM snapshot or backup.

2. Stop Motadata Services: Stop the Motadata AIOPS service from Windows Services. You can search Services directly using Windows Search or press 'Window+R' and follow the command.

   services.msc

3. Download AIOPS_UPGRADE-WIN.zip: Download and place the AIOPS_UPGRADE-WIN.zip file in the C:\Program Files\Motadata\Motadata location.

4. Unzip the Upgrade Patch: Extract the AIOPS_UPGRADE-WIN.zip file.

5. Run the Upgrade Script: After unzipping the patch, run the upgrade script by opening the terminal as Administrator in the C:\Program Files\Motadata\Motadata location:

   aiops-upgrade.bat

6. Final Steps:

   • Start the motadata service.
   • Verify that data is visible on the monitoring screen.

HA Deployment

Pre-Upgrade Validation

note

Kindly refer Upgrade Guide in case you need to upgrade Ubuntu 20 to Ubuntu 24.

note

Ensure there is no data sync backlog among Primary server, Secondary server, and Collector before proceeding to upgrade. Any data yet to be synced will be lost and cannot be recovered.

note

Ensure all servers are up and running. Once all servers are up and running, navigate to Motadata health monitoring screen to ensure all servers are operational and working as intended.

Applying Upgrade Patch

1. Take a VM Snapshot/Backup: Before proceeding with the upgrade, ensure you take a VM snapshot or backup of all servers.

2. Stop Motadata services on all servers in the following sequence: You will required to first stop services on Other Servers, then Primary App Server, and finally the Observer Server.

   sudo service motadata stop 

   sudo service motadata-observer stop

3. Perform a backup of Configuration files for all App servers: Ensure you create a backup for configuration files on all the App server (Primary App and Secondary App).

   sudo cp -r /motadata/motadata/config/ /tmp/ 

4. Remove JSON files from the temporary folder and create a tar file in the Primary App server:

   sudo rm /tmp/config/*json 

   sudo tar -cvf /tmp/config.tar /tmp/config/ 

5. Replicate the Config folder with non-JSON files from Primary App server to other App servers: You will need to copy the config folder containing non-JSON files to Secondary App server.

   sudo scp -r /tmp/config.tar motadata@<App_server_IP>:/tmp/ 

note

Kindly replace the <App_server_IP> placeholder with actual IP address of your App servers.

6. Overwrite the non-JSON files on other App servers: Execute the below-mentioned commands one by one on all other app servers Secondary App server.

   sudo tar -xvf /tmp/config.tar 

   sudo cp /tmp/tmp/config/* /motadata/motadata/config 

7. Perform the Upgrade on all Servers: You can now start upgrading all servers (Observer, Primary App. Primary DB, Secondary App, Secondary DB, and Collectors)

   • Download AIOPS_UPGRADE.zip: Download and place the AIOPS_UPGRADE.zip file in the /motadata directory on all servers.

   • Unzip the Upgrade Patch:

     unzip AIOPS_UPGRADE.zip

   • Run the Upgrade Script: After unzipping the patch, run the upgrade script:

     sudo ./aiops-upgrade.sh

Post-Upgrade Validation

note

Kindly wait for the python3 /motadata/motadata/metricagent/bootstrap.pyc to spawn on Primary App server before proceeding to next step.

sudo watch service motadata status

8. Start Motadata services on Observer server, Primary App server, and all other servers: Once the upgrade process has been completed, start the services on Motadata Observer server, then Primary App server, and then all other servers in the sequence.

sudo service motadata-observer start

sudo service motadata start

9. Verify all servers are up and running: Once all servers are up and running, navigate to Motadata health monitoring screen to ensure all servers are operational and working as intended.

HA-DR Deployment

Pre-Upgrade Validation

note

Kindly refer Upgrade Guide in case you need to upgrade Ubuntu 20 to Ubuntu 24.

note

Ensure there is no data sync backlog among Primary server, Secondary server, and Collector before proceeding to upgrade. Any data yet to be synced will be lost and cannot be recovered.

note

Ensure all servers are up and running. Once all servers are up and running, navigate to Motadata health monitoring screen to ensure all servers are operational and working as intended..

Applying Upgrade Patch

1. Take a VM Snapshot/Backup: Before proceeding with the upgrade, ensure you take a VM snapshot or backup of all servers.

2. Stop Motadata services on all servers in the following sequence: You will required to first stop services on Other Servers, then Primary App Server, and finally the Observer Server.

   sudo service motadata stop 

   sudo service motadata-observer stop

3. Perform a backup of Configuration files for all App servers: Ensure you create a backup for configuration files on all the App server (Primary App and Secondary App).

   sudo cp -r /motadata/motadata/config/ /tmp/ 

4. Remove JSON files from the temporary folder and create a tar file in the Primary App server:

   sudo rm /tmp/config/*json 

   sudo tar -cvf /tmp/config.tar /tmp/config/ 

5. Replicate the Config folder with non-JSON files from Primary App server to other App servers: You will need to copy the config folder containing non-JSON files to Secondary App server.

   sudo scp -r /tmp/config.tar motadata@<App_server_IP>:/tmp/ 

note

Kindly replace the <App_server_IP> placeholder with actual IP address of your App servers.

6. Overwrite the non-JSON files on other App servers: Execute the below-mentioned commands one by one on all other app servers Secondary App server.

   sudo tar -xvf /tmp/config.tar 

   sudo cp /tmp/tmp/config/* /motadata/motadata/config 

7. Perform the Upgrade on all Servers: You can now start upgrading all servers (Observer, Primary App. Primary DB, Secondary App, Secondary DB, and Collectors)

   • Download AIOPS_UPGRADE.zip: Download and place the AIOPS_UPGRADE.zip file in the /motadata directory on all servers.

   • Unzip the Upgrade Patch:

     unzip AIOPS_UPGRADE.zip

   • Run the Upgrade Script: After unzipping the patch, run the upgrade script:

     sudo ./aiops-upgrade.sh

Post-Upgrade Validation

note

Kindly wait for the python3 /motadata/motadata/metricagent/bootstrap.pyc to spawn on Primary App server before proceeding to next step.

sudo watch service motadata status

8. Start Motadata services on Observer server, Primary App server, and all other servers: Once the upgrade process has been completed, start the services on Motadata Observer server, then Primary App server, and then all other servers in the sequence.

sudo service motadata-observer start

sudo service motadata start

9. Verify all servers are up and running: Once all servers are up and running, navigate to Motadata health monitoring screen to ensure all servers are operational and working as intended.

Agent Upgrade (Ubuntu, Windows, RHEL/CentOS)

1. Download MOTADATA-MANAGER_UPGRADE.zip: Download the agent file from the above link and Upload the file on the Agent upgrade screen.
2. Run Compatibility Check: Click 'Run Compatibility Check' and then click on 'Upgrade Now' for the agent that need to be upgraded.
3. Wait for few moments: Kindly wait for a few moments for the upgrade to be completed.
4. Download the Agent Upgrade Zip: Download the appropriate agent upgrade zip from the above link corresponding to the OS version of your system.
5. Run Compatibility Check: Click 'Run Compatibility Check' and then click on 'Upgrade Now' for the agent that need to be upgraded.