User Guide for the CiscoWorks WLSE and WLSE Express, 2.11
Using WLSM Templates

Table Of Contents

Using WLSM Templates

What is a Configuration Template?

Viewing the Existing Templates

Creating a Template

Copying a Template

Editing a Template

Deleting a Template

Importing a Template

Exporting a Template

Template Choices

Naming the Template

Using the Server Manager

Adding a Server Manager

Deleting a Server Manager

Configuring Custom Values

Previewing the Template

Saving the Template


Using WLSM Templates


The WLSE allows you to view, create, copy, edit, and delete WLSM (Wireless LAN Services Module) configuration templates and apply them.

The topics covered are:

What is a Configuration Template?

Viewing the Existing Templates

Creating a Template

Copying a Template

Editing a Template

Deleting a Template

Importing a Template

Exporting a Template

Template Choices

Related Topics

Using Wizard Templates

Managing Configuration Jobs

What is a Configuration Template?

You can think of a configuration template as a configuration update file for an WLSM. This file might contain the update for only one parameter or a complete configuration.

WLSM-based templates are stored as text files containing IOS commands.

You can use the Configure > Templates option to:

View existing templates—SeeViewing the Existing Templates

Create a configuration template—See Creating a Template

Copy an existing template—See Copying a Template

Edit an existing template—See Editing a Template

Delete a template—See Deleting a Template

Import a template—See Importing a Template

Export a template—Exporting a Template

Viewing the Existing Templates

Use this option to create a configuration template.


Note Your login determines whether you can use this option.


Procedure


Step 1 Select Configure > Templates. The Templates dialog box appears.

Step 2 From the list, select the type of templates you want to display, then click Filter.

Step 3 The selected template types are displayed in the Existing Templates table.


Creating a Template

Use this option to create a configuration template.


Note Your login determines whether you can use this option.


Procedure


Step 1 Select Configure > Templates. The Templates dialog box appears.

Step 2 From the list, select WLSM.

Step 3 Enter a unique name. See Naming Guidelines for details.

Step 4 Click New. The window refreshes with the Template Creation menu in the left pane and the Template Name dialog box in the right pane.

Step 5 Select the choices in the left pane to create a configuration template. For a description, see Template Choices.


Copying a Template

Use this option to copy a configuration template that you can use as a base for another template.


Note Your login determines whether you can use this option.


Procedure


Step 1 Select Configure > Templates. The Templates dialog box appears.

Step 2 Select the template you want to copy from the Existing Templates table, then click Copy. A dialog box appears asking you to enter a name for the copy.

Step 3 Enter a unique name. See Naming Guidelines for details.

Step 4 Click OK. The Templates window refreshes and the new name appears in the Existing Templates table.

Step 5 Select the template, then click Edit. See Editing a Template.


Editing a Template

Use this option to edit a configuration template.


Note Your login determines whether you can use this option.


Procedure


Step 1 Select Configure > Templates. The Templates dialog box appears.

Step 2 Select the template you want to edit from the Existing Templates table, then click Edit. The window refreshes with Template Creation menu in the left pane and the Template Name dialog box in the right pane.

Step 3 Select the choices in the Template Menu to create a configuration template. For a description, see Template Choices.


Deleting a Template

Use this option to delete a configuration template.


Note Your login determines whether you can use this option.


Procedure


Step 1 Select Configure > Templates. The Templates dialog box appears.

Step 2 Select the template you want to delete from the Existing Templates table, then click Delete. A window appears asking if you want to delete the template.


Note You cannot delete a template if it used in a scheduled job.


Step 3 Click OK to delete it.


Importing a Template

Use this option to import a configuration to the WLSE, either from a file or from a device. You can import files from devices that are not managed by the WLSE.

When you import a configuration from a WLSM, the imported configuration options are displayed in the Custom Values template screen.


Note Your login determines whether you can use this option.


Procedure


Step 1 Select Configure > Templates. The Templates dialog box appears.

Step 2 Click Import. The Import Template window appears and varies depending upon which type you selected.

Step 3 Complete the following:

Field
Description

Template Name

If you are importing from a file, enter a new name for the template or leave the entry blank to use the imported template name.

If you are importing from a device, you must enter a template name.

Description

Enter a description for the template.

Do not click the Enter key at the end of the description; it will generate an error.

From file

Enter the template filename or browse to find the file, then click Import.

From device (IP Address)

Enter a device name or IP address, then click Import.

Non-IP-Identity

Select this option if you do not want to download identity parameters, such as IP address.

Some parameters are ignored using this type of import. The downloaded configuration parameters are not a full representation of the configuration but an optimal representation.

Full

Select this option to import a full configuration from the WLSM.

This type of import includes the identity parameters, such as sysname, IP address, etc.

When using this option, it is recommended you delete all the custom key values from the imported template before applying the template to any device.

Device HTTP Credentials

User Name

If the device is not managed by the WLSE, or if the device is managed but the credentials have not been set, enter the username on the WLSM.

User Password

If the device is not managed by the WLSE, enter the user password on the WLSM.


Step 4 To import another template, click Back and go to Step 2.

Step 5 When you are finished, click Done.

