Ask Before Update

Auto-upgrade service prompts the User to upgrade the TSP client.

Never AutoUpdate

Select this to disable the auto-update service.

Always AutoUpdate

Select this to enable automatic updates when new TSP client versions are detected.

AutoUpdate on Incompatible QBEProtocolVersion

Select this to allow the Cisco TSP to auto update only when the local TSP version is incompatible with the Unified CM version.

User Name

Enter the user name of the user. The TSP instance will access devices and lines that are associated with this User in Cisco Unified CM. Make sure that this User is enabled for CTI using the Cisco Unified CM Administration UI

Password

Enter the password that is associated with the user. The computer encrypts the password and stores it in the registry.

Verify Password

Reenter the user password.

Primary CTI Manager Location

Use this field to specify the CTI Manager to which the TSP attempts to connect to first. Select any of these options:

• Select IPv4 Address radio button and use the text box to provide the IPv4 address of the Primary CTI Manager, or
• Use IPv6 Address radio button and use the text box to provide the IPv6 address, if application needs to connect using IPv6 with Primary CTIManager, or
• Select the Host Name radio button and enter the host name of Primary CTI Manager.

Backup CTI Manager Location

Use this field to specify the CTI Manager to which the TSP attempts to connect to first. Select any of these options:

• Select the IPv4 Address radio button and use the text box to provide the IPv4 address of the Backup CTI Manager, or
• Select IPv6 Address radio button and use the text box to provide the IPv6 address of the Backup CTI Manager, or
• Select the Host Name radio button and enter the host name of the Backup CTI Manager.

IP Addressing Preference

Preferred addressing mode with which the application tries to connect with the CTIManager when IPv4 or IPv6 address is available.

If the TSP fails to connect, it will retry with the other IP addressing modes.

Secure Connection to CTIManager

If selected, TSP will secure the connection with CTIManager. Default setting is a non-secure connection, so the setting is unchecked.

It is important that the security flag for the TSP User must be enabled through the Cisco Unified CM Administration UI. CTIManager performs a verification to check whether the User connecting via TLS is allowed to have secure access. CTIManager allows only security-enabled users to connect using TLS.

The User flag to enable security requires the cluster security to also be enabled/set, otherwise the connection has to be non-secure.

Fetch Certificates

Select this option for the Cisco TSP to download certificate files if they are not already available or installed. This is performed when the certificate status is Need Update.

This setting is not stored anywhere and is used only to update the Client certificate when checked and is cleared automatically.

Authorization String

Provide the authentication (authorization) string generated under the CAPF profile.

To install or upgrade a locally stored certificate, the User must enter the authentication (authorization) string. This string supports one-time use only; after you use the string for an instance, you cannot use it again.

This is required for Client authentication with CAPF Server and Private Key storage on client machine.

Instance Identifier

Provide Instance ID for CAPF end User profile:

Each secure connection to CTIManager must have its own certificate for authentication. With the restriction of a distinct certificate per connection, CAPF Server must verify that the user with appropriate AuthCode and InstanceID is requesting the certificate. CAPF server uses the AuthCode and InstanceID to verify the User's identity. Once CAPF server provides a certificate it clears the AuthCode to ensure that only one instance of an application requests a certificate based on a single AuthCode. Cisco Unified CM Administration UI allows User configuration to provide multiple InstanceID and AuthCode.

IP Address

Provide the CAPF server IP address from which to fetch the client certificate.

Port

Provide the CAPF Server Port to connect for Certificate download (Default :3804).

Number of Retries for Certificate Fetch

Indicates the number of retries TSP will perform to connect to the CAPF Server for certificate download in case of an error.

This value is used when a communication failure occurs while the certificate installation is taking place.

Default value is 0 and range is 0 to 3.

Retry Interval for Certificate Fetch

Indicates the number of seconds the TSP should wait between re-attempting to retrieve the certificate.

Default value is 0 and range is 0 to 15.

TFTP IP Address

Indicates the TFTP server IP address from which to fetch the CTL file. CTL file is required to verify the server certificate, sent while mutually authenticating the TLS connection.

Automated Voice Calls

The number of Cisco Wave devices determines the number of automated voice lines. (The default value is 5.) The application can open as many CTI ports as the number of Cisco Wave devices that are configured. For example, if you enter "5," you need to create five CTI port devices in Cisco Unified Communications Manager. If you change this number, you need to remove and then reinstall any Cisco Wave devices which were installed.

A maximum of 255 Wave devices for all installed TSP instances can be configured. The Wave device limit is specific to Microsoft TAPI which limits the number of Wave devices per Wave driver to 255. The Cisco Media Driver does not have this limitation.

