|
|
The following topics describe the pages in the Deploy tab. Topics are organized according to the following Deploy tab options:
The Deployment option contains the Deployment wizard that guides you through the process of creating a deployment job.
To open the Deployment wizard, select Deploy > Deployment.
The following pages are accessed from the Deployment option:
Use this page to select the deployment group to be deployed.
To open this page, do any of the following:
| Field | Description |
|---|---|
Current version of a deployment group | Select this radio button to deploy the current version of a deployment group, and then choose the required deployment group from the list box. |
Restore a previous version of a deployment group | Select this radio button to deploy a historical version of a deployment group, and then choose the required deployment group from the list box. |
Next button | Click to proceed to the next step of the wizard. |
Finish button | Click to complete the wizard. The Summary page appears. |
Use this page to view the details (Owner, Creation Time) of all the current deployment groups, before making your deployment group selection. You can access this page from the Deployment wizard, the CLI Preview wizard, or the Device Configuration Verification wizard.
To open this page, do one of the following:
| Field | Description |
|---|---|
Deployment Group | The deployment group name. |
Owner | The person who last saved the deployment group. |
Creation Time | The date and time the deployment group was created. |
Select button | Click to confirm the deployment group selection. |
Use this page to view the details of all the historical deployment groups before making your deployment group selection.
To open this page, click the View list link next to the historical deployment group list box in the Deployment Group Selection page of the Deployment wizard.
| Field | Description |
|---|---|
Deployment Group | The deployment group name. |
Version | The version number of the deployment job. |
Job | The name of the deployment job. |
Owner | The person who last saved the deployment group. |
Creation Time | The date and time the deployment group was created. |
Restore button | Click to confirm the historical deployment group selection. |
Use this page to access the validation report that results from the validation process of a historical deployment group.
To open this page, do any of the following:
| Field | Description |
|---|---|
View Restore Validation Report | Click this button to open the Restore Validation Report window, that displays any validation violations that were discovered during the deployment group restore procedure. |
Back button | Click to return to the previous step of the wizard. |
Next button | Click to save the changed deployment group as a new version, and proceed to the next step of the wizard. |
Finish button | Click to save the changed deployment group as a new version, and move to the last step of the wizard. The Summary page appears. |
Use this window to view a validation report that results from the validation checks that are done on a restored deployment group.
To open this window, click the View Restore Validation Report button in the Validate Historical page of the Deployment wizard.
| Field | Description |
|---|---|
Missing Network Elements | Displays any invalid or missing network elements that were found in the restored deployment group. 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 this report. The assignments of policies to these network elements in the restored deployment group will be automatically removed. |
Invalid Assignments | Displays any invalid assignments that were found in the restored deployment group. It displays all the network elements that no longer conform to the constraints of their policy group. The validation procedure checks for assigned network elements that no longer match the constraints of their policy groups. These network elements will be removed from the assignment. |
Reusable Components Violations | Displays any reusable components violations that were found in the restored deployment group. 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 in the report. The validation process overrides the current library components with the original ones and adds them locally to the deployment group. In this case, the dynamic link to the library components will no longer exist. |
Constraints Violations | Displays any invalid policy groups that were found in the restored deployment group. This check validates the policy group device constraints against the predefined constraints limitations. These limitations may change from time to time causing some of the policy group constraints to be invalid. Invalid policy groups will be removed along with their assignments. |
Use this page to preview your device configurations prior to deployment and select the devices you want to deploy.
To open this page, do any of the following:
| Field | Description |
|---|---|
Device | Displays the device name or IP address. 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 which you want to deploy your policies. |
Device Folder | Displays the name of the device folder. |
Policy Configuration | Displays the current configuration for the device, as follows:
Click the policy configuration link to open a Device Configuration Preview window that displays the configuration details of the selected device. |
Back button | Click to return to the previous step of the wizard. |
Next button | Click to proceed to the next step of the wizard. |
Finish button | Click to complete the wizard. The Summary page appears. |
Use this window to preview the configuration details of a device prior to deployment.
To open this window, do any of the following:
| Field | Description |
|---|---|
Backup button | Click to view the backup ShowRun configuration commands for the device. |
Incremental Telnet button | Click to view the incremental Telnet script commands that will be written to the device, if deploying directly to network devices. |
Close button | Click to close the Device Configuration Preview window. |
Use this page to enter details about your deployment job and set the deployment options.
To open this page, do any of the following:
| Field | Description |
|---|---|
Job Name | The default deployment job name. You can change the default name by entering a name for your deployment job in this field. |
Job Description | Optionally, you can enter a description for the deployment job in this field. |
Deploy configuration to the devices using Telnet | Select this check box to deploy the deployment group directly to the devices. Deselect it if you don't want to deploy directly to the devices. By default, the check box is selected. |
Back button | Click to return to the previous step of the wizard. |
Next button | Click to proceed to the next step of the wizard. |
Finish button | Click to complete the wizard. The Summary page appears. |
Use this page to view and verify all the data collected by the wizard for the current deployment job.
To open this page, do any of the following:
| Field | Description |
|---|---|
Job Owner | The person who last saved the deployment job. |
Job Name | The name of the deployment job. |
Job Description | A description of the deployment job, if available. |
Deployment Group Name | The name of the deployment group. |
Deployment Group Version | Current or History, depending on the deployment group version selected. |
Number of devices to be deployed | The number of devices that will be deployed to. |
Deploy configuration to the devices | Yes or No, depending on whether you selected to deploy directly to the devices in the Job Details page. |
Back button | Click to return to the previous step of the wizard. |
Deploy button | Click to deploy the deployment group to the network. The Active Jobs page appears. |
The following topics describe the fields in the pages that are accessed from the Jobs option:
The Active Jobs page provides a dynamic view of all the active deployments and their status. Use the Active Jobs page to:
To open this page, do one of the following:
| Field | Description |
|---|---|
Job Name | The name of the deployment job. Click the Job Name link for a selected job to open the Job Details report for that job. |
Owner | The person who last saved the deployment job. |
Deployment Group | The name of the deployment group. |
Start Time | The start time of deployment job configuration. |
Job Status | Selected deployment job's status (Pending, In Progress, Paused, Aborted, Completed, or Failed). |
Devices Pending | The number of devices that are waiting for deployment. |
Devices In Progress | The number of devices whose deployment is in-progress. |
Devices Completed | The number of devices whose deployment completed successfully. |
Devices Failed | The number of devices whose deployment failed. |
Total | The total number of devices in the current deployment. (This number is the sum of the four previous status fields.) |
Refresh | Click to force a manual update of the displayed data. The display is automatically refreshed every ten seconds. |
Pause | Click to pause a job during deployment. 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". |
Resume | Click to resume the configuration of devices for a job that was paused. |
Redeploy | Click to manually request that deployment be re-tried for a specific failed device or all failed devices in the selected job. Another deployment is created for the job. |
Remove from Display | Click to remove a completed or failed deployment job from the table. |
Abort | Click to terminate a deployment that is currently in progress or has been paused. Any devices that were not configured when the Abort command was issued will not be deployed. They will be set as Failed. A terminated deployment cannot be resumed. |
Use this page to:
To open this page, select Deploy > Jobs > Job History.
| Field | Description |
|---|---|
Job Name | The name of the deployment job. Click the Job Name link for a selected job to open the Job Details report for that job. |
Owner | The person who last saved the deployment job. |
Deployment Group | The name of the deployment group. |
Deployment Time | The time the last deployment occurred for the job. |
Deployments | The number of deployments that were made for the job. Click the Deployments link of a job whose deployment details you want to view to open a Deployment History report for the selected deployment. |
Status | The selected job's deployment status—Pending, In Progress, Completed, Paused, Aborted, or Failed. |
Lock Job | Lock or Unlock, depending on whether the job is locked to prevent deletion when the history cache becomes full. |
Files | Click this link to download the zip file containing the individual configuration files for a device to your desktop. |
Details | Click the Details icon for a job to open its Job Details report in which you can view the status of devices related to the deployment job. |
DNS Resolution | Click to view the results of a DNS host name resolution check for a selected deployment job. |
View Deployment Group | Click to verify the details of a selected historical version. The Policy Groups page appears in read-only mode, displaying the selected deployment group and its policy groups. |
Restore | Click to restore a selected historical version for editing and deploying. The Restore Deployment Group page appears. |
Delete | Click to delete a selected historical version from the Job History list. After deleted, you cannot restore it. |
Lock Job | Click to prevent a selected historical version from being automatically deleted when the history cache is full. |
Unlock Job | Click to unlock a historical version, making it available for deletion. |
Use this page to view the validation report for a deployment group that is being restored, and to confirm or cancel the restore process.
This page opens automatically when you click Restore after selecting a historical deployment group in the Job History page.
| Field | Description |
|---|---|
Name | The name of the deployment group. |
Version | The restored version number of the deployment group. |
Show Restore Report | Click to open a Restore Validation Report window for the selected deployment group. |
OK | Click to confirm the restoring of this version as the current deployment group for editing and deploying. The Policy Groups page appears. |
Use this page to 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 open this page, do one of the following:
| Field | Description |
|---|---|
Host Name | The name of the network host. |
Resolved Address | The IP address to which the host name was resolved. |
Policy | The policy associated with the host. |
Policy Group | The policy group to which the policy belongs. |
Use this page to view:
To open this page, do any of the following:
| Field | Description |
|---|---|
Job Name | The name of the deployment job. |
Deployment Group | The name of the deployment group. |
Device Group | The device group that contains the deployment job. |
Job Status | The deployment job's status (Pending, In Progress, Paused, Aborted, Completed, or Failed). |
Owner | The person who last saved the deployment job. |
Creation Time | The date and time the job was created. |
Job Description | The description of the job, if any. |
Note | If you selected not to deploy the deployment group directly to the devices, this field will display "Deployment to files only". |
Device Name/IP | The name of the device or its IP address. |
Status | The deployment status of the device. |
Status Time | The time the device received its status. |
Errors/Warnings | An error string, if available. In the case of a FAILED status, the CLI command that caused the error will also be displayed. If the error string for a Failed job displays "Internal error - unknown device state", some of the job's 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 Cisco technical support for help. |
View CLI Commands | Click to view the CLI commands that were used to configure the device. A Device Configuration window opens. |
Use this page to view details about any errors or warnings that resulted from the deployment of a device.
To open this page, click the Errors/Warnings link for a device in the Job Details Report page.
| Field | Description |
|---|---|
Type | Displays Error or Warning. |
Message | Displays the reason for the error or warning message. |
Message Time | Displays the time the error or warning occurred. |
Use this page to view the deployment history details of a selected deployment.
To open this page, in the Job History page, click the Deployments link of the job whose deployment details you want to view.
| Field | Description |
|---|---|
Job Name | The name of the deployment job. |
Deployment Group | The name of the deployment group. |
Device Group | The device group that contains the deployment job. |
Owner ID | The person who last saved the deployment job. |
Creation Time | The date and time the job was created. |
Job Description | The description of the job, if any. |
Note | If you selected not to deploy the deployment group directly to the devices, this field will display "Deployment to files only". |
Deployment Type | The deployment type - Normal or Redeploy. Click this link to view the Job Details report of the selected deployment. |
Start Time | The date and time the deployment started. |
End Time | The date and time the deployment ended. |
Use this page to view all the devices in the current device group that were configured (deployed to) by QPM, and their statuses. Devices that were never deployed to are not displayed.
To open this page, select Deploy > Jobs > Managed Devices.
| Field | Description |
|---|---|
Device Name/IP | The name or IP address of the device. |
Status | The deployment status of the device. |
Status Time | The date and time of the device deployment. |
Job Name | The deployment job responsible for the device. Click this link to view a Job Details report about the device's deployment job. |
The following topics describe the fields in the pages that are accessed from the Previews option:
Use this page to view all the CLI Preview job requests that were created and those that are currently being executed.
To open this page, do any of the following:
| Field | Description |
|---|---|
Owner | The person who last saved the deployment job. |
Deployment Group | The current deployment group. |
Deployment Time | The time the last deployment occurred for the CLI Preview job. |
Status | The status of the CLI Preview job—Pending, In Progress, Completed, or Failed. |
Details | Click the Details icon for a preview job to open its Job Details report, in which you can view the status of devices related to the job. |
Refresh | Click to force a manual update of the displayed data. |
DNS Resolution | Click to view the results of a DNS host name resolution check for a selected preview job. |
New Preview | Click to open the CLI Preview wizard for creating a new CLI Preview job. |
View Preview Details | Click to open the CLI Preview Details page for the selected job. |
Delete | Click to delete a selected CLI Preview job from the list. |
The following topics describe the pages of the CLI Preview wizard that guides you through the steps required to create a new CLI Preview job, for the devices in a deployment group.
The CLI Preview wizard contains the following pages:
Use this page to select the deployment group to be previewed.
To open this page, do any of the following:
| Field | Description |
|---|---|
Deployment Group | Select the deployment group whose devices you want to preview. Click the View list link to view a detailed list of all the current deployment groups. |
Next button | Click to proceed to the next step of the wizard. |
Finish button | Click to complete the wizard. The Summary page appears. |
Use this page to see previews of the CLI commands for all the devices in your deployment group. These CLI previews are determined by querying the devices for their existing configuration and then calculating the incremental changes.
To open this page, do any of the following:
| Field | Description |
|---|---|
Device | Displays the device name or IP address. |
Device Folder | Displays the name of the device folder. |
Policy Configuration | Displays the current configuration for the device (Modified, No Changes). Click to open a Device Configuration Preview window that displays the configuration details of the selected device. |
Back button | Click to return to the previous step of the wizard. |
Next button | Click to proceed to the next step of the wizard. |
Finish button | Click to complete the wizard. The Summary page appears. |
Use this page to view and verify all the data collected by the wizard for the current deployment job.
To open this page, do any of the following:
| Field | Description |
|---|---|
Deployment group name | The name of the deployment group. |
Number of devices to be previewed | The number of devices that were selected for previewing. |
Back button | Click to go back through the CLI Preview wizard to make any changes that are required. |
Preview button | Click this button to activate the preview job. The CLI Preview page appears. |
Use this page to view a detailed report for a selected CLI Preview job, including device status information.
To open this page, do any of the following:
| Field | Description |
|---|---|
Job Name | The name of the preview job. |
Deployment Group | The name of the deployment group. |
Device Group | The name of the device group. |
Owner | The person who last saved the preview job. |
Creation Time | The date and time the CLI Preview job was created. |
Job Description | A description of the preview job, if available. |
Device Name/IP | Displays the device name or IP address. |
Status | Displays the deployment status of the device. |
Status Time | The time the device received its status. |
Errors/Warnings | An error string, if available. In the case of a FAILED status, the CLI command that caused the error will also be displayed. |
View CLI Commands | Click to view the CLI commands that were used to configure the device. A Device Configuration Preview window opens. |
Posted: Tue Nov 12 12:31:10 PST 2002
All contents are Copyright © 1992--2002 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.