Skip To Content

Configure a multiple-machine deployment

ArcGIS Server has a scalable architecture that allows deployment sizes ranging from one to many machines. You may need to consider a distributed installation of ArcGIS Server so that you can achieve an acceptable level of performance for the number of users accessing the system.

All machines in an ArcGIS Server site have the ArcGIS Server component installed. On the first ArcGIS Server machine you configure, you'll need to create the site. Subsequently, you can add or join additional ArcGIS Server machines to the site. Each ArcGIS Server in the site must be at the same version number and be licensed exactly the same.

When you create a site, you determine where to store the critical files and configuration information for your site. This directory is called the configuration store. Your site also has server directories that store service output files, geoprocessing jobs information, service definitions, cache tiles, and other items. When you add a machine to the site, it is configured to point to the configuration store and server directories. In a multiple-machine site, you must share the configuration store and server directories so that the other ArcGIS Server machines can access them.

You might choose to put the configuration store on a machine or disk that is not dependent on the ArcGIS Server, such as a fault-tolerant file server. This allows you to add or remove machines from the site without worrying which of them has the configuration store installed. This is especially important in cloud deployments where automatic scaling mechanisms might add and remove machines from your site without any intelligence built in about which holds the configuration store.

The steps below explain how to configure a multiple-machine deployment of ArcGIS Server. The site is created on Machine A, then Machine B is added to the site. If you've already been running ArcGIS Server on a single machine and you're looking to expand your site, see the following topic instead: Expanding from one ArcGIS Server to multiple ArcGIS Servers.

  1. On both machines, adjust your firewalls to open the ports described in Ports used by ArcGIS Server.
  2. Install and authorize ArcGIS Server on Machine A and Machine B with Enterprise licenses. This requires running the Software Authorization Wizard on each machine. The Software Authorization Wizard is launched at the end of the ArcGIS Server installation. You can also access the Software Authorization Wizard by navigating to the installed shortcut. The installed version of ArcGIS Server must be the same on each machine and the exact same license must be applied to each machine.

    Make sure you install using the same operating system user on both machines. 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. The user account used to install on Machine A and B, for example, could be as follows:

    1. Install ArcGIS Server on Machine A at /data/ags as user ags, with a user ID of 58103.
    2. Install ArcGIS Server on Machine B at /data/ags with the same user name and ID (ags, user ID 58103).

    If the machine you've installed ArcGIS Server on has multiple network interface controller (NIC) cards, you may want to specify which NIC card should handle network communication for the server. To do so, follow this workflow.

  3. Create and share two directories on your network, granting the installation user as the owner. One should be for the configuration store and the other for your server directories. You must grant at least 700 permissions to the folders. For example:

    Shared network directories that are hidden or use special characters (for example, $) are not supported by ArcGIS Server.

    1. Create a directory called config-store. Specify the owner as ags, with the user ID of 58103. Grant at least 700 permissions to the directory.
    2. Share the config-store folder so that both machines can access the directory using the same path, for example, /net/myserver/config-store.
    3. Create a directory called arcgisserver. Specify the owner as ags, with the user ID of 58103. Grant at least 700 permissions to the directory.
    4. Share the arcgisserver folder so that both machines can access the directory using the same path, for example, /net/myserver/arcgisserver.

      Even if the directories reside on the same machine that you will use when creating the site, you must still manually create and share the directories and reference them through a network path.

  4. Open ArcGIS Server Manager on Machine A and click Create New Site.
  5. To create a new site, you are required to define a user name and password as the primary site administrator. Choose a user name and password and click Next.

    This name and password is recognized only by ArcGIS Server; it is not an operating system account, and it is managed separately from the user accounts in your user store. The primary site administrator has unrestricted access to the ArcGIS Server site. This account is generally used to create the ArcGIS Server site and to configure and manage security. Do not confuse the primary site administrator account with the ArcGIS Server account you provided during the ArcGIS Server installation.

  6. Type the paths to your server directory and configuration store folders that you set up earlier and click Next.

    Use the network path share you set up earlier (for example, /net/myserver/arcgisserver) so that all machines in the site can see the location.

  7. Click Finish to create your site or Back if you want to make changes.
  8. Type the user name and password of the primary site administrator account you chose when you created the site and click Login.
  9. Click Site > GIS Server > Machines.
  10. In the Machines module, click Add Machine.
  11. In the Add Machine window, enter the name of Machine B. You must type the exact name of the machine; do not use localhost.

    The URL of machine B is entered automatically.

  12. Click Add to add Machine B to your site.

    Steps 9 through 12 demonstrate how to add a machine to your site. You can alternatively join Machine B to your site by opening ArcGIS Server Manager on Machine B and click Join An Existing Site. For step-by-step instructions, see Joining an existing site.

  13. Consider registering your data with your site. Data registration gives the server a list of locations that the server administrator has verified that ArcGIS Server can access. Data registration also helps ArcGIS Server understand how to adjust data paths as you publish across machines. If you attempt to publish a service that references data from an unregistered location, the data is copied to the server during the publishing operation. To learn more about this, see About registering your data with ArcGIS Server.
  14. Publish a map service to your site. After publishing, make some requests to the map service using the View in JavaScript option in the Services Directory. Then, in the ArcGIS Server Administrator Directory, navigate to services > (your service.MapServer) > statistics. You should be able to see some statistics about how many requests each machine received.
  15. Install and configure 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 allows you to prevent outside users from accessing Manager and the Administrator Directory. See About the ArcGIS Web Adaptor to learn more.


    Esri recommends using the script to check for security best practices with your ArcGIS Server following the upgrade.