Upgrade ArcGIS Velocity
The ArcGIS Velocity setup package is capable of upgrading the 12.1 version currently installed on your system. You can choose to upgrade interactively using the setup program or to upgrade silently.
The ArcGIS Velocity setup package is capable of upgrading the 12.1 version currently installed on your system.
Important:
Carefully review the information for upgrading ArcGIS Enterprise before upgrading ArcGIS Velocity.
Caution:
The upgrade process restarts all of your ArcGIS Velocity services. You should consider your ArcGIS Velocity site to be offline during the upgrade.
Important:
Carefully review the information for upgrading ArcGIS Enterprise before upgrading ArcGIS Velocity.
Note:
You must stop all of your ArcGIS Velocity services before you start the upgrade. Your ArcGIS Velocity site is offline during the upgrade.
Prepare to upgrade ArcGIS Velocity
Consider the following before and during the upgrade.
During the upgrade, you must reauthorize your software with a new authorization file. You can access your new authorization files in My Esri.
Ensure you have the required installation files from My Esri.
Upgrade all ArcGIS Enterprise components in your deployment to version 12.2 before upgrading ArcGIS Velocity.
Do not unfederate the ArcGIS Velocity site or any other federated servers when you upgrade your deployment.
It is recommended that you make a snapshot of your feed and real-time analytic configurations before upgrading. For more information, refer to backing up and restoring feeds and analytics.
Stop all running feeds and real-time analytics in the ArcGIS Velocity site.
Clear the cache of all web browsers used to access the ArcGIS Velocity deployment.
You can configure a reverse proxy server with your ArcGIS Velocity site. If you are upgrading from ArcGIS Velocity 12.1 to 12.2 and intend to configure a reverse proxy server, it is strongly recommended to do a clean installation of ArcGIS Velocity instead of an upgrade.
During the upgrade, you must reauthorize your software with a new authorization file. You can access your new authorization files in My Esri.
Ensure you have the required installation files from My Esri.
Upgrade all ArcGIS Enterprise components in your deployment to version 12.2 before upgrading ArcGIS Velocity.
Do not unfederate the ArcGIS Velocity site or any other federated servers when you upgrade your deployment.
It is recommended that you make a snapshot of your feed and real-time analytic configurations before upgrading. For more information, refer to backup and restore.
Stop all running feeds and real-time analytics in the ArcGIS Velocity site.
Stop all ArcGIS Velocity services. For more information, refer to stopping all services.
Clear the cache of all web browsers used to access the ArcGIS Velocity deployment.
You can configure a reverse proxy server with your ArcGIS Velocity site. If you are upgrading from ArcGIS Velocity 12.1 to 12.2 and intend to configure a reverse proxy server, it is strongly recommended to do a clean installation of ArcGIS Velocity instead of an upgrade.
Upgrade using the setup program
The Windows service account for your ArcGIS Velocity site (its Run As account value) must remain the same when upgrading.
To upgrade using the setup program, complete the following steps:
Browse to the location of the setup files and double-click Setup.exe.
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.
On the next dialog box, either specify the account login credentials or provide a configuration file.
The ArcGIS Velocity services account used by the existing installation is prepopulated. Provide the password for the ArcGIS Velocity services account. Typically, this is the password you defined when installing the software unless an existing domain account was provided.
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 Velocity services account, contact your system administrator or reset your password using the
configureserviceaccount_allutility.If you provide a configuration file, the credentials in the server configuration file must be the same credentials used by the existing ArcGIS Velocity site.
Optionally, if you selected Specify the account name and password and manually provided the ArcGIS Velocity 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.
After installation is complete, in the software authorization wizard, reauthorize ArcGIS Velocity with a new license file.
You can access your new authorization files in My Esri. You can authorize your software later, but you must complete this workflow before moving on to the next step of the upgrade process.
After authorization is complete, go to the ArcGIS Velocity Administrator directory at
https://velocity.example.com:7143/arcgis/admin/.Select Upgrade > Upgrade Site to complete your upgrade.
Continue to the Post-upgrade steps section.
Upgrade silently
The Windows service account for your ArcGIS Velocity site (its Run As account value) must remain the same when upgrading.
To upgrade from the command line, complete the following steps:
To start the upgrade, open a command line window using the Run as administrator option and run the ArcGIS Velocity setup command with the argument shown in the example.
This command uninstalls the previous version, installs the upgraded version, and reauthorizes ArcGIS Velocity.
Ensure that you use the same ArcGIS Velocity account used by the existing installation.
<path to setup directory>\setup.exe ACCEPTEULA=yes USER_NAME=<ArcGIS Velocity account username> PASSWORD=<password> LIF=<license path>\<Server_Velocity.ecp or .prvc> /qnOpen a command-line window using the Run as administrator option and run the
upgradesiteutility with the following command.upgradesite.bat -sBy default, the
upgradesiteutility is at:C:\Program Files\ArcGIS\Velocity\tools\upgradesiteFor assistance, run the command with
-hor--help. To specify a recovery codes file, run the command with-ror--recoveryCodesFile.Continue to the Post-upgrade steps section.
Upgrade from the command line
Stop ArcGIS Velocity services before performing an upgrade. For more information, refer to stopping all services.
To upgrade from the command line, complete the following steps:
To start the upgrade, run
Setupfrom the location where ArcGIS Velocity was extracted, with the argument shown in the example, and follow the prompts to complete the upgrade.<untar directory>/Setup -l yes -a <full path to the .ecp file or .prvc file>This command uninstalls the previous version, installs the upgraded version, and reauthorizes ArcGIS Velocity.
Note:
ArcGIS Velocity services must be stopped to successfully perform an upgrade. If ArcGIS Velocity services are started when the upgrade is initiated, you receive an error message, and the upgrade stops.
After the upgrade utility has completed, start the services that run ArcGIS Velocity. For more information, refer to starting all services.
You can upgrade the site using either the utility or the Administrator directory.
Upgrade the site by using one of the following methods:
To upgrade with the
upgradesitecommand line utility, complete the following steps:Browse to the location of the
upgradesiteutility.By default, the location is:
<ArcGIS Velocity installation directory>/tools/upgradesite/upgradesite.shRun the following command:
./upgradesite.sh -sFor assistance, run the command with
-hor--help. To specify a recovery codes file, run the command with-ror--recoveryCodesFile.
To upgrade with the ArcGIS Velocity Administrator directory, complete the following steps:
Browse to the ArcGIS Velocity Administrator directory at
https://velocity.example.com:7143/arcgis/admin/.Choose Upgrade > Upgrade Site to complete your upgrade.
Continue to the Post-upgrade steps section.
Post-upgrade steps
Complete the following tasks after upgrading ArcGIS Velocity, as applicable to your deployment.
Reverse proxy server configuration (optional)
ArcGIS Velocity supports the optional configuration of a reverse proxy server. If upgrading from 12.1 to 12.2 and choosing to use a reverse proxy server, read the considerations and follow the steps to configure a reverse proxy server.
Update the Services URL
The Services URL and Administration URL used to federate have changed from the 12.1 release. If you are upgrading from 12.1 to 12.2, complete the following steps to account for these changes:
Sign in to the portal directory with an account that has administrative privileges.
The URL is in the format
https://webadaptorhost.example.com/webadaptorname/sharing/rest.Click Home > Portals > Self.
From the Self resource page, click Servers.
From the list of servers, find your ArcGIS Velocity instance and select the Server ID.
Select Update Server.
Change the URL to align with one of the following examples:
If ArcGIS Velocity is not configured with a reverse proxy, the URL is in the format
https://velocity.example.com:7143/arcgis.If ArcGIS Velocity is configured with a reverse proxy, the URL is in the format
https://reverseproxy.example.com/velocity.
Add a Server Admin URL to align with the following example:
https://velocity.example.com:7143/arcgis.Select Update.
Sign in to the portal with an account that has administrative privileges.
The URL is in the format
https://webadaptorhost.example.com/webadaptorname/home.Click Organization > Settings > Servers.
Verify that ArcGIS Velocity server status is All systems operational.
Considerations when upgrading
Review the following considerations that may apply to your upgrade.
Reverse proxy considerations
You can configure a reverse proxy server with your ArcGIS Velocity site. If you are upgrading from ArcGIS Velocity 12.1 to 12.2 and intend to configure a reverse proxy server, it is strongly recommended to do a clean installation of ArcGIS Velocity instead of an upgrade.
If you do perform an upgrade from 12.1 to 12.2 and implement a reverse proxy, this process is a significant change and could have serious impacts on feeds and real-time analytics created before the upgrade. Consider recreating existing items after the upgrade in this scenario.
App launcher shortcut
A federated ArcGIS Velocity instance does not automatically create an ArcGIS Velocity app icon in the app launcher. For more information on how to add an app icon shortcut to the app launcher, refer to adding ArcGIS Velocity to the portal in ArcGIS Enterprise app launcher.