Upgrade ArcGIS Video Server

Upgrading ArcGIS Video Server provides your organization with the software's latest features and improvements.

The ArcGIS Video Server setup package detects whether you have an existing installation of a previous version of ArcGIS Video Server on your machine. If you do, it can upgrade the software to the latest version.

The upgrade process for ArcGIS Video Server is an in-place upgrade, which does not require uninstalling and reinstalling software. The site will be down during the upgrade process, and users will be unable to access until the upgrade is complete.

During this upgrade process, any video layers created in the previous version of ArcGIS Video Server will be upgraded to the current version.

Follow the steps below to upgrade ArcGIS Video Server.

Prepare to upgrade

Before upgrading, do the following:

1. Access all of the necessary files in My Esri.
2. Ensure the ArcGIS Video Server version matches the version of the portal with which it's federated. To upgrade your ArcGIS Enterprise deployment, do the following:
   1. Upgrade Portal for ArcGIS.
   2. Upgrade ArcGIS Web Adaptor (for Portal for ArcGIS).
   3. Upgrade the ArcGIS Server site serving as the portal's hosting server.
   4. Upgrade ArcGIS Web Adaptor (for Server).
   5. Upgrade ArcGIS Data Store (upgrade primary first and then standby).
   6. Remove the ArcGIS Video Server designation as the portal's video server prior to upgrading ArcGIS Video Server.
3. Upgrade any other servers, including ArcGIS Video Server.
4. Redesignate the Video Server role.

   This automatically configures the use of the ArcGIS queueing system for efficient publishing. This workflow can also be completed after a successful upgrade by disabling and re-enabling the designation of the Video Server role.

5. Before upgrading, clear the caches of all web browsers used on the ArcGIS Video Server machine.

Back up your deployment

Before you upgrade, it's recommended that you make backups of your deployment. Perform the following steps to complete the backup operation:

1. Open the ArcGIS Video Server Administrator Directory and sign in as a user with administrative privileges.

   The URL is typically https://videoserver.example.com:21443/arcgis/admin.

2. Click Supported Operations: Export Site.
3. Enter the full path of the location on your machine to which you want to export the file.

   The site must have access to this directory.

4. Click Export.

   When the export operation is complete, the directory provides a link to the backup file location on the server.

5. Download the file, which will have an .agssite file extension, as promptly as possible.

Upgrade using the setup program

Complete the following steps to upgrade your server using the setup program:

1. During the installation, read the master agreement and accept it, or close the installation window if you do not agree with the terms.

   The setup program displays the feature that will be installed and the free disk space it requires on your hard drive.

2. On the next dialog box, either specify the account login credentials or provide a configuration file.

   The ArcGIS Video Server account used by your existing installation is prepopulated in the ArcGIS Server Account box. Provide the password for the ArcGIS Video Server account. Typically, this is the password you defined when installing the software.

   If the password is not validated successfully, an error message appears, indicating that the password is invalid. If you are unsure of the password for the ArcGIS Video Server account, contact your system administrator or reset your password using the ArcGIS Video Server Administrator Directory.

   If you provide a configuration file, the credentials in the server configuration file must be the same credentials used by your existing ArcGIS Video Server site.

3. Optionally, if you selected Specify the account name and password and manually entered the ArcGIS Video Server account information, export a server configuration file on the dialog box that appears. If you do not want to export a configuration file, click Next and accept the default Do not export configuration file option. If you want to export a server configuration file for future installations, click Export configuration file, browse to a secure folder, and provide a name for the configuration file.

   Note:

   You may want to export a server configuration file if you need to do any of the following:

   • Create the same ArcGIS Video Server account when installing on multiple machines.
   • Store the account for use when upgrading to a newer version.
   • Perform a silent installation in which the username and password are encrypted.

   Caution:

   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. If the permissions are not set, the server configuration file may not export successfully. If you're 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.

4. To complete the installation, follow the directions on the screen.

   After installation is complete, the configuration wizard opens in a browser.

5. Follow the instructions in the configuration wizard to complete the upgrade process.

   Note:

   During the site upgrade process, any video layers created in the previous version of ArcGIS Video Server will be upgraded to the current version. This process may take longer if the object store was registered and configured as the data store of the Video Server.

Upgrade from the command line

To upgrade from the command line, complete the following steps:

1. To start the upgrade, run ./Setup from the location where ArcGIS Video Server was extracted, with the argument shown in the example below and follow the prompts to complete the upgrade.

   This uninstalls the previous version of ArcGIS Video Server and installs the upgraded version of ArcGIS Video Server.

   <untar directory>/Setup -l yes -m silent

2. After the upgrade utility has completed, re-authorize ArcGIS Video Server for 11.4. Run the software authorization with the following syntax to authorize ArcGIS Video Server silently:

   <ArcGIS Video Server install directory>/tools/authorizeSoftware

   Run the following command to view all options for authorization:

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

   Note:

   See the section Authorize in a disconnected environment for information on authorizing the Video Server installations in a disconnected environment.

3. Upgrade the site using the upgradesite command line utility.

   This utility has two parameters:

   • -s—When included in the command, this prompts the utility to run the upgrade. The upgrade won't run without -s. This is intended as a safeguard to ensure you only run the upgrade when you're ready.
   • -h—This displays the help for the tool. When the command is run without -s, the help also displays.

   By default, the upgradesite utility is found at ${HOME}/arcgis/videoserver/tools/upgradesiteutility/upgradesite.sh.

   Before upgrading, review the preparation information at the beginning of this topic. When you are ready to upgrade, open a command terminal on the machine you're upgrading. Browse to the directory where the utility is located, and run the following command:

   > ./upgradesite.sh -s

   The utility displays progress reports and stops when the upgrade is complete.