Page tree
Skip to end of metadata
Go to start of metadata


Backup Existing System

  1. Backup $MOOGSOFT_HOME.
  2. Take a snapshot (for VMs).
  3. Backup MySQL.

Stop Services and Processes

  1. moog_farmd: 

    service moogfarmd stop
  2. apache-tomcat: 

    service apache-tomcat stop
  3. LAMs. Either via their service scripts:

    service <lam_service_name> stop

    Alternatively, stop their running processes using:

    kill <pid>
  4. Ensure all the above processes have been stopped before continuing:

    service <service_name> status
  5. Disable the events_analyser from running during the upgrade process:

    1. Run the following command to comment out the relevant lines in crontab:

      (crontab -l | sed -e 's/^\(.*events_analyser.*\)$/#\1/') | crontab -
    2. Run the following command to stop any running events_analyser processes:

      ps -ef | grep java | egrep 'events_analyser|moog_indexer' | awk '{print $2}' | xargs kill 2>/dev/null

Upgrade AIOps

Upgrade Mechanism

  1. Single host from a remote repository:

    yum upgrade moogsoft-db-6.2.3 moogsoft-lams-6.2.3 moogsoft-mooms-6.2.3 moogsoft-search-6.2.3 moogsoft-server-6.2.3 moogsoft-ui-6.2.3 moogsoft-utils-6.2.3 moogsoft-common-6.2.3
  2. Single host from same machine (assumes the RPMs have been downloaded locally and are in the current folder):

    yum upgrade moogsoft-*6.2.3*.rpm
  3. Distributed installs: select the relevant update commands to run depending on which package(s) are installed on the current host. For example:

    1. HOST1:

       yum upgrade moogsoft-server-6.2.3 moogsoft-ui-6.2.3
    2. HOST2:

       yum upgrade moogsoft-db-6.2.3 moogsoft-search-6.2.3
    3. HOST3:

       yum upgrade moogsoft-lams-6.2.3 moogsoft-utils-6.2.3 moogsoft-mooms-6.2.3

Merge Latest Config File Changes

'.rpmsave' versions of files will need to be manually merged/compared with the new versions of those files (any new properties should be added to the older versions of the files).

The following files have been changed:

  • /usr/share/moogsoft/config/moog_farmd.conf
  • /usr/share/moogsoft/config/servlets.conf
  • /etc/nginx/conf.d/moog-ssl.conf

An example of the process to do this:

  1. Rename the new versions of the files (without the .rpmsave extension) to end with '.bak'.
  2. Merge the .rpmsave file with the new '.bak' file by adding new properties/config where needed so the structure matches the new version of the file.
  3. Rename the .rpmsave file to delete the '.rpmsave' extension.

Upgrade the AIOps schema 

  • Scripted (suitable for single host upgrade): 

    $MOOGSOFT_HOME/bin/utils/ -m $MOOGSOFT_HOME/etc/moog/schema_upgrades/6.2.2-6.2.3/623_moogdb_upgrade_all.sql -r $MOOGSOFT_HOME/etc/moog/schema_upgrades/6.2.2-6.2.3/623_moog_reference_upgrade_all.sql
  • OR Manual (replace 'moogdb' and 'moog_reference' database names as appropriate): 

    mysql -h localhost -P 3306 -u root moogdb < $MOOGSOFT_HOME/etc/moog/schema_upgrades/6.2.2-6.2.3/623_moogdb_upgrade_all.sql
    mysql -h localhost -P 3306 -u root moog_reference < $MOOGSOFT_HOME/etc/moog/schema_upgrades/6.2.2-6.2.3/623_moog_reference_upgrade_all.sql

Upgrade the Apache-Tomcat Webapps

Scripted (recommended for standard/single-host installs): 

$MOOGSOFT_HOME/bin/utils/ -w
  • If tomcat startup/shutdown failures are reported (such as: Web apps are not rebuilding, please check catalina.out) when running the above command then tomcat should be forcibly shutdown (using kill -9 on the apache-tomcat java PID) then the step repeated

Alternative manual steps:

  1. Stop apache-tomcat: service apache-tomcat stop
  2. Check the apache-tomcat java process is no longer running: service apache-tomcat status
  3. Delete the existing extracted webapps: rm -rf /usr/share/apache-tomcat/webapps/{moogpoller,moogsvr,toolrunner,graze,events}
  4. Copy in the new webapp WAR files (and replace the old ones): cp -f $MOOGSOFT_HOME/lib/{moogpoller,moogsvr,toolrunner,graze,events}.war $APPSERVER_HOME/webapps/
  5. Restart apache-tomcat: service apache-tomcat start


The following command needs to be run to extract Integrations and SolutionPaks:

bash $MOOGSOFT_HOME/bin/utils/integration_installer -a -l WARN

: If the images for some Integrations are not visible post-upgrade, the following script can be run to replace the broken image links in the database:

bash $MOOGSOFT_HOME/etc/moog/schema_upgrades/6.1.0_ESR5-6.2.0_ESR6/

Update nginx with new security configuration

The following command needs to be run to add the following line into /etc/nginx/conf.d/moog-ssl.conf:

  • add_header X-Frame-Options SAMEORIGIN;
sed -i 's/\(ssl_protocols.*;\).*/\1\nadd_header X-Frame-Options SAMEORIGIN;/' /etc/nginx/conf.d/moog-ssl.conf

Then restart nginx:

service nginx restart

Confirm all services are running and start moogfarmd

Check all required services are running and start moogfarmd by entering these commands:

service apache-tomcat status
service moogfarmd start
service nginx status
service elasticsearch status

Re-enable the events_analyser cronjobs using the following command:

(crontab -l | sed -e 's/^\#\+\(.*events_analyser.*\)/\1/') | crontab -

Any previously running integrations can be restarted using the following command:

service moogstartupd restart


Manual Verification of Upgrade

Carry out the following basic steps to ensure the upgrade to 6.2.3 was successful:

  • Ensure the $MOOGSOFT_HOME/etc/VERSION.txt file contains just "6.2.3"
  • Check that the last entry in the moogdb.schema_upgrades table in MySQL is the 6.2.3 upgrade entry
  • Check that the UI login page displays "Version 6.2.3" at the top
  • Check that the UI "Support Information" window correctly indicates the current version as 6.2.3 and shows the correct schema upgrade history
  • Integrations: If any of the Integrations images are not displaying, please see the 'Integrations' section above and run the final optional step/command.

Automated Verification of Upgrade

Confirm all Moog files have been deployed correctly within $MOOGSOFT_HOME using this utility:


Confirm all apache-tomcat files have been deployed correctly within $MOOGSOFT_HOME using this utility:


Confirm that all the steps are successful. If there are some webapp differences then this can be resolved using -w which will extract the webapps with the right files.

If there are only hostname-related differences in the apache-tomcat server.xml file then these can be safely ignored.

Confirm the schema has been upgraded successfully:


Confirm that all the steps are successful.

If there are some schema differences, they may be valid (e.g.: custom_info related) but if there are more substantial differences then it would be worth investigating further to check if all the pre-requisite upgrade scripts have been applied in the right order:

mysql -u root <moogdb_database_name> -e "select * from schema_upgrades;"
mysql -u root <moog_reference_database_name> -e "select * from schema_upgrades;"


If you have an issues please refer to Troubleshooting.
  • No labels