Skip To Content

ArcGIS Video Server administrator operations

The following sections describe the properties available to ArcGIS Video Server administrators. Each property is described along with its path, located in the ArcGIS Video Server administration site by browsing to the URL https://machine.domain.com:21443/arcgis/admin.

Designate the ArcGIS Video Server account

The ArcGIS Video Server account defaults to the name arcgis. Accepting this default is sufficient for most nonproduction deployments; however, for production systems, it is recommended that you create a domain or Active Directory account prior to installing ArcGIS Video Server.

You are allowed to specify a local account or a domain account. You can export the setup configuration file when you install ArcGIS Video Server on the first machine in your site and use the configuration file when you install ArcGIS Video Server on the other machines in your site. This ensures that the ArcGIS Video Server account is configured the same on all the machines in your site.

Domain account

A domain account makes it easier to access data on remote systems. A domain account is also preferable for security purposes because the account is centrally managed.

When specifying a domain account, use the format DOMAIN\username. If you do not specify the domain, the ArcGIS Video Server installation wizard creates a local account with the username you specified. If you specify a domain account that does not exist, the installation returns an error.

If your login settings deny login rights to the machine where ArcGIS Video Server is installed, you will encounter an error during the installation. It is not necessary to grant Log on locally group policy settings to the ArcGIS Video Server account.

Local account

If you choose a local account, the local account and password must exist on each machine in the ArcGIS Video Server site and must be identical. You can create the local account with the same password on each machine before installing ArcGIS Video Server, or you can allow the ArcGIS Video Server installation wizard to create the local account; just be sure to use the same username and password on every machine in the site.

If you created a new local account as part of the installation, the password you specify for the account must adhere to your operating system's local security policy. If the password does not meet the minimum strength requirements of your operating system, the installation returns an error. Consult the Microsoft documentation for the version of Windows you are using to learn how to check the security policy on your machines.

Group managed service account

A group managed service account (gMSA) is a special Active Directory domain account that provides automatic password management. The account cannot be used for interactive logins and is restricted for use on only a predefined group of servers.

Using a gMSA is especially advantageous when a service account governs software on multiple machines, such as in a multiple-machine ArcGIS Video Server site. Because the gMSA works at the domain level, it can regularly change the service account password on each machine with no manual steps required.

The configureserviceaccount command line tool, which is described below, can be used to configure the ArcGIS Video Server service to run under a gMSA. You can find this tool in the <Video_Install>\tools\ConfigUtility directory. For the username parameter, the group managed service account can be specified either with or without the $ symbol at the end. The password parameter is not needed. The readconfig and writeconfig parameters both function the same with a group managed service account.

The following is a sample command to configure a gMSA as the ArcGIS Video Server account:

configureserviceaccount.bat --username mydomain\enterprise-gmsa$ --writeconfig c:\temp\domainaccountconfig.xml

Import a root certificate

To import a root certificate, click Home > Machines > MachineName > sslCertificates > importRootOrIntermediate.

This operation imports a CA's root and intermediate certificates into the keystore. To create a production-quality CA-signed certificate, add the CA's certificates to the keystore that enables the SSL mechanism to trust the CA (and the certificates it has signed). While most of the popular CA's certificates are already available in the keystore, you can use this operation if you have a custom CA or specific intermediate certificates.

Update the security configuration

To update the security configuration, click Home > Security > Config > Update.

This operation updates the security configuration, including TLS protocols and cipher suites, for your ArcGIS Video Server site. This operation causes the REST service endpoints to be redeployed on every server machine in the site. If you updated the communication protocol as part of this operation, it takes ArcGIS Web Adaptor one minute to recognize changes to the communication protocol of your site.

Edit system properties

Administrators can edit ArcGIS Video Server properties to fit their organization. Custom property values can be set at https://machine.domain.com:21443/arcgis/admin/system/properties/update. When setting a custom system property, the property must be set as a valid JSON object. Multiple system properties can be set at a time, as long as they are strung together as valid JSON, for example:


{
"maxFrameCount": 1000,
"maxFileUploadSize": 5000
}
The sections below describe common system properties an administrator can use.

Define the maximum frame count

The maximum frame count determines the maximum number of frames that can be returned on the frameset creation operation. The minimum allowed max frame count is 100.

The default is 1000 frames, for example:

{"maxFrameCount": 1000}

Define the maximum file upload size

The maximum file upload size sets the maximum threshold for a single file size that can be uploaded to the video server when publishing video files. If a file that exceeds this maximum size is uploaded during the publishing, the process will fail. The highest this property can be set to is 10 GB (10000). If this property is set to 0GB, the publishing of video files will be disabled.

The default is 5GB, for example:

{"maxFileUploadSize":"5000"}

Define the elevation source

The elevation data source used to orthorectify the computed polygon of each image’s footprint. An elevation imagery service itemId can be set as the source. If no elevation source is defined, a constant elevation = 0 is used. Using an elevation source increases the accuracy of the image footprints.

The default is set to use a constant elevation = 0, but can be set with an existing elevation imagery service itemId, for example:

{"elevationSource":"a08984c643a24bfd8f8d2eb0d192357d"}

Configure ArcGIS Web Adaptor

To configure ArcGIS Web Adaptor, click Home > System > Web Adaptors > WebAdaptorConfig.

The ArcGIS Web Adaptor configuration is a resource for all the configuration parameters shared across the web adaptors in the site. This resource identifies the shared key used by all the web adaptors to encrypt key data bits in the incoming requests to the server.

Edit the log settings

To edit the log settings, click Home > Logs > Settings> Edit.

This procedure updates the log settings for the entire server site, such as log output location, level, and format, as well as log file age.

Set default item data store

To edit the default item data store, click Home > Data > Items > Set Default Item.

The default item data store will be the location in which original video files and their corresponding metadata files, and output encoded video files and their corresponding metadata files will be stored after a successful publish operation. By default, this is set to the FILESYSTEM.

Register data store

To register an existing data store, click Home > Data > Configure Enterprise Data Stores > Submit.

By default, the ArcGIS Video Server stores all video and metadata files on the file system. An organization can register an existing Object Data Store to use as the output location of video and metadata. This procedure will search for an existing Object Data Store and register it to the Video Server. This data store can then be set as the default data store using the Set Default Item Data Store workflow.

Delete a site

To delete a site, click Home > Delete Site.

This operation deletes the site configuration and releases all server resources. It is suited for development or test servers that need to be cleaned up regularly and can also be performed before uninstallation. Use caution with this option because it deletes all settings and other configurations and is an unrecoverable operation.

This operation performs the following tasks:

  • All server machines participating in the site are stopped.
  • All server machines are unregistered from the site.
  • The configuration store is deleted.

Back up the site

It is recommended that you frequently export your site settings through the admin API. You can do this by browsing to Home > Export Site. It is recommended when defining a destination property for the exported site that the location be a network drive, or a location other than the ArcGIS Video Server machine itself. The destination must be a location that is accessible to the ArcGIS Video Server machine. In the event of a site failure, the site can be recovered by creating a new server site and browsing to Home > Import Site.