Guest

CiscoWorks QoS Policy Manager

Readme for QoS Policy Manager 4.1.1 on Windows

  • Viewing Options

  • PDF (477.3 KB)
  • Feedback
Readme for QoS Policy Manager 4.1.1 on Windows

Table Of Contents

Readme for QoS Policy Manager 4.1.1 on Windows

Description

Related Documentation

New Features

Enhanced Features

Command Support

Device Support

Hardware and Software Requirements

Downloading and Installing QPM 4.1.1

Downloading from Cisco.com

Installing QPM 4.1.1

Known Problems

Resolved Problems


Readme for QoS Policy Manager 4.1.1 on Windows


This Readme is for CiscoWorks QoS Policy Manager (QPM) 4.1.1 running on a windows platform. This Readme contains the following sections:

Description

Related Documentation

New Features

Enhanced Features

Command Support

Device Support

Hardware and Software Requirements

Downloading and Installing QPM 4.1.1

Known Problems

Resolved Problems

Description

CiscoWorks QoS Policy Manager 4.1.1 is a maintenance release that enhances the functionality of QoS Policy Manager 4.1 by providing:

Support for new features

Enhancements to existing QPM 4.1 features

Command support

Device support

QPM 4.1.1 is a patch release, and you can install it on top of QPM 4.1.

Related Documentation

QPM 4.1.1 is a maintenance release after QPM 4.1. The most updated documentation for QPM 4.1.1 and QPM 4.1 can be found on Cisco.com:

Supported Devices and Software Releases for QoS Policy Manager 4.1.1

http://www.cisco.com/en/US/products/sw/cscowork/ps2064/
products_device_support_tables_list.html

Installation Guide for CiscoWorks QoS Policy Manager 4.1 on windows

http://www.cisco.com/en/US/docs/net_mgmt/ciscoworks_qos_policy_manager/4.1/installation/guide/windows/QPM41WIN.html

Getting Started Guide for CiscoWorks QoS Policy Manager 4.1

http://www.cisco.com/en/US/docs/net_mgmt/ciscoworks_qos_policy_manager/4.1/getting_started/guide/qpm41gsg.html

Quick Start Guide for CiscoWorks QoS Policy Manager 4.1.

http://www.cisco.com/en/US/docs/net_mgmt/ciscoworks_qos_policy_manager/4.1/quick_start/guide/qpm41qsg.html

Readme for CS 3.2 with QoS Policy Manager 4.1.

http://www.cisco.com/en/US/docs/net_mgmt/ciscoworks_qos_policy_manager/4.1/readme/CS32RMe.html

User Guide for QoS Policy Manager 4.1

http://www.cisco.com/en/US/docs/net_mgmt/ciscoworks_qos_policy_manager/4.1/user/guide/qpm41ug.html

New Features

QPM 4.1.1 includes the following new features:

NBAR PDLM Protocol Discovery—Enables you to add, import, edit, or delete new NBAR supported protocols. You can also add new parameter values to the existing set of NBAR supported protocols.

When you add support for a new protocol to a device, the Protocol Discovery Language Module (PDLM) is updated on the device. You can add these newly supported NBAR protocols on the device to the QPM user interface.

VLAN Monitoring—Enables you to monitor VLAN interfaces that are based on CBQoS MIB. QPM supports both real time and historical monitoring jobs for VLAN interfaces.

Catalyst 6000 Device Discovery—Enables you to easily locate Cat 6000 devices that support PISA cards from Cat 6000 devices that support other cards. QPM user interface displays the Catalyst 6000 (Cat 6000) devices that enclose a PISA card with a "with PISA" suffix to their display names.

For example, the display name of a Cat 6000 device with PISA card support appears in the Device Summary page as:

Cat6000_PFC3 (IOS) with PISA

Whereas, the display name of a Cat 6000 device that supports other cards appears in the Device Summary page as:

Cat6000_PFC3 (IOS)

Object Selector Filter Options—Enables you to search for one or more objects in an object selector. You can search for objects, based on the object categories. You can also edit or delete the objects that appear as a result of the Filter operation.

