Tarball Installation

This topic describes how to install Moogsoft Enterprise 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 Enterprise.

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

For RPM installation steps, see RPM Installation.

Before you begin

Before you start to install Moogsoft Enterprise, complete all steps in Moogsoft Enterprise - Tarball pre-installation steps.

Install Moogsoft Enterprise

To complete a tarball installation of Moogsoft Enterprise v8.0.x, perform the following steps:

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

    • Download via a web browser from https://speedy.moogsoft.com/installer 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>@speedy.moogsoft.com/installer/moogsoft-enterprise-8.0.0.tgz"
  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:

      https://keys.openpgp.org/vks/v1/by-fingerprint/2529C94A49E42429EDAAADAEC7A2253BFC50512A 
    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-enterprise-8.0.0.tgz.sig file from the same 'speedy' path:

      curl -L -O "https://<username>:<password>@speedy.moogsoft.com/installer/moogsoft-enterprise-8.0.0.tgz.sig"
    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-enterprise-8.0.0.tgz.sig moogsoft-enterprise-8.0.0.tgz
    6. Confirm that the report states:

      Good signature from "Moogsoft Information Security Team "<security@moogsoft.com>"
  3. Unzip and untar the Moogsoft Enterprise distribution archive in your working directory:

    tar -xf moogsoft-enterprise-8.0.0.tgz

    The distribution archive contains the following files:

    • A README.txt file

    • The installation script: moogsoft-enterprise-install-8.0.0.sh

    • The distribution archive: moogsoft-enterprise-dist-8.0.0.tgz

  4. Run the Percona installation script:

    bash install_percona_nodes_tarball.sh

    The script guides you through the installation process.

    To configure a single database node on the same server as Moogsoft Enterprise use these settings:

    • Configure Percona as "Primary".

    • Do not set the server to "DB only".

    • Set the first database node IP address to the server IP address.

    • When prompted to enter the IP addresses of the second and third nodes, press Enter to skip these settings.

    Configure Percona as "Primary". Do not set the server to "DB only". Set the first database node IP address to the server IP address. When prompted to enter the IP addresses of the second and third nodes, press Enter to skip these settings.

  5. Source the bashrc file:

    source ~/.bashrc
  6. If the root user installs the tarball, Moogsoft Enterprise must not be installed in the /root directory

  7. Execute the installation script moogsoft-enterprise-install-8.0.0.sh in your working directory to install Moogsoft Enterprise.

    bash moogsoft-enterprise-install-8.0.0.sh

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

  8. 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 Enterprise

When the installation process is complete, initialize Moogsoft Enterprise 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. To initialize Moogsoft Enterprise, you run the initialization script moog_init.

    You can run this script with the -k flag to set processes (for example Percona, RabbitMQ, Moogfarmd) to automatically restart when you reboot the system. For example:

    $MOOGSOFT_HOME/bin/utils/moog_init.sh -kI <zone_name> -u root

    If you do not want to set these processes to automatically restart when you reboot the system, run this script without the -k flag. For example:

    $MOOGSOFT_HOME/bin/utils/moog_init.sh -I <zone_name> -u root

    If you then decide after you have finished the install that you want these processes to automatically restart after all, run:

    [ -z "$(crontab -l|grep process_keepalive.sh)" ] && (crontab -l; echo -e "*\t*\t*\t*\t* $MOOGSOFT_HOME/bin/utils/process_keepalive.sh 2>&1") | crontab -

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

    When asked if you want to change the configuration hostname, say yes and enter the public URL for the server.

    For more information see Configure Services to Restart.

  3. Restart Moogfarmd and Apache Tomcat:

    $MOOGSOFT_HOME/bin/utils/process_cntl moog_farmd restart
    $MOOGSOFT_HOME/bin/utils/process_cntl apache-tomcat restart

Configure Elasticsearch heap size

The minimum and maximum JVM heap sizes must be large enough to ensure that Elasticsearch starts.

See Finalize and Validate the Install for more information.

Enable the enhanced Content Security Policy (optional)

Allow access to external domains

Configure Moogsoft Enterprise for use with Safari

Run an unattended installation

Verify the installation

Change passwords for default users

Install Moogsoft Add-Ons

Moogsoft periodically releases add-ons to extend and enhance the core Moogsoft Enterprise functionality. For example, new Workflow Engine functions, new Workflow Engines, or Integrations tiles. All add-ons releases are cumulative and include the fixes from previous releases.

Once you have finished upgrading or installing Moogsoft Enterprise, you should install the Moogsoft Enterprise add-ons to ensure you have the latest version.

See Install Moogsoft Add-ons for more information on how to install the Moogsoft Enterprise add-ons.