You can install ArcGIS Monitor Agent 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 uninstallation process. For example, if you install from the command prompt window, you can uninstall using either the command prompt window or the wizard.
Note:
Upgrading from a previous version? Learn more about upgrading ArcGIS Monitor.
Prepare for the installation
Before you install Monitor Agent, do the following:
- Sign in to My Esri and download the software.
- Click the Downloads tab and click All Products and Versions.
- Click the All Versions tab.
- Click View Downloads next to ArcGIS Monitor to download the software.
- Verify that your machine meets the system requirements.
- Create the ArcGIS Monitor account.
You can now proceed with the Monitor Agent installation.
Installation through command line parameters
The following parameter is required when installing Monitor Agent 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 setup download>\setup.exe /qb ACCEPTEULA=yes ADDLOCAL=Agent
Once the software installation is complete, register Monitor Agent with Monitor Server.
Optional installation command line parameters
The following are optional Windows Installer command line parameters to be used when installing Monitor Agent silently. Use these commands to change the installation location of Monitor Agent.
- 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.
- ADDLOCAL=<software feature to install>
This parameter allows you to specify which software feature is installed. Values that can be assigned to the ADDLOCAL parameter are as follows:
- Server—Installs the Monitor Server feature
- Agent—Installs the Monitor Agent feature
Monitor Server is installed by default.
Use the following example to install Monitor Agent from the command line:
<path to the ArcGIS Monitor setup download>\setup.exe /qb ACCEPTEULA=yes INSTALLDIR=C:\<Installation location> ADDLOCAL=Agent USER_NAME=myaccount PASSWORD=my.password
Configure the ArcGIS Monitor account using command line parameters
The ArcGIS Monitor account must be configured when Monitor Agent is installed silently. For production systems, it is recommended that you designate an existing account that resides on your domain or in the Active Directory and 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 box 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 your 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 setup download>\setup.exe /qb ACCEPTEULA=yes ADDLOCAL=Agent USER_NAME=mydomain\mydomainaccount PASSWORD=my.password
Use a new or existing local account
<path to the ArcGIS Monitor setup download>\setup.exe /qb ACCEPTEULA=yes ADDLOCAL=Agent USER_NAME=myaccount PASSWORD=my.password
Use a Managed Service Account
<path to the ArcGIS Monitor setup download>\setup.exe /qb ACCEPTEULA=yes ADDLOCAL=Agent MSA=TRUE USER_NAME=mydomain\mymsa
Import ArcGIS Monitor account credentials using a configuration file
The two command line parameters below must be used together to import ArcGIS Monitor account credentials using a configuration file.
- ACCOUNT=UseConfigFile
Use the ACCOUNT command line parameter exactly as shown above. There are no other valid values for this parameter.
- CONFIGPATH=<full path and name of configuration file>
Used in conjunction with ACCOUNT=UseConfigFile, this parameter allows you to specify the configuration file that will be used to configure the ArcGIS Monitor account. Configuration files are created by exporting a configuration file when installing Monitor (earlier installations or from other machines).
Learn more about the ArcGIS Monitor account
Refer to the following example:
<path to the ArcGIS Monitor setup download>\setup.exe /qb ACCEPTEULA=yes ADDLOCAL=Agent ACCOUNT=UseConfigFile CONFIGPATH=\\networkmachine\serverconfigs\standardaccount.xml
Caution:
Command line parameters are case sensitive. If the command line installation isn't working, ensure that the case matches the parameters as shown in the examples.
Export ArcGIS Monitor account credentials to a configuration file
Caution:
When exporting a configuration file to a network share, the LocalSystem account on the machine where Monitor Agent is being installed must have write permissions to the network share. For example, if you're installing on a machine named Quick, the LocalSystem account on Quick must have write permission to the network share. If permissions are not set, the configuration file may not be exported successfully. If you are unsure how to correctly set permissions for the network share, contact your system administrator or export the configuration file locally and copy it to the network share.
The two command line parameters below must be used together to export ArcGIS Monitor account credentials to a configuration file.
- EXPORTCONFIG=Yes
Use this parameter to export the account information provided with the USER_NAME and PASSWORD command line parameters. The account information is stored in an encrypted .xml file, known as a configuration file. This parameter is set to No by default.
- CONFIGPATH=<full path and name of configuration file>
Used in conjunction with EXPORTCONFIG=Yes, this parameter allows you to define the name of the configuration file and the location where it is stored. The file name must end with .xml and the specified folder must already exist. If the file does not have an .xml extension and the specified directory does not already exist, the configuration file creation may not be successful.
Refer to the following example:
<path to the ArcGIS Monitor setup download>\setup.exe /qb ACCEPTEULA=yes ADDLOCAL=agent EXPORTCONFIG=Yes CONFIGPATH=\\myserver\secure\config.xml
Caution:
Command line parameters are case sensitive. If the command line installation isn't working, ensure that the case matches the parameters as shown in the examples.