Match VLAN Support—Enables you to define or remove VLAN IDs to specify a VLAN condition in the current traffic classifier rule.

You can set up to 30 VLAN IDs in a single VLAN condition. The range of VLAN IDs that you can set depends on the device type. VLAN ID ranges for various device types are:

IOS devices—1 to 1500

CAT devices—1 to 4094

7600 devices—1 to 4095

To add or modify a VLAN condition to a device, you must set at least one VLAN ID in each VLAN condition.

Enhanced Features

QPM 4.1.1 provides enhancements to the Table Pagination feature in QPM 4.1. The 4.1.1 release has new controls to the QPM tables.

The table header includes a Rows per page drop down list that enables you to set the number of rows that can appear on a single table page. You can set the following values in the Rows per page drop down list: 10, 25, 50, 100, and All. The default value is 10.

The table footer includes page navigation controls that enable you to navigate across multiple table pages. If a table consists of only one page, the navigation controls are disabled.

Command Support

QPM 4.1.1 not only supports the commands supported in QPM 4.1, but also the following new commands:

rcv-queue cos-map queue-id threshold-id [cos-1 ...cos-n]

priority-queue queue-limit weight

qos dbl

qos dbl exceed-action ecn

mls qos srr-queue input dscp-map queue queue-id {dscp1...dscp8 | threshold threshold-id dscp1...dscp8}

mls qos srr-queue output dscp-map queue queue-id {dscp1...dscp8 | threshold threshold-id dscp1...dscp8}

queue-set qset-id

wrr-queue random-detect queue-id

In addition to these new commands, this release also adds IOS XR command support for the CRS and the GSR devices.

Device Support

QPM 4.1.1 not only supports the devices supported in QPM 4.1, but also the Cisco 860 Series and 880 Series Routers

Table 1 shows the device OIDs and names of the additional devices supported by QPM 4.1.1.

Table 1 Additional Devices Supported by QPM 4.1.1

Cisco System Device
Device OID
Device Name
Supported OS

Cisco 860 Series

 

Cisco 860 Series Routers

 

1.3.6.1.4.1.9.1.834

Cisco 861Integrated Services Router

12.4

1.3.6.1.4.1.9.1.835

Cisco 866 Router

12.4

1.3.6.1.4.1.9.1.836

Cisco 867 Integrated Services Router

12.4

Cisco 880 Series

 

Cisco 880 Series Routers

 

1.3.6.1.4.1.9.1.837

Cisco 881 Integrated Services Router

12.4T

1.3.6.1.4.1.9.1.842

Cisco 886 Integrated Services Router

12.4T

1.3.6.1.4.1.9.1.847

Cisco 887 Integrated Services Router

12.4T

1.3.6.1.4.1.9.1.852

Cisco 888 Integrated Services Router

12.4T

1.3.6.1.4.1.9.1.859

Cisco 885 Integrated Services Router (885-D-3)

12.4T

1.3.6.1.4.1.9.1.861

Cisco 885 Integrated Services Router (885-E/J-3)

12.4T

Cisco 1800 Series

 

Cisco 1800 Series Integrated Services Routers

 

1.3.6.1.4.1.9.1.902

Cisco 1861 Integrated Services Router (C1861-UC-2BRI-K9)

12.3

1.3.6.1.4.1.9.1.903

Cisco 1861 Integrated Services Router (C1861-UC-4FXO-K9)

12.3

1.3.6.1.4.1.9.1.904

Cisco 1861 Integrated Services Router (C1861-SRST-B/K9)

12.3

1.3.6.1.4.1.9.1.905

Cisco 1861 Integrated Services Router (C1861-SRST-F/K9)

12.3

1.3.6.1.4.1.9.1.939

Cisco 1861 Integrated Services Router (C1861-SRST-C-B/K9)

12.3

1.3.6.1.4.1.9.1.940

Cisco 1861 Integrated Services Router (C1861-SRST-C-F/K9)

12.3

1.3.6.1.4.1.9.1.990

Cisco 1861 Integrated Services Router (C1861W-SRST-F/K9)

12.3

1.3.6.1.4.1.9.1.991

Cisco 1861 Integrated Services Router (C1861W-SRST-B/K9)

