Skip To Content

Installing ArcGIS for Server silently

The following steps guide you through the ArcGIS for Server silent installation process on one machine. Performing a silent installation of ArcGIS for Server doesn't require an X display or user interaction during the installation process. If you're installing ArcGIS for Server on multiple machines, see the instructions in Installing ArcGIS for Server on multiple machines.

Note:

Upgrading to 10.4.1? For more information, see Existing ArcGIS for Server users.

How to prepare to install ArcGIS Server

  1. Obtain an authorization file for the machine on which you're installing ArcGIS Server.
  2. Verify that your site meets the system requirements.
  3. Make sure the user has full permissions to the ArcGIS Server installation directory. The user account used to install ArcGIS Server will be the account used to run the software. Group users and all others must have at least execute permissions to the ArcGIS Server installation directory. Note that installing ArcGIS Server with the root account is not supported. For more information, see The ArcGIS Server account.
  4. Navigate to the directory where the ArcGIS Server tar file was uncompressed, or insert the ArcGIS Server media into the appropriate drive and browse for Setup to launch the setup program.
Note:

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

How to install ArcGIS for Server silently

The instructions below describe how to install ArcGIS for Server silently from the command line. For instructions on installing ArcGIS for Server from the setup user interface, see Installing ArcGIS for Server on one machine.

Tip:

The installation mode that you choose will determine the default uninstallation mode. For example, if you choose to install silently from the command line, the uninstallation will default to uninstalling silently from the command line.

  1. Before beginning the installation, read the license agreement located at <CD_ROOT or untar directory>/Documentation/EULA.pdf and accept the terms.
  2. Run the setup silently and authorize by passing an authorization (.ecp) or a provisioning (.prvc) file. See sample syntax shown below:

    <CD_ROOT or untar directory>/Setup -m silent -l yes -a <fullpath to .ecp or .prvc file>

    Usage: Setup [Options]

    OptionDescription

    -m; --mode MODE

    Optional. Defaults to GUI.

    MODE is one of silent, console, or gui.

    -l; --license-agreement CHOICE

    Required for silent mode. CHOICE is either Yes or No.

    Yes indicates that you have read and agreed to the Esri License Agreement (E204, E300). Visit Licensing Terms of Use to read the license agreement.

    -a; --authorization-file FULL_PATH_TO_AUTHORIZATION_FILE or FULL_PATH_TO_PROVISIONING_FILE

    Optional. If this option is not used, you will need to authorize the software after installation.

    FULL_PATH_TO_AUTHORIZATION_FILE is the full, absolute path to the authorization (.ecp) file provided by Esri.

    FULL_PATH_TO_PROVISIONING_FILE is the full, absolute path to the provisioning (.prvc) file provided by Esri.

    -d; --directory DIRECTORY

    Optional. By default, ArcGIS for Server is installed to your $HOME directory. DIRECTORY specifies a different installation directory.

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

    The name of the installation directory should be lowercase. The samples and data bundled with the installation require the data path to be lowercase.

    -v; --verbose

    Installer runs in verbose mode.

    -h; --help

    Displays command line help and exits.

    -e; --examples

    Displays usage examples of these options and exits.

    Note:

    The authorization tool can also be launched silently after ArcGIS for Server has been installed. For a complete list of available parameters, run the authorization script with the help parameter as shown below (based on default install location):

    ${HOME}/arcgis/server/tools/authorizeSoftware --help

    For a more detailed information about the authorization tool, seeAuthorizing ArcGIS for Server silently below.

  3. Once the installation finishes, the installation status message appears. If the installation completed successfully, you will be able to access ArcGIS Server Manager from Firefox or any supported web browser by browsing to http://<server name>:6080/arcgis/manager. See the ArcGIS Server help for more information.
  4. If you are preparing your site for a production deployment, you should install the ArcGIS Web Adaptor. The Web Adaptor provides a link between your enterprise web server and your ArcGIS Server site. It allows you to choose the port, address, and authentication settings that you want to use for incoming requests. It also prevents outside users from accessing Manager and the Administrator Directory. For more information, see About the ArcGIS Web Adaptor.
  5. Most of your work publishing services occurs in ArcGIS for Desktop, where you create your maps, globes, geodatabases, and so forth. To publish a service directly from ArcGIS for Desktop, define a connection to your server using ArcCatalog or the Catalog window in ArcMap. Once you've done this, the connection information is saved on your machine and you can then reference it whenever you want to publish a service. If you make the connection with administrative privileges, you can also perform some server administration functions from ArcGIS for Desktop. See Making an administrative connection to ArcGIS Server in ArcGIS for Desktop for instructions.
  6. Ensure that ArcGIS Server can access all the data referenced by its services. For more information, see Making your data accessible to ArcGIS Server.
  7. With a connection to the server established, you can begin publishing your GIS resources as services. To add a service, follow the directions in How to publish a service.
  8. Once you add services to your GIS server, you can use them in many types of applications. These include applications that you create with the ArcGIS Web APIs and Native SDKs, or Configurable Apps and App Builders. Alternatively, you can view services in desktop-based applications, such as ArcGIS Explorer, ArcMap, or ArcGlobe. Mobile devices, such as the iPhone, Android devices, and Windows Phone, can also use your GIS services. See About creating web GIS applications to get started.

