CiscoWorks Wireless LAN Solution Engine (WLSE)

Document ID: 41888

Contents

Introduction
Prerequisites
      Requirements
      Components Used
      Conventions
Backing up the WLSE
      Backing Up the WLSE from the GUI
      Backing Up the WLSE From the CLI
Related Information

Introduction

This document shows how to back up the Wireless LAN Solution Engine (WLSE) prior to an upgrade.

Prerequisites

Requirements

There are no specific prerequisites for this document.

Components Used

The information in this document is based on the software and hardware versions, WLSE 1.0 through 1.3.1.

Conventions

For more information on document conventions, refer to the Cisco Technical Tips Conventions.

Backing up the WLSE

Before you upgrade, you should backup the WLSE. The WLSE 1.3 upgrade attempts to preserve the WLSE database, but you must backup if something goes wrong with the upgrade.

Data backed up includes:

• WLSE role and user information

• discovery configuration information

• other configuration information

The WLSE backs up its configuration and database to an FTP server. You can perform the backup from the WLSE GUI or CLI.

With both the CLI and GUI backup methods, the WLSE creates a directory on the FTP server, named by concatenating the WLSE hostname with a time and date stamp. There are two files inside the directory—a tar ball archive and .inf file—each with the same name as the directory. The file names are hostname_date_time.tar and hostname_date_time.inf, respectively.

Before you can use a Windows 2000 or Windows XP system for backups, you must configure it for UNIX directory mode as follows:

1. On the server, select Start->Settings->Control Panel->Administrative Tools -> Internet Services Manager. If this option is not available on the server, enable it as follows:

   1. Select Start > Settings > Control Panel > Add/Remove Programs.

   2. On the left side of the Add/Remove window, click Add/Remove Windows Components. The Windows Components wizard starts.

   3. Check the checkbox for Internet Information Services.

   4. Click Next and complete the screens for the install.

2. If IIS is installed, from the Tree panel on the left side of the window, select the Windows 2000 or Windows XP system name.

   1. In the Description panel, verify that the State for Default FTP Site shows as Running.

   2. Right-click Default FTP Site and select Properties.

   3. Under the Home Directory tab perform these steps:

      • Under FTP Site Directory, verify that Write box is checked

      • Under Directory Listing Style, select the UNIX radio button

      • Click Apply/OK to save the changes.

Backing Up the WLSE from the GUI

To configure the FTP server in the WLSE GUI perform these steps:

1. Login as admin.

2. Navigate to Administration->Appliance->Backup and Restore->Configure

3. Enter these values:

   • Hostname or IP address of the FTP server

   • Appropriate username and passwords

   • Path to the FTP directory if other than the default of the FTP server

4. Click Save to complete the backup FTP server configuration.

5. Navigate to Administration->Appliance->Backup and Restore->Backup

6. Click Backup. A warning screen displays stating that the WLSE needs to shutdown the Tomcat servlet engine to complete the backup.

7. At the warning screen, select OK to start the backup.

8. Once the backup is complete, login to the WLSE again.

   Note: It can take a few minutes for the servlet engine to reinitialize. During this time, you can see web page errors. After a few minutes, you have full WLSE GUI access.

   Note: The time required for a WLSE backup is related to the amount of data to backup and network latency between the WLSE and the FTP server. The backup may take 10-15 minutes if there are several hundred devices across a LAN.

Backing Up the WLSE From the CLI

To backup the WLSE using the CLI, perform these steps:

1. Login to the console as an administrative user, typically admin.

2. Use the backupconfig command to configure the backup FTP server. The command syntax is:

   backupconfig {hostname} {username} {password} [directory]
   
   

   where:

   • hostname is the hostname or IP address of the FTP server where backup data is saved.

   • username is a valid username on the FTP server.

   • password is the password for the above username.

   • directory parameter is only required if the backup location is not in the FTP root directory (optional)

   admin@wlse:show backupconfig 
    Hostname: 172.16.96.44 
    Username: cse 
    Directory: /var/tmp
   

3. Next do a show backupconfig to verify that the values are taken correctly by the WLSE:

   admin@wlse:show backupconfig 
    Hostname: 172.16.96.44 
    Username: cse 
    Directory: /var/tmp 
   

4. Perform a backup test to verify that the WLSE accesses the target location with the username/password defined to write the data. If this fails, then the backup fails. A failed test indicates that either the username/password is incorrect or that you do not have permissions to write at the target location/directory.

   admin@wlse:backup test 
    Test OK
   

5. If the result is anything but Test OK, then the backup fails.

   Perform a backup for the actual backup. The length of time the backup takes to complete depends upon the quantity of data requiring backup and network latency between the WLSE and FTP server. If there are several hundred devices on the LAN the backup can take 10-15 minutes. During this time, there is no status indicator available in the CLI. Once the backup is completed, the backup file name displays and the CLI prompt becomes available.

    admin@wlse:backup 
   
    backupfile:  wlse_12162002_140840.tar wlse_12162002_140840.inf 
   
    admin@wlse: 
   
   

Related Information

• Technical Support - Cisco Systems