Using QoS Policy Manager 1.1
QPM Command Reference
Download this chapter
QPM Command ReferenceQPM Command Reference
give_us_feedback

Table of Contents

QPM Command Reference
 Policy Manager Command Reference
 Distribution Manager Command Reference
 QPM Abstract Actions Translated to Device Commands

QPM Command Reference

These sections provide a quick reference for QPM menu commands, tool bar buttons, and policy action translations:

Policy Manager Command Reference

Table A-1   Policy Manager Command Reference

Menu  Command  Toolbar Button  Description 

File

New>Database


Creates a new QoS database.

File

New>Device

None

Adds a device to the QoS database.

File

New>Interface

None

Adds an interface for the selected device to the QoS database.

To add an interface to an existing device, it is easier to select the device and select Devices>Device>Properties, and click the Detect Interfaces button in the Device Properties window. QPM queries the device for a list of interfaces and displays them in the Detect Interfaces window. You can select the interfaces you want to add from this window.

File

New>Device Group

None

Creates a device group, which is a grouping of interfaces to which you want to apply the same policies.

File

New>Policy


Creates a new policy for the selected interface, device, or device group.

File

Open


Opens a QoS database.

File

Save


Saves the currently open database without changing its file name.

File

Save As

None

Saves the currently open database using a different file name.

File

Close

None

Closes Policy Manager without closing Distribution Manager.

File

Exit

None

Closes Policy Manager and Distribution Manager.

Edit

Cut

None

Copies the selected policy to the Windows clipboard and removes it from the interface, device, or device group.

Edit

Copy

None

Copies the selected policy to the Windows clipboard without removing it from the interface, device, or device group.

Edit

Paste

None

Pastes the policy in the clipboard to the selected interface, device, or device group if the policy's action is supported on that item.

Edit

Delete

None

Deletes the selected policy from the interface, device, or device group.

View

Tool Bar

None

Displays (when checked) or hides the tool bar, which contains shortcut buttons for some menu commands.

View

Status Bar

None

Displays (when checked) or hides the status bar tray at the bottom of the main window.

View

Policy Preview

None

Displays (when checked) or hides the preview pane at the bottom right of the main Policy Manager window. The summary shows the details of the policy selected in the list view pane.

Devices

Device>New

None

Adds a device to the QoS database, so that you can manage policies on that device through Policy Manager.

Devices

Device>View Configuration

None

Displays the selected device's settings, including SNMP communities and Cisco IOS software version numbers.

Devices

Device>Delete

None

Removes the selected device from the QoS database.

Devices

Device>Properties

None

Displays the selected device's properties as defined in the QoS database.

Devices

Interface>New

None

Adds an interface for the selected device to the QoS database. It is easier to have QPM detect the device's interfaces by clicking Detect Interfaces when viewing the device's properties for previously-defined devices (Devices>Device>Properties), or when adding a new device.

Devices

Interface>Delete

None

Removes the selected interface from the QoS database.

Devices

Interface>Properties

None

Displays the interface settings for the selected interface.

Devices

Device Group>New

None

Creates a device group, which is a grouping of interfaces to which you want to apply the same policies.

Devices

Device Group>Add/Remove Members

None

Adds interfaces to the selected device group, or removes them from the selected device group.

Devices

Device Group>Delete

None

Deletes the selected device group from the QoS database.

Device

Device Group>Properties

None

Displays the device group properties for the selected device group.

Devices

Policy>New


Creates a new policy for the selected interface or device group.

Devices

Policy>Disable

Policy>Enable

None

Disables the selected policy without deleting it from the database, or enables the selected policy, depending on the status of the policy. However, the policy is not disabled or enabled on the device until you save and distribute the database.

Devices

Policy>Delete

None

Deletes the selected policy from the database. However, the policy is not deleted from the device until you save and distribute the database.

Devices

Policy>Properties

None

Displays the selected policy's properties.

Devices

Import

None

Imports devices from an inventory list exported from Cisco Resource Manager (CRM) or CiscoWorks2000 Resource Manager Essentials.

Tools

Distribution Manager


Starts the Distribution Manager application, which you use to distribute policies to network devices.

Tools

Reports>All Policies

None

Displays a report of all the policies defined in the open database.

Tools

Reports>Device Policies

None

Displays a report of the policies defined for the selected device.

Tools

Reports>Device Group Policies

None

Displays a report of the policies defined for the selected device group.

Tools

Reports>Interface Policies

None