Authorizing ArcGIS for Server silently

The authorization tool can also be launched silently after ArcGIS for Server has been installed. For a complete list of available parameters, run the authorization script with the help parameter as shown below (based on the default installation location):

${HOME}/arcgis/server/tools/authorizeSoftware --help

Usage: authorizeSoftware [options]

OptionDescription

none

Software Authorization Wizard GUI will be run.

-s

Displays authorization status.

-f FULL_PATH_TO_ECP_AUTHORIZATION_FILE

Authorizing with an ecp authorization file.

FULL_PATH_TO_ECP_AUTHORIZATION_FILE is the full, absolute path to the authorization (.ecp) file provided by Esri.

-f FULL_PATH_TO_PROVISIONING_FILE -e EMAIL_ADDRESS

Authorizing with a provisioning file. An email address is required.

FULL_PATH_TO_PROVISIONING_FILE is the full, absolute path to the provisioning (.prvc) file provided by Esri.

EMAIL_ADDRESS is required to authorize using a provisioning file.

-f FULL_PATH_TO_PROVISIONING_FILE -e EMAIL_ADDRESS -o AUTHORIZATION_FILE_OUTPUT

Generates an authorization file to be uploaded to Esri's website or email. Once completed, run this tool again using the received ecp authorization file to complete the authorization process for this product.

FULL_PATH_TO_PROVISIONING_FILE is the full, absolute path to the provisioning (.prvc) file provided by Esri.

EMAIL_ADDRESS is required to authorize using a provisioning file.

AUTHORIZATION_FILE_OUTPUT is the output file generated which needs to be sent to the Esri Customer Service website (https://service.esri.com/drm) or an email to authorize@esri.com.

For more information, see Authorizing in a disconnected network environment and with no display set (headless).

-h;

Displays command line help and exits.

Authorizing in a disconnected network environment and with no display set (headless)

Starting at 10.2.1, installing ArcGIS for Server in a disconnected network environment with no display set (headless) can now be authorized using a provisioning (.prvc) file. This is a two-step process.

  1. At the prompt, run the authorization command provided below after a successful installation of ArcGIS for Server.

    <ArcGIS for Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file>  -e <email address> -o <full path to authorization file output>

    Once the authorization information file output has been created, do one of the following:

    • Browse to the Esri Customer Service website (https://service.esri.com/drm). Follow the instructions on the screen to upload your authorization information file and download your ecp authorization file.
    • Send your authorization information file by email to authorize@esri.com. Esri will send your ecp authorization file back to you in an email.
  2. Once you receive your ecp authorization file using either of the above methods, run the authorizeSoftware script again to process it and complete the server authorization process:

    <ArcGIS for Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>

Post-installation configuration

If you want ArcGIS Server to start with the operating system, complete the steps specific to your operating system.

Operating systems that support systemd

Note:

This workflow is applicable for 10.4.1 only.

If your operating system supports the use of systemd to bootstrap and manage processes (for example, if you are using Red Hat 7.x), follow these steps to configure ArcGIS Server to start with the operating system.

  1. Within a command shell, switch to root user.
  2. Copy <ArcGIS Server installation directory>/framework/etc/scripts/arcgisserver.service unit file to /etc/systemd/system.

    This file is installed with ArcGIS 10.4.1 for Server.

  3. Still as root user, run the following command to automatically create the links in /etc/systemd/system/multi-user.target.wants:
    # systemctl enable arcgisserver.service
  4. To verify that the systemd service is properly configured, restart the service and check its status.
    # systemctl stop arcgisserver.service
    # systemctl start arcgisserver.service
    # systemctl status arcgisserver.service
  5. End the root user session.
  6. Reboot the operating system and verify that ArcGIS Server restarts properly.

Operating systems that support SysV

If your operating system supports the use of SysV to bootstrap and manage processes, follow these steps to configure ArcGIS Server to start with the operating system.

  1. Within a command shell, switch to root user.
  2. Copy <ArcGIS Server installation directory>/framework/etc/scripts/arcgisserver shell script to the appropriate supported Linux distribution-based locations provided below:
    • RHEL: /etc/rc.d/init.d/
    • SUSE: /etc/init.d/
  3. Change directory to the applicable init.d folder and check the arcgisserver script to make sure that root has at least read and execute permissions.
  4. Edit the arcgisserver script as follows:
    1. Update the agshome variable to the ArcGIS Server installation directory, for example, /home/username/arcgis/server.

    2. For RHEL only, add the line below just before # Description: ArcGIS Server Service:

      # chkconfig: 35 99 01

    3. Save the edits to the arcgisserver script.

  5. Still as root user, run the following command to automatically create the links in /etc/rc*.d with the appropriate run levels:
    • RHEL:
      $ chkconfig --add arcgisserver
      $ chkconfig arcgisserver on
    • SUSE:
      $ insserv arcgisserver
      $ chkconfig arcgisserver on
  6. End the root user session.
  7. Reboot the operating system and verify that ArcGIS Server restarts properly.