Prepare to Upgrade VoiceConsole On Prem Deployment

This section applies only to a VoiceConsole On Prem deployment.

Review these items before starting to Upgrade VoiceConsole On Prem Deployment.

Honeywell strongly recommends that you back up the database that you are using for the previous version of VoiceConsole before upgrading to this version.

Honeywell strongly recommends first testing the upgrade in a lab environment prior to upgrading in production. The test environment should contain the most recent snapshot of your production database to provide the most accurate representation for your upgrade test efforts.

To avoid any potential issues, Honeywell highly recommends against installing VoiceConsole On Prem deployment from a shared network drive.

When VoiceConsole 6.2 or later is first accessed it is necessary to visit the Configure License page and select a license option. After a license option is selected, the appropriate license actions are displayed. Follow the instructions at the link above for the selected option to ensure VoiceConsole is licensed.

  • Close all other applications before installing.
  • When upgrading with Windows, you must run the installer as an administrator. When installing with Linux, the installer must be run as root.
  • Honeywell has only tested upgrades with supported databases. The installer may prohibit you from upgrading from an unsupported database. If you have questions regarding upgrading from an unsupported environment, please contact Honeywell technical support.
  • On Windows, navigate to install.exe on the downloaded location to which the files were copied. On Linux, if you are using Intel or AMD architecture, copy the files from the downloaded location, or other source, to your computer and execute the install.sh file.

When VoiceConsole is updated from version 6.1 or earlier, the upgrade process installs a local licensing server as part of the upgrade.

SAML SSO cannot be enabled during an upgrade installation. It can only be enabled during a new installation.

Default Ports

  • Ports 9090, 9443, 9010, 9006, and 9091 are used by default by the Apache Tomcat Service for proper startup and shutdown. If these ports are not available, the next available ports are used.
  • The Licensing Server uses port 1443. if this port is not available, the next available port is used.
  • TERMINAL_TCP_PORT port 21050 must be available.
  • UDP port 21055 must be available.

See Available Ports and Protocols for more information on these ports.

Data Agent

Operational Acuity is replaced by Honeywell Forge Performance+ for Guided Work.

In previous versions of VoiceConsole, the Operational Acuity Agent data agent service could be installed. This service is no longer supported and is no longer installed with VoiceConsole 5.5 or later.

For customers who installed the service and are upgrading to VoiceConsole 5.5 or later, Honeywell recommends either disabling or removing it. Use the service manager (services.msc) or applicable Linux service management system to disable it.

To completely remove the service in Windows, run this command in an elevated command prompt: sc delete 'opacuity-agent'.

For Linux, Honeywell recommends consulting with the server's Linux Administrator because of Service Management differences.