This document contains information and procedures that reduce the time needed to pinpoint and solve many common Call Management System (CMS) and Multi-Application Platform on Definity (MAPD) problems.
Cisco recommends that you have knowledge of these topics:
Cisco Intelligent Contact Management (ICM)
The information in this document is based on these software and hardware versions:
Cisco ICM version 4.6.2 or later
Avaya Automatic Call Distribution (ACD)
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.
Refer to Cisco Technical Tips Conventions for more information on document conventions.
The CMS provides snapshots of the real-time agent login and logout and of non-ACD-related agent state data to the Peripheral Gateway (PG) through the CMS Ethernet connection. A single CMS report is required for each Peripheral Interface Manager (PIM). For example, a duplexed PG connected to a single Definity Enterprise Communications Server (ECS) requires two CMS reports. Only one report is running at any given time, per the Definity ECS ACD.
This section covers several items to check when you are troubleshooting the Avaya Definity G3 switch when CMS is implemented.
Open the host file using a text editor. The host file can be found in C:\WINNT\system32\drivers\etc\hosts. Get both the host name and the IP address of the CMS device, and try to ping from a Telnet session or a DOS prompt on the PG that connects to the CMS device that is using the IP address. If you can not ping the CMS device then there is a network connection problem that must be resolved.
A Request timed out indication is a symptom of a broken network connection:
C:\> ping 126.96.36.199 !--- Use the IP address of the CMS device. Pinging 188.8.131.52 with 32 bytes of data: Request timed out. Request timed out. Request timed out. Request timed out.
Try to ping by the host name instead of the IP address, to verify that the host name is correct.
For additional information, refer to Ping Utility Usage.
Another command used to determine where the network break is located is the tracert command. This command is also run at a command prompt:
C:\> tracert 184.108.40.206 !--- Use the IP address of the CMS device.
For additional information, refer to Using the Trace Route Utility.
Timeout errors are a direct response from a ping command and, depending on the time delay, can also be a symptom of IP network problems:
C:\> ping 220.127.116.11 Pinging 18.104.22.168 with 32 bytes of data: Reply from 22.214.171.124: bytes=32 time<10ms TTL=128 Reply from 126.96.36.199: bytes=32 time<123ms TTL=128 Reply from 188.8.131.52: bytes=32 time<175ms TTL=128 Reply from 184.108.40.206: bytes=32 time<68ms TTL=128
The ECS PIM process that runs on the PG clearly shows, in either the process window or the PIM log files, that the CMS Real Time feed is down or an ASAI link 0 failure is detected.
If the CMS device is not sending the Real Time Adherence (RTA) report then the ECS PIM process on the PG can not become active; the ECS PIM process continually tries to restart until it receives the RTA report from the CMS device. The customer often is not aware of this type of problem, when the CMS report is viewed from the CMS PC. At this point, the CMS reports must be stopped and started, or the CMS PC must be stopped and started by the customer or Avaya support. This happens frequently when a customer does a CMS backup and forgets to stop and start the RTA report when the backup is completed.
See the Event ID table.
It is very important that the CMSTypicalRefreshRateSec on the PG matches the same time setting on the Avaya Definity G3. The preferred setting is 10 seconds. A mismatch of this setting can cause the CMS to go down randomly. This setting on the PG side can be found in the registry in one of these keys:
|ICM 4.6.2||\HKEY_LOCAL_MACHINE\SOFTWARE\Geotel\ICR\<cust_inst>\<pg_inst> \PG\CurrentVersion\PIMS\<pim_inst>\ATTData:|
|5.x and later||\HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\ICM\<cust_inst>\<pg_inst>\PG\CurrentVersion\PIMS\<pim_inst>\ATTData:|
Note: Those keys are displayed over two lines due to space limitations.
The setting for this field on the Avaya side must be set by Avaya support.
This must be true when the Definity ECS is configured:
For a Basic Rate Interface (BRI) Adjunct Switch Application Interface (ASAI) link, the Terminal End Indicator (TEI) value is 3.
For a Definity LAN or MAPD, the TEI value is 1.
The MAPD is a card which is plugged into the Avaya Definity switch. The Call Visor LAN (CVLAN) Server software runs on it, and it is used to configure the ASAI links between the Switch and the PG. Most often, the links are on the same LAN segment as the PG.
It is entirely a Avaya product that is supported by Avaya.
Avaya provides Cisco with a utility called ASAI_TEST that tests the connectivity from the Definity ESC PG over the ASAI link to the MAPD card. A test failure indicates that the trouble is with the MAPD card and that the card needs to be reset. Most often, the card is reset by Avaya onsite support in one of these ways:
Restart through software.
Press the reset button on the back of card.
This is an example of how to use the ASAI_TEST utility to test MAPD connectivity:
C:\icm\bin> asai_test -m hostname or ipaddress node_id !--- The node_id is a value from 1 to 8.
The host name and IP address for the MAPD card can be found in the host table.
For additional information, refer to Using the ASAI_TEST Utility.
This is an example of a successful test connection with the host name amexphxg3:
C:\icm\bin> asai_test -m amexphxg3 1 Heartbeat with switch for ASAI node signal01 was successful.
This is an example of a failed test connection with the IP address 220.127.116.11:
C:\icm\bin> asai_test -m 18.104.22.168 1 Open of ASAI communication path for ASAI node signal01 failed. :Error messages not available open failed errno= 2 Heartbeat test with switch for ASAI node signal01 failed.
For related Microsoft Event Viewer Application Log error codes associated with CMS and ASAI failures, see the Event ID table. Follow these steps to access the Microsoft Event Viewer on the PG:
Choose Start > Programs > Administrative Tools (Common) > Event Viewer.
Choose File > Open Log File from the Event Viewer menu.
For additional information, refer to What is the NT Event Viewer?.
This table provides definitions of error codes related to CMS and MAPD that are generated by Microsoft Event Viewer:
|49275||ASAI link0 failure detected. Call visor ASAI reports status: 0.|
|49246||Required minimum number of ASAI links (1) not active.|
|32791||Client PIM1 stopping due to error.|
|63||Side A PIM1 process down.|
|49193||Unable to activate ASAI link 0.|
|49240||CMS agent real-time feed #0 data timeout.|
|16387||CMS data (0) processed invalid CMS record.|
|49134||Unable to activate CMS.|
|49157||CMS agent real-time feed #1 is down.|
The Cisco Support Community is a forum for you to ask and answer questions, share suggestions, and collaborate with your peers.
Refer to Cisco Technical Tips Conventions for information on conventions used in this document.