-
User Guide for CiscoWorks QoS Policy Manager 4.1
-
Preface
-
Chapter 1 Introduction
-
Chapter 2 Planning for Quality of Service
-
Chapter 3 Getting Started
-
Chapter 4 Managing Devices
-
Chapter 5 Working with Policy Groups
-
Chapter 6 Working with Macros
-
Chapter 7 Configuring QoS for IP Telephony
-
Chapter 8 Working with Policies, Properties, and Traffic Rules
-
Chapter 9 Deploying QoS Policies
-
Chapter 10 Monitoring: Using QoS Analysis
-
Chapter 11 Using Administration Features
-
Chapter 12 Integrating NCM with QPM
-
Chapter 13 Integrating CUOM with QPM
-
Chapter 14 Troubleshooting QPM
-
Appendix A Devices Drawer Reference
-
Appendix B Provision Tab Reference: Macros and Policy Creation
-
Appendix C Provision Tab Reference: Policy Preview and Deployment
-
Appendix D Monitor Tab Reference
-
Appendix E Administration Tab Reference
-
Appendix F CLI Command Reference for QPM Actions
-
Appendix G QPM FAQs
-
Index
-
Table Of Contents
Source-Dest Pair Properties Page
Import Devices Wizard - General Page
Import Devices Wizard - Select Devices Page
Discovery Status Devices List Dialog Box
Devices Drawer Reference
The following topics describe the pages in the Devices drawer. Topics are organized according to the following Devices tab options:
Device Summary Page
The following topics describe the fields that are accessed from the Device Summary page:
•
Source-Dest Pair Properties Page
•
Device Summary Page
Use this page to:
•
•
•
•
•
•
•
•
To open this page, go to Devices > Device Management > Device Summary.
Device Selector
The device selector displays all devices under the active device group in the QPM inventory. The devices are further categorized under different device folders (if any) under the active device group.
The device selector also displays the failed devices under the active device group as a separate category. The failed devices are further categorized based on the reason for failure—Unreachable, SNMP Error, Telnet Error, or DCR Error.
When you click a device name, the corresponding device properties are displayed in the content area.
General Information Area
Table A-1 Device Summary Page - General Information Area (for the Selected Device)
Sys Name
Displays the system name, which is obtained from the SysName MIB variable. Click a name to display that device's properties.
Primary Name
Displays the device IP address or DNS name entered to identify the device when it was added to the inventory.
IP/DNS
Displays the device IP address or DNS name.
Although this field is an editable field, you cannot change its data. Changes will not be saved when you click the Save button.
You cannot use device DNS names that contain the backslash (\) character.
Status
Displays the device status.
The following statuses indicate that the device is working properly:
•
•
The following statuses indicate a problem with the device. Devices with these statuses are not usable in QPM:
•
•
–
–
–
–
•
•
•
•
–
–
Description
Displays the device description. Although this is an editable field, you cannot save changes you make to the description.
Role
Displays the device role, if one is assigned. Select a role from the list to assign it to the device.
OS
Displays the device operating system (OS) version.
Mapped OS
Displays the OS version that QPM has mapped to the device. See the section Adding Devices to the Device Inventory, page 4-2 for information about mapped OS versions.
If you change the mapped OS version, QoS that is currently configured on the device might not be supported in the new OS version.
Model
Displays the device model.
Last Discovery
Displays the date the device was last discovered.
Device Group
Displays the device group to which the device belongs.
Device Folder
Displays the device folder to which the device is assigned. Select a device folder from the list to assign it to the device.
All Interfaces
Displays the number of interfaces on the device that are in the QPM inventory.
Ignored Interfaces
Displays the number of ignored interfaces on the device. Click the number to remove the ignore setting from one or more interfaces. The Ignored Interfaces List Dialog Box opens.
Table A-2 Device Summary Page - General Information Area (for the Selected Interface)
Name
Interface name.
Index
Interface index.
Type
Interface type.
Card Type
Interface card type.
If the card type is not correct, see QPM does not detect the correct card type, page 14-7. If the procedure described has been implemented, you can select a different card type in this field.
Rate
Interface rate.
Description
Interface description.
IP
Interface IP address.
Subnet Mask
Interface IP address subnet mask.
Is Ignored
Indicated whether the interface is marked as ignored, which prevents it from appearing in the QPM UI. Select the check box to ignore the interface, or clear it to remove the ignore setting.
Device Settings Area
Access Configuration Area
For security, fields that contain passwords do not display the text that you type.
Table A-4 Device Summary Page - Access Configuration Area
Login Protocol
Choose the login protocol that QPM uses to communicate with the device.
You can choose SSHv2, SSHv1, or Telnet as the login protocol. You can also choose Auto Select so that QPM automatically selects the login protocol with the order of preference as SSHv2, SSHv1, and Telnet.
If the device has non-standard prompts, ensure they are identified to QPM as described in QPM cannot log into a device, page 14-5.
Reset to Default button
Click to reset the values in the Access Configuration area to the device group default values.
ACL Ranges Area
Select ACL ranges for translation of QPM policies to CLI commands.
Note
Topology Area
This area displays the topology of the device (or the interface) by listing the device to which each interface connects. Only devices in the QPM inventory that support Cisco Discovery Protocol (CDP) are listed.
VC ATM Area
VC Bundle Area
DLCI Frame Relay Area
Table A-10 Interface Properties Page - DLCI Frame Relay Area
Check box column
Click a check box to select its row.
DLCI Name
DLCI name.
Interface VLAN Association Area
Buttons
Table A-12 Device Summary Page - Buttons
Launch Device Center
Click to go to CiscoWorks Device Center so that you can manage the selected device available in DCR.
Save
Click to save any changes you have made in the page.
Rediscover
Click to rediscover the device. The Discovery Status Page appears.
Show Run
Click to display the device's running configuration. The Display show run Page appears.
Telnet
Click to Telnet to the device using your client system's default Telnet application. Does not work if your client system does not have a Telnet application installed.
Export
Click to export the device's information to a virtual device file, which you can use to import the device into the inventory as a virtual device. The browser's file saving process starts.
Populate DCR
Click to populate the Common Services DCR with devices, either by manual addition or by the Network Discovery feature, so that you can later import them to QPM.
Click the drop down arrow to select between these options.
The default option is By Manual Addition.
Import Devices to QPM
Click to import devices from DCR or from a Virtual Devices file, into QPM.
Click the drop down arrow to select between these options.
The default option is Import from DCR.
Rediscover Devices
Click to rediscover the selected devices from the QPM inventory.
Additionally, you can click the drop down arrow on the button, and click the following options:
•
•
Delete Devices
Click to delete the selected devices from the QPM inventory.
Additionally, you can click the drop down arrow on the button, and click the following options:
•
•
Related Topics
•
•
•
Discovery Status Page
Use this page to view the status of device discovery jobs.
To open this page, do one of the following:
•
•
•
•
Table A-13 Discovery Status Page
Check box column
Select a check box to select its row.
Job Type column
Displays the job type.
Start column
Displays the job start time.
End column
Displays the job end time.
In Progress column
Displays the number of devices that are in the process of being discovered.
Click the number to view details about discovery of these devices. The Discovery Status Devices List Dialog Box opens.
Completed column
Displays the number of devices that have been discovered.
Click the number to view details about discovery of these devices. The Discovery Status Devices List Dialog Box opens.
Total column
Displays the number of devices that are in the process of being discovered or have been discovered.
Click the number to view details about discovery of these devices. The Discovery Status Devices List Dialog Box opens.
User column
Displays the user who started the job.
Delete button
Click to delete the selected jobs. This does not stop the discovery job.
Refresh Rate list box
Select a page refresh rate from the list. The refresh rate determines how often the page refreshes with updated information.
Related Topics
•
•
•
Device Groups Page
Device groups are groups of devices (and their network elements) within the inventory that are created and maintained in ACS, except the default device group, which exists and is maintained only in QPM.
Use this page to:
•
•
To open this page, select Devices > Device Grouping > Device Groups.
Table A-14 Device Groups Page
Radio button column
Select a radio button to select its row.
Name column
Displays the device group name.
Description column
Displays the device group description.
Active Device Group column
Indicates whether the device group is the active device group. The active device group has a check mark in this column.
Device Folders column
Click the Device Folders icon in the column to view the device folders that exist within the device group. The Device Folders page appears.
Edit button
Click to edit the properties of the selected device group. The Device Group Properties Page appears.
Set Active button
Click to set the selected device group as the active device group.
This setting takes effect throughout the QPM UI. Only the devices, deployment groups, and policy groups in the active device group appear in the UI. To work with items from another device group in the QPM UI, set that device group to be the active device group.
Delete button
Click to delete the selected device group.
Any policy groups and policies contained in the device group are also deleted. This feature is useful because device groups are not automatically deleted from QPM when you delete them in ACS, even when you synchronize device group information with ACS.
This allows you to edit your QPM policy groups and policies before manually deleting the device group.
Device Group Properties Page
Device groups are groups of devices (and their network elements) within the inventory that are created and maintained in ACS, except the default device group, which exists and is maintained only in QPM.
Many of the device group properties are the same properties that QPM maintains for devices. These device group properties are assigned to all devices in the device group by default. You can override these defaults by entering different device properties for an individual device.
Use this page to view and edit device group properties.
To open this page, do any of the following in the Device Groups page:
•
•
General Information Area
Device Settings Area
Default Access Parameters Area
For security, fields that contain passwords do not display the text you enter.
ACL Ranges Area
Select ACL ranges for translation of QPM policies to CLI commands.
Note
Buttons
Table A-19 Device Group Properties Page - Buttons
Save button
Saves any changes you have made in the page.
Related Topics
•
•
•
•
•
Device Folders Page
Device folders are groups of devices, used for organizational purposes.
Use this page to view, create, edit, and delete device folders.
To open this page, do any of the following:
•
•
Table A-20 Device Folders Page
Check box column
Select a check box to select its row.
Name column
Displays the device folder name. Click a device folder name to view or edit the device folder properties.
Description column
Displays the device folder description.
Devices column
Click the Devices icon in the Devices column to view the devices in a device folder. The Device Table page appears.
Create button
Click to create a new device folder. The Device Folder Properties Page appears.
Edit button
Click to edit the selected device folder. The Device Folder Properties Page appears.
Delete button
Click to delete the selected device folder.
Device Folder Properties Page
Device folders are groups of devices, used for organizational purposes.
Use this page to create new device folders, and view and edit device folder's properties.
To open this page, do any of the following from the Device Folders page:
•
•
•
Related Topics
•
•
•
•
•
Group Selection Page
Use this page to apply the device groups in ACS, DCR, or CiscoWorks Local, to QPM device inventory.
Sync Privileges Page
Use this page to manually synchronize the user permissions and device group information in the inventory with ACS or CiscoWorks Common Services (depending on which you are using to administer device groups and user permissions).
Typically you would synchronize in the following cases:
•
•
To open this page, select Devices > Device Grouping > Sync Privileges.
If you are using ACS mode, this view only gives you a high-level view of your privileges. Although this table might show that you have a privilege, you might not have all the sub-privileges for that privilege type.
If you cannot perform a task even though this page indicates you have permission, first press Sync to synchronize with ACS.
If you still cannot perform the task, view the privilege settings within ACS to determine if you are missing a sub-privilege.
Display show run Page
Use this page to display a device's running configuration.
Click Show Run to open.
This page displays the device's running configuration.
Related Topics
•
Source-Dest Pair Page
Source-destination pairs are logical (not physical) user-supplied network elements defined for Catalyst 8400 series and Catalyst 8500 series switches, which have QoS features that require a named source and destination interface pair on the device.
Use this page to:
•
•
To open this page, select Devices > Device Summary. The Device Table page appears. Open the Device Properties page by clicking the device name, then select Device Information > Source-Dest Pair from the TOC.
Table A-24 Source-Dest Pair Page
Pair Name
Source-destination pair name.
Source Interface
Source interface name.
Target Interface
Target (destination) interface name.
Policy Group
Policy in the current policy group to which the source-destination pair is assigned. The current policy group is displayed in the Policy Group field in the context area at the top of the page.
Create button
Click to create a new source-destination pair. The Source-Dest Pair Properties Page appears.
Edit button
Click to edit the selected source-destination pair. The Source-Dest Pair Properties Page appears.
Delete button
Click to delete the selected source-destination pair. The Source-Dest Pair Properties Page appears.
Set Policy Group button
Click to set the policy group assignment of the selected source-destination pair. The Policy Group Assignment dialog box opens.
Related Topics
•
•
Source-Dest Pair Properties Page
Source-destination pairs are logical (not physical) user-supplied network elements defined for Catalyst 8400 and Catalyst 8500 switches, which have QoS features that require a named source and destination interface pair on the device.
Use this page to view and edit source-destination pair properties.
To open this page, do any of the following in the Source-Dest Pairs page:
•
•
•
Related Topics
•
VLANs Page
Use this page to:
•
•
To open this page, select Devices > Device Summary. The Device Table page appears. Open the Device Properties page by clicking the device name, then select Device Information > VLANs from the TOC.
Related Topics
•
•
VLAN Properties Page
Use this page to view and edit a VLAN's properties.
Click the VLAN name in the VLANs page to open.
General Information Area
VLAN Interfaces Association Area
Related Topics
•
Import Devices Wizard
Use the Import Devices wizard to import devices into the inventory.
The Import Devices wizard contains the following pages:
•
•
Import Devices Wizard - General Page
Use this page to import new devices into the QPM device inventory. For all the import types except virtual devices (which are not physical devices), QPM discovers the devices to import them. Therefore, devices you attempt to import must be online and connected to the network.
You cannot use device DNS names that contain the backslash (\) character to import devices into QPM.
To open this page, go to Devices > Device Management > Device Summary, and click Import Devices to QPM.
The Device and Credential Repository (DCR) in Common Services is a common repository of devices, device attributes, and the credentials required to manage devices in a management domain. DCR enables device information to be shared among various network management applications.
Individual applications interact with this repository to get the device list, device attributes, and device credentials.
Applications can read or retrieve the information from DCR and update the information in DCR to share with other applications. Device Credentials Repository (DCR) is the central credentials repository for QPM.
You can import QPM-manageable devices from DCR.
You can choose not to re-import devices that were previously imported, but not added to the QPM inventory by selecting the do not reimport.. check box in the Import devices Wizard General page.
To import device information from CSV file or from RME, use the import functions in DCR. This information can then be imported to QPM using the Import from DCR option.
Import Virtual Devices from File Option
Related Topics
•
•
•
•
•
Import Devices Wizard - Select Devices Page
Use this page to select devices to import into the inventory.
To open this page, in the Import Devices Wizard - General page, click the Next button.
Tip
Related Topics
•
•
•
•
•
Discovery Status Devices List Dialog Box
Use this dialog box to get detailed information about devices in the Discovery Status report.
To open, click the number in the In Progress, Completed, or Total columns in the Discovery Status page.
Table A-32 Discovery Status Devices List Dialog Box
Primary Device Name column
Displays the device IP address or DNS name entered to identify the device when it was added to the inventory.
Model column
Displays the device model.
Status column
Displays the device status.
The following statuses indicate that the device is working properly:
•
•
The following statuses indicate a problem with the device. Devices with these statuses are not usable in QPM:
•
•
–
–
–
–
–
•
–
–
–
–
OS column
Displays the device operating system (OS) version.
Mapped OS column
Displays the OS version that QPM has mapped to the device. See Adding Devices to the Device Inventory, page 4-2 for information about mapped OS versions.
Close button
Click to close the dialog box.
Related Topics
•
•
