Cisco Configuration Engine Administration Guide 3.5
image
Downloads: This chapterpdf (PDF - 202.0KB) The complete bookPDF (PDF - 5.91MB) | Feedback

Image Service

Table Of Contents

Image Service

Working with Images

Viewing an Image

Adding an Image

Editing an Image

Deleting an Image

Associating Images with Devices

Search Parameters

Viewing Search Parameters

Creating Search Parameters

Editing Search Parameters

Deleting Search Parameters


Image Service


This chapter describes Image Service management tasks. To access the Image Service feature, click the Image Service tab. The Image Service Functional Overview page appears showing:

Images

Search Parameters


Note For External Directory Mode, the Search Parameters tab is called Preconditions.


Working with Images

From the Image Service Functional Overview page, click Images. The Images Functional Overview page appears showing:

View Image

Create Image

Edit Image

Delete Image

Associate Image with Device(s)

Viewing an Image


Step 1 From the Images Functional Overview page, click View Image.

The list of images to view appears (see Figure 18-1).

Figure 18-1 View Image List

Step 2 From the Name column, select the image you want to view.

The image information appears (see Figure 18-2).

Figure 18-2 View Image Information


Adding an Image


Step 1 From the Image Service Functional Overview page, click Create Image.

The Create Image page appears (see Figure 18-3).

Figure 18-3 Create Image

There are two methods for creating an Image Object:

Manual data entry

To enter image information manually, jump to Step 2.


Timesaver You can get image attributes for manual entry by clicking the link: Lookup image attributes from Cisco.com.


Automatic data entry

a. In the Image Location field, enter a valid URL for the desired image.

b. Click Populate.

Step 2 Enter the name of the image used by Image Service to identify this image object in the Name field.

Table 18-1 shows valid values for these attributes.

Table 18-1 Valid Values for Create Image 

Attribute
Description
Valid Values

Name

The name used my Image Services to identify this image object.

a-z

A-Z
0-9
#
_ (under-score)
- (hyphen)

Image Name

The actual Image name.

a-z
A-Z

0-9
- (hyphen)

Version

Version of the image.

a-z
A-Z
0-9
. (period)
( (open braces)
) (close braces)

Platform Family

Platform family of the image.

a-z
A-Z

0-9
- (hyphen)

Image Checksum

Checksum generated by MD5 hashing algorithm

128-bit hex number

Size

File size

0 - 9

Description

Description of the image.

Any text except Ctrl characters.

Image Type

(i) PDM

(ii) QDM

(iii) VDM

(iv) Other

(v) Pix-image

From drop-down list.

Image Location

- Any Valid URL:

(i) http

(ii) https

(iii) ftp

(iv) tftp

- rcp

Valid URL as per RFC 1738.


Step 3 Enter the actual image name in the Image Name field.

Step 4 Enter the version of the image in the Version field.

Step 5 Enter the name of the platform family in the Platform Family field.

Step 6 Enter the image checksum for the image in the Image Checksum field.

Step 7 Enter the size of this file in the Size field.

Step 8 Enter a description of the image in the space provided.

Step 9 Select an image type from the Image Type drop-down list.

Step 10 Enter a valid URL for the image location in the Image Location field.

Follow the proper syntax as described.


Note You can create an image without specifying a location. You can add a location later by using the Edit Image function.


Step 11 To add another row for image location, click Add Another Row.

You can locate multiple copies of an image on separate servers. This allows you to do load-sharing when updating a large number of devices. Each device in a large group can be associated with a copy of the image (see"Adding Devices" section on page 3-5) located at one of many server locations.

Step 12 To cancel this task, click Cancel.

Step 13 To create this image, click Create.


Editing an Image


Step 1 From the Image Service Functional Overview page, click Edit Image.

The Edit Image page appears (see Figure 18-4).

Figure 18-4 Edit Image

Step 2 Select the image you want to edit by clicking the Image Name.

The Edit Image information page appears (see).

Figure 18-5 Edit Image Information

Step 3 To edit the image name, enter a new value in the Name field.

Table 18-2 Valid Values for Edit Image 

Attribute
Description
Valid Values

Name

The name used my Image Services to identify this image object.

a-z

A-Z
0-9
#
_ (under-score)
- (hyphen)

Image Location

