Table Of Contents
Release Notes for the Home Agent Service Manager, Release 4.0.1
Prerequisites for Installing the HA Service Manager
Installing the HA Service Manager
Uninstalling the HA Service Manager
Reinstalling the HA Service Manager
Caveats Resolved With This Release
Prerequisites for Configuring HA 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 Home Agent Service Manager, Release 4.0.1
OL-9212-01
March 2006
The Cisco Home Agent Service Manager (HA SM) facilitates service activation or deactivation in Cisco Home Agent devices in Cisco Mobile Exchange networks.
These release notes contain important information for Release 4.0.1 of the HA 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 HA Service Manager
•
•
•
•
•
•
Introduction
Cisco Systems offers mobile operators a seamless roaming solution based on the Cisco Mobile Wireless Home Agent (HA), part of the Cisco Mobile Exchange framework. The HA SM provides an easy and intuitive way to provision service activation or deactivation in Cisco Home Agent devices in Cisco Mobile Exchange networks. The HA SM also helps you to troubleshoot and debug connectivity and performance issues.
The HA SM includes:
•
•
•
The User Guide for Cisco Home Agent Service Manager provides complete information on the HA SM. See Product Documentation and Related Documentation for information on accessing the electronic version of this document on the Cisco website.
The HA 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 the MWC for Cisco Mobile Exchange.
The LMS 2.5.1 includes:
•
•
•
Note
Please 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 HA Service Manager
Please 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 HA Service Manager
This section provides information on:
•
•
•
Installation Order
The HA 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.
For new installations, always install 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 HA SM.
Installation Procedure
To install the HA SM:
Step 1
Step 2
Step 3
HASM401-CD-SOL-YYYY-MMDD-FCS.zip
Step 4
unzip HASM401-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/hainstall.log.
Backing Up and Restoring Data
You can use the HA SM to back up and restore:
•
•
•
•
Backing up and restoring information makes use of the Common Services backup tool. 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 HA Service Manager
Note
To uninstall the HA 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 HA Service Manager
To reinstall the HA SM after an interrupted or failed installation attempt, use this order:
1.
2.
3.
4.
Note
Caveats Resolved With This Release
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
CSCei24346
The status of some HA configuration jobs appears successful even after they have failed.
The status of some HA configuration jobs appears successful in the HA SM Job Details window and the RME NetConfig Job browser after they have failed.
This error occurs when you submit an incorrect configuration job. For example, when you configure an invalid IP address for VPN Routing and Forwarding (VRF).
Workaround:
None. Check the output of the configurations on the device.
CSCsb32820
The HA 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.CSCsb35170
HA devices of different IOS versions can exist in the same group.
This problem occurs when you:
1.
2.
Workaround:
Perform one of these actions:
•
•
CSCsb81149
MWAMs deleted from the DCR continue to appear in the HA SM.
None
CSCsd09457
The Sync Report continues to show a previous master device after that master device is changed in the group.
None
Supported Devices
Table 3 displays the device versions supported by the HA SM.
Review Prerequisites for Configuring HA 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 HA Devices
Before you configure a Home Agent by using the HA SM:
•
•
•
•
•
•
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.•
Documentation Support
This section provides information on:
•
•
Note
Product Documentation and Related Documentation
This section provides information on:
Product Documentation
Table 4 describes available product documentation.
Table 4 Product Documentation
User Guide for Cisco Home Agent Service Manager for this release
•
•
http://www.cisco.com/en/US/products/ps6506/
products_user_guide_list.htmlRelease Notes for Cisco Home Agent Service Manager for this release (this document)
•
•
http://www.cisco.com/en/US/products/ps6506/
prod_release_notes_list.htmlContext-sensitive online help
•
•
Related Documentation
Table 5 describes available related documentation for the HA SM.
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.htmlCiscoWorks LAN Management Solution documents
On Cisco.com at:
http://www.cisco.com/en/US/products/sw/cscowork/ps2425/
tsd_products_support_series_home.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.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/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. These sections explain how to obtain technical information from Cisco Systems.
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
Cisco documentation and additional literature are available in the Product Documentation DVD package, which may have shipped with your product. The Product Documentation DVD is updated regularly and may be more current than printed documentation.
The Product Documentation DVD is a comprehensive library of technical product documentation on portable media. The DVD enables you to access multiple versions of hardware and software installation, configuration, and command guides for Cisco products and to view technical documentation in HTML. With the DVD, you have access to the same documentation that is found on the Cisco website without being connected to the Internet. Certain products also have .pdf versions of the documentation available.
The Product Documentation DVD is available as a single unit or as a subscription. Registered Cisco.com users (Cisco direct customers) can order a Product Documentation DVD (product number DOC-DOCDVD=) from Cisco Marketplace at this URL:
http://www.cisco.com/go/marketplace/
Ordering Documentation
Beginning June 30, 2005, registered Cisco.com users may order Cisco documentation at the Product Documentation Store in the Cisco Marketplace at this URL:
http://www.cisco.com/go/marketplace/
Nonregistered Cisco.com users can order technical documentation from 8:00 a.m. to 5:00 p.m. (0800 to 1700) PDT by calling 1 866 463-3487 in the United States and Canada, or elsewhere by calling 011 408 519-5055. You can also order documentation by e-mail at tech-doc-store-mkpl@external.cisco.com or by fax at 1 408 519-5001 in the United States and Canada, or elsewhere at 011 408 519-5001.
Documentation Feedback
You can rate and provide feedback about Cisco technical documents by completing the online feedback form that appears with the technical documents on Cisco.com.
You can send comments about Cisco 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-9883We appreciate 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.html
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 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.
•
http://www.cisco.com/go/marketplace/
•
•
•
http://www.cisco.com/go/iqmagazine
or view the digital edition at this URL:
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" section.
Release Notes for the Home Agent Service Manager, Release 4.0.1© 2006 Cisco Systems, Inc. All rights reserved.
