Table Of Contents
Troubleshooting TAPS on the Cisco IP IVR/IP AA Server
Troubleshooting BAT and TAPS
These section describe problems you may encounter when using BAT or TAPS, provides the error messages, and suggests actions to help you resolve the problems.
Related Topics
•
Troubleshooting TAPS on the Cisco IP IVR/IP AA Server
BAT Log Files
BAT generates log files for each bulk transaction and stores them on the Publisher database server in the following location: C:\CiscoWebs\BAT\logfiles\.
The log file also shows the key value of a record, so the administrator may re-examine the record. The MAC address of the phone serves as the key value when adding, updating, or modifying phones. When users are added, the User ID serves as the key value.
View Log File displays the summary view for the bulk transaction as well as the detail view for the failures.
Caution
Viewing BAT Log Files
To view the log file for the bulk operation, select View Log File on the BAT interface or go to the following location:
C:\CiscoWebs\BAT\LogFile directory.
Note
The timestamp format for the log file name is mmddyyyyhhmmss.
Table 1 shows examples of commands and log file names.
Troubleshooting BAT
The following list describes some scenarios that could occur, and provides possible resolutions.
Symptom Failure details show on log file.
Explanation The message shows the MAC address or dummy MAC address for phones, or the User ID for users.
Action Open the file <ModifiedDataFileName>#TimeStamp.dat in Notepad and look for an error in one of the records. Access the log files in the C:\CiscoWebs\BAT\LogFile folder on the Publisher database server.
Symptom The page cannot be displayed.
Explanation Message can occur because of an unexpected termination of IIS Administrative service.
Action This is a display problem only. The process continues in the background. You can refer to the log file for transaction details.
Symptom Stop BAT does not work.
Explanation You have tried stopping BAT using the instructions in Stopping BAT, page 1-8, but it is not working.
Action Close other applications and processes that are running on your system and try again.
Symptom Data files (CSV) format does not match Phone Template/Sample File.
Explanation The number of lines on the data file should exactly match the number of lines configured in the Phone Template, but do not. For example, the phone template has four lines, and, of these, Lines 1, 3, and 4 are configured. Phone data file should be used (in all the cases, there should be three fields)
1111,3333,4444 results in Line1-1111 Line2-None Line3-3333 Line4-4444Action View the phone template files stored as a file on the server to look for a deleted record (such as location or line number).
Symptom Errors occur when using the dummy MAC address option.
Explanation Errors occur in the records for the dummy MAC addresses.
Action To map this to the records that actually had the problem, you can see another generated file with the name <ModifiedDataFileName>#<TimeStamp>.dat that shows the actual record with dummy MAC address. Access this file in the ...\BAT\LogFiles folder.
Symptom The Call Pickup Group entered does not exist.
Explanation You are attempting to add or update a record using a call pickup group that is not configured in the system.
Action Click Application > Cisco CallManager Administration and configure the call pickup group. You can then return to BAT, use the newly configured call pickup group, and proceed with the bulk transaction.
Symptom Route partition for the call pickup group must be a member of the calling search space for that line.
Explanation The route partition used in the call pickup group is not part of the calling search space for the line.
Action Click Application > Cisco CallManager and configure the calling search space with the appropriate route pattern. You can then return to BAT, use the updated call pickup group, and proceed with the bulk transaction.
Symptom Load information cannot be set for CYI ports.
Explanation CTI ports do not require load information.
Action Click Configure > Template > Phone and select the phone template you used for the transaction.
Symptom The location entered does not exist.
Explanation The location you are attempting to use does not exist in the system. Check your spelling and try again or add the location to Cisco CallManager.
Action Click Application > Cisco CallManager and configure the location. You can then return to BAT, use the new location, and proceed with the bulk transaction.
Symptom The User ID already exists.
Explanation The User ID you are attempting to add or update already has a user assigned to it, or you have added or updated using the same file as a previous transaction.
Action Click Application > Cisco CallManager and verify whether the user ID is correctly or incorrectly assigned. If incorrect, delete the user and return to BAT to start the bulk transaction again.
Symptom .The Manager entered does not exist.
Explanation You are trying to use a User ID for a Manager that does not exist.
Action Click Application > Cisco CallManager and verify whether the User ID of the Manager exists. If it does not exist, either use the User ID of an existing user, or insert the Manager's User ID in Cisco CallManager Administration or via BAT, and rerun the bulk transaction.
Symptom .Couldn't create user object. Check if DC Directory is running.
Explanation DC Directory is not running or it returned an error.
Action Click Start > Programs > Administrative Tools > Services and check whether the service "DC Directory Server" is running. If it is not, start the service and return to BAT to proceed with the bulk transaction.
Troubleshooting TAPS
The following conditions may occur while running TAPS on the Publisher database server or on the Cisco IP IVR/IP AA server. Actions provided allow TAPS to properly execute.
Java TAPS Exceptions
After starting the RMI registry and running Java TAPS using the command taps, you may encounter the following exceptions:
Symptom Security exception
Explanation Exception occurs because a policy file is not found for this user. The policytool.exe program, a Java application, allows you to manage policy files. A policy file contains a list of permissions that are associated with various sources of code. To allow an applet (or an application running under a security manager) to perform secured actions (such as reading or writing a file), the applet (or application) must be granted permission for that particular action. In the default policy implementation, a grant entry in a policy configuration file must grant that permission.
Action Perform the following steps to correct this problem.
Step 1
Step 2
Step 3
Note
Step 4
Symptom Already bound exception
Explanation Exception occurs because the TAPSCCM.txt file is trying to use a port that is already in use. TAPS runs on port number 9050 on the Cisco CallManager server.
Action Perform the following steps to change the port number in the TAPSCCM.txt file to a port that is not in use and copy the file to the Applications server.
Step 1
Note
Step 2
Step 3
Step 4
Note
Step 5
Step 6
Step 7
Step 8
Step 9
Symptom Class not found
Explanation Message occurs because the class path is not located where TAPS is installed.
Action Change the CLASSPATH to point to C:\TAPS in the system environment variable.
Symptom File not found
Explanation Message occurs because the java.exe is not found.
Action Perform the following steps to correct this problem.
Step 1
Step 2
Troubleshooting TAPS on the Cisco IP IVR/IP AA Server
You may receive the following messages while running TAPS on the Cisco IP IVR/IP AA server.
Symptom When the IP IVR/IP AA server starts, the JTAPI subsystem shows partial service or out of service
Explanation Message occurs because of configuration problems in the Cisco CallManager.
Action Perform the following steps to correct this problem.
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
Symptom The workflow does not start properly
Explanation Message occurs when a wrong path is set for CLASSPATH.
Action Set the CLASSPATH to C:\TAPS.
Symptom Preprocess exception
Explanation Cisco IP IVR/IP AA server trace file shows "Preprocess exception" for TAPS.aef.
Action Perform the following steps to correct this problem.
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
Step 7
If you have problems after restarting IP IVR/IP AA, check the CLASSPATH on the IP IVR/IP AA server and append C:\TAPS to the IP IVR/IP AA server.
Symptom Provider exception
Explanation Trace file of the IP IVR/IP AA server shows this error.
Action Make sure the Cisco CallManager service is running on the Cisco CallManager server.
