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 Window display.

Tip:

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

Note:

Upgrading from a previous version? Learn more about upgrading 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.

3. Verify that your machine meets the system requirements.
4. 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.

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

   For example, use tar -zxvf ArcGIS_Monitor.tar.gz.

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

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

You can now 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 now 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 variable	Description
ARCGIS_USERNAME=<Username>	<Username> specifies the name of 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/ is appended to the installation directory. The default installation location is /usr/lib/arcgis/monitor.