User Guide for CiscoWorks QoS Policy Manager 4.0.3 - Chapter 9 Provisioning: Deploying QoS Policies [CiscoWorks QoS Policy Manager]

Table Of Contents

Provisioning: Deploying QoS Policies

Understanding Policy Deployment

Deploying Policies and QoS Configurations

Step 1: Entering the Job Details for Deployment

Step 2: Selecting a Policy Group for Deployment

Step 3: Validating the Historical Policy Group

Step 4: Selecting and Previewing the Devices for Deployment

Step 5: Confirming the Wizard Information for Deployment

Viewing the Deployment Status

Pausing and Resuming a Deployment Job

Stopping a Deployment Job

Redeploying a Job

Managing Historical Versions

Restoring and Deploying a Historical Policy Group

Viewing a Historical Policy Group

Deleting a Historical Job

Locking and Unlocking a Historical Job

Downloading a Historical Job's Configuration Files

Viewing the Job Details Report

Viewing Device Deployment Errors and Warnings

Viewing the Deployment History Report

Viewing the DNS Resolution

Viewing the Status of Devices

Previewing the CLI Commands

Local Preview

Online Preview

Creating an Online Preview Job

Step 1: Selecting the Policy Group for an Online Preview Job

Step 2: Previewing and Selecting the Devices for an Online Preview Job

Step 3: Confirming the Wizard Information for an Online Preview Job

Viewing the Online Preview Jobs

Provisioning: Deploying QoS Policies

After you have defined your QoS policies and assigned them to network elements, you can deploy the policies to the network devices.

The following topics describe policy deployment and the tasks associated with the deployment of QoS policies:

•Understanding Policy Deployment

•Deploying Policies and QoS Configurations

•Viewing the Deployment Status

•Pausing and Resuming a Deployment Job

•Redeploying a Job

•Managing Historical Versions

•Viewing the Status of Devices

•Previewing the CLI Commands

Understanding Policy Deployment

QPM deploys the QoS policies in a policy group to your network devices. You can deploy an entire policy group, or you can specify a subset of devices within a selected policy group to which QPM will deploy the appropriate QoS policies. Each deployment event is called a "job."

Note You can only deploy QoS policies to devices in the network if the devices are real. If you are using virtual devices, you will not be able to deploy your policies to the network.

When you deploy your QoS policies to network devices, QPM translates the policies into device commands and enters the commands through the device's command line interface (CLI). You can choose to deploy your QoS configurations directly to network devices using Telnet. QPM automatically deploys your QoS configurations to configuration files.

This deployment process does not configure the devices but generates configuration files that can be sent manually to the devices. QoS configurations can be deployed to the device using any application that downloads configuration files to the devices. QPM allows you to monitor the deployment process in real-time, viewing the active deployment jobs and their status.

Through QPM, you can verify the device configuration to ensure that your policy group policy definitions match the actual device configurations, and preview the commands that will be used to configure the devices.

Upon deployment of a job, a read-only copy of the current policy group is automatically made. This allows you to continue editing the policy group, and also provides a historical version of it.

QPM allows you to restore, as the current editable policy group, a previous version of a policy group that was already deployed to the network.

You can restore a policy group for editing without deploying it, or you can restore and redeploy the policy group. This feature is very useful when unexpected errors occur as a result of a deployment and you must go back to a previous version of the policy group.

QPM maintains a history of deployments and their status results. This history allows you to view the policy groups deployed and the deployment status results. QPM also provides static job reports that display the statuses of the devices in the deployment.

Note You can also trigger the deployment process from an application that is external to QPM, by issuing an HTTPS request.

Related Topics

•Deploying Policies and QoS Configurations

•Viewing the Deployment Status

•Managing Historical Versions

•Previewing the CLI Commands

Deploying Policies and QoS Configurations

QPM provides options for deploying policies and QoS configurations to network devices. Using the Deployment wizard, you can deploy a current or historical version of a policy group. If a deployment job fails, you can redeploy it to some or all of its failed devices.

The Deployment wizard guides you through the steps required for deploying a policy group. You select your policy group, enter the job details and select the deployment options. The wizard gathers and validates all the information that you enter, and allows you to view a summary of the job information. You can confirm or edit this information before deploying.

The following sections describe the step-by-step procedures for creating a deployment job, using the Deployment wizard.

The following topics describe the steps of the wizard:

•Step 1: Entering the Job Details for Deployment

•Step 2: Selecting a Policy Group for Deployment

•Related Topics

•Step 3: Validating the Historical Policy Group

•Step 4: Selecting and Previewing the Devices for Deployment

•Step 5: Confirming the Wizard Information for Deployment

Related Topics

•Using QPM Wizards, page 3-8

Step 1: Entering the Job Details for Deployment

The first step in the policy deployment process is to enter the details of the job to be deployed.

In this step of the wizard, you enter a name (a default name is provided) and, optionally, a description for the job you want to deploy. You also select the schedule for deploying the job (either now or at a specified time later).

To enter the job details:

Step 1 Select Provision > Policy Deployment > Create Job.

The first step of the Deployment wizard is displayed—Job Details.

Step 2 In the Job Details page, enter a name for your policy deployment job (or accept the default).

Step 3 If required, you can enter a description of the job in the Job Description field.

Step 4 Schedule the deployment job:

•If you want to deploy the policy immediatly after you complete this wizard, select the Now radio button.

•If you want to deploy the policy sometime later after you complete this wizard, select the Run at (server time) radio button.

You can select the date for policy deployment by clicking the calendar icon, or you can enter the date in MM/DD/YYYY format in the first field. You must enter the time for policy deployment in the second field.

Step 5 Click Next to move to the next step of the wizard.

Related Topics

•Restoring and Deploying a Historical Policy Group

•Step 2: Selecting a Policy Group for Deployment

•Downloading a Historical Job's Configuration Files

Step 2: Selecting a Policy Group for Deployment

The second step in the deployment process is to select the policy group to be deployed. While the default is to select one of the currently managed policy groups, you can select a historical version of a policy group that was deployed.

Note If deployment was activated from the IP Telephony wizard, the first page of the wizard—Deployment Group Selection, does not display. In this case, the Device Selection and Preview page automatically appears.

If you select a historical version of a policy group, it is restored as the current deployment group for editing. The existing current deployment group is saved as a historical version.

To select a policy group:

Step 1 In the Device Selection and Preview page (that is, step 2 of the wizard), choose the type of policy group (current or historical), by selecting

•Current version of a policy group

or

•Restore a previous version of a policy group

Step 2 Select the policy group:

•If you are deploying a current policy group, select the policy group name from the list.

To view the details (Owner, Creation Time) of all the policy groups before making your selection:

a. Click the View list link.

The Policy Group List page appears, displaying all the currently managed policy groups. For more information about this page, see Policy Groups List Page, page C-8.

b. Select the required policy group by clicking the corresponding radio button, and click Select.

The selected policy group name will be displayed in the Policy Group list in the second page of the wizard.

•If you are deploying a historical policy group, select the policy group name from the list.

To view the details (Version, Job, Owner, Creation Time) of all the historical deployment groups before making your selection:

a. Click the View list link.

The Job History List page appears, displaying all the historical policy groups. For more information about this page, see Job History List Page, page C-8.

b. Select the required policy group by clicking the corresponding radio button, and click Restore.

The selected policy group name will be displayed in the Policy Group list in the second page of the wizard.

Step 3 Click Next to move to the next step of the wizard:

•If you selected to deploy a current policy group, the next step of the wizard is to select your devices.

•If you selected to deploy a historical version of a policy group, the next step of the wizard is to validate the policy group.

Related Topics

•Step 3: Validating the Historical Policy Group

•Step 4: Selecting and Previewing the Devices for Deployment

•Managing Historical Versions

Step 3: Validating the Historical Policy Group

Note This step of the wizard is only available if you selected to deploy a historical version of a policy group in step 2 of the wizard.

Whenever a previous version of a policy group is restored, validation checks must be done on the policy group. The validation process is automatically activated after selecting a historical policy group and clicking the Next button in Related Topics.

The system does the following checks and automatically provides a report of violations, where relevant:

•Missing Network Elements