Displays a report of the policies defined for the selected interface.

Tools

Application Services


Creates or edits application service aliases. Application services are a defined set of characteristics that identify the source of traffic, so that you can more easily write policies that target the defined traffic.

Tools

Host Groups


Creates or edits host groups. Host groups are collections of hosts or subnets that you can use when creating QoS statements, so that you do not have to retype long lists for multiple statements.

Tools

DNS Resolution>Resolve Unresolved Host Names

None

Resolves only those host names that have not previously been resolved. Does not check previously resolved host names to determine if the IP address is correct.

Tools

DNS Resolution>Resolve All Host Names

None

Resolves all host names, even those that have previously been resolved. This ensures that the QoS database contains all current IP addresses for the hosts on the network.

Tools

Telnet


Starts Telnet and attempts to connected to the selected device, if any.

Tools

User Manager


Opens Windows NT User Manager, so that you can change the membership in the QPM user and guest groups. These groups manage user authentication for QPM, and are defined as local groups on the machine running the QoS Manager service.

Help

Contents


Opens the online help to the contents page.

Help

Index

None

Opens the online help to the index page.

Help

About

None

Displays the version and copyright information for the program.

(None)

(None)


Moves the selected policy up in the list of policies.

(None)

(None)


Moves the selected policy down in the list of policies.

(None)

(None)

Filter box

Filters which policy statements are displayed based on your selection.

Distribution Manager Command Reference

Table A-2   Distribution Manager Command Reference

Menu  Command  Toolbar Button  Description 

File

Close

None

Closes Distribution Manager without closing Policy Manager.

File

Exit

None

Closes Distribution Manager and Policy Manager.

View

Toolbar

None

Displays (when checked) or hides the toolbar, which contains shortcut buttons for some menu commands.

View

Log

None

Displays (when checked) the log pane at the bottom of the main window.

View

Status Bar

None

Displays (when checked) or hides the status bar tray at the bottom of the main window.

Devices

Create Job

None

Creates a distribution job. You are prompted to select the QoS database that contains the configuration that you want to deploy to the network.

Devices

Apply


Applies the job the first valid Not-Applied job (created with the Devices>Create Job command) in the tree view to the network, if there is one. If there is no valid Not-Applied job, QPM asks you to select the database from which to create the job, and then applies the job without allowing you to inspect the job contents. The job contains the configuration commands required to deploy your QoS policies and settings to the network.

Use the Devices>Create Job command to create a job that you can inspect before applying it.

Devices

Stop


Stops the deployment of the current job to the network. The job is stopped after the changes to the device currently being configured are complete.

Devices

Resume


Resumes the deployment of the job that you previously stopped.

Devices

View Commands

None

Displays the commands that will be used to configure the device selected in the list pane.

Devices

View Device Logging

View Job Logging

None

Displays the device or job log tab in the log pane at the bottom of the main window.

Devices

Options

None

Opens the Options dialog, which allows you to configure some characteristics of Distribution Manager operation.

Tools

Policy Manager


Starts the Policy Manager application, which lets you create and edit policy statements.

Tools

Reports>All Jobs

None

Displays the summary information for each job, along with the device details for each job.

Tools

Reports>System Log

None

Displays the system log, which contains messages concerning the functioning of Distribution Manager.

Tools

Reports>Device Log

None

Displays the log of the selected device, which contains Telnet and device messages produced while the device was being configured.

Tools

Reports>Job Log

None

Displays the log of the selected job, which contains Telnet and device messages produced while the job was being applied to the network.

Tools

User Manager


Opens Windows NT User Manager, so that you can change the membership in the QPM user and guest groups. These groups manage user authentication for QPM, and are defined as local groups on the machine running the QoS Manager service.

Help

Contents


Opens the online help to the contents page.

Help

Index

None

Opens the online help to the index page.

Help

About

None

Displays the version and copyright information for the program.

QPM Abstract Actions Translated to Device Commands

QPM uses device commands to configure your QoS policies and configurations on the devices. These are the same commands you can use on the device's command line interface (CLI), and they are described in the device's documentation.

This section shows the command sequences used to configure each type of abstract policy action that you can create using QPM. You can use this information to help you understand how QPM configures your devices. See the device's documentation for complete information on the commands and their parameters. (See the "More Information About Quality of Service" section for a partial list of product documentation.)

These sections show the full command translation, including optional parameters. If you do not configure an optional setting, the associated command or parameter is not included in the command sequence QPM uses to configure the device.

