Cisco Content Services Gateway Service Manager

Table Of Contents

Release Notes for Content Services Gateway Service Manager 4.0

Contents

Introduction

System Requirements

Hardware Requirements

Software Requirements

Requirements Specific to CSG Service Manager

Limitations and Restrictions

Installation

Installation Notes

Installing the CSG Service Manager

Backing Up and Restoring Files

Uninstalling the CSG SM

CSG Versions Supported

Caveats Resolved With This Release

Open Caveats and Workarounds

Documentation Updates

Related Documentation

Product Documentation

Related Documentation

Online Information on Supported Devices

Obtaining Documentation

Cisco.com

Documentation DVD

Ordering Documentation

Documentation Feedback

Service and Support

Cisco Technical Support Website

Submitting a Service Request

Definitions of Service Request Severity

Cisco Product Security Overview

Reporting Security Problems in Cisco Products

Other Cisco Publications and Information

Release Notes for Content Services Gateway Service Manager 4.0

---

78-17097-02

December 2005

Contents

•Introduction

•System Requirements

•Limitations and Restrictions

•Installation

•Caveats Resolved With This Release

•Open Caveats and Workarounds

•Documentation Updates

•Related Documentation

•Service and Support

•Cisco Product Security Overview

Introduction

The Cisco Content Services Gateway (CSG) 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. Additionally, the CSG gathers user-name and usage statistics, and enables differentiated billing for individual transactions.

You can use the CSG SM to provision service-activation features for CSG Releases 5.3 through 5.8 and 6.2.

These Release Notes contain important information for the CSG SM, 4.0. They include the installation procedure, one resolved caveat, and five open caveats.

The modules provided in this release of the CSG SM are the:

•Inventory Manager—Use this module to manage and display device group information.

•Service Manager—Use this module to work with device groups for service activation.

•Troubleshooting Engine—Use this module to troubleshoot CSG devices.

The CSG Service Manager User Guide provides complete information on these modules. See Related Documentation, for information on accessing the electronic version of this document on the Cisco website.

The CSG SM is part of the Mobile Wireless Exchange (MWC) for Cisco Mobile Exchange, a suite of element-management applications that provide configuration and fault-monitoring capabilities to mobile wireless operators. The 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 LMS is a prerequisite to MWC for Cisco Mobile Exchange.

The LMS includes:

•Common Services 3.0.2 with CiscoView 6.1

•Resource Manager Essentials 4.0 with the 4.0.2 update

•Campus Manager 4.0

•Internet Performance Monitor (IPM) 2.6 (optional)

Please refer to the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange Release 4.0 for information on MWC for Cisco Mobile Exchange and the LMS requirement.

System Requirements

This section provides information on hardware and software requirements for installing the CSG SM.

Hardware Requirements

Please see the section on "Minimum Server Platform Requirements" in the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange at http://www.cisco.com/en/US/products/ps6401/prod_release_note09186a0080490f51.html#wp38280.

Software Requirements

Please see the section on "Supported Browsers" in the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange at http://www.cisco.com/en/US/products/ps6401/prod_release_note09186a0080490f51.html#wp38370.

Requirements Specific to CSG Service Manager

To configure a CSG device by using the CSG Service Manager, perform the following required actions. The optional actions that follow deal with configurations that are not addressed by the CSG SM, but may exist in the device.

Required

•Ensure that the IOS version of the Catalyst switch matches the CSG version. The IOS releases supported by Leapfrog phase III are 12.2(18)SXD(x) and 12.2(18)SXE(x). CSG Versions 5.3 through 5.8 run on a Catalyst Switch with a Sup 2 card running the 12.2(18)SXDx.

•Each catalyst can have a maximum of four CSG cards. All CSG cards must be running the same CSG image version.

•SNMP must be enabled in order to facilitate device-version checking.

•Cisco Works LMS Bundle 2.5 must be installed prior to installing the CSG SM.

•The CSG device to be configured must be added into the DCR and managed by the RME Inventory Manager.

Optional

The following configuration issues would not be addressed by the CSG SM but may exist in the device:

•All network preparation, such as configuring the required VLANs, VRFs, virtual templates, AAA servers, RADIUS server, and interface configurations, must be complete on all CSG devices.

•All service preparation, such as enabling server farms and charging related configurations, must be complete.

•Load balancing must be configured.

Limitations and Restrictions

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 using the CLI. See the following example:

!

ip csg accounting ACCT12

 user-group MAIN

 agent 10.1.0.1 3333 2

 agent 10.1.0.2 3333 3

 agent 10.1.0.3 3333 4

 agent 10.1.0.4 3333 1

 inservice

!

If an accounting configuration has been applied to a user group defined in the Service Manager, you must first delete the accounting configuration using the CLI before deleting the user group in the GUI.

Installation

This section provides information on:

