Upgrade VoiceConsole On Prem Deployment

To upgrade an existing VoiceConsole On Prem deployment to 6.2.1, select the appropriate instructions below.

VoiceConsole 6.2

Contact Technical Support for assistance upgrading from VoiceConsole 6.2.

VoiceConsole 4.2 through 6.1 with an Embedded Database

The embedded database is no longer supported. If the upgrade installation is attempted on an earlier version with an embedded database, a warning message is displayed.

To perform the upgrade, follow these steps;

  1. Install a database. The following options are recommended to replace the embedded database in deployments with 300 or fewer devices:

  2. Run the VoiceConsole Database Migrator.

  3. Run the installer.
    The Introduction window appears.
  4. Click Next.
    The License Agreement window appears.
  5. Accept the terms of the license agreement, and click Next.
    The Upgrade VoiceConsole window appears.
  6. Click Next.
    The Copying Software window displays the installer's progress during the copy of the individual selected software and the entire copying process.
  7. When the copying process is finished, click Next.
    The Configuration and Installation window appears.
  8. Fields on the Tomcat Server Configuration are populated with previous installation and cannot be changed.
  9. The Database Configuration tab must be completed with the information for the new Express database option.

    10. Enter the appropriate information for your database.

    For Express database installs, the Advanced fields below are not used.

    1. SQL Server
      For more information on using a SQL Server Express database with VoiceConsole, see Microsoft SQL Server 2019 or 2022 Express.
      For installations using SQL Server, you must enter the information listed in the following table:

      SQL Server does not enable TCP/IP by default. You must manually enable TCP/IP before the installation can complete successfully.

      • For Basic
        FieldDescriptionValid Entry Format
        Database HostnameDNS name or IP address of the machine hosting the database. 
        Database PortThe port that the database uses.Must be an integer between 1 and 65535.
        Default is 1433.
        Database NameThe name of the database. 
      • For Advanced
        FieldDescriptionValid Entry Format
        JDBC URLThe JDBC URL for the database.

        jdbc:sqlserver://<host>:<port>; DatabaseName=<database name>

      • For Both Basic and Advanced
        FieldDescriptionValid Entry Format
        Authentication Type (Windows installs only where existing user specified for Tomcat Server configuration)The authentication type used to connect to the database.If installing on Windows and an existing user was specified for the Tomcat Service configuration, you can select to use NT Authentication. Otherwise, select SQL Server Authentication.
        Database UsernameThe username that the application should use to log into the database. This is disabled if using NT Authentication. 
        Database PasswordThe password of the user that the application should use to log into the database. This is disabled if using NT Authentication. 
        Database SchemaThe database schema that you are using. 
    2. Oracle
      For more information on using an Oracle Express database with VoiceConsole, see Oracle Database 21c Express Edition.
      For installations using Oracle, you must enter the following information:
      • For Basic
        FieldDescriptionValid Entry Format
        Database HostnameDNS name or IP address of the machine hosting the database. 
        Database PortThe port that the database uses.Must be an integer between 1 and 65535.
        Default is 1521.
        SID or Service NameThe SID or Service Name of the Oracle database. 
      • For Advanced
        FieldDescriptionValid Entry Format
        JDBC URLThe JDBC URL for the database.jdbc:oracle:thin:@<host>:<port>:<database name>
      • For Both Basic and Advanced
        FieldDescriptionValid Entry Format
        Database UsernameThe username of a user with administrative privileges. 
        Database PasswordThe password of a user with administrative privileges. 
  10. Fields on the VoiceConsole Configuration tab are populated with previous installation and fields cannot be changed except the Enable HTTPS support checkbox can be edited.
  11. The License Server Configuration tab is new and must be completed.

    12. Enter the appropriate information for the VoiceConsole On Prem deployment to enable the local licensing server:

    1. Port
      The port to be used by the license server. The default is 1443.

    2. Password
      The password to be used for the local license server.

  12. Click Install Now.
    The installation begins. When the first part of the VoiceConsoleOn Prem deployment installation is successfully completed, click OK.
    If installing on Windows, the Setup Shortcuts window appears. If installing on Linux, go to step 9.
  13. If desired, select the program group in the Start menu to place the shortcut within or edit the path of the shortcut. If you do not want a VoiceConsole shortcut on the Start menu, clear the Create shortcut in the Start menu checkbox. A shortcut to VoiceConsoleOn Prem deployment is placed on the desktop automatically after the upgrade process completes.
  14. Click Next.
    The upgrade continues. When the upgrade is complete, the Installation Finished window appears.
  15. If desired, click Generate an automatic installation script to generate an .xml file with your installation choice data to use for silent or automatic installations.
  16. Click Done.
    The VoiceConsole Installer closes, and the VoiceConsoleOn Prem deployment application opens.

VoiceConsole 4.2 through 6.1 with an External Database

  1. Run the installer.
    The Introduction window appears.
  2. Click Next.
    The License Agreement window appears.
  3. Accept the terms of the license agreement, and click Next.
    The Upgrade VoiceConsole window appears.
  4. Click Next.
    The Copying Software window displays the installer's progress during the copy of the individual selected software and the entire copying process.
  5. When the copying process is finished, click Next.
    The Configuration and Installation window appears.
  6. Fields on the Tomcat Server Configuration and Database Configuration tabs are populated with previous installation and cannot be changed.
  7. Fields on the VoiceConsole Configuration tab are populated with previous installation and fields cannot be changed except the Enable HTTPS support checkbox can be edited.
  8. The License Server Configuration tab is new and must be completed.

    9. Enter the appropriate information for the VoiceConsole On Prem deployment to enable the local licensing server:

    1. Port
      The port to be used by the license server. The default is 1443.

    2. Password
      The password to be used for the local license server.

  9. Click Install Now.
    The installation begins. When the first part of the VoiceConsoleOn Prem deployment installation is successfully completed, click OK.
    If installing on Windows, the Setup Shortcuts window appears. If installing on Linux, go to step 9.
  10. If desired, select the program group in the Start menu to place the shortcut within or edit the path of the shortcut. If you do not want a VoiceConsole shortcut on the Start menu, clear the Create shortcut in the Start menu checkbox. A shortcut to VoiceConsoleOn Prem deployment is placed on the desktop automatically after the upgrade process completes.
  11. Click Next.
    The upgrade continues. When the upgrade is complete, the Installation Finished window appears.
  12. If desired, click Generate an automatic installation script to generate an .xml file with your installation choice data to use for silent or automatic installations.
  13. Click Done.
    The VoiceConsole Installer closes, and the VoiceConsoleOn Prem deployment application opens.

VoiceConsole Earlier than 4.2

Contact Technical Support for assistance before upgrading from VoiceConsole earlier than 4.2. Additional files and instruction are required to complete this upgrade.