Note      The notation in the translation is bold for the router's key words, italic for variables. Some of the variables are parameters you enter into QPM. Other variables are managed by QPM, for example, the ACL number.

These sections describe QPM abstract actions:

CBWFQ Configuration

When you select CBWFQ for an interface's QoS property, and create CBWFQ policies on the interface, QPM uses this command sequence to configure the device:

1. access-list ACLNum filter

2. class-map classname

3. match access-group ACLNum

4. policy-map policy-map-name

5. class classname

(a). bandwidth bandwidth

(b). queue-limit queue-limit

(c). random-detect (see the "WRED Configuration" section for the random-detect commands)

(d). fair queue queue-limit individual-queue-limit

(e). priority

6. class class-default

(a). bandwidth bandwidth

(b). queue-limit queue-limit

(c). random-detect (see the "WRED Configuration" section for the random-detect commands)

(d). fair-queue number-of-queues
or
fair queue queue-limit individual-queue-limit

(e). priority

7. interface interfacename

8. service-policy output policy-map-name

If you are using CBWFQ on a device that supports NBAR, these commands are added:

1. class match-all classname

2. match access-group ACLNum

3. match protocol protocol [ url string | mime string ]

WFQ Configuration

When you select WFQ for an interface's QoS property, QPM uses this command sequence to configure the device.

1. interface interfacename

2. fair-queue

WFQ with FRTS Configuration

When you select WFQ for an interface's QoS property, and you enable Frame Relay traffic shaping (FRTS) on an interface, QPM uses this command sequence to configure the device:

1. map-class frame-relay classname

2. frame-relay fair-queue congestive-discard-threshold number-dynamic-conversation-queues number-reservable-conversation-queues max-buffer-size-for-fair-queues

3. interface interfacename

WFQ on VIP Cards (DWFQ with QoS Group) Configuration

When you select WFQ or FQ for an interface's QoS property, and that interface is on a VIP card, QPM uses this command sequence to configure the device:

1. access-list ACLNum condition

2. rate-limit input access-group ACLNum rate bc be conform-action set-qos-transmit qos-group no exceed-action set-qos-transmit qos-group no

3. interface interfacename

4. fair-queue qos-group

5. fair-queue qos-group qos-group weight weight

6. fair-queue qos-group qos-group limit limit

7. fair-queue aggregate-limit aggregate-packet

8. fair-queue individual-limit individual-packet

WRED Configuration

When you select WRED for an interface's QoS property, or select WRED for the drop mechanism for a CBWFQ policy or interface QoS property, QPM uses this command sequence to configure the device:

1. interface interfacename

2. random-detect weight

3. random-detect precedence precedence min-threshold max-threshold probability-denominator

FRTS Configuration

When you enable Frame Relay traffic shaping (FRTS) on an interface, QPM uses this command sequence to configure the device:

1. map-class frame-relay classname

2. frame-relay cir cir

3. frame-relay bc bc

4. frame-relay be be

5. frame-relay adaptive-shaping becn

6. interface interfacename

7. frame-relay class classname

8. frame-relay traffic-shaping

FRTS with FRF.12 (Voice Configuration) Configuration

When you enable Frame Relay traffic shaping (FRTS) on an interface, and configure the voice fields, QPM uses this command sequence to configure the device:

1. map-class frame-relay classname

2. frame-relay fragment fragment-size

3. frame-relay voice bandwidth bps-reserved

4. interface interfacename

5. frame-relay class classname

6. frame-relay traffic-shaping

Priority Queuing Configuration

When you select Priority Queuing for an interface's QoS property, and create priority queuing policies on the interface, QPM uses this command sequence to configure the device (except for Frame Relay interfaces on which you have enabled FRTS):

1. access-list ACLNum filter

2. priority-list priorityNum protocol ip level list ACLNum

3. priority-list priorityNum queue-limit high-limit medium-limit normal-limit low-limit

4. interface interfacename

5. priority-group priorityNum

If the interface is Frame Relay using FRTS, QPM uses this command sequence to configure the device:

1. map-class frame-relay classname

2. frame-relay priority-group priorityNum

3. interface interfacename

4. frame-relay class classname

Custom Queuing Configuration

When you select Custom Queuing for an interface's QoS property, and create custom queuing policies on the interface, QPM uses this command sequence to configure the device (except for Frame Relay interfaces on which you have enabled FRTS):

1. access-list ACLNum filter

