Moogsoft Docs

Tarball installation

This topic describes how to install Moogsoft AIOps on a single host using the tarball archives, previously known as the non-root install.

Follow these steps if you do not have root access to the machine or machines on which you will install Moogsoft AIOps.

To install Moogsoft AIOps in a highly available distributed environment, see Distributed HA Installation.

For RPM installation steps, see Prepare for an RPM Installation.Prepare for an RPM Installation

Before you begin

Before you start to install Moogsoft AIOps, complete all steps in the following document:

v7.3.x - Tarball pre-installation steps.

Install Moogsoft AIOps

To complete a Tarball installation of Moogsoft AIOps v7.3.x, perform the following steps:

  1. Download the tarball installer, using one of the following options:

    • Download via a web browser from and user the Yum user credentials provided by Moogsoft support.

    • Use the following cURL command, substituting your "speedy" Yum repo user credentials:

      curl -L -O "https://<username>:<password>"
  2. Optional: GPG key validation of the Tarball

    For users wishing to validate the Tarball before installation, the following steps must be followed:

    1. Download the key from this site: 
    2. Copy the key to the server onto which the Tarball will be installed (it will be a .asc file)

    3. Import the key:

      gpg --import 2529C94A49E42429EDAAADAEC7A2253BFC50512A.asc
    4. Download the moogsoft-aiops-7.3.0.tgz.sig file from the same 'speedy' path:

      curl -L -O "https://<username>:<password>"
    5. Ensure both the tgz and the .sig file are both in the same folder, then copy the following command into a bash terminal and run it to perform the validation:

      gpg --verify moogsoft-aiops-7.3.0.tgz.sig moogsoft-aiops-7.3.0.tgz
    6. Confirm that the report states:

      Good signature from "Moogsoft Information Security Team "<>"
  3. Unzip and untar the Moogsoft AIOps distribution archive in your working directory:

    tar -xf moogsoft-aiops-7.3.0.tgz

    The distribution archive contains the following files:

    • A README.txt file

    • The installation script:

    • The distribution archive: moogsoft-aiops-dist-7.3.0.tgz

  4. Execute the installation script in your working directory to install Moogsoft AIOps.


    The script guides you through the installation process. The installation directory defaults to <working-directory>/Moogsoft. You can change this if you wish.

  5. Set the $MOOGSOFT_HOME environment variable to point to your installation directory, and add $MOOGSOFT_HOME/bin/utils to the path. For example:

    echo "export MOOGSOFT_HOME=~/moogsoft" >> ~/.bashrc
    echo "export PATH=$PATH:\$MOOGSOFT_HOME/bin/utils" >> ~/.bashrc && \
    source ~/.bashrc
Initialize Moogsoft AIOps

When the installation process is complete, initialize Moogsoft AIOps as follows:

  1. Configure the Toolrunner to execute locally by setting "execute_locally: true" in $MOOGSOFT_HOME/config/servlets.conf:

    sed -i 's/# execute_locally: false,/,execute_locally: true/1' $MOOGSOFT_HOME/config/servlets.conf
  2. Run the initialization script moog_init:

    $MOOGSOFT_HOME/bin/utils/ -qI <zone_name> -u root

    The script prompts you to accept the End User License Agreement (EULA) and guides you through the initialization process.

    The zone_name sets up a virtual host for the Message Bus. If you have multiple systems sharing the same bus, set a different zone name for each.

    To set processes to restart when the system is rebooted (Percona, RabbitMQ, Moogfarmd etc) use the -k flag. For example:

    $MOOGSOFT_HOME/bin/utils/ -k

    For more information see Configure Services to Restart.

  3. If you are deploying more than one database, configure HA Proxy to load-balance the database nodes. The following script requires root privileges. Run this script on any host running any Moogsoft AIOps components. Provide your "speedy" Yum repo user credentials when prompted:

    cat > << _EOF_
    echo "Please provide access credentials for the 'speedy' yum repository in order to download the Percona setup script"
    read -p "AIOps Repository Username: " AIOPS_USER
    export AIOPS_USER
    read -p "AIOps Repository Password: " -s AIOPS_PASS
    export AIOPS_PASS
    curl -L -O https://\$AIOPS_USER:\$ 2>/dev/null

    Then run the script:

  4. Restart Moogfarmd and Apache Tomcat:

    $MOOGSOFT_HOME/bin/utils/process_cntl moog_farmd restart
    $MOOGSOFT_HOME/bin/utils/process_cntl apache-tomcat restart
Run an unattended installation
Verify the installation
Change passwords for default users