Feedback
|
Table Of Contents
Release Notes for the Packet Data Serving Node Service Manager, Release 4.1.1
Prerequisites for Installing the PDSN Service Manager
Installing the PDSN Service Manager
Reinstalling the PDSN Service Manager
Uninstalling the PDSN Service Manager
Caveats Resolved With This Release
Prerequisites for Configuring PDSN Devices for Mobile IP
PDSN Configurations For Service Activation
Product Documentation and Related Documentation
Cisco Product Security Overview
Reporting Security Problems in Cisco Products
Product Alerts and Field Notices
Obtaining Technical Assistance
Definitions of Service Request Severity
Obtaining Additional Publications and Information
Release Notes for the Packet Data Serving Node Service Manager, Release 4.1.1
OL-11462-01
January 2007
The Cisco Packet Data Serving Node Service Manager (PDSN SM) facilitates service-activation or deactivation in Cisco PDSN devices in Cisco Mobile Exchange networks.
These release notes contain important information for Release 4.1.1 of the PDSN 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 PDSN Service Manager
•
Installing the PDSN Service Manager
•
Caveats Resolved With This Release
•
Prerequisites for Configuring PDSN Devices for Mobile IP
•
Cisco Product Security Overview
•
Obtaining Technical Assistance
•
Obtaining Additional Publications and Information
Introduction
A Cisco Packet Data Serving Node (PDSN) provides access to the Internet, intranets, and Wireless Application Protocol (WAP) servers for mobile stations that use a CDMA2000 radio access network (RAN).
The PDSN SM is an application that provides an easy and intuitive way to provision service activation or deactivation in Cisco PDSN devices in Cisco Mobile Exchange networks. You can also use the PDSN SM to troubleshoot and debug by using show and debug commands.
The PDSN SM includes:
•
Inventory—Manages and displays PDSN device group information. It interfaces with the Common Services Device Credentials Repository (DCR) to obtain information about PDSN devices in the network.
•
Service Manager—Activates and manages the various services in a PDSN device group.
•
Tools—Troubleshoot and debug by using show and debug commands. You can assess the status of the PDSN devices and, by so doing, improve network serviceability.
The User Guide for Cisco Packet Data Serving Node Service Manager provides complete information on the PDSN SM. See Product Documentation, for information on accessing the electronic version of this document on the Cisco website.
The PDSN 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. The MWC for Cisco Mobile Exchange applications complement the CiscoWorks LAN Management Solution (LMS) to manage the Cisco Mobile Exchange. The LMS is prerequisite to the MWC for Cisco Mobile Exchange.
The LMS 2.6 includes:
•
Common Services 3.0.5 with CiscoView 6.1.5
•
Resource Manager Essentials 4.0.5
•
Campus Manager 4.0.5
Note
The LMS 2.6 also includes Internet Performance Monitor (IPM) 2.6 and Device Fault Manager 2.0.5, 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 Release for this release, http://www.cisco.com/en/US/products/ps6401/prod_release_notes_list.html, for information on the MWC for Cisco Mobile Exchange and the LMS requirement.
Prerequisites for Installing the PDSN 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 Cisco Mobile Exchange hardware and software requirements, including information on Sun patches and package requirements.
Installing the PDSN Service Manager
This section contains information on:
•
Backing Up and Restoring Data
•
Reinstalling the PDSN Service Manager
•
Uninstalling the PDSN Service Manager
Installation Order
The PDSN SM requires that the CiscoWorks Common Services application be bundled with the Release 2.6 of the LMS. The LMS is prerequisite to the MWC for Cisco Mobile Exchange.
For new installations, always install in this order:
1.
Upgrade CiscoWorks to LMS 2.6
2.
Upgrade CMX core to 4.1.1
3.
Upgrade PDSN SM from 4.1 or 4.0.1 to 4.1.1
Note
When upgrading PDSN SM from 4.1 or 4.01, the following message may be generated:
cmxinstall.log.12012006_14:04:INFO: Package CSCO<pkgnam> - Installed. Verifying - Failed. Modifying - Done.
Ignore this message.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 PDSN SM.
Installation Procedure
To install the PDSN SM for the first time:
Step 1
Log in to the server as the root user.
Step 2
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 3
Install CMX core. 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.
Step 4
Change to the directory from which you will perform the installation.
Step 5
Run the setup script:
./setup.shA confirmation message appears after a successful installation. If errors occur during installation, check the installation log file /var/tmp/pdsninstall.log.
Backing Up and Restoring Data
You can use the PDSN SM to back up and restore:
•
Device groups that you create
•
Batch files that you create
•
Sync Report files
•
PDSN SM-specific data
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.
Reinstalling the PDSN Service Manager
To reinstall the PDSN SM after an interrupted or failed installation attempt:
Step 1
Log in to the server as the root user.
Step 2
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 3
Ensure that the CMX core 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 information on this procedure.Step 4
Change to the directory from which you will perform the installation.
Step 5
Run the setup script:
./setup.shA confirmation message appears after a successful installation. If errors occur during installation, check the installation log file: /var/tmp/pdsninstall.log.
Uninstalling the PDSN Service Manager
To uninstall PDSN SM:
Step 1
Log in to the server as the root user.
Step 2
Enter this command to change directories:
cd /opt/CSCOpx/binStep 3
Enter the command to uninstall PDSN SM:
./uninstall.shThe script prompts you with a list of software that is installed in the host machine.
Step 4
Choose PDSN SM and confirm the choice.
A confirmation message appears after a successful uninstallation.
What's New in PDSN SM 4.1.1
In previous releases, you used the Service Activation and Batch Mode features to deploy batch configurations to devices on demand. In patch release 4.1.1, you can use a new feature, Batch Mode Scheduling, to schedule deployment of batch configurations at a future time. You can also monitor the configurations that you have scheduled.
You launch the Batch Mode Scheduling feature by clicking the:
•
Schedule and Job Browser/History buttons in the Batch Config dialog box. (Choose Service Manager > Batch Config to access this dialog box.)
•
Schedule button in the Add to Batch dialog box (in the Service Activation windows).
Refer to the Release Notes for Mobile Wireless Center for Cisco Mobile Exchange Release 4.1.1 at http://www.cisco.com/en/US/products/ps6401/prod_release_notes_list.html for information on this procedure.
Caveats Resolved With This Release
Table 1 lists the ID number and a summary of each caveat closed with this release.
Table 1 Caveats Resolved With This Release
Bug ID Summary NotesCSCsb3280
The Service Managers now control the size of the cmxTe.log file by adding that file to the Common Services logrot utility during installation of the Service Manager Core module. The cmxTe.log can increase rapidly if you have enabled devices for debugging and viewing Syslogs. If this file becomes larger than 10 MB, the logrot utility rotates the log file. If the rotation occurs while you are viewing the Debug window, you should close and reopen the window to observe the most recent log messages.
Find more information about the logrot utility at http://www.cisco.com/en/US/
products/sw/cscowork/ps3996/
products_user_guide_chapter
09186a008022f958.html#wp271846.CSCsb87801
You cannot use PDSN SM to select a suboption for show commands.
This bug has been resolved.
CSCsc17290
The AAA password configured user session parameters is visible when you click List.
When you click List to view the current user session configuration or Execute to configure the user session parameters (Service Manager > Service Activation > User Session Parameters), you can see the AAA password.
Workaround: None.
CSCsc19877
In User Session Parameters, when you configure the maximum mobile sessions as 20,000 (the default value), the field is blank. The corresponding command is generated and downloaded to the device, even though the value does not appear in the GUI.
This bug has been resolved.
CSCsd43594
The install script claims to be installing the Gateway GPRS Support Node Service Manager rather than the PDSN Service Manager.
This bug has been resolved.
CSCsb67002
When running more than one Service Manager simultaneously, log messages were being written to the log file of the Service Manager that was instantiated first.
This bug has been resolved.
CSCsd39538
The Restore function claims to be restoring the HA Service Manager rather than the PDSN Service Manager.
This bug has been resolved.
Open Caveats and Workarounds
Table 2 lists the ID number, summary, and any available workaround for each open caveat in this release.
Note
To obtain updated information about open caveats and workarounds, 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.
Supported Device Versions
Table 3 lists the devices that the PDSN SM supports.
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 PDSN Devices for Mobile IP
Before you configure a PDSN device by using the PDSN SM:
1.
Ensure that the device is one of those in Table 3.
2.
Ensure that the device is configured as a PDSN. Without this step, the PDSN SM will fail to identify the device as a Cisco PDSN device.
3.
Enable Mobile IP service in the device.
4.
Enable Simple Network Management Protocol (SNMP) so that the PDSN SM can check the version of the device.
5.
Ensure that you configure all the PDSN devices with some prerequisite configurations to manage and configure service-activation commands. For more information on this procedure, see PDSN Configurations For Service Activation.
6.
Complete installation of the PDSN SM in the correct installation order. See Installation Order, for more information.
7.
Ensure that the PDSN device to be configured has been added into the RME DCR, so that the RME Inventory Manager manages the device.
For more information on the RME inventory function, see the "Adding and Troubleshooting Devices Using Device Management" section in the User Guide for Resource Manager Essentials 4.0.5 (With LMS 2.6) at http://www.cisco.com/en/US/products/sw/cscowork/ps2073/
products_installation_guide_book09186a008073d5dc.html. The specific section is here.8.
Ensure that the device is in Normal device state. When the device is in Normal state, RME has successfully contacted the device or the device has contacted RME at least once (polling, successful job completion, Syslog receipt, and so on). This action indicates that this device has been recognized by RME as a real device in the network at least once.
PDSN Configurations For Service Activation
You must configure the PDSN devices with the following configurations as a prerequisite to managing and configuring some service-activation commands by using PDSN SM:
Step 1
Enable PDSN service on the device:
service cdma pdsnStep 2
Enable FA and Mobile IP service:
router mobileip mobile foreign-agent care-of <Interface Name>ip mobile routerStep 3
Enable the AAA access control model for Packet of Disconnect (POD) or RADIUS Disconnect configuration:
aaa new-modelStep 4
Enable local user access (using Telnet) when AAA is configured:
If you do not require user login:
aaa authentication login default enableIf you do not require username and password:
aaa authentication login default localusername <login name> privilege <user privelege level> password <user password>Step 5
Enable AAA authorization for MSID-based (mobile station ID-based) user authentication:
aaa authorization configuration default group radiusStep 6
Configure SNMP community strings:
Configure read-only (RO) community string:
snmp-server community <read community> ROConfigure read-write (RW) community string:
snmp-server community <write community> RWStep 7
Configure the service internal command in Multiprocessor WAN Application Module (MWAM) devices to monitor redundancy statistics.
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 lists the available product documentation.
Table 4 Product Documentation
Document Title Cisco.com LocationUser Guide for Cisco Packet Data Serving Node Service Manager
http://www.cisco.com/en/US/products/ps6696/
products_user_guide_list.htmRelease Notes for Cisco Packet Data Serving Node Service Manager (this document)
http://www.cisco.com/en/US/products/ps6696/
prod_release_notes_list.htmlContext-sensitive online help
•
Select an option from the navigation tree, then click Help.
•
Click Help in any dialog box.
Related Documentation
Table 5 lists available related documentation for the Cisco PDSN SM.
Table 5 Related Documentation
Document Title Cisco.com LocationThe Cisco Content Services Gateway documentation set
http://www.cisco.com/en/US/products/sw/wirelssw/ps779/
index.htmlRelease Notes for Mobile Wireless Center for Cisco Mobile Exchange for this release
http://www.cisco.com/en/US/products/ps6401/
prod_release_notes_list.htmlUser Guide for CiscoWorks Common Services 3.0.5 (With LMS 2.6)
http://www.cisco.com/en/US/products/sw/cscowork/ps3996/
products_user_guide_book09186a00806feda7.htmlUser Guide for Resource Manager Essentials 4.0.5 (With LMS 2.6)
http://www.cisco.com/en/US/products/sw/cscowork/ps2073/
products_user_guide_book09186a00806a52cb.html
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 Publications and Information.
Obtaining Documentation
Cisco documentation and additional literature are available on Cisco.com. This section explains the product documentation resources that Cisco offers.
Cisco.com
You can access the most current Cisco documentation at this URL:
http://www.cisco.com/techsupport
You can access the Cisco website at this URL:
You can access international Cisco websites at this URL:
http://www.cisco.com/public/countries_languages.shtml
Product Documentation DVD
The Product Documentation DVD is a library of technical product documentation on a portable medium. The DVD enables you to access installation, configuration, and command guides for Cisco hardware and software products. With the DVD, you have access to the HTML documentation and some of the PDF files found on the Cisco website at this URL:
http://www.cisco.com/univercd/home/home.htm
The Product Documentation DVD is created and released regularly. DVDs are available singly or by subscription. Registered Cisco.com users can order a Product Documentation DVD (product number DOC-DOCDVD= or DOC-DOCDVD=SUB) from Cisco Marketplace at the Product Documentation Store at this URL:
http://www.cisco.com/go/marketplace/docstore
Ordering Documentation
You must be a registered Cisco.com user to access Cisco Marketplace. Registered users may order Cisco documentation at the Product Documentation Store at this URL:
http://www.cisco.com/go/marketplace/docstore
If you do not have a user ID or password, you can register at this URL:
http://tools.cisco.com/RPF/register/register.do
Documentation Feedback
You can provide feedback about Cisco technical documentation on the Cisco Support site area by entering your comments in the feedback form available in every online document.
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 will find information about how to do the following:
•
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, security notices, and security responses for Cisco products is available at this URL:
To see security advisories, security notices, and security responses as they are updated in real time, you can subscribe to the Product Security Incident Response Team Really Simple Syndication (PSIRT RSS) feed. Information about how to subscribe to the PSIRT RSS feed is found at 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 have identified a vulnerability in a Cisco product, contact PSIRT:
•
For emergencies only — 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.
•
For 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 (for example, GnuPG) to encrypt any sensitive information that you send to Cisco. PSIRT can work with information that has been encrypted with PGP versions 2.x through 9.x.
Never use a revoked encryption key 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.html
The link on this page has the current PGP key ID in use.
If you do not have or use PGP, contact PSIRT to find other means of encrypting the data before sending any sensitive material.
Product Alerts and Field Notices
Modifications to or updates about Cisco products are announced in Cisco Product Alerts and Cisco Field Notices. You can receive these announcements by using the Product Alert Tool on Cisco.com. This tool enables you to create a profile and choose those products for which you want to receive information.
To access the Product Alert Tool, you must be a registered Cisco.com user. Registered users can access the tool at this URL:
http://tools.cisco.com/Support/PAT/do/ViewMyProfiles.do?local=en
To register as a Cisco.com user, go to this URL:
http://tools.cisco.com/RPF/register/register.do
Obtaining Technical Assistance
Cisco Technical Support provides 24-hour-a-day award-winning technical assistance. The Cisco Support 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 Support Website
The Cisco 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 at this URL:
http://www.cisco.com/en/US/support/index.html
Access to all tools on the Cisco 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 this URL:
http://tools.cisco.com/RPF/register/register.do
Note
Before you submit a request for service online or by phone, use the Cisco Product Identification Tool to locate your product serial number. You can access this tool from the Cisco Support website by clicking the Get Tools & Resources link, clicking the All Tools (A-Z) tab, and then choosing Cisco Product Identification Tool from the alphabetical list. This 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.
Tip
Displaying and Searching on Cisco.com
If you suspect that the browser is not refreshing a web page, force the browser to update the web page by holding down the Ctrl key while pressing F5.
To find technical information, narrow your search to look in technical documentation, not the entire Cisco.com website. After using the Search box on the Cisco.com home page, click the Advanced Search link next to the Search box on the resulting page and then click the Technical Support & Documentation radio button.
To provide feedback about the Cisco.com website or a particular technical document, click Contacts & Feedback at the top of any Cisco.com web page.
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)—An existing 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 operations 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 the network is impaired while 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 Publications and Information
Information about Cisco products, technologies, and network solutions is available from various online and printed sources.
•
The Cisco Online Subscription Center is the website where you can sign up for a variety of Cisco e-mail newsletters and other communications. Create a profile and then select the subscriptions that you would like to receive. To visit the Cisco Online Subscription Center, go to this URL:
http://www.cisco.com/offer/subscribe
•
The Cisco Product Quick Reference Guide is a handy, compact reference tool that includes brief product overviews, key features, sample part numbers, and abbreviated technical specifications for many Cisco products that are sold through channel partners. It is updated twice a year and includes the latest Cisco channel product offerings. To order and find out more about the Cisco Product Quick Reference Guide, go to this URL:
•
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:
•
Internet Protocol Journal is a quarterly journal published by Cisco 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, 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 where networking professionals 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
•
"What's New in Cisco Documentation" is an online publication that provides information about the latest documentation releases for Cisco products. Updated monthly, this online publication is organized by product category to direct you quickly to the documentation for your products. You can view the latest release of "What's New in Cisco Documentation" at this URL:
http://www.cisco.com/univercd/cc/td/doc/abtunicd/136957.htm
•
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
![]()
Feedback
