Install ArcGIS Monitor Agent

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:

If you're upgrading from a previous version, see 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 for your Linux distribution.
   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. 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.

3. Verify that the machine meets the system requirements.
4. Verify that the sysstat package is installed on the Linux machine before installing Monitor Agent.
   The sysstat package is required for monitoring.
5. 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 proceed with the software installation.

Note:

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

Install the software

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

1. Start a terminal session with the ArcGIS Monitor account.
2. Change the directory to the location that contains the extracted setup file.
3. From the command shell, run Setup.sh.

   For example, use ./Setup.sh.

4. 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.

5. Follow the prompts on the screen to install the software.
6. After the installation has finished, run the following commands as the root user to configure the arcgis-monitor-agent service to automatically start with the operating system:

   cp <Monitor Agent installation location>/framework/etc/scripts/arcgis-monitor-agent.service  /etc/systemd/system/.
   chmod 600 /etc/systemd/system/arcgis-monitor-agent.service
   systemctl daemon-reload
   systemctl enable arcgis-monitor-agent
   systemctl start arcgis-monitor-agent

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

7. Verify that the arcgis-monitor-agent service is running, and start the service if necessary:
   1. Run the following command to check the status of the service:

      systemctl status arcgis-monitor-agent

   2. If the service is not running, run the following command as the root user to start the service:

      systemctl start arcgis-monitor-agent

You can register ArcGIS Monitor Agent with Monitor Server.