This validation procedure checks for the coordination of policies and managed devices. If the validation procedure detects network elements that are missing from the current device group, they will be displayed in the report. The assignments of policies to these network elements in the restored deployment group will be automatically removed.

•Invalid Assignments

This validation procedure checks for assigned network elements that no longer match the constraints of their policy groups. Any invalid assignments will be displayed in the report. The network elements will be removed from the assignment.

•Reusable Components Violations

This validation procedure checks for the coordination of policies and library components (IP aliases, application aliases and policy group templates). If the validation process detects some library components in the restored version that are different than the ones in the current libraries, this will be displayed. The validation process overrides the current library components with the original ones and adds them locally to the policy group. In this case, the dynamic link to the library components will no longer exist.

•Constraints Violations

This check validates the policy device constraints against the predefined constraints limitations. These limitations might change from time to time causing some of the policy constraints to be invalid. Policies that are invalid will be displayed and removed along with their assignments.

To validate the historical policy group:

Step 1 In the Deployment Group Validate Historical page, click the View Restore Validation Report button.

The Restore Validation Report window opens, displaying any validation violations that were discovered during the deployment group restore procedure.

For more information about this window, see Restore Validation Report Window, page C-10.

Step 2 After you have finished viewing the report, close the window.

Step 3 Click Next or Finish to accept any changes made as a result of the validation checks, and move to the next step of the wizard.

Step 4 To stop the deployment without saving any changes, click Cancel.

Related Topics

•Step 4: Selecting and Previewing the Devices for Deployment

•Managing Historical Versions

Step 4: Selecting and Previewing the Devices for Deployment

Note If you are deploying a deployment group from the IP Telephony wizard, the Deployment wizard will open automatically on this page.

In this step of the wizard, you select the devices to which you want to deploy your policies. You can also preview the CLI commands that will be configured on your devices prior to deployment.

This page displays a list of all the devices that are available for deployment and their configurations. Devices whose configurations have changed since the last deployment will be displayed with the check boxes alongside them selected.

You can accept the default selection, or you can make your own selection of devices.

To select and preview the devices for deployment:

Step 1 In the Device Selection and Preview page, select the check boxes alongside the devices to which you want to deploy your policies. Deselect those you do not want to deploy to. For best performance, select no more than 200 devices at a time.

Step 2 To preview the CLI configuration commands for a device:

a. Click its Policy Configuration link in the table. A preview window opens, displaying the following configuration details for the device:

•Backup ShowRun configuration commands.

•Incremental Telnet script commands to be written (if deploying directly to network devices).

b. Click the appropriate buttons to view the relevant configuration details.

c. After you have finished previewing the device's configuration, click Close to close the Preview window.

Step 3 Click Next to move to the next step of the wizard.

Related Topics

•Step 5: Confirming the Wizard Information for Deployment

•Previewing the CLI Commands

•Deployment Wizard - Device Selection and Preview Page, page C-11

•Device Configuration Preview Window, page C-12

Step 5: Confirming the Wizard Information for Deployment

The last page of the Deployment wizard presents a summary of all the data collected through the Deployment wizard for you to verify. After you are satisfied with the job information, you can deploy the policy group to the network.

Caution Jobs are not necessarily deployed to devices in the order in which they are triggered. Avoid deploying several jobs to the same device simultaneously. This could result in the incorrect configuration of the device.

To confirm the wizard information:

Step 1 In the Deployment Wizard - Summary page, verify the job information that displayed on the page. If you are not satisfied with any of the job details, you can go back through the wizard to make the required changes.

Step 2 After you are satisfied with the job information, click Schedule (or Deploy) to confirm the schedule for policy group deployment (or to deploy the policy group) to the network. The Active Jobs page appears, allowing you to view the deployment process.

Related Topics

•Viewing the Deployment Status

Viewing the Deployment Status

You can view the status of your job during deployment using the Active Jobs page. The Active Jobs page provides a dynamic view of all the active deployments and their status. For each deployment job, the start time of its configuration, its status, and a summary of the number of devices deployed according to their status, are displayed.

The status of a job deployment or a device deployment might be Pending, In Progress, Completed, or Failed. A job deployment might also have the status of Aborted or Paused.

During the deployment process, a status of "In Progress" will be displayed for a job. When the job is completed successfully, its status will change to "Completed".

For a deployment job to be Completed, all the devices must be successfully configured.

If the deployment of at least one device fails, and all the other devices passed without errors, the overall status of the deployment is Failed. Completed jobs are automatically removed from the display after ten minutes.

From the Active Jobs page, you can:

•View the deployment details of a job.

•Pause and resume the deployment process.

•Stop the deployment.

•Redeploy a failed deployment.

•Remove a deployment job from the display.

To view the deployment status:

Step 1 Select Provision > Policy Deployment > Pending Jobs.

The Active Jobs page appears, displaying the currently active deployment jobs and their status, in a table.

Tip The display is automatically refreshed every ten seconds. To force a refresh manually, click Refresh.

For more information about the Active Jobs page, see Pending Jobs Page, page C-14.

Note The Active Jobs page appears automatically when you click Deploy in the Summary page of the Deployment wizard (see Step 5: Confirming the Wizard Information for Deployment).

Step 2 View the status of the active job deployments and device deployments:

•To view the details of a deployment job, select its Job Name link in the table. The Job Details report appears.

•To remove a deployment job from the table, select it and click Remove From Display.

Related Topics

•Pausing and Resuming a Deployment Job

•Stopping a Deployment Job

•Redeploying a Job

•Viewing the Job Details Report

•Troubleshooting Deployment Problems, page 12-8

Pausing and Resuming a Deployment Job

You can pause a job during deployment. However, QPM will not stop the configuration of a device after it has begun. Any devices that are being configured when the Pause command is issued will be finished.

Devices for which deployment had not yet begun will remain with the status Pending. You can also cause any paused deployment to resume configuration of devices. This does not create a new job—it continues the selected job.

To pause and resume a deployment job:

Step 1 Select Provision > Policy Deployment > Pending Jobs.

The Active Jobs page appears.

Step 2 In the Active Jobs list, select the check box next to your deployment job and click Pause. A message appears asking you if you are sure you want to pause the deployment of your job.

Step 3 Click Yes to pause the job's deployment.

Step 4 To resume the deployment of your job, select the check box next to the job and click Resume.

The deployment of the selected job will resume.

Related Topics

•Viewing the Deployment Status

Stopping a Deployment Job

You can stop a deployment job that is currently in progress or has been paused. This feature is useful if you want to change a job's configuration details before deploying it, or if a job becomes stuck while in progress.

Terminating a job stops the configuration of the devices. All the devices that were In Progress or Pending will receive a Failed status. You cannot resume a stopped deployment job.

To stop a deployment job:

Step 1 Select Provision > Policy Deployment > Pending Jobs.

The Active Jobs page appears.

Step 2 In the Active Jobs list, select the check box next to the deployment job (In Progress or Pending) that you want to stop, and click Abort.

A message appears warning you that the job will be aborted with no option to resume it.

Step 3 Click Yes to confirm the stop procedure. The job status for the selected deployment job will display "Aborted".

Related Topics

•Viewing the Deployment Status

Redeploying a Job

You can manually request that deployment be retried for either a specific device that failed or all failed devices in any displayed failed job. This does not create a new job—it creates another deployment for the job.

The redeployment process resets the status of the selected devices and re-requests the deployment of the selected job.

To redeploy a deployment job:

Step 1 Select Provision > Policy Deployment > Pending Jobs. The Active Jobs page appears.

Step 2 In the Active Jobs table, select the check box next to the job you want to redeploy and click Redeploy.

The Device Selection and Preview page of the Deployment wizard appears, displaying all the failed devices of the job. See Step 4: Selecting and Previewing the Devices for Deployment.

Step 3 Select the check boxes alongside the devices to which you want to deploy your policies.

If required, preview the CLI commands that will be configured on your devices. Then click Next.

Step 4 Enter the job details and select the deployment options, and click Next (see Related Topics).

Step 5 Verify the job information and click Deploy to redeploy your job to the network (see Step 5: Confirming the Wizard Information for Deployment).

