Skip To Content

Join additional machines to an ArcGIS Video Server site

Multiple-machine ArcGIS Video Server sites allow you to support more active members. 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 Video Server site must have the same version and license file. On the first machine you set up, you'll need to create an ArcGIS Video Server site. You can then join any additional ArcGIS Video Server  machines to the site.

Before installation

When you create an ArcGIS Video 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 Video Server site, additional steps are required.

  1. Review the system requirements for ArcGIS Video Server for each machine. Adjust the firewalls to open port 21080 and 21443 for communication from each machine in your ArcGIS Video Server deployment if necessary. If a firewall is in place between ArcGIS Web Adaptor or external clients, open port 21443 in the firewall.

    Port 21443 must be reachable by  ArcGIS Web Adaptor (if used) or external clients.

    The installed version of ArcGIS Video Server and its license file must be the same on each machine. Enter the same ArcGIS Video 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 for the configuration store and the other for the server directories. Grant read and write permissions for these two directories to the ArcGIS Video 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 Video 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 Video 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 must create the ArcGIS Video 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 Video 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 Service Accounts box.
  3. From one of your machines, create an ArcGIS Video Server site. Ensure the paths for the server and configuration store directories are specified during creation.
  4. Once the previous steps have been completed, 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 Video Server Admin Endpoint. (https://machine.domain.com:2144/arcgis/admin).
    2. Click Join Site.
    3. Enter the Admin URL and credentials for your ArcGIS Video Server site as created in step 3.
    4. 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, 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 Video Server account.
    2. Open a command prompt and run the utility, which is located at <ArcGIS Video Server install directory>\tools\joinsite\joinsite.bat. The following are the command line parameters for the utility:

      ParameterDescription

      -u or --username

      The username of the primary site administrator.

      The username 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 Video Server site to join, in the format https://videoserver.domain.com:20443/arcgis/admin.

      -h or --help

      Displays command line help and exits.

      The following is an example command for the utility:

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

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

If using a connection JSON file as opposed to the other parameters, the format is the following:

{"connectionString":"C:\\arcgisvideoserver\\config-store","configPersistenceType":"FILESYSTEM","username":"","status":"Ready"}

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.

Joining sites using an Object Store for a Config-Store

If using an Object Store (Amazon Web Services (AWS), Microsoft Azure) for the initial site’s Config-Store, note that the Directories folders must still be located in shared paths that can be reached by both machines with adequate permissions to read and write by the service account.