Install VoiceConsole for the First Time

This section describes how to install VoiceConsole for the first time; that is, when there are no previous instances of VoiceConsole at your site.

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

Close all other applications before installing.
When installing with Windows, you must run the installer as an administrator. When installing with Linux, the installer must be run as root.
On Windows, navigate to the install.exe on the downloaded location. On Linux, if you are using Intel or AMD architecture, copy the files from the downloaded location, to your computer, and execute the install.sh file.
When you install this version of VoiceConsole for the first time, the following two users are installed with the application with default passwords:
- admin/admin
- vocollect/voiceworks

System Components

The following system components are installed when you install VoiceConsole 5.6.5.

Apache Tomcat
Java™ JRE
VoiceConsole Web Application
VoiceConsole Online Help
Hardware Documentation

Available Ports and Protocols

VoiceConsole uses the following protocols:

Internet Control Message Protocol (ICMP)
Hypertext Transfer Protocol (HTTP)
Hypertext Transfer Protocol with Secure Sockets Layer (HTTPS)

The Apache Tomcat Service uses the following ports by default for proper startup and shutdown:

Use	Default	Direction
HTTP	9090	Inbound
WebSocket	9091	Both
HTTPS	9443	Inbound (Browser Only)
Shutdown	9006	Internal

If these ports are not available, the next available ports are used.

Standard Installation Procedure

If one is not already installed, install the database platform.
Create a blank VoiceConsole database and a user with create, read, and write permissions to the database. When you run the installer in the next step, the database schema will be created automatically.
Run the installer.
The Introduction window appears.
Click Next.
The License Agreement window appears.
Accept the terms of the license agreement, and click Next.
The Select Installation Path window appears.
Click Next to install to the default path or, if necessary, browse to the desired installation path and click Next. The Software to Install window appears.
Click Next.
The Copying Software window displays the installer progress during the copy of the individual selected software and the entire copying process.
When the copying process is finished, click Next.
The Remote Upgrade window appears.
Select No, and click Next.
The Cluster Configurations window appears.
Select No to select a standard installation, and click Next. If you want to install to a clustered environment, see Install into a Clustered Environment for more information.
The Configuration and Installation window displays three tabs to configure your installation.
Click the Tomcat Server Configuration tab.
Enter the appropriate information for your Tomcat server configuration.

Tomcat Login Information

Choose an account, and enter the account username and password, if necessary.

In Windows, if you select Use Existing Account, ensure that the account entered has the necessary permission described below:

If you want to use NT authentication for SQL Server databases for a Windows installation, you must use an existing account.

When using an existing account, set the permissions for starting the Tomcat service. Access \Domain\Users\ to enable the logon for the particular user group and to set permissions.

Read permission to the directory from which the installation program is being run
Log On As a Service rights and permissions (refer to Tomcat documentation for setup information).
Write permissions to all paths provided during installation for the install folder, log files directory, application files location
Write permissions to the shared drive for a clustered install (if applicable)

Tomcat Path Configuration

Confirm the default path to the location where the log files will be stored, or - if necessary - browse to the desired path. Log files track user activities in the VoiceConsole application.

Tomcat Port Configuration

Confirm the default ports that the application server will use, or - if necessary - enter different ports.

Click the Database Configuration tab.

Enter the appropriate information for your database.

SQL Server

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

Field	Description	Valid Entry Format
Database Hostname	DNS name or IP address of the machine hosting the database.
Database Port	The port that the database uses.	Must be an integer between 1 and 65535. Default is 1433.
Database Name	The name of the database.

Field

Description

Valid Entry Format

Database Hostname

DNS name or IP address of the machine hosting the database.

Database Port

The port that the database uses.

Must be an integer between 1 and 65535.

Default is 1433.

Database Name

The name of the database.

For Advanced

Field	Description	Valid Entry Format
JDBC URL	The JDBC URL for the database.	jdbc:sqlserver://<host>:<port>; DatabaseName=<database name>

For Both Basic and Advanced

Field	Description	Valid 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 Username	The username that the application should use to log into the database. This is disabled if using NT Authentication.
Database Password	The password of the user that the application should use to log into the database. This is disabled if using NT Authentication.
Database Schema	The database schema that you are using.

Oracle

For installations using Oracle, you must enter the following information:

For Basic

Field	Description	Valid Entry Format
Database Hostname	DNS name or IP address of the machine hosting the database.
Database Port	The port that the database uses.	Must be an integer between 1 and 65535. Default is 1521.
SID or Service Name	The SID or Service Name of the Oracle database.

