Table Of Contents
Release Notes for the Gateway GPRS Support Node Service Manager, Release 4.1
Prerequisites for Installing the GGSN Service Manager
Installing the GGSN Service Manager
Reinstalling the GGSN Service Manager
Caveats Resolved With This Release
Prerequisites for Configuring GGSN 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 Gateway GPRS Support Node Service Manager, Release 4.1
OL-9210-01
March 2006
The Cisco Gateway General Packet Radio Service (GPRS) Support Node Service Manager (GGSN SM) is a tool for managing the configuration of the Cisco Gateway GPRS Support Node (GGSN).
These release notes contain important information for Release 4.1 of the GGSN SM. These notes include the installation procedure and information on resolved and open caveats.
Contents
This document covers the following topics:
•
Prerequisites for Installing the GGSN Service Manager
•
Installing the GGSN Service Manager
•
Caveats Resolved With This Release
•
Prerequisites for Configuring GGSN Devices
•
Cisco Product Security Overview
•
Obtaining Technical Assistance
•
Obtaining Additional Cisco Publications and Information
Introduction
The GGSN SM provides an easy and intuitive way to provision service-activation features on a Cisco Gateway GPRS Support Node (GGSN) device. In addition to service-activation provisioning, you can use the GGSN SM to view the configurations in the device, and troubleshoot them by viewing and responding to debugging messages.
The GGSN SM includes:
•
Inventory Manager—Manages and displays device group information.
•
The Service Manager—Activates and manages the various services in a GGSN device groups.
•
The Troubleshooting Engine—Troubleshoots GGSN devices.
The Gateway GPRS Support Node Service Manager User Guide provides complete information on these modules. See Product Documentation for information on accessing the electronic version of this document on the Cisco website.
The GGSN 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 prerequisite to MWC for Cisco Mobile Exchange.
The LMS 2.5.1 includes:
•
Common Services 3.0.3 with CiscoView 6.1.2
•
Resource Manager Essentials 4.0.3
•
Campus Manager 4.0.3
Note
The LMS 2.5.1 also includes Internet Performance Monitor (IPM) 2.6 and Device Fault Manager 2.0.3, but these applications are not required for the MWC for Cisco Mobile Exchange.
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 Cisco Mobile Exchange and the LMS requirement.
Prerequisites for Installing the GGSN 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 GGSN Service Manager
This section provides information on:
•
Backing Up and Restoring Data
•
Reinstalling the GGSN Service Manager
Installation Order
The GGSN 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 MWC for Cisco Mobile Exchange.
For new installations, always install in this order:
1.
The CiscoWorks LMS bundle
2.
The CMX core
3.
The GGSN SM
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 GGSN SM.
Installation Procedure
To install the GGSN SM for the first time:
Step 1
Install the CiscoWorks LMS bundle. Refer to the CiscoWorks LAN Management Solution documents at http://www.cisco.com/en/US/partner/products/sw/cscowork/ps2425/prod_installation_guides_list.htmlfor information on this procedure.
Step 2
Install the CMX core. Refer to the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange at http://www.cisco.com/en/US/products/ps6401/prod_release_notes_list.html for specific information on this procedure.
Step 3
Insert the GGSN SM CD.
Step 4
Enter this command to change directories:
cd /cdrom/cmx_ggsn_sm4_1_sol/CMX-GGSN-SM4.1
Step 5
Enter this command to run the setup script:
./setup.sh
A confirmation message appears after a successful installation. If errors occur during installation, check the installation log file /var/tmp/ggsninstall.log.
Backing Up and Restoring Data
You can use the GGSN SM to back up and restore:
•
Device groups that you create
•
Batch files that you create
•
Sync Report files
•
GGSN SM-specific data
Backing up and restoring information makes use of the Common Services backup tool. This tool backs up and restores CS and all applications that are 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.
Reinstalling the GGSN Service Manager
To reinstall the GGSN SM after an interrupted or failed installation attempt:
Step 1
Ensure that the CiscoWorks LMS bundle has been successfully installed. Refer to the CiscoWorks LAN Management Solution documents at http://www.cisco.com/en/US/partner/products/sw/cscowork/ps2425/prod_installation_guides_list.htmlfor information on this procedure.
Step 2
Ensure that the CMX core for the Release 4.1 has been successfully installed. 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 specific information on this procedure.
Step 3
Reinsert the GGSN SM CD.
Step 4
Enter this command to change directories:
cd /cdrom/cmx_ggsn_sm4_1_sol/CMX-GGSN-SM4.1
Step 5
Enter this command to run the setup script:
./setup.sh
A confirmation message appears after a successful installation. If errors occur during installation, check the installation log file: /var/tmp/ggsninstall.log.
Uninstalling the GGSN SM
To uninstall the GGSN SM:
Step 1
From the root directory, enter the command:
cd /opt/CSCOpx/bin
Step 2
From the command line, run the uninstall script by entering the command:
./uninstall.sh
A list of software that is installed in the host machine appears.
Step 3
Select the choice that corresponds to the GGSN SM.
Step 4
Confirm the choice.
A confirmation message appears after a successful installation.
Caveats Resolved With This Release
Table 1 lists the ID number and summary of each caveat resolved with this release.
Open Caveats and Workarounds
Note
To obtain updated information about open caveats and workarounds, access the Cisco Software Bug Toolkit at http://www.cisco.com/pcgi-bin/Support/Bugtool/home.pl. You will be prompted to log in to Cisco.com.
Table 2 lists the ID number, summary, and any available workaround for each open caveat in this release.
Table 2 Open Caveats and Workarounds
Bug ID Summary WorkaroundCSCeh48597
Under load, configuration changes longer than desired.
Limit simultaneous configuration changes.
CSCsb32820
The GGSN 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.CSCsb79725
Tomcat process stopped running during GGSN SM post-FCS testing. This situation has a low probability of occurrence.
None
CSCsb83338
MWAM deleted in DCR but still appears in the GGSN SM.
When you make changes in the DCR to devices that are members of a GGSN SM device group, delete and recreate that group.
Supported Device Versions
Table 3 lists the device versions that the GGSN SM supports.
Review Prerequisites for Configuring GGSN 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 GGSN Devices
To use the GGSN SM to configure a GGSN 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 GGSN SM.
For more information on any of these steps, see the GGSN Services Configuration Task List at: /en/US/docs/ios/12_3/12_3x/12_3xu1/ggsn50/configuration/guide/ggsncfg.html#wp1020149
Note
The MWC for Cisco Mobile Exchange has additional prerequisites. 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.
Required—Use of the GGSN SM requires that you:
•
Ensure that the IOS version of the Catalyst switch and the GGSN version match. The IOS releases that the MWC for CMX 4.1 supports are 12.2(17d)SXB5 and 12.2(18)SXD3. The supported GGSN versions are 5.0, 5.1, 5.2, and 6.0; and 12.2(18)SXE and 12.2(18)SXF images on the Sup card.
•
Enable GGSN service on the device. Without this, the GGSN SM will not be able to identify the device as a Cisco GGSN device.
•
Configure GPRS Tunneling Protocol (GTP) encapsulation on the IOS device under the virtual template. This action is required for a device to function as a GGSN device.
•
Enable Simple Network Management Protocol (SNMP) so that the GGSN SM can check the version of the device.
•
Complete installation of the GGSN SM in the correct installation order. See Installation Order for more information.
•
Ensure that the GGSN device to be configured has been added to the DCR and is managed by the RME Inventory Manager.
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.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 information on logging commands and other requirements.
Optional—While the CSG SM does not address the following configuration issues, you may wish to take these actions as well:
•
Complete all network preparation, such as configuring the required VLANs, VRFs, virtual templates, AAA servers, RADIUS server, and interface configurations, on all GGSN devices.
•
Complete all service preparation, such as enabling server farms and charging related configurations.
•
Configure load balancing.
Documentation Support
This section provides information on:
•
Product Documentation and Related Documentation
•
Additional Information Online
Note
Cisco Systems sometimes updates printed and electronic documentation after original publication. Therefore, review the documentation on Cisco.com for any updates.
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
Document Title Available FormatsUser Guide for the Gateway GPRS Support Node Service Manager for this release
•
PDF on the product CD-ROM.
•
On Cisco.com at:
http://www.cisco.com/en/US/products/ps6454/
products_user_guide_list.htmlRelease Notes for Cisco GGSN Service Manager for this release (this document)
•
PDF on the product CD-ROM.
•
On Cisco.com at:
http://www.cisco.com/en/US/products/ps6454/
prod_release_notes_list.htmlContext-sensitive online help
•
Select an option from the navigation tree, then click Help.
•
Click the Help button in the dialog box.
Related Documentation
Table 5 describes related documentation that is available.
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/public/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:
•
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-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:
•
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:
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.
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
Use the Cisco Product Identification (CPI) tool to locate your product serial number before submitting a web or phone request for service. You can access the CPI tool from the Cisco Technical Support & Documentation website by clicking 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 link 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 placing 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 using the recommended resources, your service request is assigned to a Cisco engineer. The TAC Service Request Tool is located at this URL:
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.
•
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:
•
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:
•
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 this URL:
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 this URL:
•
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 this URL:
http://www.cisco.com/discuss/networking
•
World-class networking training is available from Cisco. You can view current offerings at this URL:
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 section.
Release Notes for the Gateway GPRS Support Node Service Manager, Release 4.1© 2006 Cisco Systems, Inc. All rights reserved.


