Managing Configuration Templates with APM

Managing Configuration Templates with APM
Creating a Custom Configuration Template
Deleting a Custom Configuration Template
Configuration Job Status
Example—Configuring a Cisco AccessPath-LS3 System

Managing Configuration Templates with APM

The Cisco AccessPath Manager (APM) Configuration Template Manager allows you to manage APM default and custom configuration templates.

APM configuration templates are text files that contain Cisco IOS command-line interface (CLI) commands and template variables. APM creates configuration files to download to the devices in your AccessPath system by substituting data for the template variables based on your entries:

In Create Stack or Stack Modify—see Chapter 3, "Configuring AccessPath Stacks Using APM."
In Shelf Add or Shelf Modify—see Chapter 4, "Configuring AccessPath Shelves Using APM."

There are two types of templates:

Default configuration templates—Read-only templates provided with APM to generate most of the configurations for AccessPath-TS and AccessPath-TS3 systems. In most cases, your answers during Create Stack and Shelf Add will provide all the information that will be needed for APM to populate these default templates and download the completed configuration files to your AccessPath shelves.

See Table 5-1 for a complete list of APM default configuration templates. See Appendix C, "Default Configuration Templates," for complete versions of the default configuration templates included with APM.

Custom configuration templates—Customer-created templates designed to add or change functionality built into the default templates. You can create these templates by editing the default configuration templates and saving them with different file names. To use APM to download (to your AccessPath system) configuration files that are different from the file(s) APM generates automatically using its default configuration templates, you must create custom configuration templates.