•Installation Notes

•Installing the CSG Service Manager

•Backing Up and Restoring Files

•Uninstalling the CSG SM

Installation Notes

The two installable units for the CSG SM are:

•CMX Core SM 4.0

•CMX CSG SM 4.0

Refer to the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange Release 4.0 for information on installing the core.

Installing the CSG Service Manager

To install the CSG SM:

---

Step 1 Install CMX Core SM 4.0. Refer to the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange Release 4.0 for information on this procedure.

Step 2 Insert the CSG-SM 4.0 CD.

Step 3 Enter:

cd /cdrom/cmx_csg_sm4_0_sol/CMX-CSG-SM4.0

Step 4 From the command line, run the setup script by entering:

./setup.sh

---

Backing Up and Restoring Files

The CSG SM includes functionality for backing up and restoring:

•Device groups that you create

•Batch files that you create

•Sync Report files

Backing Up Files

To create a backup of these types of files:

---

Step 1 From the command line, enter:

/opt/CSCOpx/bin/perl /opt/CSCOpx/bin/backup.pl backup_directory

---

Restoring Files

To restore backed-up files:

---

Step 1 From the command line, enter:

/opt/CSCOpx/bin/perl /opt/CSCOpx/bin/restorebackup.pl -d backup_directory

---

Uninstalling the CSG SM

To uninstall the CSG SM:

---

Step 1 From the root directory, enter:

cd /opt/CSCOpx/bin

Step 2 From the command line, run the uninstall script by entering:

./uninstall.sh

The script prompts you with a list of software that is installed in the host machine.

Step 3 Select the choice that corresponds to the CSG SM 4.0.

Step 4 Confirm the choice.

---

The system indicates successful uninstallation with a status message.

CSG Versions Supported

Table 1 shows the CSG versions supported by the CSG Service Manager:

Table 1 CSG Versions Supported 

CSG Version	SUP 2 Image	SUP 720 Image	CSG Image
5.3	12.2(18)SXDx		c6csg-apc.31-3.C5.3.bin
5.4	12.2(18)SXDx		c6csg-apc.31-3.C5.4.bin
5.5	12.2(18)SXDx		c6csg-apc.31-3.C5.4.bin
5.6	12.2(18)SXDx		c6csg-apc.31-3.C5.6.bin
5.7	12.2(18)SXDx		c6csg-apc.31-3.C5.7.bin
5.8	12.2(18)SXDx	12.2(18)SXDx	c6csg-apc.31-3.C5.8.bin
6.2	NA	12.2(18)SXEx	c6csg-apc.31-3.C6.2.bin

See Requirements Specific to CSG Service Manager, for specific requirements relating to versions, switches, and cards.

Caveats Resolved With This Release

Table 2 shows the ID number and a summary of caveats closed with this release.

Table 2 Caveats Resolved With This Release

Bug ID

Summary

CSCsb66273

The CSG card returns error messages with a percentage sign (%). Such error messages are not always detected by the CSG SM. As a result, reports may show success when some commands actually failed. This has been resolved, but the resolution must propagate through RME. If you encounter this error prior to the next release of RME, drill down through the command syntax level of the job report to verify that all commands were accepted.

Open Caveats and Workarounds

Table 3 gives the ID number, summary, and any available workarounds for open caveats in this release.

---

Note To obtain more information about known problems, access the Cisco Software Bug Toolkit at http://www.cisco.com/cgi-bin/Support/Bugtool/home.pl. You will be prompted to log in to Cisco.com.

---

Table 3 Known Problems in CSG SM Release 4.0 

Bug ID	Summary	Workaround
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.
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.
CSCsb87613	Only one user can view syslogs. Other user windows show blank displays.	None. If a second user wants to view the syslogs, the first user must close the syslog dialog.
CSCsb46286	Unsupported commands appear to be available. For certain commands to be supported, both the CSG and IOS versions must support the commands. The CSG SM will check the CSG version only and provide GUI screens on that basis. The CSG SM has no method by which to determine whether the IOS version on the 6500/7600 supports the commands. As a result, commands that are unsupported by the IOS version but supported by the CSG version will incorrectly appear to be available.	Read the returned Net Config job to verify whether a command was successful.
CSCsb87669	Show command windows open inside existing windows, not in new windows.	Cut and paste the output to a text editor to ensure that the data is not lost.

Documentation Updates

The online help includes a reference to CSG Release 7.0. This release is no longer planned. See Product Documentation, next, for information on this and all documentation that accompanies the CSG SM.

Related Documentation

This section provides information on:

•Product Documentation

•Related Documentation

Product Documentation

Table 4 describes available product documentation.

Table 4 Product Documentation 

