Install ArcGIS Monitor Server silently

You can install ArcGIS Monitor Server without a user interface by running the setup using Windows Installer command line parameters.

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 Server silent installation process. Performing a silent installation of Monitor Server doesn't require an X display manager or user interaction during the installation process.

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

Sign in to My Esri and download the software and authorization file.
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.
4. Click the Licensing tab, and click Start Licensing.
5. Click Other Products to download the ArcGIS Monitor license file.
Sign in to My Esri and download the software for your Linux distribution and authorization file 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.
4. Click the Licensing tab, and click Start Licensing.
5. Click Other Products to download the ArcGIS Monitor license file.
Verify that the machine meets the system requirements.

Note:

You must install or configure a database instance for the Monitor repository before you install Monitor.
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.
Create the ArcGIS Monitor account.
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/server.
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_Server.tar.gz

You can now proceed with the Monitor Server installation.

Note:

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

Installation through command line parameters

The following parameter is required when installing Monitor Server silently:

ACCEPTEULA=yes

This parameter is required to accept the End User License Agreement (EULA) during a silent installation. Specify yes to agree to the EULA and install the software. Specifying no or omitting this parameter results in a failed installation. For more information, review the Master Agreement.

Refer to the following example:

<path to the ArcGIS Monitor Server setup download>\setup.exe /qb ACCEPTEULA=yes

Once the software installation is complete, use the Software Authorization wizard to authorize ArcGIS Monitor Server.

Optional installation command line parameters

The following are optional Windows command line parameters to be used when installing Monitor Server silently. Use these commands to change the installation location of Monitor Server.

INSTALLDIR=<installation location>

This parameter allows you to specify the installation location of Monitor Agent from the command line. If you do not set this parameter, the default C:\Program Files\ArcGIS\Monitor installation location is used.

Use the following example to install Monitor Server from the command line:

<path to the ArcGIS Monitor Server setup download>\setup.exe /qb ACCEPTEULA=yes INSTALLDIR=C:\<Installation location> USER_NAME=myaccount PASSWORD=my.password

Configure the ArcGIS Monitor account using command line parameters

The ArcGIS Monitor account must be configured when Monitor is installed silently. 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 command line parameters are not used to configure the ArcGIS Monitor account during silent installations, the account is set to the LocalSystem account. This is primarily for the convenience of quickly installing Monitor.

Use the command line parameters below to configure the ArcGIS Monitor account.

Pass the ArcGIS Monitor account credentials directly

Caution:

If the ArcGIS Monitor account is not defined during a silent (/qb) installation, or the credentials are not valid, the Monitor setup displays a warning message during installation and fails.

USER_NAME=<operating system account>

The account can be a domain account or a local account. If you are using a domain account, it must already exist. If you are using a local account, the account is automatically created if it does not exist. If the account is not valid, a message appears during installation indicating the account or password is invalid.

MSA=TRUE

This parameter should only be used with a Managed Service Account. A Managed Service Account must already exist on the domain. Do not use this parameter with a local account or a domain account with a password. A Managed Service Account does not use the PASSWORD parameter.

PASSWORD=<account password>

This is the password for the account specified for the USER_NAME parameter. If the password is not valid, a message box appears during installation indicating this.

Refer to the examples below.

Caution:

Command line parameters are case sensitive. If the command line installation isn't working, ensure that the case matches the properties as shown in the examples.

Use a domain account

<path to the ArcGIS Monitor Server setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=mydomain\mydomainaccount PASSWORD=my.password

Use a new or existing local account

<path to the ArcGIS Monitor Server setup download>\setup.exe /qb ACCEPTEULA=yes USER_NAME=myaccount PASSWORD=my.password

Use a Managed Service Account

<path to the ArcGIS Monitor Server setup download>\setup.exe /qb ACCEPTEULA=yes MSA=TRUE USER_NAME=mydomain\mymsa

Install the software silently

To install Monitor Server silently, complete the steps below. For instructions on installing Monitor Server from the interactive command line interface (CLI), refer to Install ArcGIS Monitor Server.

Before beginning the installation, read the Esri Master Agreement.
Start a terminal session with the ArcGIS Monitor account.
Change the directory to the location that contains the extracted setup file.

From the command shell, run Setup.sh.

For example, use ./Setup.sh -l yes [options].

Option	Description
-l; --license-agreement CHOICE	This property is required to accept the End User License Agreement (EULA) during a silent installation. Specify yes to agree to the EULA and install the software. Specifying no or omitting this property will result in a failed installation. The download contains a PDF of the End User License Agreement. The `EULA.pdf` file is in the `Documentation` folder.
-d; --directory DIRECTORY	Optional. By default, Monitor Server is installed to the $HOME directory. DIRECTORY specifies a different installation directory. The path `/arcgis/monitor/server` is appended to the installation directory.
-h; --help	Displays command line help and exits.

Option

Description

-l; --license-agreement CHOICE

This property is required to accept the End User License Agreement (EULA) during a silent installation. Specify yes to agree to the EULA and install the software. Specifying no or omitting this property will result in a failed installation. The download contains a PDF of the End User License Agreement. The EULA.pdf file is in the Documentation folder.

-d; --directory DIRECTORY

Optional. By default, Monitor Server is installed to the $HOME directory. DIRECTORY specifies a different installation directory.

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

-h; --help

Displays command line help and exits.

After the installation has finished, run the following command as a user in the sudoers group to configure the arcgis-monitor-server service to automatically start with the operating system:
```
sudo <Monitor Server installation location>/framework/etc/scripts/create_Monitor_Server_service.sh
```
The default installation directory is <ArcGIS Monitor user account home directory>/arcgis/monitor/server.

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-server
```

You can authorize Monitor.