12.3

1.3.6.1.4.1.9.1.992

Cisco 1861 Integrated Services Router (C1861W-SRST-C-F/K9)

12.3

1.3.6.1.4.1.9.1.993

Cisco 1861 Integrated Services Router (C1861W-SRST-C-B/K9)

12.3

1.3.6.1.4.1.9.1.994

Cisco 1861 Integrated Services Router (C1861W-UC-4FXO-K9)

12.3

1.3.6.1.4.1.9.1.995

Cisco 1861 Integrated Services Router (C1861W-UC-2BRI-K9)

12.3

Cisco CRS

 

Cisco Carrier Routing Systems

 
 

1.3.6.1.4.1.9.1.738

CRS-1 Multishelf System

IOS XR 3.3 and 3.4

Cisco XR 12000 Series

 

Cisco XR 12000 Series Routers

 

1.3.6.1.4.1.9.1.388

Cisco XR 12406 Router

IOS XR 3.6.1, 3.7.0, 3.7.1

1.3.6.1.4.1.9.1.394

Cisco XR 12410 Router

IOS XR 3.6.1, 3.7.0, 3.7.1

1.3.6.1.4.1.9.1.478

Cisco XR 12810 Router

IOS XR 3.6.1, 3.7.0, 3.7.1

1.3.6.1.4.1.9.1.273

Cisco XR 12016 Router

IOS XR 3.6.1, 3.7.0, 3.7.1


For details regarding the QoS feature support for these devices, see the detailed Supported Devices Table for QPM 4.1.1 at http://www.cisco.com/en/US/products/sw/cscowork/ps2064/
products_device_support_tables_list.html

Table 2 shows the additional cards supported by QPM 4.1.1.

Table 2 Additional Cards Supported by QPM 4.1.1

Card Name
Type

Cisco 7600 Series OSM-2+4GE-5PACK+

Line Card


Hardware and Software Requirements

QoS Policy Manager 4.1.1 requires that you have installed QoS Policy Manager 4.1. All of these applications run on Common Services (CS) 3.2 server.

The hardware and software requirements for QPM 4.1.1 are the same as for QPM 4.1.

For detailed list of requirements and instructions to install CS 3.2 and QPM 4.1 on windows, see http://www.cisco.com/en/US/docs/net_mgmt/ciscoworks_qos_policy_manager/4.1/installation/guide/windows/QPM41WIN.html

Downloading and Installing QPM 4.1.1

You can download the QPM 4.1.1 installer file, qpm4_1_1_win.zip, from Cisco.com, and install it on a machine that has QPM 4.1 already installed.


Note You should have a valid Cisco.com username and password to download the installer file.


The following topics describe the download and installation process of QPM 4.1.1:

Downloading from Cisco.com

Installing QPM 4.1.1

Downloading from Cisco.com

To download the QPM 4.1.1 installer file from Cisco.com:


Step 1 Go to http://www.cisco.com/pcgi-bin/tablebuild.pl/qos-patches.

You should enter your Cisco.com credentials to access this page.

Step 2 Locate the file qpm4_1_1_win.zip from the list of files to be downloaded.

Step 3 Right-click the file, select Save Target As or Save Link As, and specify the location to download the file to your machine.


Installing QPM 4.1.1

QPM saves the Historical Monitoring data at the end of every hour. Therefore, before you install QPM 4.1.1 over QPM 4.1, wait till the end of the hour. This is to allow QPM to save the data associated with any Historical Monitoring tasks that are running.

The monitoring tasks will be resumed after you install QPM 4.1.1 and restart the CiscoWorks daemon.

To install QPM 4.1.1 on the machine that has QPM 4.1 already installed:


Step 1 Go to the folder where you have downloaded the installer file, qpm4_1_1_win.zip

Step 2 Unzip the file qpm4_1_1_win.zip

This extracts a folder called qpm4_1_1_win.

Step 3 Go to qpm4_1_1_win, which contains the executable file.

Step 4 Launch the installer. Either:

Double click the executable file, qpm4_1_1_win.exe.

Or

Select Start > Run, and enter path\qpm4_1_1_win.exe,
where path is the location of the file in your hard drive.