Note While you can create or modify a custom configuration template, you cannot create or modify the variables that come as part of the APM default configuration templates. These variables are written in all capital letters and preceded by a pound sign (#). You may add or delete any CLI code, including CLI code that contains APM variables, but you may not edit these variables or create new ones.

All of the CLI code entered into a custom configuration template must be written in valid Cisco IOS syntax or the AccessPath shelf will reject the command when APM downloads the shelf's configuration file.

If you want to download configuration files from APM to an AccessPath-LS3 system, you will need to create a custom configuration template for the Cisco 3640. See the section "ExampleConfiguring a Cisco AccessPath-LS3 System".

The basic tasks you can perform using the Configuration Template Manager include:

This chapter concludes with an example of creating and using a custom configuration template, "ExampleConfiguring a Cisco AccessPath-LS3 System".

Table 5-1 lists the default configuration templates for each type of AccessPath platform.

Table 5-1 APM Default Configuration Templates

System	Template	Supports
Cisco AccessPath-TS	Cisco 2511 (2511-default)	Cisco 2511
	Cisco 7206 (7206-default)	Cisco 7206 using a Catalyst 5000 for switching
	Cisco AS5200 (as5200-default-channelized)	Cisco AS5200s using channelized T1 or E1
	Cisco AS5200 (as5200-default-pri)	Cisco AS5200s using PRI
	Catalyst 5000 (cat5k-default)	Catalyst 5000
Cisco AccessPath-TS3	Cisco 3640 (3640-default)	Cisco 3640
	Cisco 7206 without Catalyst 5002 (7206-default-entry)	Cisco 7206 using two Switch Blade cards for switching
	Cisco 7206 with Catalyst 5002 (7206-default-midhigh)	Cisco 7206 using a Catalyst 5002 for its primary switching path
	Cisco AS5300 (as5300-default-channelized)	Cisco AS5300s using channelized T1 or E1
	Cisco AS5300 (as5300-default-pri)	Cisco AS5200s using PRI
	Catalyst 5002 (cat5002-default)	Catalyst 5002

Creating a Custom Configuration Template

To create a custom configuration template:

Step 1 Open the Template Manager. Click Configure, then Template Manager, then Execute. The Configuration Template screen appears. (See Figure 5-1.)

Figure 5-1 Configuration Template Manager Screen

Step 2 Open the template you would like to use as the basis of your custom template.

(a). Use the pull-down menu in the Template Manager to select the device type. Valid choices include 2511, 3640, 7206, 7206_ENTRY, 7206_MIDHIGH, AS5200, AS5300, CAT5K, and All. Figure 5-1 shows the Configuration Template Manager screen with All selected.

(b). Click Open. APM will open the template in an editor to allow you to modify it. (See Figure 5-2.)

Figure 5-2 Configuration Template Editor

Step 3 Make any modifications you would like to the template.

Step 4 Edit the name field to give this template a new name and the description field to give this template a new description. Click Save As.

Step 5 (Optional.) Click the Back button on your browser to go back to the list of templates. Click the Update button in the Template Manager window to view the list of templates that includes the template you just created.

The template you have created can now be used to configure AccessPath shelves using Shelf Add or Shelf Modify. (See Chapter 4, "Configuring AccessPath Shelves Using APM.")

Deleting a Custom Configuration Template

If you delete a custom configuration template you will not be able to recover it.

Step 1 Open the Template Manager. Click Configure, then Template Manager, then Execute. The Configuration Template screen appears. (See Figure 5-1.)

Note You can delete any customized template, but you cannot delete a default template.

Step 2 Select the custom template you would like to delete. Use the pull-down menu in the Template Manager to select the device type of the custom template, then select the specific custom template you want to delete.

Step 3 Click Delete.

Step 4 (Optional.) Click the Back button on your browser to go back to the list of templates. Click the Update button in the Template Manager window to view the list of templates that no longer includes the template you just deleted.

Configuration Job Status

This panel provides a summary of APM job status. Information on two kinds of jobs can be displayed:

Scheduled Configuration Jobs—You can view information on these jobs and/or cancel them.
Running/Queued Configuration Jobs—These jobs are either running or already in the queue; they cannot be deleted.

To view job status, click Configure, then Config Job Status, then Execute.

To refresh the display for Scheduled Configuration Jobs, click Refresh.

To view a list of jobs that are currently waiting or actively running in the APM job queue, click Running/Queued Jobs.

To delete a scheduled configuration job, select the single job you would like to delete and click Delete Job Now.

Note Jobs that were scheduled to run in the recent past (in the last 72 hours) or jobs scheduled to run soon (within the next 5 minutes) cannot be deleted using the Delete Job Now button. This prevents attempts to delete jobs midstream.

The information provided in the Scheduled Configuration Jobs screen is as follows:

Table 5-2 Scheduled Configuration Jobs Information

Field	Description
Job #	Identifier used by APM to uniquely identify scheduled configuration jobs.
Job Type	Type of configuration job.
Run Time	Time this job is scheduled to run, that is, when it will become a running/queued job. Time is shown in the format: MM/DD HH:MM. Year—Year when the download will take place. The first valid year is 1998. Month—Month when the download will take place. Values are 1-12. Day—Day when the download will take place. Values are 1-31. Hour—Hour when the download will take place. Values are 0-23, with 0 being midnight. Minute—Minute when the download will take place. Values are 0-59.
Stack Name	User-defined named of the stack on which this process will be run.
Shelf #	Number of the shelf on which this process will be run. This field only applies to shelf-specific operations. Stack-level processes, such as Modify Stack will be described as n/a.

Example—Configuring a Cisco AccessPath-LS3 System

To be able to download configuration files to an AccessPath-LS3 system, you must complete the following steps.

Note In order to use APM to configure your AccessPath-LS3, we recommend that you install your AccessPath-LS3 system according to the instructions in the documents Cisco AccessPath-LS3 Integrated Access System Hardware Installation and Configuration and Cisco AccessPath-LS3 Integrated Access System Software Configuration. In addition, you must have the Cisco AccessPath-LS3 management network segment and system controller option, as described in the Cisco AccessPath-LS3 documentation.

This procedure is not required to do monitoring or reporting on the AccessPath-LS3 system, only to download configurations to the AccessPath-LS3 shelves from APM. If you only want to do monitoring and reporting, you need only to make sure that the SNMP community and loopback1 IP addresses are correctly configured in the AccessPath-LS3 devices. See the Cisco AccessPath-LS3 documentation.

Step 1 Create a custom configuration template for the Cisco 3640.

(a). Click Configure, then Template Manager, then Execute.

(b). Use the pull-down menu in the Template Manager to select the device type 3640.

(c). Select the Cisco 3640 default configuration template 3640-default. You will base your custom template on this default template. Click Open. APM will open the template in an editor to allow you to modify it. (See Figure 5-3.)

Figure 5-3 Configuration Template Screen with Cisco 3640 (3640-default) Template Loaded

(d). Change the line:

 
interface Ethernet1/1

to:

 
interface Fa2/0

(e). Toward the end of the template and just after the SNMP server commands, you will find the line:

 
line 1 32

Change it to read:

 
line 1 16

(f). Edit the name field to give this template a new name and the description field to give this template a new description. Click Save As.

(g). (Optional.) Click the Back button on your browser to go back to the list of Cisco 3640 templates. Click the Update button in the Template Manager window to view the list of Cisco 3640 templates that includes the template you just created.

Step 2 Create a new stack. (See the section "Creating or Modifying a Stack" in Chapter 3, "Configuring AccessPath Stacks Using APM.")

When asked to choose a stack type, choose AP-TS3 (AS5300-based with optional Catalyst 5002).

Step 3 Add shelves to the stack. (See the section "Adding or Modifying a Shelf" in Chapter 4, "Configuring AccessPath Shelves Using APM.")

(a). Add the Cisco 3640 to the stack. When you are asked to choose a configuration template, select the custom configuration template you created for the Cisco 3640 (see Figure 4-4 and Table 4-8).

(b). Add the Cisco AS5300(s) to the stack.

Note Do not add the Cisco 7206 or Catalyst 5002 to the stack, as they are not part of the Cisco AccessPath-LS3 system.

The configurations will download to the devices in your Cisco AccessPath-LS3 system when you configured them to do so.

Table of Contents