Related Topics

•Viewing the Deployment Status

Managing Historical Versions

QPM allows you to restore previous versions of policy groups that were deployed to the network, for editing and deploying. The Restore feature is very useful when unexpected errors occur as a result of the deployment of a policy group and you must go back to a previous version of that policy group. You can also view a historical version of a policy group without restoring.

You can manage historical versions of policy groups from the Job History report, which displays a table of historical deployment jobs and all their details.

From the Job History report, you can do the following:

•Restore a historical policy group to edit and deploy it.

•View a historical policy group's policies.

•Delete a historical job.

•Lock a job to prevent automatic deletion when the history cache is full, or release a job from being locked.

•Download the configuration files of a historical deployment job.

•View a Job Details report for each deployment job.

•View a Deployment History report for each deployment job.

•View the results of a DNS host name resolution check for a deployment job.

To manage historical deployment versions:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Job History report appears.

For more information about the Job History report, see Completed Jobs Page, page C-15.

Step 2 Select the required historical report, and click the appropriate button or link depending on the procedure you want to do, as described in the following sections.

Related Topics

•Restoring and Deploying a Historical Policy Group

•Viewing a Historical Policy Group

•Deleting a Historical Job

•Locking and Unlocking a Historical Job

•Downloading a Historical Job's Configuration Files

•Viewing the Job Details Report

•Viewing the Deployment History Report

•Viewing the DNS Resolution

Restoring and Deploying a Historical Policy Group

This topic describes how you can restore a previous version of a specific policy group that was deployed to the network, for editing purposes. It also describes how to deploy the restored version, if required.

Note If required, you can view a history of all the policy group restore operations, from the Restore Reports page.

To restore and deploy a historical policy group:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Job History report appears.

Step 2 Select the historical job you want to restore, in the table.

Step 3 Click Restore.

Validation checks are automatically done on the policy group. If the restore process detects any validation violations, the results will be written to a report. The Restore Policy Group page appears, from which you can view the validation report.

For more information about this page, see Restore Policy Group Page, page C-17.

Step 4 To view a validation report:

a. Click Show Restore Report.

The Restore Validation Report window opens.

For more information about this window, see Restore Validation Report Window, page C-10.

b. When you have finished viewing the report, close the window.

Step 5 Click OK to confirm the Restore process, or Cancel to stop the process.

If you clicked OK, the restored version will be selected as the current editable policy group. The Policy Table page appears, displaying the policies for the current policy group (see Modifying a Policy, page 8-14).

If you want to deploy the restored version, follow the steps of the Deployment wizard (see Related Topics through Step 5: Confirming the Wizard Information for Deployment).

Related Topics

•Step 3: Validating the Historical Policy Group

•Managing Historical Versions

•Working with Policies, page 8-1

•Deploying Policies and QoS Configurations

Viewing a Historical Policy Group

If you want to verify the details of a historical version of a deployment job, QPM allows you to view its policies. In this case, you will not be able to make changes to the policy group or deploy it to the network.

You can view only one historical policy group at a time. The policy group will not be saved. If you select another policy group, you will lose the previous version you selected to view. To view it, you will have to select it again from the Job History report page.

To view a Historical Policy Group:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Job History report appears.

Step 2 Select the historical job in the table and click View Policy Group.

The Policy Table page appears in read-only mode, displaying the selected policy group and its policies.

Related Topics

•Managing Historical Versions

•Working with Policies, page 8-1

Deleting a Historical Job

You can delete historical jobs from the Job History report list.

To delete Historical Jobs:

Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History report appears.

Step 2 Select the historical jobs you want to remove from the report, and click Delete.

A dialog box opens, warning you that the selected jobs will be deleted.

Step 3 Click OK to confirm the deletion.

The jobs will be deleted from the list of historical jobs. You will no longer be able to restore them.

Related Topics

•Managing Historical Versions

Locking and Unlocking a Historical Job

The Job History report can display up to a predefined maximum number of jobs. When the history cache is full, the oldest historical jobs are automatically deleted. You can prevent this automatic deletion by "locking" a job. Similarly, you can "unlock" a historical version, making it available for deletion.

To lock or unlock a Historical Job:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Job History report appears.

Step 2 Select the historical job you want to prevent from automatic deletion, and click Lock Job.

The Lock Job status of the job in the report will display Lock.

Step 3 To release a historical job from being locked from automatic deletion, select it and click Unlock Job.

The Lock Job status of the job in the report will display Unlock.

Related Topics

•Managing Historical Versions

Downloading a Historical Job's Configuration Files

When QPM deploys QoS configurations to files, it generates configuration files that can be sent manually to the devices. Individual files are created for each device, and the complete set of files are saved as a single zip file to your hard disk.

From the Job History report, you can download to your desktop the zip file that contains the individual configuration files for each device in a historical deployment job that you select for editing.

To download a Historical Job's configuration file:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Job History report appears.

Step 2 Select the historical job whose configuration zip file you want to download, and click its Files icon.

The File Download dialog box opens.

Step 3 Save the zip file to the required location on your desktop and extract the configuration files.

Related Topics

•Managing Historical Versions

•Related Topics

Viewing the Job Details Report

The Job Details report shows the final status of all the deployments of a selected job. It can also show the current deployment status of a job that is still in progress.

Note The redeployment process can result in more than one deployment for a job (see Redeploying a Job).

The job's deployment details are displayed at the top of the page, and a table of all the devices related to the deployment is displayed below. From this report, you can view details about any errors or warnings that resulted from the deployment of a device. You can also view the CLI commands that were used to configure a device.

Note If the error message for a failed job displays "Internal error - unknown device state," some of the devices might be stuck in progress. In such a case, QPM will not be able to determine what was configured on these devices. You should contact technical support on the Cisco TAC web site to resolve this problem.

To view the Job Details Report:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Job History page appears.

Step 2 Click the Job Name link of the job whose details you want to view or click the Details icon for the job.

Note You can also open the Job Details page, by clicking the Job Name link for a job in the Active Jobs page, or by clicking the Job Name link for a device in the Managed Devices report.

The Job Details Report page appears, displaying the job's details and a table listing status information for each device in the job. For more information about the Job Details Report page, see Job Details Report Page, page C-18.

Step 3 To view details about an error or warning that resulted from the deployment of a device, click the Errors/Warnings link for the required device in the table.

The Device Errors and Warnings page appears.

Step 4 To view the CLI commands that were used to configure a device:

a. Select the check box next to the required device in the table.

b. Click View CLI Commands.

A preview window opens, displaying the following configuration details for the device:

•Backup ShowRun configuration commands.

•Any incremental Telnet script commands that were written (if deployed directly to network devices).

c. Click the appropriate buttons to view the relevant configuration details.

d. Click Close to close the Preview window.

Related Topics

•Managing Historical Versions

•Viewing Device Deployment Errors and Warnings

•Viewing the Status of Devices

Viewing Device Deployment Errors and Warnings

In the Device Errors and Warnings page, you can view details about any errors or warnings that resulted from the deployment of a device. The page displays the reason for the error or warning message, and the time it occurred.

To view the device deployment errors and warnings:

Step 1 In the Job Details Report page, click the Errors/Warnings link for the device whose deployment error details you want to view.

The Device Errors and Warnings page appears.

For more information about this page, see Device Errors and Warnings Page, page C-19.

Step 2 When you have finished viewing the error or warning messages, close the page.

Related Topics

•Viewing the Job Details Report

Viewing the Deployment History Report

The Deployment History report displays the deployment history details of a selected deployment.

Note The redeployment process can result in more than one deployment for a deployment job (see Redeploying a Job). A deployment history report shows only the devices that were configured in the selected deployment. These might not be all the devices in the deployment job.

To view Deployment History Report:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Job History page appears.

Step 2 Click the Deployments link of the job whose deployment details you want to view. The Deployment History report is displayed for the selected deployment.

For more information about the Deployment History report, see Deployment History Report Page, page C-20.

Step 3 To view the job details of the selected deployment, click the Deployment Type link. A Job Details report appears for the selected deployment.

Related Topics

•Managing Historical Versions

•Viewing the Job Details Report

Viewing the DNS Resolution