The Installer window appears.

Step 5 Click Install to continue.

The Welcome window appears.

Step 6 Click Next to continue.

The Software License Agreement window appears.

Step 7 Click either:

Accept to accept the license agreement and proceed with the installation,

Or

Do not Accept to deny and stop the installation.

The System Requirements window appears.

Step 8 Check whether your system meets the requirements and click Next to continue.

The Summary window appears with the summary of settings for the installation.

Step 9 Click Next to continue.

The Daemons Restart Options window appears.

Step 10 Click either:

Yes to restart the CiscoWorks daemon after this installation

Or

No to deny restart of Ciscoworks daemon after this installation (to allow installation of any other CiscoWorks applications)

The Setup Complete window appears.

Step 11 Click Finish to complete the installation.

You must restart the CiscoWorks daemon before you begin to work with QPM. The QPM services start automatically whenever you start your computer.


Known Problems

Table 3 describes the known problems in QPM 4.1.1.

Table 3 Known Problems in QPM 4.1.1 

Bug ID
Summary
Explanation

CSCsm38123

Service-Policy command is not deployed on a device with the following configuration:

Device Model: Cat6000_PFC1(IOS)

Interface: Cat6509 GigEthernet port.

IOS Version: 12.2(17r)S4

This occurs when you deploy the Service-Policy command on the specified device.

A message appears on the Local Preview page in QPM that the Service-Policy command has been deployed successfully.

However, if you enter the Service-Policy command on the device in the CLI mode, you find that the policy is not deployed.

Workaround:

None.

CSCsq12042

Firefox: Buttons do not work after you create and deploy policies and assign threshold sets.

This occurs when you:

1. Create a policy and a deployment job for any one of the following policies:

Custom policy

Voice policy

AutoQoS policy

2. Assign a threshold set.

The buttons do not work in any of the pages.

Workaround:

1. Click Dashboard to return to the Main Menu.

2. Return to the Policy Deployment page from the Main Menu

All buttons work.

CSCsq67358

QPM Dashboard on LMS does not load all portlets, initially.

This occurs when you have not added the portlets to the QPM view in LMS.

Workaround:

Add all portlets to QPM view in LMS and save the view. This setting will be preserved.

CSCsq81508

TelePresence: OC3 Interfaces on non-SOP modules are not listed in the Define Circuit page.

This occurs when you:

1. Import a device with OC3 connection.

2. Choose TelePresence > Circuit Table.

3. Create a TelePresence circuit for OC3 interface.

4. Choose OC3 from the Select the interface drop-down list.

5. Click Next.

The Define Circuit page appears. This page lists the start and end points of the circuit. It does not display OC3 interfaces.

Workaround:

None.

CSCsr04020

IE 7.0 browser—CPU usage is high when 2000 or more devices are listed in the Tree View.

IE 7.0 uses a higher percentage of CPU compared to IE 6 or FireFox 2.x.

When you continuously use the Tree View device selector (listing 2000 or more devices), IE 7.0 sometimes uses 100% of CPU.

Workaround:

You can either:

Go to some other QPM page that does not have the Tree View device selector.

Or

Close and open IE.

CSCsr17121

Show Run option in Device Properties page does not work in ACS mode.

This occurs when you:

1. Register QPM with ACS (custom privilege with all permissions enabled).

2. Go to the Device Summary page of a device.

3. Click Show Run.

A new page appears with a QPM error.

Workaround:

None.

CSCsr25139

IE 7.x: Copy policy group option opens a new page with a QPM error.

This occurs when you:

1. Choose Provisioning > Policy Management > Policy Groups.

2. Select a policy group and click Copy.

A new page appears with a QPM error.

Workaround:

To view the policy:

1. Close the QPM error page.

2. Choose Provisioning > Policy Management > Policy Groups.

The Policy Groups page lists the copied policy.

CSCsu01936

TelePresence Circuits are not available for 7200 devices with IOS version 12.3 or lower.

This occurs when you:

1. Choose Provisioning > TelePresence > Circuit Table.

2. Click Create a Circuit.