When you configure 256 or more Wave devices (including Cisco or other Wave devices), Windows displays the following message when you access the Sounds and Multimedia control panel: "An Error occurred while Windows was working with the Control Panel file C:\Winnt\System32\MMSYS.CPL."

The current number of possible automated voice lines designates the maximum number of lines that can be simultaneously opened by using both LINEMEDIAMODE_AUTOMATEDVOICE and LINEMEDIAMODE_INTERACTIVEVOICE.

If you are not developing a third-party call control application, check the Enumerate only lines that support automated voice check box, so the Cisco TSP detects only lines that are associated with a CTI port device.

Silence Detection

If you use silence detection, this check box notifies the Wave driver to detect silence on lines that support automated voice calls that are using the Cisco Wave Driver. If the check box is selected (default), the Wave driver searches for the absence of audio-stream RTP packets. As all devices on the network suppress silence and stop sending packets, this method provides a very efficient way for the Wave driver to detect silence.

However, if some phones or gateways do not perform silence suppression, the Wave driver must analyze the content of the media stream and, at some threshold, declare that silence is in effect. This CPU-intensive method handles media streams from any type of device.

If some phones or gateways on your network do not perform silence suppression, you must specify the energy level at which the Wave driver declares that silence is in effect. This value of the 16-bit linear energy level ranges from 0 to 32767, and the default value is 200. If all phones and gateways perform silence suppression, the system ignores this value.

On

This setting allows you to enable Global Cisco TSP trace.

Select the check box to enable Cisco TSP trace. When you enable trace, you can modify other trace parameters in the dialog box. The Cisco TSP trace depends on the values that you enter in these fields.

Clear the check box to disable Cisco TSP trace. When you disable trace, you cannot choose any trace parameters in the dialog box, and TSP ignores the values that are entered in these fields.

File size

Default file size is 1 MB.

No. of files

Use this field to specify the maximum number of trace files. The default value is 10. File numbering occurs in a rotating sequence starting at 0. The counter restarts at 0 after it reaches the maximum number of files minus one.

Directory

Use this field to specify the location in which trace files for all CiscoTSPs are stored.

The system creates a subdirectory for each instance of CiscoTSP. For example, the CiscoTSP001Log directory stores Cisco TSP 1 log files. The system creates trace files with filename TSP001Debug000xxx.txt for each TSP in its respective subdirectory.

TSP Trace

This setting activates internal TSP tracing. When you activate TSP tracing, Cisco Unified TSP logs internal debug information that you can use for debugging purposes. You can choose one of the following levels:

Error—Logs only TSP errors.

Detailed—Logs all TSP details (such as log function calls in the order that they are called).

The system checks the TSP Trace check box and chooses the Error radio button by default.

CTI Trace

This setting traces messages that flow between Cisco TSP and CTIManager. By default, CTI Trace is not selected.

TSPI Trace

This setting traces all messages and function calls between Microsoft TAPI and the Cisco TSP. By default, TSPI Trace is not selected.

If TSPI Trace is enabled, Cisco TSP traces all the function calls that Microsoft TAPI makes to the Cisco TSP with parameters and messages (events) from Cisco TSP to MS TAPI.

Synchronous Message Timeout (secs)

Use this field to designate the time that the TSP waits to receive a response to a synchronous message. The value displays in seconds, and the default value is 15. Range goes from 5 to 60 seconds.

Requested Heartbeat Interval (secs)

Use this field to designate the interval at which the heartbeat messages are sent from TSP to detect whether the CTI Manager connection is still alive. TSP sends heartbeats when no traffic exists between the TSP and CTI Manager for 30 seconds or more. The default interval is 30 seconds. Range goes from 30 to 300 seconds.

Connect Retry Interval (secs)

Use this field to designate the interval between reconnection attempts after a CTI Manager connection failure. The default value is 30 seconds. Range goes from 15 to 300 seconds.

Provider Open Completed Timeout (secs)

Use this field to designate the time that Cisco Unified TSP waits for a Provider Open Completed Event, which indicates the CTI Manager is initialized and ready to serve TSP requests. Be aware that CTI initialization time is directly proportional to the number of devices that are configured in the system. The default value is 50 seconds. Range goes from 5 to 900 seconds.

TFTP Server IP Address

Configure the TFTP server IP where the COP files are installed for the desired Locales.

Update Locale Files

Downloads the locale files from the configured TFTP server and extracts those files to the resources directory in the client machine

Change Language

Choose a language and click this to reload the tabs with the text in that language.