Step 6 View the template you imported by selecting Configure > Templates and selecting it in the Existing Templates table.


Exporting a Template

Use this option to export a configuration template to your local drive.


Note Your login determines whether you can use this option.


Procedure


Step 1 Select Configure > Templates. The Templates dialog box appears.

Step 2 Select a template name from Existing Templates, then click Export. The Export Template window appears.

Step 3 From the list, select the template you want to export, then click Export. The Export Template to Desktop window appears with the name of the template.

Step 4 Right-click on the template name, select Save As, and enter the location to save the template.

Step 5 Click Done.


Template Choices

When you create or edit a WLSM configuration template, the following choices appear in the left pane of the Templates window:

1. Template Name—See Naming the Template.

2. Template Categories


Note Any or all of the template categories can be completed in any order.


Server Manager—See Using the Server Manager.

Custom Values—See Configuring Custom Values.

3. Preview—See Previewing the Template.

4. Save—See Saving the Template.

Naming the Template

This option enables to you to name the template.

Procedure


Note Clicking Clear removes all the entries you have made so far and returns you to the Template Name page. Clicking Reset clears only the entries you have made on that page and restores the defaults, if any were set.



Step 1 Select Template Name. The Template Name dialog box appears:

Field
Description

Template Name

Enter a name for the template.

See Naming Guidelines.

Description

Enter a description of the purpose of the template.

See Naming Guidelines.

Do not click the Enter key at the end of the description; it will generate an error.


Step 2 Select a template category. For additional information, see Template Categories.


Using the Server Manager

Use this option to enter authentication settings. The RADIUS server on our network uses EAP to provide authentication service for wireless client devices.

You can:

Add a server manager—See Adding a Server Manager.

Delete a server manager—See Deleting a Server Manager.

Adding a Server Manager

Procedure


Step 1 Select Server Manager. The Server Manager dialog box displays in the right pane:


Note Clicking Clear removes all the entries you have made so far and returns you to the Template Name page. Clicking Reset clears only the entries you have made on that page and restores the defaults, if any were set.


Step 2 Complete the following:

Table 7-1 Adding Server Manager 

Field
Description

Radius Servers

Current Server List

Lists the servers that are currently configured.

To delete a server from the list, select it, then click Delete.

Server

Enter the hostname or IP address for the RADIUS server.

Authentication Port

Enter the port number your server uses for authentication.

Accounting Port

Enter the port number your server uses for accounting.

Shared Secret

Enter the shared secret used by your server.


Step 3 Click Save. The server is added to the Current Server List.

Step 4 Select one of the following:

Preview to see your changes before you apply them. See Previewing the Template.

Save to save the template. See Saving the Template.

Another template category to configure more options. See Template Categories.


Deleting a Server Manager


Step 1 Complete the following:

Table 7-2 Deleting Server Manager 

Field
Description

Delete Servers

Delete Server List

Lists the servers to be deleted.

To remove a server from the list, select it, then click Delete.

Delete Server

Enter the hostname or IP address for the RADIUS server to be deleted.

Authentication Port

Enter the port number the server uses for authentication.

Accounting Port

Enter the port number the server uses for accounting.


Step 2 Click Add Server to Delete List. The server appears in the Delete Server List.

Step 3 Select one of the following:

Preview to see your changes before you apply them. See Previewing the Template.

Save to save the template. See Saving the Template.

Another template category to configure more options. See Template Categories.


Configuring Custom Values

TThis option enables you to enter custom values that might not be available in the Template Menu. It also allows you to quickly enter a value, if you know the exact value you want to change, instead of going through the menu.


Note Any custom values you configure, are applied to the device only after all the other template configurations have been applied.



Note This option should be used only by advanced users.


Custom values are not validated. However, if a configuration contains a combination of custom values and values entered using the templates, the values entered using the templates are validated; only the values entered with the custom configuration are not.

Procedure


Step 1 Select Custom Values. The Custom IOS Commands dialog box appears.


Note Clicking Clear removes all the entries you have made so far and returns you to the Template Name page. Clicking Reset clears only the entries you have made on that page and restores the defaults, if any were set.



Note If the custom value you enter is the same as an existing one in the Template Menu, the custom value will override the value in the menu.


Step 2 Enter the IOS commands.

Step 3 Select one of the following:

Preview to see your changes before you apply them. See Previewing the Template.

Save to save the template. See Saving the Template.

Another template category to configure more options. See Template Categories.


Previewing the Template

Procedure


Step 1 Click Preview. A Command Preview window displays the configuration choices you have made to the template.

Step 2 Click Save. See Saving the Template.


Saving the Template

When you save a template, the WLSE first validates the template and displays the valid Device Type (WLSM), and the corresponding Device Version(s) for that template.

Procedure


Step 1 Click Save in the left pane to complete creating a template. The Save dialog box appears in the right pane.

Step 2 Click Save to create the template.

Step 3 Do one of the following:

Click Yes if you want to save the template then schedule a configuration job.

The window refreshes to the Job Creation window and a job is automatically created for you using the template name and a random number. See Selecting Devices.

Click No if you want to save the template only.

Click Cancel to cancel the operation and then display the previous screen.