3. Enter a circuit name, select interface type, and configure circuit and class utilization notifications.

4. Click Next.

The Monitoring Job page appears.

5. Choose Monthly from the Job frequency drop-down list.

6. Click Next and Finish to save the configuration.

The TelePresence Circuit does not appear in the TelePresence Circuit table.

Workaround:

This problem occurs in 7200 devices with IOS version 12.3 or lower.

If the IOS version is lower than 12.3, map the 7200 device to IOS 12.3.

If the IOS version is 12.3, map it to a higher version.

To map the 7200 device to 12.3 or higher version:

1. Choose Devices > Device Summary.

2. Click the device hyperlink.

The Device Summary General Information page appears.

3. Choose 12.3 or a higher version in the Mapped OS drop-down list.

4. Click Save.

CSCsu35483

Policy deployment for 10,000 devices—Pending Jobs page causes the Tomcat memory to grow over 1 GB.

This occurs when you:

1. Create a single deployment job for 10,000 devices.

The UI control returns to the Pending Jobs page.

2. Continue to work on the Pending Jobs page for three or four hours.

The Tomcat memory grows over 1 GB and slows down server performance.

Workaround:

After you create the job, exit out of the Pending Jobs page.

This stops the Tomcat memory growth and the used memory comes down after sometime.

CSCsw81908

Unable to select multiple rows (spread across multiple table pages) at a time in the pagination tables.

This occurs when you:

1. Go to a pagination table that contains more than 10 rows.

Examples of a pagination table are Import from DCR table, Network Element Assignment table, Completed Jobs table, and so on.

2. Check the Common Selection check box and click the right arrow button in the navigation controls.

The next table page appears.

3. Click the left arrow button to go to the previous page.

The user interface does not preserve the selection that you have made in Step 2.

This also occurs when you:

1. Go to a pagination table that contains more than 10 rows.

Examples of a pagination table are Import from DCR table, Network Element Assignment table, Completed Jobs table, and so on.

2. Check the Common Selection check box and click the right arrow button in the navigation controls.

The next table page appears.

3. Click any one of the buttons on this table page without selecting an item from the table.

An alert message appears corresponding to the button that you have clicked. This alert message informs you that the application is not able to work with multiple table pages at this time.

Workaround:

1. Go to a pagination table that contains more than 10 rows.

2. Select All from the Rows Per Page drop down list.

3. Click Go.

All items in the table appear in a single table page.

CSCsy92835

QPM does not support the trust-dscp command for CBQoS.

This occurs when you:

1. Create a policy for Cat6k.

2. Select the scheduling type as CBQoS in Qos properties page.

3. Create the IN traffic rule.

In Marking, QPM does not enable the trust option.

Workaround:

None

CSCsy83986

Cannot delete Timed ACL from the Policy.

This occurs when you:

1. Create a policy in QPM with a Timed ACL.

2. Edit the policy and try to delete the Timed ACL

A message appears that there is an error on the page.

Workaround:

1. Delete the traffic classifier rule and create a new traffic classification.

2. Replace the existing timed-acl with a new Timed ACL

CSCsw18111

While applying an FRTS policy to a Cat 1720 device, an error appears in the Debug mode.

This occurs when you:

Apply an FRTS policy to a Cat 1720 device.

The following exception appears:

com.cisco.nm.qpm.server.policy.exceptions.ContradictingCapabilitiesException occured in: /qpm/servlet/com.cisco.nm.qpm.web.policy.group.wizard.servlet.PGDefinitionWizardServlet

Workaround:

None

CSCsy84636

If you deselect an object, it is not removed from the object selectors in the Device View Device Summary and the Device Folder pages

This occurs when you:

1. Go to Devices > Device Grouping > Device Folders.

2. Select a device folder from the table and Click Edit.

The Device Folder Properties Page appears.

3. Deselect a device from the device folder and click Save.

4. Select the device folder that you have edited in Step 3 and click Edit.

The device that you have removed from the device folder in Step 3 still appears under the device folder.

This also occurs when you:

1. Go to Devices > Device Management > Device Summary

2. Expand a device and select a few interfaces in this device.

3. Expand another device and select a few interfaces in this device.

