|
|
An ACL job definition is a set of devices and commands associated with the devices that you must download to reconfigure the devices. With the ACL Manager scheduling mechanism, you can schedule the download—immediately or at a specified date and time.
A scheduled job is sent to the server; and when the scheduled time arrives, the server downloads the configuration changes to the affected devices. Alternatively, you can save the configuration changes as files on the server and use them for any purpose, including manually changing the device configuration.
These topics describe how to use the Downloader and the Job Browser:
You can use the Schedule Config Download Job dialog box to select devices and schedule downloads.
If you have not yet started ACL Manager, you need to display the Schedule Config Download Job dialog box using the following procedure.
Step 1 Select ACL Management > Schedule Donwloads from Essentials to display the Schedule Downloads dialog box (see Figure 8-1).
Step 2 Select a scenario, then select Read config from Device to synchronize the Config Archive with the devices in the scenario (get the configuration file). The Schedule Config Download Job dialog box appears (see Figure 8-2).
If you are already in the ACL Manager main window, do one of the following to display the Schedule Config Download Job dialog box:
ACL Downloader toolbar icon.
Preparing to download an ACL job is a four-step process:
1. Select the devices.
2. Select the download options to apply.
3. Verify the configuration changes to be downloaded.
4. Schedule the download.
When an ACL job is scheduled on a scenario, a copy of the scenario is made to avoid conflicting changes. The only operation you can perform on the scenario is to view it in ACL Manager Job Browser (as described in "Viewing a Downloaded Job Scenario").
Use the Schedule Config Download Job dialog box to prepare the download and select the devices to be downloaded.
The Schedule Config Download Job dialog box displays all devices that you modified in the current scenario.
Step 1 Using the Add and Remove buttons, select the devices to which you want to download the ACLs and ACL Uses (and meta-information such as comments and template include statements).
Enter the job description and select the download options in the Schedule Config Download Job dialog box.
Step 1 Enter a job description in the Job Description field. Use a description you can locate easily if you want to browse the job status later.
Step 2 If the device download order does not matter, select the Download in Parallel check box. (The download will proceed more quickly). If the order is important, ensure that the check box is not selected. The order of the download will be the order in which the devices appear in the right column.
Step 3 To copy the running configuration to the router's startup files after the download is complete, select Write to NVRAM.
Step 4 To attempt to revert to the router's original configuration if an error occurs during the download, select Rollback. Any changes made before the error occurred will be removed. (Rollback is selected automatically if you select Abort on Error.)
Step 5 To revert to the router's original configuration, remove any changes, and abort the download if an error occurs, select Abort on Error. An attempt will be made to revert router configurations back to their original state.
Use the Schedule Config Download Job dialog box to schedule the download.
Step 1 Specify the Download Schedule:
Use the Diffs feature in the Schedule Config Download Job dialog box to verify the configuration changes.
Step 1 Before downloading the changes you made in your scenario, verify them by clicking Diffs. The Config Diff View dialog box displays the modified objects to be downloaded (see Figure 8-3).
Step 2 If you are satisfied with the changes, click Close.
Step 3 Confirm your choice by clicking OK in the Schedule Config Download Job dialog box. If you have not saved the scenario, a message asks whether you want to save it.
Step 4 Click OK to save the scenario. A new window displays the IDs of the jobs scheduled.
Step 5 Click OK to dismiss the dialog box.
You can use the Job ID to track the status of the job. ACL Manager alerts you if there is a problem with a job schedule time or if the scenario has not been saved.
You can use the Schedule Config Download Job dialog box to save your configuration changes as files on the server without downloading them.
Step 1 To display the Schedule Config Download Job dialog box, select one of the following:
The Schedule Config Download Job dialog box displays a list of all devices you modified (see Figure 8-2).
Step 2 Using the Add and Remove buttons, select the router(s) to which the ACLs are to be downloaded.
Step 3 Select Save to Disk to save the router configuration files to a standard disk directory without doing a job download.
Step 4 Do one of the following:
Step 5 To verify the configuration changes, select one or more devices, then click Diffs. (Refer to "Verifying the Configuration Changes.")
Step 6 To save the configuration files on the server, click Ok.
The configuration files are saved in the output directory specified during the ACL Manager (server) installation:
Contact your system administrator for access to these directories.
If you decide to proceed with the download, start a new download. Refer to "Selecting Devices and Scheduling Downloads."
The ACL Manager Job Browser displays job status and results. The Job Browser also provides device-level details about a job.
Step 1 To display the Job Browser dialog box, select one of the following:
The Job Browser dialog box displays all scheduled jobs (see Figure 8-5).
Step 2 To display jobs filtered by Job Status or Job User, make your selection, then click Refresh.
The Job Browser dialog box contains the following columns:
| Column | Description |
|---|---|
Job ID | A unique number assigned to this task at creation time. This number is never reused. |
Job Status | The current state or last run result of the job. |
Description | The information you entered in the Job Description field of the Schedule Config Download Job dialog box. |
Scheduled At | The date and time the job is scheduled to run. |
Finish Time | The date and time the job completed. |
User | The name of the user who created the job. |
Scenario | The name of the job scenario you created from the scenario whose changes were downloaded. |
The Job Status column can display the following values:
| Status | Meaning |
|---|---|
PENDING | Job has not started, or is running. |
CANCELLED | Job was canceled by user. |
ABORTED | Job was aborted by server. |
FAILED | Download failed on all devices. Click Results to obtain more information. |
PARTIAL_SUCCESS | Download failed on one or more devices. Click Results to obtain more information. |
SUCCESS | Job downloaded successfully on all devices. |
Step 3 To view the job status by device, select the job then click Results. The Job Results window displays the status for all devices for that job (see Figure 8-6).
The Status column can have the following values:
| Status | Meaning |
|---|---|
DOWNLOAD_VERIFY_FAILED | Download configuration does not match device configuration (device became stale after download started). |
PRE_DOWNLOAD_FAILURE | Device is stale before download started. |
ROLLBACK_FAILED | Download failed, then the attempt to rollback to previous configuration failed. |
DOWNLOAD_FAILED | All other download failures. |
Step 4 Click Device Results to obtain detailed information about the device (see Figure 8-7).
When you create a job, the server creates a read-only copy of the job scenario. Using the Job Manager, you can view scenarios for both pending or completed jobs.
Step 1 To display the Job Browser dialog box (see Figure 8-5), select one of the following:
Step 2 Highlight the job whose associated scenario you want to view, then click Open. The ACL Manager main window appears, displaying the contents of the specified scenario (see Figure 8-8).
You can edit and resubmit scheduled jobs that have or have not been completed using the ACL Manager Job Browser.
You can resubmit a job that has not completed by rescheduling it using the Job Browser.
Step 1 To display the Job Browser dialog box, select one of the following:
Step 2 Select the uncompleted job, then click Edit. The Schedule Config Download Job dialog box appears, displaying the job details.
Step 3 Change the download options, schedule the date and time, and click OK.
You can resubmit a job that failed or was successfully completed by using the Job Browser and the ACL Downloader.
Step 1 To display the Job Browser dialog box, select one of the following:
Step 2 Select the job to resubmit, then click Edit. The Schedule Config Download Job dialog box appears, displaying the details of the selected job.
Step 3 Change the download options, schedule a date and time, and click OK.
To cancel a scheduled ACL job or purge old ACL jobs, use the ACL Manager Job Browser. All completed jobs displayed by the Job Browser remain until you remove them.
Step 1 To display the Job Browser dialog box, select one of the following:
Step 2 Select the jobs you want to cancel or purge.
Step 3 Click Delete.
A download can fail for a number of reasons. Two of the more common reasons are:
If your download fails, perform the following:
Step 1 Back up the scenario containing your edits and the STALE device under a different name by selecting File > Save Scenario As from the ACL Manager main window.
Step 2 Reopen the original scenario.
Step 3 Refresh any stale devices and save the scenario.
Step 4 Open the backup scenario.
Step 5 Copy the data from the device.
Step 6 Switch to the original scenario and paste the data back to the device.
Step 7 Download your changes to the device, as described in "Selecting Devices and Scheduling Downloads."
Posted: Fri Sep 29 08:26:12 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.