Skip to main content

Silently install ArcGIS Video Server

You can install and authorize ArcGIS Video Server using command line parameters instead of using the installation wizard. It is important to note that as of version 12.0, a dedicated NVIDIA GPU is required by ArcGIS Video Server for publication of video services.

Tip:

The installation mode you use determines the default uninstallation mode. For example, if you install silently from the command line, the default uninstallation mode is to uninstall silently from the command line.

Prepare for installation

Before installing ArcGIS Video Server, complete the following steps:

  1. Sign in to My Esri and obtain the following files:

    • The ArcGIS Video Server software download

    • The authorization file

  2. Verify that your machine meets the system requirements.

  3. Verify that ports 21080 and 21443 are available on the machine where you are installing ArcGIS Video Server.

    Port 21443 must be reachable by ArcGIS Web Adaptor (if used) or external clients. If a firewall is in place between ArcGIS Web Adaptor or external clients, open port 21443 in the firewall.

Installation command line parameters

The following parameters are used when installing ArcGIS Video Server:

  • ACCEPTEULA=yes

    This parameter is required to accept the End User License Agreement (EULA) during a silent installation. Specify yes to agree to the EULA and install the software. Specifying no or omitting this parameter will result in a failed installation. The download contains a PDF of the EULA in the \Documentation folder.

  • INSTALLDIR=<installation location>

    This optional parameter allows you to specify the installation location of ArcGIS Video Server from the command line. If you do not set this property, the default installation location of C:\Program Files\ArcGIS\Video\ is used.

Configure the Windows account

The ArcGIS Video Server account must be configured when the software is installed silently. For production systems, it is recommended that you designate a preexisting account that resides in your domain or Active Directory and follows your organization's security policy.

If command line parameters are not used to configure the ArcGIS Video Server account during silent installation, the account is automatically set to the Local System account.

Use the command line parameters below to configure the account.

Pass account credentials directly

Caution:

If the ArcGIS Video Server account is not defined during a silent (/qb) installation or the credentials are not valid, the setup displays a warning message during installation. To close the message, click OK. Under these circumstances, the ArcGIS Video Server account is set to the Local System account.

  • USER_NAME=<operating system account>

    The Windows account can be a domain account or a local account. If you're using a domain account, it must already exist. If you're using a local account, the account will be created if it does not exist. If the account is not valid, a message appears during installation indicating that the account or password is invalid.

  • MSA=TRUE

    Only use this parameter with a Managed Service Account. A Managed Service Account must already exist on your domain. Do not use this parameter with a local account or a domain account with a password. A Managed Service Account does not use the PASSWORD parameter.

  • PASSWORD=<account password>

    This is the password for the account specified for the USER_NAME parameter. If the password is not valid, a message appears during installation indicating that the account or password is invalid.

See the examples below.

Caution:

Command line parameters are case sensitive. If you are having trouble getting the command line installation working, confirm that the case matches the properties as shown in the examples.

Domain account

<path to the ArcGIS Video Server setup download>\setup.exe /qb USER_NAME=mydomain\mydomainaccount PASSWORD=my.password

New or existing local account

<path to the ArcGIS Video Server setup download>\setup.exe /qb USER_NAME=myaccount PASSWORD=my.password

Managed Service Account

<path to the ArcGIS Video Server setup download>\setup.exe /qb MSA=TRUE USER_NAME=mydomain\mymsa

Import account credentials from a file

You can also use a server configuration file to import your Windows account credentials. Server configuration files can be exported during installation and used in future installations. To import credentials from an existing server configuration file, set the following two parameters:

  • ACCOUNT—If you're importing credentials from a file, set this parameter to UseConfigFile (matching the case exactly). There are no other valid values for this parameter.

  • CONFIGPATH—Specify the full path and name of the server configuration file you are using.

<setup directory>\setup.exe /qb ACCOUNT=UseConfigFile CONFIGPATH=\\networkmachine\serverconfigs\standardaccount.xml ACCEPTEULA=yes

Export credentials to a server configuration file

You can export the account credentials used in the current installation to use in a future installation. The server configuration file that is created is an encrypted .xml file.

When exporting a server configuration file to a network share, the Local System account on the machine where ArcGIS Video Server is being installed must have write permissions to the network share. For example, if you're installing ArcGIS Video Server on a machine named Turing, the Local System account on Turing must have write permission to the network share. If the permissions are not set, the server configuration file may not export successfully.

Note:

If you are unsure how to correctly set permissions for the network share, contact your system administrator or export the server configuration file locally and copy it to the network share.

