Join an existing site

A site is a deployment of ArcGIS Server. If you've installed ArcGIS Server on a machine for the purpose of adding it to an existing site, you have the opportunity to specify that site the first time you open ArcGIS Server Manager. You can also join a machine to a site using a command line utility.

Important:

Before joining a machine to an existing site, carefully review the requirements and recommendations for configuring a multiple-machine site.

Note:

If your existing site has been configured to use HTTP only, you must add the new server machine from the existing site, as described in Add an ArcGIS Server machine to a site.

Join a site using Server Manager

To join a machine to a site using the ArcGIS Server Manager application, complete the following steps:

1. Open Server Manager. The URL to open Server Manager in a browser is https://gisserver.example.com:6443/arcgis/manager, or you can use the installed shortcut.

   If you're prompted to enter a username and password, someone already joined this machine to an existing site.

2. Click Join An Existing Site.

3. Type the URL to the site you want to join. The URL usually follows the format https://gisserver.example.com:6443/.

4. Type the administrator name and password of the site you want to join. This can be the same username and password that you used when you created the site (the primary site administrator), or it can be another ArcGIS Server user account to whom the server administrator has granted administrative privileges.

   Click Next.

5. Examine the configuration summary and click Finish when you are ready to join the machine to the site.

6. If your site has database connector types, you must restart ArcGIS Server on each newly added machine by running the stopserver/startserver scripts as the owner of your ArcGIS Server. These scripts are located at the $AGSHOME directory. After restarting, ArcGIS Server on each added machine will be fully functional.

7. If your site has database connector types, you must restart ArcGIS Server on each newly added machine by restarting the Windows service. After restarting, ArcGIS Server on each added machine will be fully functional.

Your machine is now added to the site.

Join a site from the command line

You can also use the join-site command line utility to join your machine to an ArcGIS Server site. This utility requires that you specify the location of the configuration store of the existing site, rather than its URL. Because of this, the utility is advantageous for certain cases in which using the URL would clog up the network requests queue for the site. Consider using this utility if the machines in your ArcGIS Server site are already overloaded with network requests, or if you want to join a large number of machines to your site at one time.

The same criteria and considerations apply to machines when using the join-site utility as when joining using Server Manager.

The join-site utility is installed in /tools/JoinSite under the ArcGIS Server installation directory. Run the join-site utility from the ArcGIS Server machine you want to add to an existing site, using the Run As account for ArcGIS Server.

The join-site utility is installed in \tools\JoinSite under the ArcGIS Server installation directory. Run the join-site utility from the ArcGIS Server machine you want to add to an existing site, using the Run As account for ArcGIS Server.

The utility includes an optional flag, -m, starting at 10.8, to control when the newly added machine can start processing requests. If you include -m true in the utility command, the machine will be placed under maintenance when it joins the site. When a machine is under maintenance, ArcGIS Web Adaptor does not send requests to the machine. If you don't include -m or include -m false, the machine will be able to process requests as soon as it is added to the server site.

1. Grant read and write access on the configuration store directory of the existing site to the account used to install ArcGIS Server on the machine or machines you are joining to the site.

2. Grant read and write access on the configuration store folder of the existing site to the network account used to run the ArcGIS Server service on the machine or machines you want to join to the site.

3. Create a JavaScript Object Notation (JSON) file named connection.json.

4. Add the following line to the file, replacing <path to the configuration store> with the configuration store location of the existing ArcGIS Server site:

   {"type": "FILESYSTEM", "connectionString": "<path to the configuration store>"}

   In this example, the path to the configuration store of the existing site is /net/myserver/share/config-store:

   {"type": "FILESYSTEM", "connectionString": "/net/myserver/arcgis/server/usr/config-store"}

   In this example, the path to the configuration store of the existing site is \\\\myshare\\arcgisserver\\config-store:

   {"type": "FILESYSTEM", "connectionString": "\\\\myshare\\arcgisserver\\config-store"}

5. Save and close the connection.json file.

6. Place the connection.json file on the machine that will join the site or on a shared directory that you can access from the machine that will join the site.

7. Open a command prompt and run join-site.

   The syntax is as follows:

   ./join-site.sh -f <The file path to the configuration store JSON file> -m <specify true to initially place the machine under maintenance>

   In this example, the path to the configuration store JSON file (connection.json) is /usr/serverfiles and the machine will not be placed under maintenance upon joining.

   ./join-site.sh -f "/usr/serverfiles/connection.json"

   join-site -f <The file path to the configuration store JSON file> -m <specify true to initially place the machine under maintenance>

   In this example, the path to the configuration store JSON file (connection.json) is C:\serverfiles and the machine will initially be placed under maintenance.

   join-site -f "C:\serverfiles\connection.json" -m true

The machine is joined to the ArcGIS Server site.