ArcGIS Server can be installed without a user interface by running the setup using Windows Installer command line parameters.
Note:
Upgrading to 10.7? For more information, see Frequently asked upgrading questions.
Requirements
- ArcGIS Server requires Microsoft Core XML Services (MSXML) 6.
- The .NET Extension Support feature requires Microsoft .NET Framework 4.5. If Microsoft .NET Framework 4.5. is not found, the .NET Extension Support feature will not be available for installation.
For more information, see System requirements.
Installation location command line parameters
The following are the Windows Installer command line parameters to be used when installing ArcGIS Server silently. Use these commands to change the installation location of ArcGIS Server or the installation location of Python.
INSTALLDIR=<installation location>
This property allows you to specify the installation location of ArcGIS Server from the command line. If you do not set this property, the default installation location of C:\Program Files\ArcGIS\Server\ is used.
INSTALLDIR1=<installation location for Python>
This property allows you to specify the installation location of Python from the command line. If you do not set this property, the default location for this feature is \Python27 on the local drive with the most available disk space.
For example:
<path to the ArcGIS Server setup download>\setup.exe /qb INSTALLDIR=C:\NewServerDir INSTALLDIR1=C:\NewPythonDir
Configuring the ArcGIS Server account using command line parameters
The ArcGIS Server account must be configured when ArcGIS Server is installed silently. For production systems, it is recommended that you designate a preexisting account that resides in your domain or Active Directory and follows your organization's security policy. If command line parameters are not used to configure the ArcGIS Server account during silent installations, the account will be set to the Local System account. This is primarily for the convenience of quickly installing ArcGIS Server.
Note:
The ArcGIS Server account can be changed at a later time by running the Configure ArcGIS Server Account utility. The utility is available at Start > ArcGIS > ArcGIS Server > Configure ArcGIS Server Account. When prompted, enter the name and password for the account that will be used by ArcGIS Server. The option is available to save a configuration file with this information to speed up the configuration process on other ArcGIS Server machines and reduce the chance of inadvertently typing a wrong name or password. While the account password is encrypted, be sure to store the configuration file in a secure location.
Use the command line parameters below to configure the ArcGIS Server account.
Passing ArcGIS Server account credentials directly
Caution:
If the ArcGIS Server account is not defined during a silent (/qb) installation, or the credentials are not valid, the ArcGIS Server setup displays a warning message during installation. The message can be closed by clicking OK. Under these circumstances, the ArcGIS Server account is set to the Local System account.
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 will be created if it does not already exist. If the account is not valid, a message box will appear during installation indicating the account and/or password is invalid.
PASSWORD=<account password>
Password for the account specified for the USER_NAME parameter. If the password is not valid, a message box will appear during installation indicating the account and/or password is invalid.
For example:
Using a domain account
<path to the ArcGIS Server setup download>\setup.exe /qb USER_NAME=mydomain\mydomainaccount PASSWORD=my.password
Using a new or existing local account
<path to the ArcGIS Server setup download>\setup.exe /qb USER_NAME=myaccount PASSWORD=my.password
Caution:
Command line parameters are case sensitive. If you are having trouble getting your command line installation working, confirm the case matches the properties as shown in the examples.
Importing ArcGIS Server account credentials using a server configuration file
The two command line parameters below must be used together to import ArcGIS Server account credentials using a server configuration file.
ACCOUNT=UseConfigFile
Use the ACCOUNT command line parameter exactly as shown above. There are no other valid values for this property.
CONFIGPATH=<full path and name of server configuration file>
Used in conjunction with ACCOUNT=UseConfigFile, this property allows you to specify the server configuration file that will be used to configure the ArcGIS Server account. Server configuration files are created by exporting a server configuration file when installing ArcGIS Server (earlier installations or from other machines). For more information, see The ArcGIS Server account.
For example:
<path to the ArcGIS Server setup download>\setup.exe /qb ACCOUNT=UseConfigFile CONFIGPATH=\\networkmachine\serverconfigs\standardaccount.xml
Caution:
Command line parameters are case sensitive. If you are having trouble getting your command line installation working, confirm the case matches the properties as shown in the examples.
Exporting ArcGIS Server account credentials to a server configuration file
Note:
When exporting a server configuration file to a network share, the Local System account on the machine where ArcGIS Server is being installed must have write permissions to the network share. For example, if you're installing ArcGIS Server on a machine named Quick, the Local System account on Quick must have write permission to the network share. If the permissions are not set, the server 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 server configuration file locally and copy it to the network share.
The two command line parameters below must be used together to export ArcGIS Server account credentials to a server configuration file.
EXPORTCONFIG=Yes
Use this property to export the account information entered with the USER_NAME and PASSWORD command line parameters. The account information will be stored in an encrypted XML file, known as a server configuration file. This property is set to No by default.
CONFIGPATH=<full path and name of server configuration file>
Used in conjunction with EXPORTCONFIG=Yes, this property allows you to define the name of the server configuration file and the location where it will be 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 server configuration file creation may not be successful.
For example:
<path to the ArcGIS Server setup download>\setup.exe /qb EXPORTCONFIG=Yes CONFIGPATH=\\networkmachine\serverconfigs\standardaccount.xml
Caution:
Command line parameters are case sensitive. If you are having trouble getting your command line installation working, confirm the case matches the properties as shown in the examples.
Using the createsite command line utility to create an ArcGIS Server site
At 10.6, you can use the createsite command line utility to create a new ArcGIS Server site once ArcGIS Server has been installed. Two options available for using the createsite utility are as follows:
- Run the createsite utility as an administrator from a command prompt and specify user name, password, config-store, and directory parameters.
- Provide a createsite.properties file containing specified parameters.
For the usage of the createsite command line utility, run the createsite.bat script with -h or -help as shown below:
<ArcGIS Server Installation Directory>\tools\createsite\createsite.bat -help
Example usage with the utility: createsite.bat [-u <arg>] [-p <arg>] [-d <arg>] [-c <arg>]
Example usage using a file: createsite.bat [-f <FILE>]
Note:
When you reference a path in the createsite.properties file, you need to escape the backslash. For example: C:\\arcgisserver\\config-store, or \\\\<Absolute path to>\\<Server config-store>.
Option | Description |
---|---|
-u; --username | User name for the primary site administrator. User name cannot contain the following characters: \/:*?|<>" |
-p; --password | Password for the primary site administrator. Password cannot contain the following characters: \/:*?|<>" |
-d; --directory | Root server directory. By default, the server directories will be created locally at this location: C:\\arcgisserver\\directories or \\\\<Absolute path to>\\<Server directories> |
-c; --configstore | Configuration store for ArcGIS Server site. By default, the configuration store will be created locally at this location: C:\\arcgisserver\\config-store or \\\\<Absolute path to>\\<ArcGIS Server config-store> |
-f; --file | Properties file for the createsite utility. By default, the createsite.properties file can be found at this location: <ArcGIS Server Installation Directory>\tools\createsite |
-h; --help | Displays command line help and exits. |
An example of the createsite.properties file:
#
# Configuration properties for Server site creation
#
# User name for primary site administrator.
# Cannot contain these characters: \/:*?<>"
SERVER_ADMIN_USERNAME =
# Password for primary site administrator.
# Cannot contain these characters: \/:*?<>"
SERVER_ADMIN_PASSWORD =
# Initially, leave SERVER_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and SERVER_ADMIN_PASSWORD_ENCRYPTED will change to true.
SERVER_ADMIN_PASSWORD_ENCRYPTED = false
# Root server directory. By default, the server directories will be created locally,
# e.g.C:\\arcgisserver\\directories, or \\\\<Absolute path to>\\<Server directories>.
SERVER_DIRECTORIES_PATH =
# Configuration store for the ArcGIS Server site. By default, the configuration store will be created locally,
# e.g. C:\\arcgisserver\\config-store, or \\\\<Absolute path to>\\<Server config-store>.
SERVER_CONFIGSTORE_PATH =
You will receive a message that the ArcGIS Server site is created successfully before the tool exits.
Authorizing ArcGIS Server silently
Run the following command to authorize ArcGIS Server silently, editing the command line where necessary to reflect the actual authorization file location:
<System disk drive>\Program files\Common files\ArcGIS\bin\SoftwareAuthorization.exe /S /Ver 10.6 /LIF <path to .prvc authorization file>authorizationfile.prvc
Note:
The .prvc authorization file must have all user information completed before running the command to authorize ArcGIS Server silently. Open the authorization file in a text editor, and complete the User Information section.
Silently uninstall ArcGIS Server
For ArcGIS Server 10.7
Run this command from the command line:
msiexec /x {98D5572E-C435-4841-A747-B4C72A8F76BB} /qb
For ArcGIS Server 10.6.1
Run this command from the command line:
msiexec /x {F62B418D-E9E4-41CE-9E02-167BE4276105} /qb
For ArcGIS Server 10.6
Run this command from the command line:
msiexec /x {07606F78-D997-43AE-A9DC-0738D91E8D02} /qb