QPM resolves newly added host names to their IP addresses, to update any changes in the network. From the Job History report, you can view the results of a DNS resolution check done by QPM on the host names that QPM resolved to IP addresses, for a selected deployment job.

To view the DNS Resolution of a Historical Job:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Job History report appears.

Step 2 Select the historical job in the table and click DNS Resolution.

The DNS Resolution page appears, displaying a list of IP addresses to which the host names were resolved, for the selected deployment job.

For more information about the DNS Resolution page, see DNS Resolution Page, page C-17.

Related Topics

•Managing Historical Versions

•Creating an Online Preview Job

Viewing the Status of Devices

The Job Details page (for both completed and pending deployment jobs) allows you to view the status of all devices in the device group that were configured (deployed to) by QPM.

To view the status of devices:

Step 1 Select Provision > Policy Deployment > Completed Jobs.

The Completed Jobs page appears.

Step 2 To view details about the device's deployment job, click the Job Name link for the device.

A Job Details report is displayed.

Step 3 Select Provision > Policy Deployment > Pending Jobs.

The Pending Jobs page appears.

Step 4 To view details about the device's deployment job, click the Job Name link for the device. A Job Details report is displayed

Related Topics

•Viewing the Job Details Report

Previewing the CLI Commands

QPM allows you to view in advance the CLI commands that will be sent to the devices upon policy deployment. You can also create an online CLI Preview job to view the commands for the current policy group, while the policy is being deployed on devices. Online CLI previews are determined by querying the devices for their existing configuration and then calculating the incremental changes.

QPM provides several ways in which you can view the CLI commands that are already configured, or will be configured, on devices in your policy group:

•Using the Local Preview page, you can translate the policies attached to a device, to CLI commands

•Using the Online Preview wizard, you can activate an Online Preview job in which CLI commands are generated for all or some of the devices, which have policies attached from a selected policy group.

•During the deployment process, you can preview the CLI commands that will be configured on a single device, prior to deployment (see Step 4: Selecting and Previewing the Devices for Deployment).

•In the Job Details report, you can view the CLI commands that were configured on a selected device.

Related Topics

•Viewing the Job Details Report

•Creating an Online Preview Job

•Viewing the Online Preview Jobs

Local Preview

You can have a preview of CLI commands for each device (which already has a policy attached) in the device inventory.

To generate a local preview:

Step 1 Select Provision > Policy Preview > Local Preview.

The Local Preview page appears with a list of all the devices in the device inventory.

Step 2 Click the checkbox corresponding to the device whose CLI command you want to preview, and click Translate at the bottom of the page.

The Translation page appears with the CLI translation of the selected device.