4. Deselect the interfaces from the device that you have selected in Step 2.

5. Click Show QoS Capabilities.

The deselected interfaces also appear in the Qos Capabilities report.

Work around

After you deselect an object from the Object selector, collapse the parent object of the deselected object to preserve the changes.


Resolved Problems

Table 4 describes some of the problems resolved since the last release of QPM.

Table 4 Resolved Problems in QPM 4.1.1 

BugID
Summary
Additional Information

CSCsm12489

The Edit option in the Tree View device selector did not work.

This problem has been resolved.

CSCsm14370

In Real Time and Historical Monitoring charts, the option to view the chart with a logarithmic vertical axis did not work

This problem has been resolved.

CSCsm46162

System Name was not displayed fully in the Network Assignment Element page.

This problem has been resolved.

CSCso47414

Chart legends were sometimes displayed vertically.

This problem has been resolved.

CSCsq26633

QPM did not retrieve Display Name and Domain Name information from Common Services' DCR.

This problem has been resolved.

CSCsq55659

Nested policies Hierarchical QoS ClassMaps page did not have a scroll bar.

This problem has been resolved.

CSCsq60783

Search, Selection, and Filter options were not in any of the Tree View device selectors.

This problem has been resolved.

CSCsq60862

If you resized the browser scroll bars were not created.

This problem has been resolved.

CSCsq88389

Search and selection options in the Tree View policy selector were not fully functional.

This problem has been resolved.

CSCsr03804

Policy Templates: Constraints Definition link was disabled.

This problem has been resolved.

CSCsr03820

Constraint Definition, QoS Properties, and Traffic Rules pages were not visible while creating policy using the Attach Policy Template option.

This problem has been resolved.

CSCsr43606

QPM did not list the interfaces of selected devices in Voice Policy.

This problem has been resolved.

CSCsu20996

Device Discovery process took a long time for Bulk Device Import (10,000).

This problem has been resolved.

CSCsu26699

Device Group was not set after ACS integration in Policy View page.

This problem has been resolved.

CSCsu44813

QPM did not display PortQoS devices in the Tree View device selector under Real Time QoS Monitoring for the first time after a fresh installation.

This occurred when QPM inventory has only PortQoS-supported devices.

This problem has been resolved.

CSCsu47379

CbQoS historical monitoring jobs could be created after you upgraded to QPM 4.1.

This problem has been resolved.

CSCsq28775

For devices that already had display names in DCR, QPM user interface displayed the IP addresses instead of the display names specified in DCR.

This problem has been resolved.

CSCsr04179

QPM documentation did not specify real time monitoring hard limit.

This problem has been resolved.

CSCsv68575

The units of measurement of the data values in the exported graph report were different from the units of measurement of the data values in the actual graph report.

This problem has been resolved.

CSCsw80246

In SSL mode, the Real Time monitoring chart displayed an http 2032 error.

This problem has been resolved.

CSCsx06087

During class-map configuration, if you used the Traffic Rule Creation workflow, QPM displayed the Bandwidth remaining percent error even when the cumulative bandwidth equaled 100%.

This problem has been resolved.

CSCsw66015

QPM did not create the DSCP Markings for Cat2950 Policies.

This problem has been resolved.

CSCsv91443

QPM displayed an unknown error while creating a policy from the inventory on the cat6509 device with IP3Q8T.

This problem has been resolved.

CSCsu94758

After deploying a blank policy on a device, QPM did not delete some commands that existed in the previous policy.

This problem has been resolved.

CSCsw27440

In the Policy Description page, the image icon corresponding to the disabled policies did not appear correctly in the Traffic Rules table.

This problem has been resolved.

CSCsm14567

Scroll bars did not appear in the content area and the wizard pages of the QPM user interface.

This problem has been resolved.

CSCsm87782

The QPM QoS import report table did not display the start time.

This problem has been resolved.

CSCsy54083

QPM did not display the police percent option for ASR1000 if it was running IOS 12.2.

This problem has been resolved.

CSCsr76618

QPM did not import hierarchal QoS monitoring policies that were attached to the tunnel interfaces.

This problem has been resolved.