Field

Description

Valid Entry Format

Database Hostname

DNS name or IP address of the machine hosting the database.

Database Port

The port that the database uses.

Must be an integer between 1 and 65535.

Default is 1521.

SID or Service Name

The SID or Service Name of the Oracle database.

For Advanced

Field	Description	Valid Entry Format
JDBC URL	The JDBC URL for the database.	jdbc:oracle:thin:@<host>:<port>:<database name>

For Both Basic and Advanced

Field	Description	Valid Entry Format
Database Username	The username of a user with administrative privileges.
Database Password	The password of a user with administrative privileges.

Click the VoiceConsole Configuration tab.
Enter the appropriate information for your VoiceConsole configuration.
VoiceConsole Hostname
Specify the hostname of the machine onto which you are installing VoiceConsole.
Display Dialog Port
Confirm the default port that the application server will use for the Display Dialog feature.
Enable HTTPS Support
Select to enable secure HTTPS on all pages of VoiceConsole. Certain pages are still secure if this check box is not selected.
Storage Directory
Specify where you would like to have application files stored.
The storage directory must have enough room to store device logs, which could grow very large in a short amount of time. See VoiceConsole System Requirements for more information. Additionally, VoiceConsole performance may be negatively affected if the storage directory is on a shared network drive with low throughput. If not required for clustering, Honeywell recommends having this location on a local drive.
Enable SAML SSO
Check to enable Federation SAML (Security Assertion Markup Language) Single Sign On. Additional configuration is necessary to use this feature after the installation is completed.
SAML SSO cannot be enabled during an upgrade installation. It can only be enabled during a new installation.
Click Install Now.
The installation begins. When the first part of the VoiceConsole installation is successfully completed, click OK.
If installing on Windows, the Setup Shortcuts window appears. If installing on Linux, go to step 19.
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 VoiceConsole is placed on the desktop automatically after the installation process completes.
Click Next.
When the installation is complete, the Installation Finished window appears.
If desired, click Generate script to generate an .xml file with your installation choices to use for silent or automatic installations.
Click Done.
The VoiceConsole Installer closes, and the VoiceConsole application opens.

Install into a Clustered Environment

This installation procedure is different from the standard installation procedure in that you must install on each node in the cluster individually. The license that was provided to you must be imported into each installation.

Installing in a clustered environment:

If you are installing into an Active/Passive cluster configuration, make sure that the active node has access to shared resources - for example, the log and firmware files location.

Install Into the First Node

If one is not already installed, install the database platform.
Create a blank VoiceConsole database and a user with create, read, and write permissions to the database. When you run the installer in the next step, the database schema will be created automatically.
Run the installer.
The Introduction window appears.
Click Next.
The License Agreement window appears.
Accept the terms of the license agreement and click Next.
The Select Installation Path window appears.
Click Next to install to the default path, or - if necessary - browse to the desired installation path and click Next.
The Software to Install window appears.
Click Next.
The Copying Software window displays the installer's progress during the copy of the individual selected software and the entire copying process.
When the copying process is finished, click Next.
The Cluster Configurations window appears.
Select Yes, select a directory that can be accessed by all cluster nodes by the same path, and click Next.
For Windows operating systems, Honeywell recommends using a UNC path (ex. \\ComputerName\Path) as the Shared Storage directory.
The Configuration and Installation window displays three tabs to configure your installation.
Enter the appropriate information for your Tomcat server configuration.
Tomcat Login Information
Choose an account, and enter the account username and password, if necessary.
In Windows, if you select Use Existing Account, ensure that the account entered has the necessary permission described below:
If you want to use NT authentication for SQL Server databases for a Windows installation, you must use an existing account.
- Read permission to the directory from which the installation program is being run.
- Log On As a Service rights and permissions.
- Write permissions to all paths provided during installation for the install folder, log files directory, application files location.
- Full Control permissions to the shared drive for a clustered install (if applicable).
Tomcat Path Configuration
Confirm the default path to the shared storage location where log files will be stored, or- if necessary - browse to the desired path. Log files track user activities in the VoiceConsole application.
Tomcat Port Configuration
Confirm the default ports that the application server will use, or - if necessary - enter different ports.
Click the Database Configuration tab.

Enter the appropriate information for your database.

SQL Server

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

Field	Description	Valid Entry Format
Database Hostname	DNS name or IP address of the machine hosting the database.
Database Port	The port that the database uses.	Must be an integer between 1 and 65535. Default is 1433.
Database Name	The name of the database.