The message `No CLI Translation available' appears if there are no policies attached to the selected device.

Online Preview

You can have an online preview of the CLI commands for the devices on which the policies are currently being deployed. You create a CLI Preview job, and specify the devices for which you want to see the CLI preview, through the CLI Preview wizard. QPM stores these Online Preview jobs, so that you can later refer it for analysis.

Related Topics

•Creating an Online Preview Job

•Viewing the Online Preview Jobs

Creating an Online Preview Job

The Online Preview wizard guides you through the steps required to create a new Online Preview job for all the devices on which policies of a particular policy group are attached (or being attached).

The steps of the Online Preview wizard are:

•Step 1: Selecting the Policy Group for an Online Preview Job

•Step 2: Previewing and Selecting the Devices for an Online Preview Job

•Step 3: Confirming the Wizard Information for an Online Preview Job

Related Topics

•Using QPM Wizards, page 3-8

•Previewing the CLI Commands

Step 1: Selecting the Policy Group for an Online Preview Job

In this step of the wizard, you select the policy group that contains the policies that have been attached to the devices. The policy group must be one of those that are currently managed.

To select the policy group:

Step 1 Select Provision > Policy Preview > Online Preview.

The Online Preview page appears.

Step 2 Click New Preview.

The Online Preview wizard appears at the first page—Policy Group Selection.

Step 3 Select the current policy group from the list box.

To view the details (Owner, Creation Time) of all the current policy groups, and then make your selection:

a. Click the View list link. The Policy Groups List page appears.

b. Select the required policy group and click Select.

The policy group will appear selected in the Policy Group Selection page of the wizard.

Step 4 Click Next to move to the next step of the wizard.

The Device Selection and Preview page appears.

Related Topics

•Creating an Online Preview Job

•Step 2: Previewing and Selecting the Devices for an Online Preview Job

Step 2: Previewing and Selecting the Devices for an Online Preview Job

In this step of the wizard, you select the devices and preview their configurations. This page displays a list of all the devices that are assigned to policies in the selected policy group.

To preview and select the devices:

Step 1 In the Device Selection and Preview page, select the check boxes alongside the devices whose configuration details you want to preview.

By default, all the devices will be selected.

Step 2 To preview the CLI configuration commands for a device:

a. Click its Policy Configuration link.

A preview window opens, displaying the following configuration details for the device:

•Backup ShowRun configuration commands.

•Any incremental Telnet script commands that will be written (if deploying directly to network devices).

b. Click the appropriate buttons to view the relevant configuration details.

c. After you have finished previewing the device's configuration, click Close to close the Preview window.

Step 3 Click Next to move to the final step of the CLI Preview wizard.

Related Topics

•Creating an Online Preview Job

•Step 3: Confirming the Wizard Information for an Online Preview Job

Step 3: Confirming the Wizard Information for an Online Preview Job

The last step of the Online Preview wizard asks you to verify the policy group name and the number of devices that were selected for previewing.

To confirm the wizard information:

Step 1 Verify the job information displayed on the page. If you are not satisfied with any of the job details, you can go back through the Online Preview wizard to make the required changes.

Step 2 Click Preview.

The Online Preview page appears, allowing you to view the current CLI jobs that are being executed.

Related Topics

•Creating an Online Preview Job

•Viewing the Online Preview Jobs

Viewing the Online Preview Jobs

The Online Preview page displays a table of all the Online Preview job requests that were created and those that are currently being executed. This page provides a dynamic view of all the Online Preview jobs and their status. It also displays the time the last preview was initiated for a job, the job's status, and its owner. The status of an Online Preview job may be Pending, In Progress, Completed, or Failed.

During the Online Preview process, CLI commands are generated for all the devices in the policy group. A status of "In Progress" will be displayed for a job during this process. When the job is completed successfully, its status will change to "Completed".

From the Online Preview page, you can:

•Create a new Online Preview job.

•View the details of an Online Preview job. The Online Preview Details report describes the details of a Online Preview job. From this report, you can also view the CLI commands that were used to configure a device.

•View the results of a DNS host name resolution check for a selected CLI Preview job.

•Delete a Online Preview job from the list.

To view the Online Preview Jobs:

Step 1 Select Provision > Policy Preview > Online Preview.

The Online Preview page appears.

Note The Online Preview page appears automatically when you click Preview in the last step of the CLI Preview wizard (see Step 3: Confirming the Wizard Information for an Online Preview Job).

For more information about the Online Preview page, see Online Preview Page, page C-2.

To view the details of an Online Preview job:

Select the Online Preview job whose details you want to view, and click its Details icon or the View Preview Details button.

The Online Preview Details page appears. For more information about the Online Preview Details page, see Online Preview Details Page, page C-5.

To view the CLI commands that were used to configure a device:

a. Select the check box next to the required device in the table.

b. Click View CLI Commands.

A preview window opens, displaying the Backup ShowRun configuration commands and any incremental Telnet commands that were written to the device.

c. Click the appropriate buttons to view the relevant configuration details.

d. Click Close to close the Preview window.

Step 2 To view the results of a DNS host name resolution check, select the preview job and click DNS Resolution.

The DNS Resolution page appears, displaying a list of IP addresses to which the host names were resolved, for the selected preview job.

For more information about the DNS Resolution page, see DNS Resolution Page, page C-17.

Step 3 To delete Online Preview jobs:

a. Select the jobs you want to remove from the list, and click Delete.

A dialog box opens, warning you that the selected jobs will be deleted.

b. Click OK to confirm the deletion.

The jobs will be deleted from the list of Online Preview jobs.

Related Topics

•Previewing the CLI Commands

•Creating an Online Preview Job

•Viewing the DNS Resolution

	User Guide for CiscoWorks QoS Policy Manager 4.0.3
	Chapter 9 Provisioning: Deploying QoS Policies
User Guide for CiscoWorks QoS Policy Manager 4.0.3 Preface Chapter 1 Introduction Chapter 2 Planning for Quality of Service Chapter 3 Getting Started Chapter 4 Managing Devices Chapter 5 Provisioning: Working with Policy Groups Chapter 6 Provisioning: Configuring QoS for IP Telephony Chapter 7 Provisioning: Working with Macros Chapter 8 Provisioning: Working with Policies, Properties, and Traffic Rules Chapter 9 Provisioning: Deploying QoS Policies Chapter 10 Monitoring: Using QoS Analysis Chapter 11 Using Administration Features Chapter 12 Troubleshooting QPM Appendix A Devices Tab 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 Index	Download this chapter Chapter 9 Provisioning: Deploying QoS Policies Download the complete book Complete PDF of User Guide for QoS Policy Manager 4.0.3 (PDF - 7 MB) Table Of Contents Provisioning: Deploying QoS Policies Understanding Policy Deployment Deploying Policies and QoS Configurations Step 1: Entering the Job Details for Deployment Step 2: Selecting a Policy Group for Deployment Step 3: Validating the Historical Policy Group Step 4: Selecting and Previewing the Devices for Deployment Step 5: Confirming the Wizard Information for Deployment Viewing the Deployment Status Pausing and Resuming a Deployment Job Stopping a Deployment Job Redeploying a Job Managing Historical Versions Restoring and Deploying a Historical Policy Group Viewing a Historical Policy Group Deleting a Historical Job Locking and Unlocking a Historical Job Downloading a Historical Job's Configuration Files Viewing the Job Details Report Viewing Device Deployment Errors and Warnings Viewing the Deployment History Report Viewing the DNS Resolution Viewing the Status of Devices Previewing the CLI Commands Local Preview Online Preview Creating an Online Preview Job Step 1: Selecting the Policy Group for an Online Preview Job Step 2: Previewing and Selecting the Devices for an Online Preview Job Step 3: Confirming the Wizard Information for an Online Preview Job Viewing the Online Preview Jobs Provisioning: Deploying QoS Policies After you have defined your QoS policies and assigned them to network elements, you can deploy the policies to the network devices. The following topics describe policy deployment and the tasks associated with the deployment of QoS policies: •Understanding Policy Deployment •Deploying Policies and QoS Configurations •Viewing the Deployment Status •Pausing and Resuming a Deployment Job •Redeploying a Job •Managing Historical Versions •Viewing the Status of Devices •Previewing the CLI Commands Understanding Policy Deployment QPM deploys the QoS policies in a policy group to your network devices. You can deploy an entire policy group, or you can specify a subset of devices within a selected policy group to which QPM will deploy the appropriate QoS policies. Each deployment event is called a "job." Note You can only deploy QoS policies to devices in the network if the devices are real. If you are using virtual devices, you will not be able to deploy your policies to the network. When you deploy your QoS policies to network devices, QPM translates the policies into device commands and enters the commands through the device's command line interface (CLI). You can choose to deploy your QoS configurations directly to network devices using Telnet. QPM automatically deploys your QoS configurations to configuration files. This deployment process does not configure the devices but generates configuration files that can be sent manually to the devices. QoS configurations can be deployed to the device using any application that downloads configuration files to the devices. QPM allows you to monitor the deployment process in real-time, viewing the active deployment jobs and their status. Through QPM, you can verify the device configuration to ensure that your policy group policy definitions match the actual device configurations, and preview the commands that will be used to configure the devices. Upon deployment of a job, a read-only copy of the current policy group is automatically made. This allows you to continue editing the policy group, and also provides a historical version of it. QPM allows you to restore, as the current editable policy group, a previous version of a policy group that was already deployed to the network. You can restore a policy group for editing without deploying it, or you can restore and redeploy the policy group. This feature is very useful when unexpected errors occur as a result of a deployment and you must go back to a previous version of the policy group. QPM maintains a history of deployments and their status results. This history allows you to view the policy groups deployed and the deployment status results. QPM also provides static job reports that display the statuses of the devices in the deployment. Note You can also trigger the deployment process from an application that is external to QPM, by issuing an HTTPS request. Related Topics •Deploying Policies and QoS Configurations •Viewing the Deployment Status •Managing Historical Versions •Previewing the CLI Commands Deploying Policies and QoS Configurations QPM provides options for deploying policies and QoS configurations to network devices. Using the Deployment wizard, you can deploy a current or historical version of a policy group. If a deployment job fails, you can redeploy it to some or all of its failed devices. The Deployment wizard guides you through the steps required for deploying a policy group. You select your policy group, enter the job details and select the deployment options. The wizard gathers and validates all the information that you enter, and allows you to view a summary of the job information. You can confirm or edit this information before deploying. The following sections describe the step-by-step procedures for creating a deployment job, using the Deployment wizard. The following topics describe the steps of the wizard: •Step 1: Entering the Job Details for Deployment •Step 2: Selecting a Policy Group for Deployment •Related Topics •Step 3: Validating the Historical Policy Group •Step 4: Selecting and Previewing the Devices for Deployment •Step 5: Confirming the Wizard Information for Deployment Related Topics •Using QPM Wizards, page 3-8 Step 1: Entering the Job Details for Deployment The first step in the policy deployment process is to enter the details of the job to be deployed. In this step of the wizard, you enter a name (a default name is provided) and, optionally, a description for the job you want to deploy. You also select the schedule for deploying the job (either now or at a specified time later). To enter the job details: Step 1 Select Provision > Policy Deployment > Create Job. The first step of the Deployment wizard is displayed—Job Details. Step 2 In the Job Details page, enter a name for your policy deployment job (or accept the default). Step 3 If required, you can enter a description of the job in the Job Description field. Step 4 Schedule the deployment job: •If you want to deploy the policy immediatly after you complete this wizard, select the Now radio button. •If you want to deploy the policy sometime later after you complete this wizard, select the Run at (server time) radio button. You can select the date for policy deployment by clicking the calendar icon, or you can enter the date in MM/DD/YYYY format in the first field. You must enter the time for policy deployment in the second field. Step 5 Click Next to move to the next step of the wizard. Related Topics •Restoring and Deploying a Historical Policy Group •Step 2: Selecting a Policy Group for Deployment •Downloading a Historical Job's Configuration Files Step 2: Selecting a Policy Group for Deployment The second step in the deployment process is to select the policy group to be deployed. While the default is to select one of the currently managed policy groups, you can select a historical version of a policy group that was deployed. Note If deployment was activated from the IP Telephony wizard, the first page of the wizard—Deployment Group Selection, does not display. In this case, the Device Selection and Preview page automatically appears. If you select a historical version of a policy group, it is restored as the current deployment group for editing. The existing current deployment group is saved as a historical version. To select a policy group: Step 1 In the Device Selection and Preview page (that is, step 2 of the wizard), choose the type of policy group (current or historical), by selecting •Current version of a policy group or •Restore a previous version of a policy group Step 2 Select the policy group: •If you are deploying a current policy group, select the policy group name from the list. To view the details (Owner, Creation Time) of all the policy groups before making your selection: a. Click the View list link. The Policy Group List page appears, displaying all the currently managed policy groups. For more information about this page, see Policy Groups List Page, page C-8. b. Select the required policy group by clicking the corresponding radio button, and click Select. The selected policy group name will be displayed in the Policy Group list in the second page of the wizard. •If you are deploying a historical policy group, select the policy group name from the list. To view the details (Version, Job, Owner, Creation Time) of all the historical deployment groups before making your selection: a. Click the View list link. The Job History List page appears, displaying all the historical policy groups. For more information about this page, see Job History List Page, page C-8. b. Select the required policy group by clicking the corresponding radio button, and click Restore. The selected policy group name will be displayed in the Policy Group list in the second page of the wizard. Step 3 Click Next to move to the next step of the wizard: •If you selected to deploy a current policy group, the next step of the wizard is to select your devices. •If you selected to deploy a historical version of a policy group, the next step of the wizard is to validate the policy group. Related Topics •Step 3: Validating the Historical Policy Group •Step 4: Selecting and Previewing the Devices for Deployment •Managing Historical Versions Step 3: Validating the Historical Policy Group Note This step of the wizard is only available if you selected to deploy a historical version of a policy group in step 2 of the wizard. Whenever a previous version of a policy group is restored, validation checks must be done on the policy group. The validation process is automatically activated after selecting a historical policy group and clicking the Next button in Related Topics. The system does the following checks and automatically provides a report of violations, where relevant: •Missing Network Elements This validation procedure checks for the coordination of policies and managed devices. If the validation procedure detects network elements that are missing from the current device group, they will be displayed in the report. The assignments of policies to these network elements in the restored deployment group will be automatically removed. •Invalid Assignments This validation procedure checks for assigned network elements that no longer match the constraints of their policy groups. Any invalid assignments will be displayed in the report. The network elements will be removed from the assignment. •Reusable Components Violations This validation procedure checks for the coordination of policies and library components (IP aliases, application aliases and policy group templates). If the validation process detects some library components in the restored version that are different than the ones in the current libraries, this will be displayed. The validation process overrides the current library components with the original ones and adds them locally to the policy group. In this case, the dynamic link to the library components will no longer exist. •Constraints Violations This check validates the policy device constraints against the predefined constraints limitations. These limitations might change from time to time causing some of the policy constraints to be invalid. Policies that are invalid will be displayed and removed along with their assignments. To validate the historical policy group: Step 1 In the Deployment Group Validate Historical page, click the View Restore Validation Report button. The Restore Validation Report window opens, displaying any validation violations that were discovered during the deployment group restore procedure. For more information about this window, see Restore Validation Report Window, page C-10. Step 2 After you have finished viewing the report, close the window. Step 3 Click Next or Finish to accept any changes made as a result of the validation checks, and move to the next step of the wizard. Step 4 To stop the deployment without saving any changes, click Cancel. Related Topics •Step 4: Selecting and Previewing the Devices for Deployment •Managing Historical Versions Step 4: Selecting and Previewing the Devices for Deployment Note If you are deploying a deployment group from the IP Telephony wizard, the Deployment wizard will open automatically on this page. In this step of the wizard, you select the devices to which you want to deploy your policies. You can also preview the CLI commands that will be configured on your devices prior to deployment. This page displays a list of all the devices that are available for deployment and their configurations. Devices whose configurations have changed since the last deployment will be displayed with the check boxes alongside them selected. You can accept the default selection, or you can make your own selection of devices. To select and preview the devices for deployment: Step 1 In the Device Selection and Preview page, select the check boxes alongside the devices to which you want to deploy your policies. Deselect those you do not want to deploy to. For best performance, select no more than 200 devices at a time. Step 2 To preview the CLI configuration commands for a device: a. Click its Policy Configuration link in the table. A preview window opens, displaying the following configuration details for the device: •Backup ShowRun configuration commands. •Incremental Telnet script commands to be written (if deploying directly to network devices). b. Click the appropriate buttons to view the relevant configuration details. c. After you have finished previewing the device's configuration, click Close to close the Preview window. Step 3 Click Next to move to the next step of the wizard. Related Topics •Step 5: Confirming the Wizard Information for Deployment •Previewing the CLI Commands •Deployment Wizard - Device Selection and Preview Page, page C-11 •Device Configuration Preview Window, page C-12 Step 5: Confirming the Wizard Information for Deployment The last page of the Deployment wizard presents a summary of all the data collected through the Deployment wizard for you to verify. After you are satisfied with the job information, you can deploy the policy group to the network. Caution Jobs are not necessarily deployed to devices in the order in which they are triggered. Avoid deploying several jobs to the same device simultaneously. This could result in the incorrect configuration of the device. To confirm the wizard information: Step 1 In the Deployment Wizard - Summary page, verify the job information that displayed on the page. If you are not satisfied with any of the job details, you can go back through the wizard to make the required changes. Step 2 After you are satisfied with the job information, click Schedule (or Deploy) to confirm the schedule for policy group deployment (or to deploy the policy group) to the network. The Active Jobs page appears, allowing you to view the deployment process. Related Topics •Viewing the Deployment Status Viewing the Deployment Status You can view the status of your job during deployment using the Active Jobs page. The Active Jobs page provides a dynamic view of all the active deployments and their status. For each deployment job, the start time of its configuration, its status, and a summary of the number of devices deployed according to their status, are displayed. The status of a job deployment or a device deployment might be Pending, In Progress, Completed, or Failed. A job deployment might also have the status of Aborted or Paused. During the deployment process, a status of "In Progress" will be displayed for a job. When the job is completed successfully, its status will change to "Completed". For a deployment job to be Completed, all the devices must be successfully configured. If the deployment of at least one device fails, and all the other devices passed without errors, the overall status of the deployment is Failed. Completed jobs are automatically removed from the display after ten minutes. From the Active Jobs page, you can: •View the deployment details of a job. •Pause and resume the deployment process. •Stop the deployment. •Redeploy a failed deployment. •Remove a deployment job from the display. To view the deployment status: Step 1 Select Provision > Policy Deployment > Pending Jobs. The Active Jobs page appears, displaying the currently active deployment jobs and their status, in a table. Tip The display is automatically refreshed every ten seconds. To force a refresh manually, click Refresh. For more information about the Active Jobs page, see Pending Jobs Page, page C-14. Note The Active Jobs page appears automatically when you click Deploy in the Summary page of the Deployment wizard (see Step 5: Confirming the Wizard Information for Deployment). Step 2 View the status of the active job deployments and device deployments: •To view the details of a deployment job, select its Job Name link in the table. The Job Details report appears. •To remove a deployment job from the table, select it and click Remove From Display. Related Topics •Pausing and Resuming a Deployment Job •Stopping a Deployment Job •Redeploying a Job •Viewing the Job Details Report •Troubleshooting Deployment Problems, page 12-8 Pausing and Resuming a Deployment Job You can pause a job during deployment. However, QPM will not stop the configuration of a device after it has begun. Any devices that are being configured when the Pause command is issued will be finished. Devices for which deployment had not yet begun will remain with the status Pending. You can also cause any paused deployment to resume configuration of devices. This does not create a new job—it continues the selected job. To pause and resume a deployment job: Step 1 Select Provision > Policy Deployment > Pending Jobs. The Active Jobs page appears. Step 2 In the Active Jobs list, select the check box next to your deployment job and click Pause. A message appears asking you if you are sure you want to pause the deployment of your job. Step 3 Click Yes to pause the job's deployment. Step 4 To resume the deployment of your job, select the check box next to the job and click Resume. The deployment of the selected job will resume. Related Topics •Viewing the Deployment Status Stopping a Deployment Job You can stop a deployment job that is currently in progress or has been paused. This feature is useful if you want to change a job's configuration details before deploying it, or if a job becomes stuck while in progress. Terminating a job stops the configuration of the devices. All the devices that were In Progress or Pending will receive a Failed status. You cannot resume a stopped deployment job. To stop a deployment job: Step 1 Select Provision > Policy Deployment > Pending Jobs. The Active Jobs page appears. Step 2 In the Active Jobs list, select the check box next to the deployment job (In Progress or Pending) that you want to stop, and click Abort. A message appears warning you that the job will be aborted with no option to resume it. Step 3 Click Yes to confirm the stop procedure. The job status for the selected deployment job will display "Aborted". Related Topics •Viewing the Deployment Status Redeploying a Job You can manually request that deployment be retried for either a specific device that failed or all failed devices in any displayed failed job. This does not create a new job—it creates another deployment for the job. The redeployment process resets the status of the selected devices and re-requests the deployment of the selected job. To redeploy a deployment job: Step 1 Select Provision > Policy Deployment > Pending Jobs. The Active Jobs page appears. Step 2 In the Active Jobs table, select the check box next to the job you want to redeploy and click Redeploy. The Device Selection and Preview page of the Deployment wizard appears, displaying all the failed devices of the job. See Step 4: Selecting and Previewing the Devices for Deployment. Step 3 Select the check boxes alongside the devices to which you want to deploy your policies. If required, preview the CLI commands that will be configured on your devices. Then click Next. Step 4 Enter the job details and select the deployment options, and click Next (see Related Topics). Step 5 Verify the job information and click Deploy to redeploy your job to the network (see Step 5: Confirming the Wizard Information for Deployment). Related Topics •Viewing the Deployment Status Managing Historical Versions QPM allows you to restore previous versions of policy groups that were deployed to the network, for editing and deploying. The Restore feature is very useful when unexpected errors occur as a result of the deployment of a policy group and you must go back to a previous version of that policy group. You can also view a historical version of a policy group without restoring. You can manage historical versions of policy groups from the Job History report, which displays a table of historical deployment jobs and all their details. From the Job History report, you can do the following: •Restore a historical policy group to edit and deploy it. •View a historical policy group's policies. •Delete a historical job. •Lock a job to prevent automatic deletion when the history cache is full, or release a job from being locked. •Download the configuration files of a historical deployment job. •View a Job Details report for each deployment job. •View a Deployment History report for each deployment job. •View the results of a DNS host name resolution check for a deployment job. To manage historical deployment versions: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History report appears. For more information about the Job History report, see Completed Jobs Page, page C-15. Step 2 Select the required historical report, and click the appropriate button or link depending on the procedure you want to do, as described in the following sections. Related Topics •Restoring and Deploying a Historical Policy Group •Viewing a Historical Policy Group •Deleting a Historical Job •Locking and Unlocking a Historical Job •Downloading a Historical Job's Configuration Files •Viewing the Job Details Report •Viewing the Deployment History Report •Viewing the DNS Resolution Restoring and Deploying a Historical Policy Group This topic describes how you can restore a previous version of a specific policy group that was deployed to the network, for editing purposes. It also describes how to deploy the restored version, if required. Note If required, you can view a history of all the policy group restore operations, from the Restore Reports page. To restore and deploy a historical policy group: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History report appears. Step 2 Select the historical job you want to restore, in the table. Step 3 Click Restore. Validation checks are automatically done on the policy group. If the restore process detects any validation violations, the results will be written to a report. The Restore Policy Group page appears, from which you can view the validation report. For more information about this page, see Restore Policy Group Page, page C-17. Step 4 To view a validation report: a. Click Show Restore Report. The Restore Validation Report window opens. For more information about this window, see Restore Validation Report Window, page C-10. b. When you have finished viewing the report, close the window. Step 5 Click OK to confirm the Restore process, or Cancel to stop the process. If you clicked OK, the restored version will be selected as the current editable policy group. The Policy Table page appears, displaying the policies for the current policy group (see Modifying a Policy, page 8-14). If you want to deploy the restored version, follow the steps of the Deployment wizard (see Related Topics through Step 5: Confirming the Wizard Information for Deployment). Related Topics •Step 3: Validating the Historical Policy Group •Managing Historical Versions •Working with Policies, page 8-1 •Deploying Policies and QoS Configurations Viewing a Historical Policy Group If you want to verify the details of a historical version of a deployment job, QPM allows you to view its policies. In this case, you will not be able to make changes to the policy group or deploy it to the network. You can view only one historical policy group at a time. The policy group will not be saved. If you select another policy group, you will lose the previous version you selected to view. To view it, you will have to select it again from the Job History report page. To view a Historical Policy Group: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History report appears. Step 2 Select the historical job in the table and click View Policy Group. The Policy Table page appears in read-only mode, displaying the selected policy group and its policies. Related Topics •Managing Historical Versions •Working with Policies, page 8-1 Deleting a Historical Job You can delete historical jobs from the Job History report list. To delete Historical Jobs: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History report appears. Step 2 Select the historical jobs you want to remove from the report, and click Delete. A dialog box opens, warning you that the selected jobs will be deleted. Step 3 Click OK to confirm the deletion. The jobs will be deleted from the list of historical jobs. You will no longer be able to restore them. Related Topics •Managing Historical Versions Locking and Unlocking a Historical Job The Job History report can display up to a predefined maximum number of jobs. When the history cache is full, the oldest historical jobs are automatically deleted. You can prevent this automatic deletion by "locking" a job. Similarly, you can "unlock" a historical version, making it available for deletion. To lock or unlock a Historical Job: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History report appears. Step 2 Select the historical job you want to prevent from automatic deletion, and click Lock Job. The Lock Job status of the job in the report will display Lock. Step 3 To release a historical job from being locked from automatic deletion, select it and click Unlock Job. The Lock Job status of the job in the report will display Unlock. Related Topics •Managing Historical Versions Downloading a Historical Job's Configuration Files When QPM deploys QoS configurations to files, it generates configuration files that can be sent manually to the devices. Individual files are created for each device, and the complete set of files are saved as a single zip file to your hard disk. From the Job History report, you can download to your desktop the zip file that contains the individual configuration files for each device in a historical deployment job that you select for editing. To download a Historical Job's configuration file: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History report appears. Step 2 Select the historical job whose configuration zip file you want to download, and click its Files icon. The File Download dialog box opens. Step 3 Save the zip file to the required location on your desktop and extract the configuration files. Related Topics •Managing Historical Versions •Related Topics Viewing the Job Details Report The Job Details report shows the final status of all the deployments of a selected job. It can also show the current deployment status of a job that is still in progress. Note The redeployment process can result in more than one deployment for a job (see Redeploying a Job). The job's deployment details are displayed at the top of the page, and a table of all the devices related to the deployment is displayed below. From this report, you can view details about any errors or warnings that resulted from the deployment of a device. You can also view the CLI commands that were used to configure a device. Note If the error message for a failed job displays "Internal error - unknown device state," some of the devices might be stuck in progress. In such a case, QPM will not be able to determine what was configured on these devices. You should contact technical support on the Cisco TAC web site to resolve this problem. To view the Job Details Report: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History page appears. Step 2 Click the Job Name link of the job whose details you want to view or click the Details icon for the job. Note You can also open the Job Details page, by clicking the Job Name link for a job in the Active Jobs page, or by clicking the Job Name link for a device in the Managed Devices report. The Job Details Report page appears, displaying the job's details and a table listing status information for each device in the job. For more information about the Job Details Report page, see Job Details Report Page, page C-18. Step 3 To view details about an error or warning that resulted from the deployment of a device, click the Errors/Warnings link for the required device in the table. The Device Errors and Warnings page appears. Step 4 To view the CLI commands that were used to configure a device: a. Select the check box next to the required device in the table. b. Click View CLI Commands. A preview window opens, displaying the following configuration details for the device: •Backup ShowRun configuration commands. •Any incremental Telnet script commands that were written (if deployed directly to network devices). c. Click the appropriate buttons to view the relevant configuration details. d. Click Close to close the Preview window. Related Topics •Managing Historical Versions •Viewing Device Deployment Errors and Warnings •Viewing the Status of Devices Viewing Device Deployment Errors and Warnings In the Device Errors and Warnings page, you can view details about any errors or warnings that resulted from the deployment of a device. The page displays the reason for the error or warning message, and the time it occurred. To view the device deployment errors and warnings: Step 1 In the Job Details Report page, click the Errors/Warnings link for the device whose deployment error details you want to view. The Device Errors and Warnings page appears. For more information about this page, see Device Errors and Warnings Page, page C-19. Step 2 When you have finished viewing the error or warning messages, close the page. Related Topics •Viewing the Job Details Report Viewing the Deployment History Report The Deployment History report displays the deployment history details of a selected deployment. Note The redeployment process can result in more than one deployment for a deployment job (see Redeploying a Job). A deployment history report shows only the devices that were configured in the selected deployment. These might not be all the devices in the deployment job. To view Deployment History Report: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History page appears. Step 2 Click the Deployments link of the job whose deployment details you want to view. The Deployment History report is displayed for the selected deployment. For more information about the Deployment History report, see Deployment History Report Page, page C-20. Step 3 To view the job details of the selected deployment, click the Deployment Type link. A Job Details report appears for the selected deployment. Related Topics •Managing Historical Versions •Viewing the Job Details Report Viewing the DNS Resolution QPM resolves newly added host names to their IP addresses, to update any changes in the network. From the Job History report, you can view the results of a DNS resolution check done by QPM on the host names that QPM resolved to IP addresses, for a selected deployment job. To view the DNS Resolution of a Historical Job: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Job History report appears. Step 2 Select the historical job in the table and click DNS Resolution. The DNS Resolution page appears, displaying a list of IP addresses to which the host names were resolved, for the selected deployment job. For more information about the DNS Resolution page, see DNS Resolution Page, page C-17. Related Topics •Managing Historical Versions •Creating an Online Preview Job Viewing the Status of Devices The Job Details page (for both completed and pending deployment jobs) allows you to view the status of all devices in the device group that were configured (deployed to) by QPM. To view the status of devices: Step 1 Select Provision > Policy Deployment > Completed Jobs. The Completed Jobs page appears. Step 2 To view details about the device's deployment job, click the Job Name link for the device. A Job Details report is displayed. Step 3 Select Provision > Policy Deployment > Pending Jobs. The Pending Jobs page appears. Step 4 To view details about the device's deployment job, click the Job Name link for the device. A Job Details report is displayed Related Topics •Viewing the Job Details Report Previewing the CLI Commands QPM allows you to view in advance the CLI commands that will be sent to the devices upon policy deployment. You can also create an online CLI Preview job to view the commands for the current policy group, while the policy is being deployed on devices. Online CLI previews are determined by querying the devices for their existing configuration and then calculating the incremental changes. QPM provides several ways in which you can view the CLI commands that are already configured, or will be configured, on devices in your policy group: •Using the Local Preview page, you can translate the policies attached to a device, to CLI commands •Using the Online Preview wizard, you can activate an Online Preview job in which CLI commands are generated for all or some of the devices, which have policies attached from a selected policy group. •During the deployment process, you can preview the CLI commands that will be configured on a single device, prior to deployment (see Step 4: Selecting and Previewing the Devices for Deployment). •In the Job Details report, you can view the CLI commands that were configured on a selected device. Related Topics •Viewing the Job Details Report •Creating an Online Preview Job •Viewing the Online Preview Jobs Local Preview You can have a preview of CLI commands for each device (which already has a policy attached) in the device inventory. To generate a local preview: Step 1 Select Provision > Policy Preview > Local Preview. The Local Preview page appears with a list of all the devices in the device inventory. Step 2 Click the checkbox corresponding to the device whose CLI command you want to preview, and click Translate at the bottom of the page. The Translation page appears with the CLI translation of the selected device. The message `No CLI Translation available' appears if there are no policies attached to the selected device. Online Preview You can have an online preview of the CLI commands for the devices on which the policies are currently being deployed. You create a CLI Preview job, and specify the devices for which you want to see the CLI preview, through the CLI Preview wizard. QPM stores these Online Preview jobs, so that you can later refer it for analysis. Related Topics •Creating an Online Preview Job •Viewing the Online Preview Jobs Creating an Online Preview Job The Online Preview wizard guides you through the steps required to create a new Online Preview job for all the devices on which policies of a particular policy group are attached (or being attached). The steps of the Online Preview wizard are: •Step 1: Selecting the Policy Group for an Online Preview Job •Step 2: Previewing and Selecting the Devices for an Online Preview Job •Step 3: Confirming the Wizard Information for an Online Preview Job Related Topics •Using QPM Wizards, page 3-8 •Previewing the CLI Commands Step 1: Selecting the Policy Group for an Online Preview Job In this step of the wizard, you select the policy group that contains the policies that have been attached to the devices. The policy group must be one of those that are currently managed. To select the policy group: Step 1 Select Provision > Policy Preview > Online Preview. The Online Preview page appears. Step 2 Click New Preview. The Online Preview wizard appears at the first page—Policy Group Selection. Step 3 Select the current policy group from the list box. To view the details (Owner, Creation Time) of all the current policy groups, and then make your selection: a. Click the View list link. The Policy Groups List page appears. b. Select the required policy group and click Select. The policy group will appear selected in the Policy Group Selection page of the wizard. Step 4 Click Next to move to the next step of the wizard. The Device Selection and Preview page appears. Related Topics •Creating an Online Preview Job •Step 2: Previewing and Selecting the Devices for an Online Preview Job Step 2: Previewing and Selecting the Devices for an Online Preview Job In this step of the wizard, you select the devices and preview their configurations. This page displays a list of all the devices that are assigned to policies in the selected policy group. To preview and select the devices: Step 1 In the Device Selection and Preview page, select the check boxes alongside the devices whose configuration details you want to preview. By default, all the devices will be selected. Step 2 To preview the CLI configuration commands for a device: a. Click its Policy Configuration link. A preview window opens, displaying the following configuration details for the device: •Backup ShowRun configuration commands. •Any incremental Telnet script commands that will be written (if deploying directly to network devices). b. Click the appropriate buttons to view the relevant configuration details. c. After you have finished previewing the device's configuration, click Close to close the Preview window. Step 3 Click Next to move to the final step of the CLI Preview wizard. Related Topics •Creating an Online Preview Job •Step 3: Confirming the Wizard Information for an Online Preview Job Step 3: Confirming the Wizard Information for an Online Preview Job The last step of the Online Preview wizard asks you to verify the policy group name and the number of devices that were selected for previewing. To confirm the wizard information: Step 1 Verify the job information displayed on the page. If you are not satisfied with any of the job details, you can go back through the Online Preview wizard to make the required changes. Step 2 Click Preview. The Online Preview page appears, allowing you to view the current CLI jobs that are being executed. Related Topics •Creating an Online Preview Job •Viewing the Online Preview Jobs Viewing the Online Preview Jobs The Online Preview page displays a table of all the Online Preview job requests that were created and those that are currently being executed. This page provides a dynamic view of all the Online Preview jobs and their status. It also displays the time the last preview was initiated for a job, the job's status, and its owner. The status of an Online Preview job may be Pending, In Progress, Completed, or Failed. During the Online Preview process, CLI commands are generated for all the devices in the policy group. A status of "In Progress" will be displayed for a job during this process. When the job is completed successfully, its status will change to "Completed". From the Online Preview page, you can: •Create a new Online Preview job. •View the details of an Online Preview job. The Online Preview Details report describes the details of a Online Preview job. From this report, you can also view the CLI commands that were used to configure a device. •View the results of a DNS host name resolution check for a selected CLI Preview job. •Delete a Online Preview job from the list. To view the Online Preview Jobs: Step 1 Select Provision > Policy Preview > Online Preview. The Online Preview page appears. Note The Online Preview page appears automatically when you click Preview in the last step of the CLI Preview wizard (see Step 3: Confirming the Wizard Information for an Online Preview Job). For more information about the Online Preview page, see Online Preview Page, page C-2. To view the details of an Online Preview job: Select the Online Preview job whose details you want to view, and click its Details icon or the View Preview Details button. The Online Preview Details page appears. For more information about the Online Preview Details page, see Online Preview Details Page, page C-5. To view the CLI commands that were used to configure a device: a. Select the check box next to the required device in the table. b. Click View CLI Commands. A preview window opens, displaying the Backup ShowRun configuration commands and any incremental Telnet commands that were written to the device. c. Click the appropriate buttons to view the relevant configuration details. d. Click Close to close the Preview window. Step 2 To view the results of a DNS host name resolution check, select the preview job and click DNS Resolution. The DNS Resolution page appears, displaying a list of IP addresses to which the host names were resolved, for the selected preview job. For more information about the DNS Resolution page, see DNS Resolution Page, page C-17. Step 3 To delete Online Preview jobs: a. Select the jobs you want to remove from the list, and click Delete. A dialog box opens, warning you that the selected jobs will be deleted. b. Click OK to confirm the deletion. The jobs will be deleted from the list of Online Preview jobs. Related Topics •Previewing the CLI Commands •Creating an Online Preview Job •Viewing the DNS Resolution
	© 1992-2009 Cisco Systems, Inc. All rights reserved. Terms & Conditions \| Privacy Statement \| Cookie Policy \| Trademarks of Cisco Systems, Inc.