Document Title	Available Formats
CSG Service Manager User Guide 4.0	On Cisco.com at http://www.cisco.com/en/US/products/ps6399/ products_user_guide_list.html
Release Notes for Cisco Content Services Gateway Service Manager 4.0 (this document)	On Cisco.com at http://www.cisco.com/en/US/products/ps6399/prod_release_notes_list.html

Related Documentation

Table 5 describes available related documentation.

Table 5 Related Documentation 

Document Title	Available Formats
The Cisco Content Services Gateway documentation set	On Cisco.com at http://www.cisco.com/univercd/cc/td/doc/product/wireless/moblwrls/csg/index.htm
The CiscoWorks documentation set	On Cisco.com at http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2000/index.htm
The CiscoWorks for Mobile Wireless documentation set	On Cisco.com at http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cw2k4mw/index.htm
Cisco IOS Mobile Wireless Configuration Guide for Release 12.2	On Cisco.com at http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122cgcr/fmwire_c/index.htm
The Cisco IOS Mobile Wireless Command Reference for Release 12.2	On Cisco.com at http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122cgcr/fmwire_r/index.htm

Online Information on Supported Devices

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

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:

http://www.cisco.com

You can access international Cisco websites at:

http://www.cisco.com/public/countries_languages.shtml

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:

•Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Ordering tool:

http://www.cisco.com/en/US/partner/ordering/

•Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208; or, elsewhere in North America, by calling 1 800 553-NETS (6387).

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-9883

Cisco appreciates your comments.

Service and Support

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.

This section provides information on:

•Cisco Technical Support Website

•Submitting a Service Request

•Definitions of Service Request Severity

Cisco Technical Support Website

The Cisco Technical Support 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, 365 days a year, at:

http://www.cisco.com/techsupport

Access to all tools on the Cisco Technical Support 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:

http://tools.cisco.com/RPF/register/register.do

---

Note Use the Cisco Product Identification (CPI) tool to locate your product serial number before you submit a web or telephone request for service. To access the CPI tool from the Cisco Technical Support website, click the Tools & Resources link under Documentation & Tools. Choose Cisco Product Identification Tool from the Alphabetical Index drop-down list, or click the Cisco Product Identification Tool under Alerts & RMAs. The CPI tool offers three search options: by product ID or model name; by tree view; or for certain products, by copying and pasting show command output. Search results show an illustration of your product with the serial number label location highlighted. Locate the serial number label on your product and record the information before you place a service call.

---

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 by using the recommended resources, your service request is assigned to a Cisco TAC 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 TAC 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, call one of these numbers:

Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553-2447

For a complete list of Cisco TAC contacts, go to:

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 these 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.

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:

•Report security vulnerabilities in Cisco products.

•Obtain assistance with security incidents that involve Cisco products.

•Register to receive security information from Cisco.

A current list of security advisories and notices for Cisco products is available at this URL:

http://www.cisco.com/go/psirt

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:

•Emergencies — security-alert@cisco.com

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.

•Nonemergencies — psirt@cisco.com

In an emergency, you can also reach PSIRT by telephone:

•1 877 228-7302

•1 408 525-6532

---

Tip We encourage you to use Pretty Good Privacy (PGP) or a compatible product to encrypt any sensitive information that you send to Cisco. PSIRT can work from encrypted information that is compatible with PGP versions 2.x through 8.x.

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.

---

Other Cisco Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources.

•Cisco Marketplace provides a variety of Cisco books, reference guides, documentation, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL:

http://www.cisco.com/go/marketplace/

•Cisco Press publishes a wide range of general networking, training and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL:

http://www.ciscopress.com

•Packet magazine is the Cisco Systems technical user magazine for maximizing Internet and networking investments. Each quarter, Packet delivers coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions, as well as network deployment and troubleshooting tips, configuration examples, customer case studies, certification and training information, and links to scores of in-depth online resources. You can access Packet magazine at this URL:

http://www.cisco.com/packet

•iQ Magazine is the quarterly publication from Cisco Systems designed to help growing companies learn how they can use technology to increase revenue, streamline their business, and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, using real-world case studies and business strategies to help readers make sound technology investment decisions. You can access iQ Magazine at:

http://www.cisco.com/go/iqmagazine

or view the digital edition at this URL:

http://ciscoiq.texterity.com/ciscoiq/sample/

•Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at:

http://www.cisco.com/ipj

•Networking products offered by Cisco Systems, as well as customer support services, can be obtained at this URL:

http://www.cisco.com/en/US/products/index.html

•Networking Professionals Connection is an interactive website for networking professionals to share questions, suggestions, and information about networking products and technologies with Cisco experts and other networking professionals. Join a discussion at:

http://www.cisco.com/discuss/networking

•World-class networking training is available from Cisco. You can view current offerings at:

http://www.cisco.com/en/US/learning/index.html

This document is to be used in conjunction with the documents listed in the "Related Documentation" section.

© 2005 Cisco Systems, Inc. All rights reserved.