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 a ArcGIS Mission Server site must have same the 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 you install

When you first create a 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 to verify that each machine qualifies. On each machine, adjust the firewalls to open port 20443 for communication from each machine in your ArcGIS Enterprise deployment.

    Make sure you install using the same operating system user on both machines. The user account used to install ArcGIS Mission Server will be the account used to run the software. Group users and all others must have at least execute permissions to the ArcGIS Mission Server installation directory. Note that installing ArcGIS Mission Server with the root account is not supported. The user account used to install on two different machines, for example, could be as follows:

    1. Install ArcGIS Mission Server on the first machine at /data/ags as user ags, with a user ID of 58103.
    2. Install ArcGIS Mission Server on a second machine at /data/ags with the same user name and ID (ags, user ID 58103).
  2. Ensure that you have already done the following during the installation process to this point:
  3. Create and share two directories on your network, specifying 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.
    Note:

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

    For example:
    1. Create a directory named 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 named arcgismissionserver. Specify the owner as ags, with the user ID of 58103. Grant at least 700 permissions to the directory.
    4. Share the arcgismissionserver folder so that both machines can access the directory using the same path, for example, /net/myserver/arcgismissionserver.

      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. From one of your machines, create an ArcGIS Mission Server site. Ensure you use the paths for your server directories and configuration store that you set up earlier.
  5. 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 6.
    1. From the first additional machine, open the ArcGIS Mission Server Configuration Wizard.
    2. Review and follow the instructions provided in the wizard, and then click Continue.
    3. Click Join Existing Site.
    4. Enter the site URL and credentials for your ArcGIS Mission Server site as created in step 4.
    5. Repeat steps a through d for each additional machine you want to join to the site.
  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 logged 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.sh. 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.

      An example command for the utility:

      <ArcGIS Mission Server install directory>/tools/joinsite/joinsite.sh -u missionPSA -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.

  7. Once all 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.