Field

Description

Valid Entry Format

Database Hostname

DNS name or IP address of the machine hosting the database.

Database Port

The port that the database uses.

Must be an integer between 1 and 65535.

Default is 1433.

Database Name

The name of the database.

For Advanced

Field	Description	Valid Entry Format
JDBC URL	The JDBC URL for the database.	jdbc:sqlserver://<host>:<port>; DatabaseName=<database name>

For Both Basic and Advanced

Field	Description	Valid 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 Username	The username that the application should use to log into the database. This is disabled if using NT Authentication.
Database Password	The password of the user that the application should use to log into the database. This is disabled if using NT Authentication.
Database Schema	The database schema that you are using.

Oracle

For installations using Oracle, you must enter the following information:

For Basic

Field	Description	Valid Entry Format
Database Hostname	DNS name or IP address of the machine hosting the database.
Database Port	The port that the database uses.	Must be an integer between 1 and 65535. Default is 1521.
SID or Service Name	The SID or Service Name of the Oracle database.

Field

Description

Valid Entry Format

Database Hostname

DNS name or IP address of the machine hosting the database.

Database Port

The port that the database uses.

Must be an integer between 1 and 65535.

Default is 1521.

SID or Service Name

The SID or Service Name of the Oracle database.

For Advanced

Field	Description	Valid Entry Format
JDBC URL	The JDBC URL for the database.	jdbc:oracle:thin:@<host>:<port>:<database name>

For Both Basic and Advanced

Field	Description	Valid Entry Format
Database Username	The username of a user with administrative privileges.
Database Password	The password of a user with administrative privileges.

Click the VoiceConsole Configuration tab.

Enter the appropriate information for your VoiceConsole configuration.

Field	Description
VoiceConsole Hostname	Specify the hostname or IP address of the machine controlling the cluster.
Display Dialog Port	Confirm the default port that the application server will use for the Display Dialog feature.
Enable HTTPS Support	Select to enable secure HTTPS on all pages of VoiceConsole. Certain pages are still secure if this check box is not selected.
Storage Directory	Confirm the default path to the shared storage location accessible by all cluster nodes where you would like to have application files stored. The storage directory must have enough room to store device logs, which could grow very large in a short amount of time. See VoiceConsole System Requirements for more information. Additionally, VoiceConsole performance may be negatively affected if the storage directory is on a shared network drive with low throughput. If not required for clustering, Honeywell recommends having this location on a local drive.

Click Install Now.
The installation begins. When the first part of the VoiceConsole installation is successfully completed, click OK.
If installing on Windows, the Setup Shortcuts window appears. If installing on Linux, go to step 18.
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 VoiceConsole is placed on the desktop automatically after the installation process completes.
Click Next.
The installation continues. When the installation is complete, the Installation Finished window appears.
If desired, click Generate script to generate an .xml file with your installation choice data to use for silent or automatic installations.
Click Done.
The VoiceConsole Installer closes, and the VoiceConsole application opens.

Install into Additional Nodes

If you are installing into an Active/Passive cluster configuration, make sure that the active node has access to shared resources - for example, the log and firmware files location.

Run the installer

The Introduction window appears.
Click Next.
The License Agreement window appears.
Accept the terms of the license agreement, and click Next.
The Select Installation Path window appears.
Click Next to install to the default path or, if necessary, browse to the desired installation path and click Next.

The Software to Install window appears.
Click Next.
The Copying Software window displays the installer progress during the copy of the individual selected software and the entire copying process.
When the copying process is finished, click Next.
The Cluster Configurations window appears.
Select Yes, select the directory that you entered in step 9 of Install Into the First Node, and click Next.
The Configuration and Installation window contains three tabs to configure your installation.
Click the Tomcat Server Configuration tab.
In the Tomcat Path Configuration field, confirm the default path to the shared storage location where log files will be stored, or - if necessary - browse to the desired path.
Fields on the tabs of the Configuration and Installation window are populated with installation information entered when you installed VoiceConsole on the first node. Only the Tomcat Path Configuration field can be edited.
Click the Database Configuration tab and the VoiceConsole Configuration tab to verify that the information automatically entered.
Click Install Now.
The installation begins. When the first part of the VoiceConsole installation is successfully completed, click OK.
If installing on Windows, the Setup Shortcuts window displays. If installing on Linux, go to step 14.
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.
Click Next.
The installation continues. When the installation is complete, the Installation Finished window displays.
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.
Click Done.
The VoiceConsole Installer closes, and the VoiceConsole application opens.