Skip To Content

Install ArcGIS Server on one machine

The following steps guide you through the ArcGIS Server installation process on one machine using the setup user interface. If you're installing ArcGIS Server on multiple machines, see the instructions in Install ArcGIS Server on multiple machines.

Note:

Upgrading to 10.8? For more information, see Frequently asked upgrading questions.

How to prepare to install ArcGIS Server

Follow these steps before beginning the installation process for 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 Server

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

Tip:

The installation mode that you choose will determine the default uninstallation mode. For example, if you choose to install from the setup user interface, the uninstallation will default to the user interface mode.

  1. The setup program begins by checking the prerequisites that must be met to successfully set up and use ArcGIS Server. If all the prerequisites are met, the Introduction dialog box displays. Click Next to proceed.
  2. On the Master Agreement dialog box, read the master agreement. If you accept the terms, select the I accept the master agreement button and click Next to proceed; otherwise, exit the setup by clicking Cancel.
  3. On the Choose Install Folder dialog box, specify the installation location.

    Specify the installation location on the Choose Install Folder dialog box

    Note:

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

  4. On the Pre-Installation Summary dialog box, click Install to start the installation.

    To begin the installation, click Install on the Pre-Installation Summary dialog box

    Note:

    Approximately 1.5 GB of the required disk space is used only during the installation of the product. This temporary disk use ceases at the end of the installation.

  5. Upon completion of the installation, follow the directions on the screen.
  6. Authorize ArcGIS Server:
    Tip:

    The authorization tool can also be launched with one of the following methods after ArcGIS Server has been installed:

    • Use the shortcut on your desktop environment: ArcGIS > Authorize ArcGIS Server.
    • Run the authorization script: <ArcGIS Server installation directory>/tools/authorizeSoftware. For more information about this authorization tool, see Authorizing ArcGIS Server silently.

    Choose the appropriate authorization option for your environment on the Authorization Options dialog box

    You can configure your machine using three methods:

    • I have installed my software and need to authorize it.

      Select this option if you do not already have an authorization file. When this option is selected, there are several methods to provide your authorization information. Select the authorization method you want to use (see the Authorization Method screen capture below). This is the method by which you will provide your authorization information.

    • I have already authorized the software and need to authorize additional extensions.

      Select this option if you have already authorized ArcGIS Server but want to authorize additional extensions (if available). When this option is selected, there are several methods to provide your authorization information. Select the authorization method you want to use (see the Authorization Method screen capture below). This is the method by which you will provide your authorization information.

      Authorization Method dialog box

      Tip:

      Authorizing now using the Internet enables you to receive the authorization file immediately. It requires an Internet connection.

    • I have received an authorization file from Esri and am now ready to finish the authorization process.

      Select this option if you have already received your authorization file from Esri Customer Service. With this option, you can browse to the location of the file received from Esri Customer service to complete your authorization.

      Authorization Options dialog box

    After the installation is complete, ArcGIS Server Manager is automatically launched in Mozilla Firefox. You will also be able to access Server Manager manually from any supported web browser by navigating to http://<server name>:6080/arcgis/manager. For more information, see the ArcGIS Server help.

    Follow post-installation instructions to configure ArcGIS Server to start with the operating system.

    Tip:

    Esri recommends using the serverScan.py script to check for security best practices with your ArcGIS Server after installation.

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

If your operating system supports the use of systemd to bootstrap and manage processes (for example, if you are using Red Hat Enterprise Linux (RHEL) Server 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. Change file permissions of /etc/systemd/system/arcgisserver.service from 700 to 600

    This file is installed with ArcGIS Server 10.8.

  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.
Note:

If you install ArcGIS Server on a Linux machine that includes systemd v228 or a later version, you may need to enable and raise the systemd limit to 512 maximum threads if the ArcGIS Server machine is heavily used. (For example, SUSE Linux Enterprise Server (SLES) 12 SP2 includes systemd v228.) Setting systemd to a maximum of 512 threads can prevent any single service from spawning too many threads and consuming all server resources.

To enable and raise the limit, as the root user, uncomment and edit the following line in the arcgisserver.service unit file before deploying it to the /etc/systemd/system directory:

# TasksMax=512

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 Server: /etc/rc.d/init.d/
    • SLES: /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 Server 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 Server:
      $ chkconfig --add arcgisserver
      $ chkconfig arcgisserver on
    • SLES:
      $ insserv arcgisserver
      $ chkconfig arcgisserver on
  6. End the root user session.
  7. Reboot the operating system and verify that ArcGIS Server restarts properly.

Machines with multiple network interface controller cards

ArcGIS Enterprise can be deployed on machines that have multiple network interface controller (NIC) cards. If you installed ArcGIS Server on a machine that contains more than one NIC card, you must identify which interface the server should use for network communication. This is done by adding a file into the installation directory for each machine in the site..

Note:

Perform these steps immediately after installing ArcGIS Server and prior to creating the new server site.

  1. Log in to the multi-NIC machine where Portal for ArcGIS is installed. Navigate to the folder <Server installation directory>/framework/etc. Create a new file named hostname.properties, with appropriate permissions, inside this folder.
  2. Add the following text to the first line of the file, and specify the fully-qualified domain name of the intended interface: hostname=interface.domain.com. For example, if you have a machine with two NIC cards (1 and 2), these interfaces' domain names resolve to S1.mycompany.com and S2.mycompany.com, and you want ArcGIS Server to use the second interface for network communication, add this text to the hostname.properties file: hostname=S2.mycompany.com.
    Note:

    In some cases, as when a hostname is identical for multiple interfaces, you should instead specify the IP address of the interface you want ArcGIS Server to use for network communication. The syntax is hostname=<IP address>.

  3. Save and close the hostname.properties file.
  4. Restart ArcGIS Server using the stopserver.sh and startserver.sh commands. Repeat with other machines in your ArcGIS Server site as necessary.

If necessary, follow the steps to configure other ArcGIS Enterprise software components on machines with multiple NIC cards:

Additional configuration notes

  1. After completing authorization, ArcGIS Server Manager should already be open. You are now ready to log in to Server Manager and create a new site. For more information. see Create a new site.
  2. 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 Server Manager and the Administrator Directory. For more information, see About the ArcGIS Web Adaptor.
  3. Most of your work publishing services occurs in ArcGIS Desktop, where you create your maps, globes, geodatabases, and so forth. To publish a service directly from ArcGIS 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 Desktop. See Connect to ArcGIS Server from ArcGIS Desktop for instructions.
  4. Ensure that ArcGIS Server can access all the data referenced by its services. For more information, see Make your data accessible to ArcGIS Server.
  5. 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.
  6. 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.