Table Of Contents
Release Notes for the Content Services Gateway Service Manager, Release 4.0.1
Prerequisites for Installing the CSG Service Manager
Installing the CSG Service Manager
Caveats Resolved With This Release
Prerequisites for Configuring CSG Devices
Product Documentation and Related Documentation
Cisco Product Security Overview
Reporting Security Problems in Cisco Products
Obtaining Technical Assistance
Cisco Technical Support & Documentation Website
Definitions of Service Request Severity
Obtaining Additional Cisco Publications and Information
Release Notes for the Content Services Gateway Service Manager, Release 4.0.1
OL-9208-02
March 2006
The Cisco Content Services Gateway Service Manager (CSG SM) is a tool for managing the configuration of the Cisco Content Services Gateway.
These Release Notes contain important information for Release 4.0.1 of the CSG SM. These notes include the installation procedure and information on resolved and open caveats.
Contents
•
Prerequisites for Installing the CSG Service Manager
•
•
•
•
•
•
Introduction
The Cisco Content Services Gateway adds accounting and content-billing features to the Cisco Catalyst 6500 switch and the Cisco 7600 router platforms. The CSG typically is located at the edge of an ISP network. It provides IP flow accounting and content accounting by examining HTTP request URLs and header information. The CSG Service Manager (CSG SM) is a CSG-management tool that provides powerful fault-management, configuration, and troubleshooting functionality. Additionally, the CSG SM gathers user-name and usage statistics, and enables differentiated billing for individual transactions. In so doing, the CSG SM supports mobile operators who are migrating their wireless service delivery networks from second-generation (2G) circuit-based traffic to 2.5G- and 3G-based services.
The CSG SM includes:
•
•
•
You can use the CSG SM to provision service-activation features for CSG Releases 5.3 through 5.9, 6.4, and 7.1.
The CSG SM is part of the Mobile Wireless Center (MWC) for Cisco Mobile Exchange, a suite of element-management applications that provide configuration and fault-monitoring capabilities to mobile wireless operators. MWC for Cisco Mobile Exchange applications complement the CiscoWorks LAN Management Solution (LMS) to provide end-to-end management of the Cisco Mobile Exchange. The Release Notes for Mobile Wireless Center for Cisco Mobile Exchange provide information on these tools. See Product Documentation and Related Documentation, for information on accessing the electronic version of this document on the Cisco website.
The LMS 2.5.1 includes:
•
•
•
Note
Refer to the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange Release for this release, http://www.cisco.com/en/US/products/ps6401/prod_release_notes_list.html, for information on MWC for Cisco Mobile Exchange and the LMS requirement.
Prerequisites for Installing the CSG Service Manager
Refer to the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange for this release, http://www.cisco.com/en/US/products/ps6401/prod_release_notes_list.html, for information on MWC for CMX hardware and software requirements, including information on Sun patches and package requirements.
Installing the CSG Service Manager
This section provides information on:
•
Installation Order
The CSG SM requires that the CiscoWorks Common Services application be bundled with the LAN Management Solution (LMS), Release 2.5.1. The LMS is prerequisite to the MWC for Cisco Mobile Exchange.
Always install the elements in this order:
1.
2.
3.
The Release Notes for Mobile Wireless Center for Cisco Mobile Exchange for this release, http://www.cisco.com/en/US/products/ps6401/prod_release_notes_list.html, contains instructions for installing the LMS bundle and the CMX core. This section provides information on installing the CSG SM.
Installation Procedure
To install the CSG SM:
Step 1
Step 2
Step 3
CSGSM401-CD-SOL-YYYY-MMDD-FCS.zip
Step 4
unzip CSGSM401-CD-SOL-YYYY-MMDD-FCS.zip
Step 5
cd disk1
Step 6
. /setup.sh
The setup script starts an interactive installation. Respond to prompts to complete the installation.
A confirmation message appears after a successful installation. If errors occur during installation, check the installation log file /var/tmp/csginstall.log.
Backing Up and Restoring Data
You can use the CSG SM to back up and restore:
•
•
•
•
Use the Common Services (CS) back-up tool to back up and restore information. This tool backs up and restores CS and all applications registered with it.
Refer to the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange Release at http://www.cisco.com/en/US/products/ps6401/prod_release_notes_list.html for information on this procedure.
Uninstalling the CSG SM
Note
To uninstall the CSG SM:
Step 1
cd /opt/CSCOpx/bin
Step 2
./uninstall.sh
The script prompts you with a list of software that is installed in the host machine. For example:
1) CiscoView 6.1.22) Mobile Wireless Fault Mediator 4.1.13) Integration Utility 1.64) CiscoWorks Common Services 3.0.35) Resource Manager Essentials 4.0.36) PDSN Service Manager 4.0.17) HA Service Manager 4.0.18) CSG Service Manager 4.0.19) GGSN Service Manager 4.0.110) All of the aboveSelect one or more of the items using its number separated by comma or enter q to quit [q]Step 3
Step 4
A confirmation message appears after a successful uninstallation.
Reinstalling the CSG SM
To reinstall the CSG SM after an interrupted or failed installation attempt, use this order:
1.
2.
3.
4.
Note
Caveats Resolved With This Release
Note
Table 1 lists the ID number and a summary of each caveat resolved with this release.
Open Caveats and Workarounds
Table 2 lists the ID number, summary, and any available workaround for each open caveat in this release.
Note
Table 2 Open Caveats and Workarounds
CSCsb32820
The CSG SM does not automatically control the size of the cmxTe.log file. File size can increase rapidly if you have enabled devices for debugging and viewing Syslogs. If this file becomes bigger than 10MB, the following warning message appears:
The log file: /var/adm/CSCOpx/log/
cmxTe.log has exceeded the maximum recommended file size; performance might be impacted. To setup an automation log rotation facility, refer to: http://www.cisco.com/en/US/products/ps6401/prod_release_notes_list.htmlUse the logrot utility against /var/tmp/CSCOpx/log/cmxTe.log.
You may wish to implement this action in a cronjob.
You can access the logrot utility at http://www.cisco.com/en/US/
products/sw/cscowork/ps3996/
products_user_guide_chapter
09186a008022f958.html#wp271846.CSCsb41531
The CSG SM Stop Debug function does not show an error when its associated RME job fails.
If login credentials were changed while debug commands were running from the CSG SM, Telnet to the device and execute the show debug command from Enable mode.
Execute the no debug command to disable debugging.
CSCsb45729
An RME job stopped during CSG stress testing
None.
CSCsb52549
The CSG config display times out after long runs lacking a timeout.
You can set maximum RME concurrency to five threads. However, this probably will degrade overall system performance (that is, job elapsed time).
CSCsb94740
The CSG SM gives false information about Reassign Quota Server and Ack Error.
Use the recommended version of IOS with CSG 6.2, which is 12.2(18)SXE. If you choose to use an IOS version that does not support these commands, ignore check boxes in the GUI.
Known Problems
Note
The CSG Service Manager provides a Graphical User Interface (GUI) for service activation of CSG devices. Service activation includes configuration tasks that you perform frequently (for example, in daily operations). Network preparation and service preparation tasks occur less frequently, and you apply them through the command-line interface (CLI).
One limitation of this design occurs when deleting user groups that have accounting configurations. An accounting configuration is a service-preparation task performed from the CLI, as in the following example:
!ip csg accounting ACCT12user-group MAINagent 10.1.0.1 3333 2agent 10.1.0.2 3333 3agent 10.1.0.3 3333 4agent 10.1.0.4 3333 1inservice!If an accounting configuration has been applied to a user group that is defined in the Service Manager, you must first use CLI commands to delete the accounting configuration before deleting the user group in the GUI.
Supported Device Versions
Table 3 lists the device versions that the CSG SM supports.
Review Prerequisites for Configuring CSG Devices, for specific requirements relating to versions, switches, and cards.
You can find further information about all supported devices on Cisco.com at: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2000/mgt_pix/fwmc_1_3/px_sd_13.htm
Prerequisites for Configuring CSG Devices
To use the CSG SM to configure a CSG device, perform the following required actions. The optional actions that follow deal with configurations that may exist in the device, but that are not addressed by the CSG SM.
Required—Use of the CSG SM requires that you:
•
•
•
•
•
•
For more information on the RME inventory function, see the section titled "Adding and Troubleshooting Devices Using Device Management" in the User Guide for Resource Manager Essentials 4.0.3 (With LMS 2.5.1) at http://cisco.com/en/US/products/sw/cscowork/ps2073/
products_user_guide_book09186a008055b137.html. The specific section is here.Optional—While the CSG SM does not address the following configuration issues, you may wish to take these actions as well:
•
•
•
Documentation Support
This section provides information on:
•
•
Note
Product Documentation and Related Documentation
This section provides information on:
Product Documentation
Table 4 describes the product documentation that is available.
Table 4 Product Documentation
User Guide for Cisco CSG Service Manager for this release
•
•
http://www.cisco.com/en/US/products/ps6399/
products_user_guide_list.htmlRelease Notes for Cisco Content Services Gateway Service Manager for this release (this document)
•
•
http://www.cisco.com/en/US/products/ps6399/
prod_release_notes_list.htmlContext-sensitive online help
•
•
Related Documentation
Table 5 describes related documentation that is available.
Table 5 Related Documentation
The Cisco Content Services Gateway documentation set
On Cisco.com at:
http://www.cisco.com/en/US/products/sw/wirelssw/ps779/
index.htmlRelease Notes for Mobile Wireless Center for Cisco Mobile Exchange for this release
On Cisco.com at:
http://www.cisco.com/en/US/products/ps6401/
prod_release_notes_list.htmlUser Guide for CiscoWorks Common Services 3.0.3 (With LMS 2.5.1)
On Cisco.com at:
http://www.cisco.com/en/US/products/sw/cscowork/ps3996/
products_user_guide_book09186a008053eabf.htmlUser Guide for Resource Manager Essentials 4.0.3 (With LMS 2.5.1)
On Cisco.com at:
http://www.cisco.com/en/US/products/sw/cscowork/ps2073/
products_user_guide_book09186a008055b137.htmlThe CiscoWorks documentation set
On Cisco.com at:
http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/
cw2000/index.htm
Additional Information Online
Your application might support incremental device updates (IDUs). An IDU is a software package that enables an application to support new devices. An IDU might also contain bug fixes. You can download IDUs and their Readme files by logging into Cisco.com at http://www.cisco.com/kobayashi/sw-center/cw2000/lan-planner.shtml.
To determine which packages are installed on your CiscoWorks Server, go to your CiscoWorks page and choose Common Services > Software Center > Software Update.
You can also obtain any published patches from the download site.
You can find information about all supported devices on Cisco.com at http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2000/mgt_pix/fwmc_1_3/px_sd_13.htm.
You also may be interested in the additional Cisco information described in Obtaining Additional Cisco Publications and Information.
Obtaining Documentation
Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. The following sections explain how to obtain technical information from Cisco Systems.
Cisco.com
You can access the most current Cisco documentation at:
http://www.cisco.com/univercd/home/home.htm
You can access the Cisco website at:
You can access international Cisco websites at:
http://www.cisco.com/public/countries_languages.shtml
Product Documentation DVD
Cisco documentation and additional literature are available in a Documentation DVD package, which may have shipped with your product. The Documentation DVD is updated regularly and may be more current than printed documentation. The Documentation DVD package is available as a single unit.
Registered Cisco.com users (Cisco direct customers) can order a Cisco Documentation DVD from:
Cisco Ordering tool: http://www.cisco.com/en/US/partner/ordering/
Cisco Marketplace: http://www.cisco.com/go/marketplace/
Ordering Documentation
You can find instructions for ordering documentation at:
http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm
You can order Cisco documentation in these ways:
•
http://www.cisco.com/en/US/partner/ordering/
•
Documentation Feedback
You can send comments about technical documentation to bug-doc@cisco.com.
You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:
Cisco Systems
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883Cisco appreciates your comments.
Cisco Product Security Overview
Cisco provides a free online Security Vulnerability Policy portal at this URL:
http://www.cisco.com/en/US/products/products_security_vulnerability_policy.html
From this site, you can perform these tasks:
•
•
•
A current list of security advisories and notices for Cisco products is available at this URL:
If you prefer to see advisories and notices as they are updated in real time, you can access a Product Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed from this URL:
http://www.cisco.com/en/US/products/products_psirt_rss_feed.html
Reporting Security Problems in Cisco Products
Cisco is committed to delivering secure products. We test our products internally before we release them, and we strive to correct all vulnerabilities quickly. If you think that you might have identified a vulnerability in a Cisco product, contact PSIRT:
•
An emergency is either a condition in which a system is under active attack or a condition for which a severe and urgent security vulnerability should be reported. All other conditions are considered nonemergencies.
•
In an emergency, you can also reach PSIRT by telephone:
•
•
Tip
Never use a revoked or an expired encryption key. The correct public key to use in your correspondence with PSIRT is the one linked in the Contact Summary section of the Security Vulnerability Policy page at this URL:
http://www.cisco.com/en/US/products/products_security_vulnerability_policy.htm
The link on this page has the current PGP key ID in use.
Obtaining Technical Assistance
Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The Cisco Technical Support & Documentation website on Cisco.com features extensive online support resources. In addition, if you have a valid Cisco service contract, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not have a valid Cisco service contract, contact your reseller.
Cisco Technical Support & Documentation Website
The Cisco Technical Support & Documentation website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, at this URL:
http://www.cisco.com/techsupport
Access to all tools on the Cisco Technical Support & Documentation website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL:
http://tools.cisco.com/RPF/register/register.do
Note
Submitting a Service Request
Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool provides recommended solutions. If your issue is not resolved using the recommended resources, your service request is assigned to a Cisco engineer. The TAC Service Request Tool is located at:
http://www.cisco.com/techsupport/servicerequest
For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.
To open a service request by telephone, use one of the following numbers:
Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553-2447For a complete list of Cisco TAC contacts, go to this URL:
http://www.cisco.com/techsupport/contacts
Definitions of Service Request Severity
To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.
Severity 1 (S1)—Your network is "down," or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.
Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.
Severity 3 (S3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.
Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.
Obtaining Additional Cisco Publications and Information
Information about Cisco products, technologies, and network solutions is available from various online and printed sources.
•
http://www.cisco.com/go/marketplace/
•
•
•
http://www.cisco.com/go/iqmagazine
or view the digital edition at:
http://ciscoiq.texterity.com/ciscoiq/sample/
•
•
http://www.cisco.com/en/US/products/index.html
•
http://www.cisco.com/discuss/networking
•
http://www.cisco.com/en/US/learning/index.html
This document is to be used in conjunction with the documents listed in the Product Documentation and Related Documentation, page 10.
Release Notes for the Content Services Gateway Service Manager, Release 4.0.1© 2006 Cisco Systems, Inc. All rights reserved.
