Managing Device Configuration Operations
The
Cisco Prime Network 4.3.1 Customization Guide
explains how to use Command Manager and Command Builder to create commands and command scripts. Commands can range from simple show commands to wizards with multiple pages and input methods such as check boxes and drop-down lists. Once you create these command scripts, you can add them to the Vision GUI client. Users with the required privileges can run the commands by right-clicking an NE’s
Commands
menu. Depending on a user’s device scope and access role, they can also launch commands from the Command Manager command repository.
To create more complex workflows and activations, use Transaction Manager and the Extended Development Environment (XDE) Eclipse SDK. After creating a transaction using XDE, you can execute it using Transaction Manager or the NBI.
These topics describe administrative tasks for managing command scripts and transactions:
Check for Executed Transactions and Command Scripts
Transactions can be executed from the Transaction Manager GUI or from the NBI. Once a transaction is executed (or a transaction is scheduled), you can view it in the Transaction Manager Jobs window. You can also get information on executed scripts from the Provisioning tab in the Events GUI client.
To open the jobs window for Transaction Manager or Command Manager:
Step 1 Launch Change and Configuration Management. (Transaction Manager is launched from CCM.)
https://
gateway-I
P:8043/ccmweb/ccm/tabs.htm?
Step 2 Choose either
Transaction Manager > Jobs
or
Command Manager > Jobs
. All jobs are listed, regardless of whether they were successful.
From here you can do the following.
|
Choose this from the job window:
|
Check which users have executed or scheduled jobs
|
Choose a user from the Users drop-down list.
|
View job details such as the commands that were executed, the job output, the cause of a job failure, the devices that were affected, and so forth
|
Select a job and click the hyperlink in the Status column.
|
Change the job status: Cancel, Suspend, Resume, and so forth
|
Select a job and click the appropriate button
|
Filter jobs by devices, users, status, dates, and so forth
|
Use the filter at the top of the window
|
Transaction jobs are saved according to the job purging settings. See Purging Jobs. By default, no jobs are purged.
Adding a Warning Message to Command Scripts
If desired, you can configure Prime Network to display a warning message whenever users execute command scripts from these features:
-
A device’s right-click
Commands
menu in the Vision GUI client (applies to commands that are executed immediately and commands that are scheduled)
-
Command Manager repository
Users must acknowledge the message before proceeding. Figure 10-1 provides an example of what a user would see when trying to launch a device command from the Vision GUI client.
Figure 10-1 User Message When Running Command Scripts
This feature is disabled by default. To enable it and specify a message, choose
Global Settings > Commands
, enable the feature, and enter the message text you want Prime Network to display.
Adding Credential Requirements to Device Configuration Operations
You can configure Prime Network to require users to enter their device credentials when they perform device configuration operations using these features:
-
A device’s right-click
Commands
menu in the Vision GUI client (applies only to commands that are immediately executed; does not apply to scheduled commands)
-
Transaction Manager
-
Change and Configuration Management (includes Compliance Audit)
The username is also added to Provisioning and Audit events.
This mode is disabled by default. See Configuring Global User Permissions: Account Inactivity, Device Credential Requirements, and Global Job Scheduling.
Tracking Device Configuration Events
The following table provides ways you can get historical information on issues related to device configuration operations.
For historical events related to:
|
|
Information on executed device configuration operations
|
Provisioning tab in the Events GUI client
Detailed Provisioning events report (
Reports > Run Report > Events Reports
>
Detailed Network Events > Detailed Provisioning Events
)
Detailed Audit events report (
Reports > Run Report > Events Reports
>
Detailed Network Events > Detailed Audit Events
)
AVM and other appropriate log files (see Log Files Reference)
|