Skip To Content

Join additional machines to an ArcGIS Mission Server site

ArcGIS Mission Server supports multiple-machine sites starting at 10.8.1.

Legacy:

At the 10.8 release, only single-machine sites were supported.

Multiple-machine ArcGIS Mission Server sites allow you to support more active members of a mission. If you have many active users, or if your single machine's resources are inadequate for your users' needs, expanding to a multiple-machine site could be beneficial.

All machines in an ArcGIS Mission Server site must have the same version and license file. On the first machine you set up, you'll need to create a ArcGIS Mission Server site. You can then join any additional ArcGIS Mission Server machines to the site.

Note:

Unlike other ArcGIS Server roles, ArcGIS Mission Server does not support adding additional machines to a site from the first machine. You must access each machine in turn and join them to the site procedurally, using either the ArcGIS Mission Server configuration wizard or the joinSite command line utility.

Before installation

When you create an ArcGIS Mission Server site, you specify locations for the configuration store and server directories. In a multiple-machine site, you must share the configuration store and server directories so that the other machines can access them. Each machine that joins the site must be granted read and write permissions to these shared locations.

Install and configure a multiple-machine site

When setting up a multiple-machine ArcGIS Mission Server site, additional steps are required.

  1. Review the system requirements for ArcGIS Mission Server for each machine. Adjust the firewalls to open port 20443 and 20160 for communication from each machine in your ArcGIS Mission Server deployment if necessary.

    The installed version of ArcGIS Mission Server and its license file must be the same on each machine. Enter the same ArcGIS Mission Server run-as account during each installation. It's recommended that you use a domain or Active Directory account, but if you choose a local account, it must exist on each machine with an identical name and password combination. Keep in mind that the account you specify does not have to be part of the Administrators group.

  2. Create and share two directories on your network. One should be for the configuration store and the other for the server directories. Grant read and write permissions for these two directories to the ArcGIS Mission Server account on each machine (make sure to do this on both the Sharing tab and the Security tab of File Explorer).
    Note:

    Shared network directories that are hidden or use special characters (such as $) are not supported by ArcGIS Mission Server.

    Note:

    If using a UNC path for directories and config-store, you must escape any backslashes \ when designating them. This applies only for the joinsite utility.

    • 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 (UNC) path.
    • If the ArcGIS Mission Server account does not exist on the machine (in the case where you put the configuration store and server directories on a file server), you need to create the ArcGIS Mission Server account using the same name and password that you used in all the other machines in your deployment.
    • If you are using a group managed service account (gMSA) for the ArcGIS Mission Server account, you must allow service accounts to have full control permissions on the Sharing and Security tabs. From the Permissions editor, click Add, and open the Object Types dialog box. Check the box for Service Accounts.
  3. From one of your machines, create an ArcGIS Mission Server site. Ensure the paths for the server and configuration store directories are specified during creation.
  4. Once the previous steps have been completed, you can join each additional machine to the site you've created using a configuration wizard. If you prefer to join the site from the command line, see step 5.
    1. From the first additional machine, open the ArcGIS Mission Server Configuration Wizard.
    2. Review and follow the instructions provided in the wizard, and click Continue.
    3. Click Join Existing Site.
    4. Enter the site URL and credentials for your ArcGIS Mission Server site as created in step 3.
    5. Repeat substeps a through d for each additional machine you want to join to the site.
  5. When additional machines are joined to the site, they are considered equal in the site; there is no primary machine.
  6. As an alternative to using the configuration wizard, you can join the machine to the site using a command line utility, as follows:
    1. Ensure you're signed in to the machine with the ArcGIS Mission Server account.
    2. Open a command prompt and run the utility, which is located at <ArcGIS Mission Server install directory>\tools\joinsite\joinsite.bat. The following are the command line parameters for the utility:

      ParameterDescription

      -u or --username

      The user name of the primary site administrator.

      The user name cannot contain these characters: \/:*?|<>

      -p or --password

      The password for the primary site administrator.

      The password cannot contain these characters: \/:*?|<>

      -f or --file

      The configuration store connection file for the joinsite utility.

      -s or --siteUrl

      The URL of the existing ArcGIS Mission Server site to join, in the format https://missionserver.domain.com:20443/arcgis/admin.

      -h or --help

      Displays command line help and exits.

      The following is an example command for the utility:

      <ArcGIS Mission Server install directory>\tools\joinsite\joinsite.bat -u missionadmin -p my.Password3 -s https://missionserver.domain.com:20443/arcgis/admin

      If the account credentials and site URL are entered correctly, the utility will join the machine to the ArcGIS Mission Server site. Repeat this step for each additional machine.

Once all the machines are joined to the site, the remaining setup process is the same as for single-machine sites. Proceed to install and configure ArcGIS Web Adaptor with your site. You will then configure your site with your ArcGIS Enterprise portal.