Cisco
The DuVoice can link to a Cisco Unified Communications Manager PBX (CUCM) using a TCP connection where the PBX is the server. This link uses the protocol and features listed in the table below:
| Link Type | Protocol Used | Log File Prefix | Features Supported |
|---|---|---|---|
| TCP Client | Cisco AXL interface | CISCO | Name Change, Set user rights group (phone COS), DND |
This page is used to configure the 7.00's link to the PBX.
The settings are grouped into three categories: Network, Scheduling and Optional. Configure the settings as needed and then click OK to save your changes and close the dialog. Or click Cancel to discard any changes and close the dialog.
Network Settings
| Setting | Default | Description |
|---|---|---|
| IP or DNS Name | (blank) | Enter the IP address or domain name of the PBX. |
| PBX Version | 14 | Select the version number of your CUCM. Supported versions are 6, 8, 11 and 14. Cisco typically supports multiple different versions of AXL the interface used by the DV2000. For example version 14 supports AXL versions 14, 12, and 11. |
| User | (blank) | Enter the user ID of the account you created in the CUCM for this link. |
| Password | (blank) | Enter the password of the account you created in the CUCM for this link. |
| TCP Port number | 8443 | Must be set to 8443 unless you have changed it in the Cisco administration. |
| DND Forward all to Operator | Disabled | If checked: When DND is set for a subscriber mailbox, the system will set 'forward all' to the extension of the operator that belongs to the same tenant as the mailbox. When DND is turned off, the 'forward all' feature is disabled on the PBX. |
Scheduling
| Setting | Default | Description |
|---|---|---|
| Retries | 3 | Number of times to retry sending a change request to the PBX if the first attempt fails for some reason. Default is 3 retries (for a total of four attempts). |
| Interval (seconds) | 60 | Enter the number of seconds to wait between attempts to send a change request if the PBX does not respond. |
| Cache Refresh (minutes) | 60 | Number of minutes before refreshing the cache. Excessive cache refresh can cause poor performance. |
Optional
| Setting | Default | Description |
|---|---|---|
| Ignore missing | Unchecked | If we are unable to find an extension on the PBX then ignore retries. This box should be checked when a room has extensions which do not exist on the PBX. Doing so will still attempt to update it, however if it's not in the cache then it will not be rescheduled not considered an error. |
| Force cache update (end-user) | Unchecked | If an extension cannot be found in the end-user cache when a change is requested, checking this field will force the cache to be refreshed. Uncheck this field when not all mailbox extensions are configured on the PBX. Excessive cache refresh can cause poor performance. |
| Force cache update (device) | Unchecked | If an extension cannot be found in the device cache when a change is requested, checking this field will force the cache to be refreshed. Uncheck this field when not all mailbox extensions are configured on the PBX. Excessive cache refresh can cause poor performance. |
| Information URL | (blank) | Enter the URL of the server from which the phone retrieves help text when the guest presses the information button or question mark button. Leave blank to use the default setting on the PBX. |
| Directory URL | (blank) | |
| Services URL | (blank) | Enter the URL of the server the phone contacts when the guest presses the Services button. Leave blank to use the default setting on the PBX. |
| Authentication Server URL | (blank) | Enter the URL that the phone uses to verify requests made to the phone web server. Leave blank to use the default setting on the PBX. |
| Message URL | (blank) | Enter the URL for the message server, which the phone contacts when the guest presses the Messages button. Leave blank to use the default setting on the PBX. |
| Idle URL | (blank) | Enter the URL of the server from which the phone retrieves the information to display when the phone has been idle for the length of time specified in the Idle Timer Occupied or Idle Timer Unoccupied setting (as determined by room status). Leave blank to use the default setting on the PBX. |
| Idle Occupied timer (seconds) | 0 | Enter the length of time, in seconds, the phone in an occupied room should be idle before the phone queries the server specified in the Idle URL setting to update the display. Set to 0 to disable. |
| Idle Vacant timer (seconds) | 0 | Enter the length of time, in seconds, the phone in an unoccupied room should be idle before the phone queries the server specified in the Idle URL setting to update the display. Set to 0 to disable. |
| URL Group | Secure | Select which group of URLs to update, Secure or Standard. Secure URLs must use HTTPS (SSL) while Standard URLs use regular HTTP. |
Other
| Setting | Default | Description |
|---|---|---|
| Enable debug | Unchecked | All communications packets will be logged. WARNING: This will make very large log files. |
Custom names
Starting with version 8.0.21 the display and displayAscii name of a device can be customized on a per-tenant basis. This file is read at each name change and can be modified or added while the system is running.
A single file can control the name changes for multiple tenants. Each section in the INI file should match the ID of the tenant the custom override should be perform for.
- Create a file named namechange.ini in the \database folder. Typically this is located in the path c:\vs\database.
- Add a section with the value of the Tenant ID. This is located in the tenant details page. Example: 8b9a6860-4a38-11e7-b52d-902b34db254e.
- Add the field you want to change it can be either display and or displayAscii. These are case sensitive and the value can use any of the standard name translation macros listed in the Name Translations tab in the tenant. These fields cannot be greater than 30 characters on the PBX. If the field is larger than that it will be truncated automatically.
Some characters are not allowed for these fields in the PBX. Valid characters include:
;#?@/,*+^`{}|\\$ '~!:.()[]_-0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ
Example
- namechange.ini
[8b9a6860-4a38-11e7-b52d-902b34db254e] display=${title} ${last} (M) displayAscii=${title} ${last} (M)