Introduction
This document describes how to change the Unreachable Destination timeout value in a Cisco Unified Customer Voice Portal (CVP) Call Server.
Contributed by Usman Ahmed, and Divin John Cisco TAC Engineers.
Prerequisites
Requirements
Cisco recommends that you have knowledge of these topics:
Components Used
The information in this document is based on these software versions:
- CVP Call server 8.5 or higher
- Wireshark
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.
Problem
When CVP Call Server configuration has multiple SIP (Session Initiation Protocol) Elements in a SIP Server group, CVP sends out the INVITE to the server with the highest priority. If the SIP element is down, CVP adds the SIP Element to an Unreachable Destination table. If SIP heart beats(OPTIONS Ping) are not enabled, then SIP element stays in the Unreachable table for 180 seconds.
Sample srv.xml Configuration
In this SIP Server group configuration, SIP Server 192.168.1.1 is the primary and 192.168.1.2 is the secondary server. If the primary server is down, CVP will place it in the Unreachable table for 180 seconds and route all calls to the secondary server. Once 180 seconds are over, CVP will remove the primary server from the Unreachable table and route calls to it.
- <host name="cusp.cisco.com">
<record weight="50" priority="1" destination="192.168.1.1" port="5060" />
<record weight="50" priority="2" destination="192.168.1.2" port="5060" />
</host>
CVP Call Server Log Analysis
SIP Element 10.17.120.5 added to Unrachable Table
250274141: 10.73.33.15: Jul 24 2012 09:21:13.244 -0500: %_ConnectionManagement-7-com.dynamicsoft.DsLibs.DsUALibs.DsSipLlApi.ConnectionManagement: UnreachableDestinationTable - add (10.17.120.5:5060:2). Current count: 2
(3 minutes later)
SIP Element 10.17.120.5 removed from Unreachable Table
250285352: 10.73.33.15: Jul 24 2012 09:24:13.244 -0500: %_ConnectionManagement-7-com.dynamicsoft.DsLibs.DsUALibs.DsSipLlApi.ConnectionManagement: UnreachableDestinationTable - remove (10.17.120.5:5060:2). Current count: 2
Change the UnreachableTable Destination Timeout
The UnreachableTable Destination timeout is configurable only in Java Virtual Machine (JVM) level. This timeout is not configurable in CVP Operations Console (OAMP).
Step 1. Open a remote desktop session into the CVP Call Server.
Step 2. Open the Registry Editor (Start > Run > regedit ).
Step 3. Browse to HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Procrun 2.0\CallServer\Parameters\Java.
Step 4. Double-click on muti-string Options.
Step 5. Add "-Dcom.dynamicsoft.DsLibs.DsSipLlApi.unreachDestTimeout=360". (Unreachable destination timeout in the following example would be set to 360 seconds).
Step 6. Restart the Call Server from OAMP (or use Windows services.msc to restart the Call Server service) .