Use the following two command line parameters to export the ArcGIS Video Server account credentials to a server configuration file:

  • EXPORTCONFIG—Set this parameter to Yes to export the account information set for the USER_NAME and PASSWORD parameters to a server configuration file. This parameter is set to No by default.

  • CONFIGPATH—Specify the full path and name of the server configuration file you want to create, including the .xml file extension. The specified folder must already exist.

Authorize the software

If you authorize the software silently, run SoftwareAuthorization.exe with the following syntax to authorize ArcGIS Video Server silently. You must have all user information complete in the authorization or provisioning file before running the file.

If you have a .prvc authorization file, use the following command:

<ArcGIS Video Server installation>\tools\SoftwareAuthorization.exe /S /Ver <11.4> /LIF <full path and name of .prvc authorization file>

Install ArcGIS Video Server silently

By default, ArcGIS Video Server is installed at ${HOME}/arcgis/video.

To install ArcGIS Video Server silently, complete the following steps:

  1. Open a command shell as the user who will run ArcGIS Video Server, and browse to the directory where you downloaded the ArcGIS Video Server tar.gz file from My Esri.

  2. Uncompress the tar.gz file with the following command:

    tar -xvzf ArcGIS_Video_Server_Linux_<version>.tar.gz

  3. Browse to the directory where the file was uncompressed and to <untar directory>/Documentation/EULA.pdf, and accept the license agreement.

  4. From the directory, run the setup silently and authorize it using a .prvc file.

    The syntax is as follows:

    <untar directory>/Setup -m silent -l yes -a <full path to .prvc file>

    The parameters of the command line tool are as follows:

    Parameter

    Description

    -m; --mode MODE

    (Optional) Specifies the install mode, either silent or GUI. The default is GUI.

    -l; --license-agreement CHOICE

    (Required for silent mode) Specifies whether you have read and agreed to the Esri Master Agreement (E204, E300), either yes or no. You can review the agreement at any time.

    -a; --authorization-file PATH_TO_FILE

    (Optional) The absolute file path to the authorization or provisioning file provided by Esri.

    If this parameter is not used, you must authorize the software after installation, as described in the next section.

    -d; --directory DIRECTORY

    (Optional) By default, ArcGIS Video Server is installed to your ${HOME} directory. Use this parameter to specify a different installation directory.

    The /arcgis/video/ path is appended to the installation directory.

    Use lowercase letters for the name of the installation directory. The samples and data bundled with the installation require the data path to be lowercase.

    -v; --verbose

    (Optional) Runs the installer in verbose mode.

    -h; --help

    Displays the command line help and exits.

    -e; --examples

    Displays usage examples of each option and exits.

  5. Modify your OS privileges to allow the systemd service to load and manage processes on ArcGIS Video Server. This allows the service to start immediately when the machine starts.

    1. In a terminal, switch to the root user.

    2. Copy the <ArcGIS Video Server install directory>/framework/etc/scripts/agsvideo.service unit file to /etc/systemd/system, and change the file permissions of this relocated file from 700 to 600.

    3. Still as the root user, run the following command:

      $ systemctl enable agsvideo.service

    4. Restart the systemd service and review its status to verify that it's properly configured:

      $ systemctl stop agsvideo.service
$ systemctl start agsvideo.service
$ systemctl status agsvideo.service

    5. End the root user session.

    6. Reboot the operating system and verify that ArcGIS Video Server starts properly.

Authorize the software silently

If you did not authorize the software during installation, run the software authorization with the following syntax to authorize ArcGIS Video Server silently. Run the following command to view all options for authorization:

<ArcGIS Video Server install directory>/tools/authorizeSoftware --help

Authorize in an environment with no display

You can authorize ArcGIS Video Server in an environment with no display (headless) using a provisioning file (.prvc).

  1. At the prompt, run the following command after the ArcGIS Video Server installation is complete:

    <ArcGIS Video Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>

  2. When the output information file has been created, do one of the following:

    • Browse to the Esri customer service website, and follow the instructions to upload the authorization information file and download the .prvc authorization file.

    • Send the authorization information file by email to authorize@esri.com. Esri will send the .prvc authorization file back to you in an email.

  3. When you receive the .prvc authorization file, run the authorizeSoftware script again to process it and complete the server authorization process:

    <ArcGIS Video Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>

Repeat this workflow for each machine where ArcGIS Video Server will be installed.

After installing ArcGIS Video Server, create an ArcGIS Video Server site.