Skip To Content

Install ArcGIS Monitor Agent

The following steps guide 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 administrative privileges and ensure that the user account has full permissions to the installation directory that will be created during the software installation.

    The default installation directory is /usr/lib/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. Optionally, create the ArcGIS Monitor account.

    The software installation automatically creates a service account for the ArcGIS Monitor account if one is not defined using the ARCGIS_USERNAME environment variable.

  6. 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.tar.gz.

  7. Change the directory to the location that contains the extracted setup file and make it an executable file.

    The following is an example:

    sudo chmod +x ArcGIS-Monitor-agent-<Version>-<deb or rpm>.bin.

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, complete the following steps:

  1. From the command shell, run ArcGIS-Monitor-agent-<Version>-<deb or rpm>.bin with elevated privileges.

    For example, use sudo ./ArcGIS-Monitor-agent-<Version>-<deb or rpm>.bin.

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

    Press Q to close the Master Agreement.

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

You can register ArcGIS Monitor Agent with Monitor Server.

Environment variables

To override the default username, group name, or installation location, you must add the following environment variables to the /etc/environment file before installing the software:

Environment variableDescription

ARCGIS_USERNAME=<Username>

<Username> specifies the ArcGIS Monitor account username. The default username is arcgis.

ARCGIS_GROUPNAME=<Group name>

<Group name> specifies the name of the group for the ArcGIS Monitor account. The default group name is arcgis.

ARCGIS_INSTALLDIR=<Directory>

<Directory> specifies the software installation location.

The path /arcgis/monitor/agent is appended to the installation directory.

The default installation location is /usr/lib/arcgis/monitor/agent.