- Any Valid URL:

(i) http

(ii) https

(iii) ftp

(iv) tftp

- rcp

Valid URL as per RFC 1738.


Step 4 To edit the image location, enter a valid URL in the Image Location field.

Step 5 To cancel this task, click Cancel.

Step 6 To make these changes, click Edit.


Deleting an Image


Step 1 From the Image Service Functional Overview page, click Delete Image.

The Delete Image page appears (see Figure 18-6).

Figure 18-6 Delete Image

Step 2 Check the image(s) you want to delete.

Step 3 To cancel this task, click Cancel.

Step 4 To make these changes, click Delete.


Associating Images with Devices


Note To associate a device with the image, the device must have been registered for image service during device object creation by providing an ImageID. If this has not been done, before trying to associate the device, the device must be edited and an ImageID must be provided.



Step 1 From the Image Service Functional Overview page, click Associate Image with Device(s).

The Associate Image with Device(s) page appears (see Figure 18-7).

Figure 18-7 Associate Image with Device(s)

Step 2 Select the image from the Name drop-down list.

The Image Type field and Image Location drop-down box are populated with corresponding information for the image.

Step 3 From the Image Location drop-down list, select the desired location.

Step 4 In the Destination field, enter a valid URL where the image will be copied.

For example:

disk0:/c7200-mz

Step 5 To assign this image to be the active image after distribution, check Set this image as the Image to be activated on device.

Step 6 To cancel this task, click Cancel.

Step 7 To continue, click Next.

The Group list page appears.

Step 8 To associate this image with a group of devices, check the group, then click Submit.

Step 9 To associate this image with specific devices, click View.

The Device list page appears (see Figure 18-8).

Figure 18-8 Device List

Step 10 Check the desired device(s).

Step 11 To cancel this task, click Cancel.

Step 12 To associate this image to the selected devices, click Submit.

A confirmation page appears.


Search Parameters

Each Search Parameter can be associated with an action to be performed. In this release, Search Parameters are associated with the action to delete certain files from the file system on a device.

For example, if you want to delete all files that contain .bin from a device, you can create a Search Parameter that states: FileName contains .bin and use this Precondition from the Devices > Delete Files.

From the Image Service Functional Overview page, click Search Parameters.


Note For External Directory Mode, the Search Parameters tab is called Preconditions.


The Search Parameters Functional Overview page appears showing:

View Search Parameters

Create Search Parameter

Edit Search Parameter

Delete Search Parameters

Viewing Search Parameters


Step 1 From the Search Parameters Functional Overview page, click View Search Parameters.

The View Search Parameters page appears (see Figure 18-9).

Figure 18-9 View Search Parameters

Step 2 To edit a Precondition, click Edit for the desired Precondition, then go to "Editing Search Parameters" section.


Creating Search Parameters


Step 1 From the Search Parameters Functional Overview page, click Create Search Parameter.

The Create Search Parameter page appears (see Figure 18-10).

Figure 18-10 Create Search Parameter

Step 2 Enter the name of this Search Parameter.

Step 3 Use the drop-down arrow in the left Content menu to select:

File Size

File Name

File Timestamp

a. For File Size, use the drop-down arrow in the center Content menu to select:

is greater than

is less than

is equal to

b. For File Name, the only choice is contains.

c. For File Timestamp, the only choice is before.

Step 4 Enter the remaining portion of the argument in the right Content field.

For example:

File Size is greater than 80,000 bytes

Step 5 To cancel this task, click Cancel.

Step 6 Click Create.


Editing Search Parameters


Step 1 From the Search Parameters Functional Overview page, click Edit Search Parameter.

The Edit Search Parameter page appears.

Step 2 Select the Search Parameter you want to edit.

The argument page for the Search Parameter appears (see Figure 18-11).

Figure 18-11 Edit Search Parameter Argument

Step 3 Edit the name or argument as required.

Step 4 To cancel this task, click Cancel.

Step 5 To save your changes, click Edit.


Deleting Search Parameters


Step 1 From the Search Parameters Functional Overview page, click Delete Search Parameter.

The Delete Search Parameters page appears (see Figure 18-12).

Figure 18-12 Delete Search Parameters

Step 2 Check to select the Search Parameter(s) to delete, then click Delete.