Install ArcGIS Monitor Agent

The following steps guide you through the ArcGIS Monitor Agent installation process. You can install Monitor Agent using the installation wizard or perform a silent installation using the command line.

Tip:

The installation method that you use does not affect the uninstall process. For example, if you install from the command prompt window, you can uninstall using either the command prompt window or the wizard.

The workflow below guides you through the ArcGIS Monitor Agent installation process. You can install Monitor Agent using the interactive command line interface (CLI) or perform a silent installation. Performing an installation of Monitor Agent doesn't require an X display manager.

Tip:

The installation method that you use does not affect the uninstall process. For example, if you install from the interactive CLI, you can uninstall using either the interactive CLI or the command line.

Note:

To upgrade from a previous version, refer to Upgrade ArcGIS Monitor.

Prepare for the installation

Before you install Monitor Agent, complete the following steps:

1. Sign in to My Esri and download the software.

   1. Click the Downloads tab, and click All Products and Versions.

   2. Click the All Versions tab.

   3. Click View Downloads next to ArcGIS Monitor to download the software.

2. Sign in to My Esri and download the software for your Linux distribution by doing the following:

   1. Click the Downloads tab, and click All Products and Versions.

   2. Click the All Versions tab.

   3. Click View Downloads next to ArcGIS Monitor to download the software.

3. Verify that the machine meets the system requirements.

4. Verify that Microsoft PowerShell is installed and included in the Windows system PATH environment variable.

5. Verify that the optional Windows VBScript feature is enabled for installation.

   You can enable VBScript temporarily for installation and disable it afterward if required by your organization's security policy.

6. Create the ArcGIS Monitor account.

7. Verify that the sysstat package is installed on the Linux machine before installing Monitor Agent.

   The sysstat package is required for monitoring.

8. Start a terminal session with the ArcGIS Monitor account and ensure that the account has full permissions to the installation directory that will be created during the software installation.

   The default installation directory is <ArcGIS Monitor user account home directory>/arcgis/monitor/agent.

9. Change the directory to the location that contains the Monitor .tar.gz file and uncompress it.

   The following is an example:

   tar -zxvf ArcGIS_Monitor_Agent.tar.gz
   

You can now proceed with the Monitor Agent installation.

Install the software

To install Monitor Agent, complete the following steps:

Note:

You cannot install Monitor on a shared network directory (NFS mounted folder). The directory must be local on the target system.

To install Monitor Agent using the CLI, complete the following steps:

1. Browse to the location of the extracted setup files, and double-click Setup.exe.

2. During the installation, read the master agreement and accept it, or exit if you do not agree with the terms.

3. Use the Specify the account name and password option to specify the account to be used by Monitor Server to manage monitoring services.

   The account used can be a local account, domain account, or Managed Service Account. The account you specify does not need to be part of the Administrators group. If you use a Managed Service Account, the account must already be configured for the machine. If you use a local operating system account, the account is created automatically if it does not exist. The default account name is arcgis.

   Learn more about the ArcGIS Monitor account

   Note:

   Creating a local account during installation is primarily for the convenience of quickly installing Monitor. For production systems, it is recommended that you use an existing account that resides on the domain or in Active Directory that adheres to your organization's security policy.

   If you are using a domain account, it must already exist on the domain and be in the following format: mydomain\domainaccount.

4. Follow the directions on the screen to complete the installation.

5. Start a terminal session with the ArcGIS Monitor account.

6. Change the directory to the location that contains the extracted setup file.

7. From the command shell, run Setup.sh.

   For example, use ./Setup.sh.

8. During the installation, accept the Master Agreement, or exit if you do not agree with the terms.

   Tip:

   Press Q on your keyboard to close the Master Agreement.

9. Follow the prompts on the screen to install the software.

10. After the installation has finished, run the following command as a user in the sudoers group to configure the arcgis-monitor-agent service to automatically start with the operating system:

    sudo <Monitor Agent installation location>/framework/etc/scripts/create_Monitor_Agent_service.sh
    

    The default installation directory is <ArcGIS Monitor user account home directory>/arcgis/monitor/agent.

    The service is configured to start with the operating system and a message appears indicating the service's status. If the service is not running, run the following command as a user in the sudoers group to start the service:

    sudo systemctl start arcgis-monitor-agent
    

Once the software installation is complete, register Monitor Agent with Monitor Server.