2. queue-list qListNum protocol ip qNum list ACLNum

3. queue-list aListNum queue qNum byte-count bytes limit limit

4. queue-list qListNum default qNum

5. interface interfacename

6. custom-queue-list qListNum

If the interface is Frame Relay using FRTS, QPM uses this command sequence to configure the device:

1. map-class frame-relay classname

2. frame-relay custom-queue-list qListNum

3. interface interfacename

4. frame-relay class classname

RSVP Configuration

When you enable resource reservation protocol (RSVP) on an interface, QPM uses this command sequence to configure the device:

1. ip rsvp bandwidth [ interface-kbps [ single-flow-kbps ] ]

2. ip rsvp udp-multicast

IP RTP Priority Configuration

When you enable IP RTP priority on an interface, QPM uses this command sequence to configure the device:

1. ip rtp priority start-port-range end-port-range bandwidth

Shaping Policies (GTS)

When you create shaping policies on an interface, QPM uses this command sequence to configure the device:

1. access-list ACLNum filter

2. interface interfacename

3. traffic-shape group ACLNum rate bc be

Limiting Policies (CAR)

When you create limiting policies on an interface, QPM uses this command sequence to configure the device:

1. access-list ACLNum filter

2. interface interfacename

3. rate-limit { input | output } access-group ACLNum rate bc be conform-action { transmit | continue | set-prec-transmit | set-prec-continue } precedence exceed-action drop

Weighted Round-Robin (WRR) Policies (Catalyst 8500 QoS Mapping)

When you create queue weight policies on a layer 3 switch, QPM uses this command sequence to configure the device:

1. qos switching

2. qos mapping [source Fastethernet name ] [ destination Fastethernet name ] precedence precedence wrr-weight weight

Router Coloring Policies (PBR and CAR)

When you create coloring policies on an interface, QPM uses a different command sequence depending on whether the device supports committed access rate (CAR) classification.

For devices that do support CAR (typically those running IOS software releases 11.1cc and 12.0), QPM uses this command sequence to configure the device:

1. access-list ACLNum filter

2. interface interfacename

3. rate-limit input access-group ACLNum rate bc be confirm-action set-prec-transmit precedence exceed-action set-prec-transmit precedence

For devices that do not support CAR, QPM uses this command sequence to configure the device:

1. access-list ACLNum filter

2. route-map tag

3. match ip address ACLNum

4. set ip precedence precedence

5. interface interfacename

6. ip policy route-map tag

LocalDirector Coloring Policies

When you create coloring policies on a LocalDirector, QPM uses this command sequence to configure the device:

1. color virtualIp : portNo : bindId : protocolName precedence

Catalyst 5000 Coloring Policies

When you create coloring policies on a Catalyst 5000 family switch, QPM uses this command sequence to configure the device:

1. set qos enable

2. set qos ip-filter precedence protocol source source-port destination destination-port

Catalyst 6000 Coloring Policies

When you create coloring policies on a Catalyst 6000 family switch, QPM uses this command sequence to configure the device:

1. dscp=precedence*8

2. set port qos module/port port-based

3. set qos acl ip acl-name dscp dscp protocol source eq port port destination eq port port

4. commit qos acl acl-name

5. set qos acl map acl-name module/port

Catalyst 6000 Limiting Policies

When you create limiting (policing) policies on a Catalyst 6000 family switch, QPM uses this command sequence to configure the device:

1. set port qos module/port port-based

2. set qos policer aggregate aggregate-name rate rate burst burst drop

3. set qos acl ip acl-name dscp dscp aggregate aggregate-name protocol source eq port port

4. set qos acl ip acl-name trust aggregate aggregate-name protocol source eq port port destination eq port port

5. commit qos acl acl-name

6. set qos acl map acl-name module/port

Catalyst 6000 2Q2T Queuing Configuration

When you configure 2Q2T queuing on a Catalyst 6000 family switch, QPM uses this command sequence to configure the device:

1. set qos enable

2. set qos map 2q2t queue-number threshold-number cos coslist

3. set qos drop-threshold 2q2t tx queue queue-number threshold-1 threshold-2

4. set qos wrr 2q2t queue-weight-1 queue-weight-2

5. set qos txq-ratio 2q2t queue-ratio-1 queue-ratio-2

Catalyst 6000 Port Trust Configuration

When you configure the trust state on a Catalyst 6000 family switch port, QPM uses this command sequence to configure the device:

1. set port qos module/port trust trust