|
These release notes are for use with CiscoWorks2000 QoS Policy Manager (QPM) 2.1.
These release notes include:
QPM 2.1 includes the following new features, which are documented in more detail in the user guide and online help:
Note For detailed information about QPM 2.1 device and QoS feature support, go
to: http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/qos/qpm21/ qpm21dev/index.htm |
Before you install QoS Policy Manager (QPM), ensure that your systems meet the requirements for running QPM. These sections describe the requirements and procedures for installing QPM:
Note In order to install QPM, you must have Administrator status on your computer. |
Table 1 shows the hardware and software requirements for installing QPM.
Note |
Complete QoS Policy Manager | Remote QoS Policy Manager |
---|---|
Pentium 266 MHz processor or better. Works on single or multiple processor machines. | Pentium 266 MHz processor or better. Works on single or multiple processor machines. |
64MB RAM or more. | |
50MB or more free hard disk space. | |
Any of these operating systems running TCP/IP and Microsoft Networking:
Note: These operating systems are supported in the Japanese environment. | Any of these operating systems running TCP/IP and Microsoft Networking:
Note: These operating systems are supported in the Japanese environment. |
Microsoft Internet Explorer 5.01 or higher, or Netscape Navigator 4.5 or higher. Needed to view the online help and QPM reports. | Microsoft Internet Explorer 5.01 or higher, or Netscape Navigator 4.5 or higher. Needed to view the online help and QPM reports. |
You can upgrade a QPM installation without first uninstalling it. You can only upgrade a QPM installation from the same installation type (full or remote installation).
You can upgrade remote installations and use them with a former complete installation version. Similarly, you can upgrade a complete installation and use it with previous versions of remote installations.
Follow the instructions in Installing the Complete QPM (or Installing the Remote QPM for remote installations).
Note Databases that were created with previous versions of QPM can be read by QPM 2.1 without any additional conversion program. Refer to the user guide for more information. |
Before you upgrade a QPM1.x system, consider these changes in QPM 2.x:
The complete QoS Policy Manager includes the management interfaces that you use to create and distribute your QoS policies to network devices and the QoS Manager service used to manage and process the QoS database.
If you are upgrading from a previous version of QPM, exit Policy Manager and Distribution Manager if you are currently running either program. The installation program automatically stops the QoS Manager service.
Step 1 Insert the QoS Policy Manager CD-ROM into the CD-ROM drive on your computer.
Note We do not recommend that you install QPM from a network CD-ROM drive. |
Step 2 The installation process should start automatically. If it does not, select Start>Run, and enter d:\qpm.exe, where d: is the drive letter for your CD-ROM drive.
The following window appears:
Step 3 Select Complete Installation.
Click OK to upgrade the old version of QPM.
Note The new version of QPM will be installed in the installation folder from the previous version, which contains all your existing databases. |
Back up your QoS databases, if required, then click Next.
Step 4 Read the Welcome window and click Next.
Step 5 Choose a destination folder (QoS Policy Manager is the default) and click Next.
Note If there is not enough space to complete the installation, a message appears. Click OK, then clear disk space and repeat the installation. |
Step 6 Enter a Windows NT or Windows 2000 local group name in the Users Group window, or use the default name shown, and click Next.
The QPM user group is used for authenticating QPM read-write users. Members of this group can save changes to the QoS database. You can enter the name of an existing group, or have QPM create a new group. The default user group is QPM_Users.
Step 7 Enter a Windows NT or Windows 2000 local group name in the Guest Group window, or use the default name shown, and click Next. If the group does not exist, you are prompted to create it.
The QPM guest group is used for authenticating QPM read-only users. Members of this group can view the QoS database, but they cannot save changes. You can enter the name of an existing group, or have QPM create a new group. The default guest group is QPM_Guests.
Step 8 In the Program Folder window, specify or select a program group, if you do not want to use the default name, and click Next.
Step 9 Review your selections in the Start Copying Files window. If you are satisfied, click Next. If you are not satisfied, click Back until you come to the window that has selections you want to change.
After you click Next, QPM is installed on your system. The last step of the installation is to set permissions on QPM directories. The following box appears:
This process might take a few moments.
See the user guide for more information about these permissions.
Note These directory permissions are effective on an NTFS partition only. The FAT file system does not support permission management. |
Step 10 Click Finish to complete the setup.
Note If you uninstalled a previous version of QPM before installing the newest version, your existing databases will remain in the previous installation folder. In order to work with your existing databases, you must first copy them into the Database folder in the new installation folder. |
You can install the remote QoS Policy Manager on any machine that has access to QoS Manager (the Windows NT or Windows 2000 service installed with the complete QPM). This allows you to manage the QoS policies from remote locations, for example, from a laptop.
Determine the host name of the workstation where you installed, or intend to install, the complete QPM.
If you are upgrading from a previous version of QPM, exit Policy Manager and Distribution Manager if you are currently running either program.
Step 1 Insert the QoS Policy Manager CD-ROM into the CD-ROM drive on your computer.
Note We do not recommend that you install QPM from a network CD-ROM drive. |
Step 2 The installation process should start automatically. If it does not, select Start>Run, and enter d:\qpm.exe, where d: is the drive letter for your CD-ROM drive. The window in Figure 1 appears.
Step 3 Select Remote Installation.
If you are upgrading from a previous version of QPM, the window in Figure 2 appears. Click Next to upgrade the previous version. Your existing databases will be saved and restored at the end of the installation process.
Step 4 Read the Welcome window and click Next.
Step 5 Choose a destination folder (one is selected by default) and click Next. The following window appears:
Step 6 Enter the host name of the machine that is running the QoS Policy Manager service. This is the machine where you installed, or intend to install, the complete QPM.
Step 7 Specify or select a program group, if you do not want to use the default name, and click Next.
Step 8 Review your selections on the Start Copying Files window. If you are satisfied, click Next. If you are not satisfied, click Back until you come to the window that has selections you want to change.
After you click Next, QPM is installed on your system. If you are upgrading from a previous version of QPM, the window in Figure 6 appears. Click OK.
Step 9 Click Finish to complete the setup.
This procedure removes all installed QoS Policy Manager components from your machine, except your QoS databases in the Database directory under the QoS Policy Manager file structure.
When you uninstall QPM, your distributed policies are not removed from network devices. If you want to remove these policies, remove them using QPM before you uninstall QPM.
Step 1 Select Start>Settings>Control Panel, and double-click Add/Remove Programs. The Add/Remove Programs Properties dialog box opens.
Step 2 Select QoS Policy Manager in the list of programs.
Step 3 Click Add/Remove. Click OK to confirm that you want to remove QPM.
QPM is deleted from your system. QoS databases are not deleted.
Known problems are unexpected behaviors or defects in QPM 2.1. Table 2 contains information for certain problems that may affect you when working with QPM 2.1.
You can search for problems using the Cisco bug tracking tool, Bug Navigator II. To access Bug Navigator II, log into Cisco.com and select Service & Support> Technical Support HelpCisco TAC>Tools>Software Bug Toolkit>
Bug Navigator II, or enter the following URL in your web browser: http://www.cisco.com/support/bugtools.
Bug ID | Summary | Explanation |
---|---|---|
CSCdu36423 | QPM does not recognize PBR coloring policy on a subinterface without FRTS. | If a PBR coloring policy has been defined on a subinterface and FRTS is not configured, QPM will not recognize this policy when you try to delete/disable or upload it. WorkaroundConfigure FRTS on the subinterface or upgrade the IOS software on the device to a version that supports CAR coloring (IOS 12.0 and higher). |
CSCdu35364 | Backup configuration not displayed for Catalyst 6000 devices. | The Backup Configuration window for a Catalyst 6000 device shows no information. WorkaroundAccess the backup configuration file for the specific job in the Versions directory under your QPM installation directory. |
CSCdu39495 | FRF bandwidth percentage is calculated according to interface rate and not minCIR. | If you do not specify a Minimum Rate (minCIR) value in the Interface Properties dialog box when configuring FRTS, the FRF bandwidth value is calculated as a percentage of the interface rate, instead of the minimum rate. WorkaroundEnter a value in the Minimum Rate field. Do not leave this field blank, even if you want to use the default minCIR value (half of the interface rate). |
CSCdu39627 | QPM uploads trust policies on Catalyst 6000(IOS) incorrectly | QPM uploads all trust policies on Catalyst 6000 devices with Supervisor IOS as Trust CoS, even if the policies specify Trust DSCP or Trust IP Precedence. WorkaroundIn the policy wizard, change the Trust value as required and redeploy the database. |
CSCdu39744 | QPM deploys adjusted rate values for limiting policies on Catalyst 4000-L3 devices | When limiting policies are deployed on Catalyst 4000-L3 devices, QPM rounds the value entered in the Rate field to the closest multiple of 8. |
CSCdu39761 | Duplicate class-map naming on device groups with FRTS and Class Based QoS. | If you have two policies defined on a device group configured with Class Based QoS and FRTS, one with inbound direction and one with outbound direction, QPM gives the same name to each map-class. Thus, the first map-class written to the device is overwritten. WorkaroundFor this device group, only define policies with the same direction. If you need policies with different directions, define them on the individual interfaces, not on the device group. |
CSCdu40749 | QPM does not upload dFRF on a 7500 VIP device with 12.1(6)E and CBWFQ. | QPM does not support the upload of dFRF on a 7500 VIP device running IOS 12.1(6)E and configured with CBWFQ. WorkaroundEnter the required dFRF values in the Voice Configuration fields in the Interface Properties dialog box. |
The following sections include additional information about QPM 2.1 that is not provided in the user guide or the online help.
QPM supports the import of CSV or DIF Version 1.0 files from RME. Import of Version 2.0 files will be successful only if a password and enable password are configured on the devices.
In RME, when exporting your device inventory to a file, you are recommended to select Version 1.0 in the Export to File window, after you have selected the required output file format (CSV or DIF). Refer to the RME user documentation for information about how to export a device inventory to a file.
You can update the passwords on several devices simultaneously by re-importing an inventory file that was exported from RME.
Step 1 From the Policy Manager, select Devices>Import.
Step 2 In the displayed dialog box, enter the full path and name of the inventory file, or click Browse and select it. Click OK when the correct file is entered.
QPM opens the Import Devices dialog box and begins querying the devices in the inventory.
Step 3 When QPM has finished querying the devices, select the devices you want to add to the QoS database in the Known Devices list and click >> to add them to the import list. Click OK.
Step 4 In the displayed Detect Interfaces dialog box, click No All. QPM imports the device password information into the database without detecting device interfaces, thus saving time.
This section includes:
Problem Your QPM 2.1 login user name is not recognized.
Explanation The QPM 2.1 login user name is case sensitiveyou may not be using the correct case.
Recommended Action Reenter your user name with the correct case.
Problem Your database is renamed when you perform the upload operation.
Explanation If a database name contains one or more periods, QPM may rename the database after upload.
Recommended Action Do not include periods in the database name.
Problem Limiting policies on device groups created using QPM 1.1 are not converted correctly for QPM 2.1.
Explanation If both directions have been specified in the policy, problems may be encountered with the conversion to QPM 2.1.
Recommended Action Delete the policies from the database and recreate them using QPM 2.1.
Problem Deployment of a shaping (GTS) policy fails and you receive a message instructing you to remove the FRTS configuration from the device.
Explanation If FRTS is configured on an interface that is detected by QPM and the QoS property for the device is Do not Change, QPM does not remove FRTS from the device.
Recommended Action You can change the QoS property in the Interface Properties window, or manually remove the FRTS configuration from the device using the CLI, or perform the Upload operation for the device.
The following sections describe the tools provided by QPM for debugging or troubleshooting purposes.
QPM provides users with the option to use its blind login feature if problems are encountered when logging into a device for detection, verification, validation or deployment. During blind login, debug and other data generated by the device are disregarded, thus avoiding possible interference with the login process.
By default, blind login is not used. However, you can set blind login in the QoS Manager.ini file, located in the AppData directory under the root QPM installation directory, using the following procedure.
Step 1 Open the QoS Manager.ini file, located in the AppData directory under the root directory.
Step 2 In the Device Mode section, set BlindLogin to 1.
Step 3 Change the BlindLoginDelay value as required. This determines the number of milliseconds to wait between each command sent during the login process.
Step 4 Save the QoS Manager.ini file.
QPM provides a debug facility that can be used if communication problems are encountered during the validation process or during deployment of policies and QoS features to a device. The debug facility helps to identify the source of the problem by logging the function call trace for QPM operations, and/or logging sessions. This information can then be used for troubleshooting.
The following logging functions can be enabled in the cqpm.ini file, located in your Windows installation directory (usually c:/Winnt):
The Device Explorer utility is provided with the QPM 2.1 installation. This utility can be used to read the properties of a device (such as device model, IOS version and interface details), and output this information so that it can be used for troubleshooting purposes.
The Device Explorer utility is located in the bin directory under the root QPM installation directory. It can be activated from the command line interface, by entering the following information:
DeviceExplorer <device IP> [community string]
The following documents are provided with QPM 2.1:
Note Adobe Acrobat Reader 4.0 is required. |
In addition, you can use the following to learn how to install and use QPM 2.1:
For information about QPM 2.1 supported devices and software versions, refer to the following URL, or check the documentation on Cisco.com for the correct location.
http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/qos/qpm21/qpm21dev/index.htm
The following sections provide sources for obtaining documentation from Cisco Systems.
You can access the most current Cisco documentation on the World Wide Web at the following sites:
Cisco documentation is available in the following ways:
If you are reading Cisco product documentation on the World Wide Web, you can submit technical comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco.
You can e-mail your comments to bug-doc@cisco.com.
To submit your comments by mail, use the response card behind the front cover of your document, or write to the following address:
Attn Document Resource Connection
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-9883
We appreciate your comments.
Cisco provides Cisco.com as a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools. For Cisco.com registered users, additional troubleshooting tools are available from the TAC website.
Cisco.com is the foundation of a suite of interactive, networked services that provides immediate, open access to Cisco information and resources at anytime, from anywhere in the world. This highly integrated Internet application is a powerful, easy-to-use tool for doing business with Cisco.
Cisco.com provides a broad range of features and services to help customers and partners streamline business processes and improve productivity. Through Cisco.com, you can find information about Cisco and our networking solutions, services, and programs. In addition, you can resolve technical issues with online technical support, download and test software packages, and order Cisco learning materials and merchandise. Valuable online skill assessment, training, and certification programs are also available.
Customers and partners can self-register on Cisco.com to obtain additional personalized information and services. Registered users can order products, check on the status of an order, access technical support, and view benefits specific to their relationships with Cisco.
To access Cisco.com, go to the following website:
The Cisco TAC website is available to all customers who need technical assistance with a Cisco product or technology that is under warranty or covered by a maintenance contract.
If you have a priority level 3 (P3) or priority level 4 (P4) problem, contact TAC by going to the TAC website:
P3 and P4 level problems are defined as follows:
In each of the above cases, use the Cisco TAC website to quickly find answers to your questions.
To register for Cisco.com, go to the following website:
http://www.cisco.com/register/
If you cannot resolve your technical issue by using the TAC online resources, Cisco.com registered users can open a case online by using the TAC Case Open tool at the following website:
http://www.cisco.com/tac/caseopen
If you have a priority level 1(P1) or priority level 2 (P2) problem, contact TAC by telephone and immediately open a case. To obtain a directory of toll-free numbers for your country, go to the following website:
http://www.cisco.com/warp/public/687/Directory/DirTAC.shtml
P1 and P2 level problems are defined as follows:
This document is to be used in conjunction with the documents listed in the "QPM 2.1 Documentation" section.
AccessPath, AtmDirector, Browse with Me, CCDE, CCIP, CCSI, CD-PAC, CiscoLink, the Cisco NetWorks logo, the Cisco Powered Network logo, Cisco Systems Networking Academy, the Cisco Systems Networking Academy logo, Fast Step, Follow Me Browsing, FormShare, FrameShare, GigaStack, IGX, Internet Quotient, IP/VC, iQ Breakthrough, iQ Expertise, iQ FastTrack, the iQ Logo, iQ Net Readiness Scorecard, MGX, the Networkers logo, Packet, RateMUX, ScriptBuilder, ScriptShare, SlideCast, SMARTnet, TransPath, Unity, Voice LAN, Wavelength Router, and WebViewer are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, Discover All That's Possible, and Empowering the Internet Generation, are service marks of Cisco Systems, Inc.; and Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCNA, CCNP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, the Cisco IOS logo, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Enterprise/Solver, EtherChannel, EtherSwitch, FastHub, FastSwitch, IOS, IP/TV, LightStream, MICA, Network Registrar, PIX, Post-Routing, Pre-Routing, Registrar, StrataView Plus, Stratm, SwitchProbe, TeleRouter, and VCO are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and certain other countries.
All other trademarks mentioned in this document or Web site are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0105R)
Copyright © 2001, Cisco Systems, Inc.
All rights reserved.
Posted: Tue Oct 1 16:56:07 PDT 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.