|
|
Table Of Contents
Release Notes for the Cisco Universal Gateway Call Analyzer 1.0(1)
Installing the Cisco UGCA Application Package
Launching Cisco UGCA from the Browser
Obtaining Technical Assistance
Release Notes for the Cisco Universal Gateway Call Analyzer 1.0(1)
The Cisco Universal Gateway Call Analyzer 1.0(1) (UGCA) monitors Cisco AS5000 universal gateway data to detect degradations in call connections and call quality that may impact service. You can create, edit, view, run, and export reports for analysis.
Contents
These release notes describe the following topics:
•
Caveats for Cisco UGCA 1.0(1)
•
Introduction
The Cisco Universal Gateway Call Analyzer (UGCA) monitors and reports call connection success and call quality on Cisco AS5000 universal gateways. The Cisco UGCA uses call records and modem call records, collected from Cisco IOS Call Tracker syslog messages, to create reports for analysis. The analysis help troubleshoot and detect degradation that may impact quality and service.
After downloading the call records and modem call records to the database, and using the predefined report types, you can use the Cisco UGCA to:
•
•
•
•
Create report specifications using the existing report types. Refer to the Cisco Universal Gateway Call Analyzer User Guide for a list of the default report types and report specifications.
System Requirements
This section outlines the hardware and software requirements for Cisco Universal Gateway Call Analyzer 1.0(1). For more information, refer to the Cisco Universal Gateway Call Analyzer User Guide.
Hardware Requirements
The following table lists the hardware requirements.
Hardware
Sun Ultra 10 Workstation (minimum)
Processor
UltraSparc
Operating System
Solaris 8
Memory
512 MB
Free disk space
4.6 GB (See the "Free Disk Space Requirements" section)
Software Requirements
The following table lists the software requirements
Sun Solaris Patches
Latest recommended patch cluster Solaris 8 and J2SE.
Refer to
http://sunsolve.sun.com/pub-cgi/
show.pl?target=patches/patch-accessJ2SE recommended patch cluster for Solaris 8 patches
Client Browser (recommended)
Microsoft Internet Explorer (IE) 5.5 or 6.0 with Microsoft Java VM on Windows 2000.
Refer to the Cisco Universal Gateway Call Analyzer User Guide for more information.
Installation Notes
Before You Begin
The following criteria must be met:
•
•
Refer to the Cisco Universal Gateway Call Analyzer User Guide for more information.
Free Disk Space Requirements
During an installation, only 100 MB of free disk space is required to accommodate the system software. However, the installation process checks to see that a minimum disk space of 4.6 GB is available. If this check fails, you can continue the installation; but if the check for 100 MB fails, the system does not install the software. Refer to the Cisco Universal Gateway Call Analyzer User Guide for more details.
Determine Free Disk Space
Use the following UNIX command to determine free disk space:
#df -b /optFollowing is displayed
Filename avail/dev/dsk/c0tod0s0 913758The value is in kilobytes. To ensure that you have sufficient free disk space, look for a value of greater than 4804841.
Installing the Cisco UGCA Application Package
To install the Cisco UGCA application, follow the procedure below:
Caution
Step 1
pkgadd -d /cdrom/cdrom0Step 2
Note
Step 3
Step 4
Step 5
Note
Step 6
Step 7
Step 8
The Cisco UGCA starts automatically and you are informed that the installation was successful.
Launching Cisco UGCA from the Browser
To launch the Cisco UGCA from the browser, follow the procedure below:
Note
Step 1
https://FQDN
where FQDN is the fully qualified domain name of the application server (for example, myserver.mydomain.com).Cisco UGCA launches.
Tip
Step 2
The predefined user ID is admin.
The predefined password is admin.
You are now connected to Cisco UGCA.
Using Cisco UGCA
Refer to the Cisco Universal Gateway Call Analyzer User Guide for details on how to perform the following tasks:
•
•
•
•
•
Caveats for Cisco UGCA 1.0(1)
This section contains the following caveats:
•
•
•
•
•
•
•
•
•
•
•
•
Backward Compatibility Not Supported
Backups of the Cisco UGCA 1.0 are not compatible with the Cisco UGCA 1.0(1). Restoring a Cisco UGCA 1.0 backup to a Cisco UGCA 1.0(1) may cause errors when starting the UGCA, or it may cause problems loading data and running reports.
Multiple Browser Windows from the Same IE Instance Not Supported (CSCdy52390)
Symptom
When you open a new browser window using File > New > Window menu, the new window belongs to the same Cisco UGCA session. You cannot edit the report specifications in both windows, because the server cannot distinguish between requests sent by two windows. Internet Explorer does not support multiple sessions for multiple windows opened from the same instance of IE.
Workaround
Create a new browser instance and then open a new window.
Edit Report Specification Locked by Exiting Edit Wizard by Closing the Browser (CSCdy65508)
Symptom
If you edit a report specification and then exit the report specification wizard by closing the browser, the report specification is locked and is inaccessible.
Workaround
The report specification remains locked until the session timeout expires. After the session timeout expires, you can access the report specification. To avoid this condition, use the Cancel and Finish buttons to exit the report specification wizard.
It Is Possible to Browse js/jars Subdirectories on the GUI (CSCdy72192)
Symptom
You can browse the subdirectories on the web server if you manually enter the URL specifying the subdirectory.
Workaround
Edit the file install /CSCOugca/jakarta-tomcat-4.0.3/conf/web.xml
Under the entry for the default servlet, change the following lines:
<init-param><param-name>listings</param-name><param-value>true</param-value></init-param>To:
<init-param><param-name>listings</param-name><param-value>false</param-value></init-param>Then stop and restart the Cisco UGCA to apply the change.
CDR Loader Does Not Clean Up After a Restart (CSCdy74539)
Symptom
If the CDR Loader task is not shut down properly, the CDR Loader task shows as running and a result file is not produced. A severe error in the CDR Loader Java Virtual Machine or the task receiving a SIGKILL message causes the CDR Loader task to shut down improperly.
Workaround
Stop and restart the Cisco UGCA to clear the task entry form the Active Jobs list. Manually create a result file to clear any other tasks, such as the Automated CDR Loader via the Crontab, waiting to run in the result file.
Markup Setup Not Validated Entirely (CSCdy87516)
Symptom
This condition is seen when invalid enumerated values or truncated string values are stored in the markup fields. This happens when the markup criteria file, markup-xml, is edited incorrectly.
Only limited validation is applied to the markup criteria. Cisco UGCA performs the following validation:
•
•
•
Workaround
You must check the following in the markup criteria file:
•
•
For more information, refer to the Cisco Universal Gateway Call Analyzer User Guide.
Paging Graph Should Allow for Configurable Scale (CSCdy87533)
Symptom
If the data ranges are significantly different from page to page, then the scale of the graph changes when moving from one page to another.
Workaround
None.
Pay attention to the values displayed on the Y axis so that you are not misled by a big bar representing a small value.
UGCA Stop and Restart Fail on isUP Check That Is Too Indiscriminate (CSCdz10160)
Symptom
This condition is seen when the user executes the UNIX process with install-dir/CSCOugca in the command path and the following conditions occur:
•
•
•
Workaround
Do not execute UNIX processes with install-dir/CSCOugca in the command syntax.
Do not manually invoke a copy of MySQL monitor in CSCOugca/mysql/bin, because Cisco UGCA comes with its own database clients that must be installed outside the CSCOugca tree.
Poor Handling Of Out-of-Disk Space (CSCdz14765)
Symptom
When the partition where the Cisco UGCA is installed has used 100 percent of the disk space, the system either pauses or prints out an error message about the lack of disk space.
Workaround
Perform the following tasks. Refer to the Cisco Universal Gateway Call Analyzer User Guide for detailed procedures.
Stop the Cisco UGCA.
Free up sufficient disk space.
Check for database corruption and repair, as necessary.
Restart the Cisco UGCA.
Small Values Hit Underflow Under Formatting with Three Decimal Digits (CSCdz18259)
Symptom
If the value of floatDecimalPositions is set to N, the data values less than 10exp(-N) in the Report Results appear as zeros. For example, if the floatDecimalPositions parameter is set at its default value of 3, any values less than 0.001 are stored and displayed as 0.000.
Workaround
Change the setup values to increase the number of decimal digits used in formatting the Report Results data. For detailed information, refer to the Cisco Universal Gateway Call Analyzer User Guide.
No Support for Non-Latin Characters (CSCdz33310)
Symptom
Cisco UGCA does not support non-latin characters. You get errors and potentially unpredictable behavior if you input symbolic or non-Latin characters into the database using the keyboard, on-screen cut and paste, or directly loading the data into the database.
Workaround
Use only Latin characters as defined by the standard Western ISO-8859-1.
Start Fails When 8-bit Characters Used in Db System Password (CSCea44722)
Symptom:
UGCA start fails to start UGCA.
Conditions
1) The database system account password (set at installation time or through the use of db_passwd.sh -system contains non-ascii characters. 2) And the locale used to perform ugca start does not contain the non-ascii characters used in the password.
N.B. The second condition is most commonly satisfied when the system default locale is not set to the locale used by the root user. The system locale is determined through entries in /etc/default/init . If UGCA is then started either through automatic startup when the machine reboots or after a backup scheduled by the crontab entries, the system default locale will be used.
Workaround
Ensure that the system default locale (defined in /etc/default/init ) matches the locale used by the root user. Alternatively, limit the database system account password to characters from the ASCII character set.
ugca.xml Formatting Changes Cause Errors (CSCea45974)
Symptoms
Shell commands (such as ugca start ) may report: Failed to find start of db module in ugca.xml or other similar errors referring to ugca.xml or failure to retrieve values.
Conditions
ugca.xml has been edited and formatting changes have been made.
Explanation
Whilst ugca.xml is in XML format, certain internal UGCA do not use a full XML parser but instead rely on simple string matching to retrieve values from this file.
Workaround
Return the formatting to the original as shown in Appendix A of the User Guide.
Related Documentation
Refer to the following documents for more information:
•
•
•
http://www.cisco.com/univercd/cc/td/doc/product/access/acs_serv/5300/index.htm•
•
•
•
http://www.cisco.com/univercd/cc/td/doc/product/access/acs_serv/as5850/index.htmObtaining Documentation
These sections explain how to obtain documentation from Cisco Systems.
World Wide Web
You can access the most current Cisco documentation on the World Wide Web at this URL:
Translated documentation is available at this URL:
http://www.cisco.com/public/countries_languages.shtml
Documentation CD-ROM
Cisco documentation and additional literature are available in a Cisco Documentation CD-ROM package, which is shipped with your product. The Documentation CD-ROM is updated monthly and may be more current than printed documentation. The CD-ROM package is available as a single unit or through an annual subscription.
Ordering Documentation
You can order Cisco documentation in these ways:
•
http://www.cisco.com/cgi-bin/order/order_root.pl
•
http://www.cisco.com/go/subscription
•
Documentation Feedback
You can submit comments electronically on Cisco.com. In the Cisco Documentation home page, click the Fax or Email option in the "Leave Feedback" section at the bottom of the page.
You can e-mail your comments to bug-doc@cisco.com.
You can submit your comments by mail by using the response card behind the front cover of your document or by writing to the following address:
Cisco Systems
Attn: Document Resource Connection
170 West Tasman Drive
San Jose, CA 95134-9883We appreciate your comments.
Obtaining Technical Assistance
Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain online documentation, troubleshooting tips, and sample configurations from online tools by using the Cisco Technical Assistance Center (TAC) Web Site. Cisco.com registered users have complete access to the technical support resources on the Cisco TAC Web Site.
Cisco.com
Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information, networking solutions, services, programs, and resources at any time, from anywhere in the world.
Cisco.com is a highly integrated Internet application and a powerful, easy-to-use tool that provides a broad range of features and services to help you with these tasks:
•
•
•
•
•
If you want to obtain customized information and service, you can self-register on Cisco.com. To access Cisco.com, go to this URL:
Technical Assistance Center
The Cisco Technical Assistance Center (TAC) is available to all customers who need technical assistance with a Cisco product, technology, or solution. Two levels of support are available: the Cisco TAC Web Site and the Cisco TAC Escalation Center.
Cisco TAC inquiries are categorized according to the urgency of the issue:
•
•
•
•
The Cisco TAC resource that you choose is based on the priority of the problem and the conditions of service contracts, when applicable.
Cisco TAC Web Site
You can use the Cisco TAC Web Site to resolve P3 and P4 issues yourself, saving both cost and time. The site provides around-the-clock access to online tools, knowledge bases, and software. To access the Cisco TAC Web Site, go to this URL:
All customers, partners, and resellers who have a valid Cisco service contract have complete access to the technical support resources on the Cisco TAC Web Site. The Cisco TAC Web Site requires a Cisco.com login ID and password. If you have a valid service contract but do not have a login ID or password, go to this URL to register:
http://www.cisco.com/register/
If you are a Cisco.com registered user, and you cannot resolve your technical issues by using the Cisco TAC Web Site, you can open a case online by using the TAC Case Open tool at this URL:
http://www.cisco.com/tac/caseopen
If you have Internet access, we recommend that you open P3 and P4 cases through the Cisco TAC Web Site.
Cisco TAC Escalation Center
The Cisco TAC Escalation Center addresses priority level 1 or priority level 2 issues. These classifications are assigned when severe network degradation significantly impacts business operations. When you contact the TAC Escalation Center with a P1 or P2 problem, a Cisco TAC engineer automatically opens a case.
To obtain a directory of toll-free Cisco TAC telephone numbers for your country, go to this URL:
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
Before calling, please check with your network operations center to determine the level of Cisco support services to which your company is entitled: for example, SMARTnet, SMARTnet Onsite, or Network Supported Accounts (NSA). When you call the center, please have available your service agreement number and your product serial number.
This document is to be used in conjunction with the documents listed in the "Related Documents" section.
Copyright © 2002, Cisco Systems, Inc.
All rights reserved.
Posted: Tue Dec 21 14:22:37 PST 2004
All contents are Copyright © 1992--2004 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
