Cisco Wireless LAN Controller Configuration Guide, Release 7.5
Managing Controller Software and Configurations
Downloads: This chapterpdf (PDF - 1.71MB) The complete bookPDF (PDF - 17.88MB) | The complete bookePub (ePub - 4.41MB) | Feedback

Managing Controller Software and Configurations

Contents

Managing Controller Software and Configurations

Upgrading the Controller Software

When you upgrade the controller software, the software on the access points associated with the controller is also automatically upgraded. When an access point is loading software, each of its LEDs blinks in succession. Up to 10 access points can be concurrently upgraded from the controller.


Caution


Do not power down the controller or any access point during this process; otherwise, you might corrupt the software image. Upgrading a controller with a large number of access points can take as long as 30 minutes, depending on the size of your network. However, with the increased number of concurrent access point upgrades supported in the controller software release, the upgrade time should be significantly reduced. The access points must remain powered, and the controller must not be reset during this time.


Restrictions for Upgrading Controller Software

  • If you require a downgrade from one release to another, you might lose the configuration from your current release. The workaround is to reload the previous controller configuration files saved on the backup server or to reconfigure the controller.
  • It is not possible to directly upgrade to this release from a release that is older than 6.0.182.0.
  • You can upgrade or downgrade the controller software only between certain releases. In some instances, you must first install an intermediate release prior to upgrading to the latest software release.
  • When you upgrade the controller to an intermediate software release, you must wait until all of the access points that are associated with the controller are upgraded to the intermediate release before you install the latest controller software. In large networks, it can take some time to download the software on each access point.
  • When you upgrade to the latest software release, the software on the access points associated with the controller is also automatically upgraded. When an access point is loading software, each of its LEDs blinks in succession.
  • We recommend that you access the controller GUI using Microsoft Internet Explorer 6.0 SP1 (or a later release) or Mozilla Firefox 2.0.0.11 (or a later release).
  • Cisco controllers support standard SNMP Management Information Base (MIB) files. MIBs can be downloaded from the Software Center on Cisco.com.
  • The controller software is factory installed on your controller and automatically downloaded to the access points after a release upgrade and whenever an access point joins a controller. We recommend that you install the latest software version available for maximum operational benefit.
  • We recommend that you install Wireless LAN Controller Field Upgrade Software for Release 1.7.0.0-FUS, which is a special AES package that contains several system-related component upgrades. These include the bootloader, field recovery image, and FPGA/MCU firmware. Installing the FUS image requires special attention because it installs some critical firmware. The FUS image is independent of the runtime image. For more information, see http:/​/​www.cisco.com/​en/​US/​docs/​wireless/​controller/​release/​notes/​fus_​rn_​1_​7_​0_​0.html.
  • Ensure that you have a TFTP or FTP server available for the software upgrade. Follow these guidelines when setting up a TFTP or FTP server:
    • Ensure that your TFTP server supports files that are larger than the size of the controller software release. Some TFTP servers that support files of this size are tftpd32 and the TFTP server within the Cisco Prime Infrastructure. If you attempt to download the controller software and your TFTP server does not support files of this size, the following error message appears: “TFTP failure while storing in flash.”
    • If you are upgrading through the distribution system network port, the TFTP or FTP server can be on the same or a different subnet because the distribution system port is routable
  • When you plug a controller into an AC power source, the bootup script and power-on self-test run to initialize the system. During this time, you can press Esc to display the bootloader Boot Options Menu. The menu options for the 5500 and Flex 7500 series controllers are different than for other controller platforms.
    Bootloader menu for 5500 Series Controllers:
    Boot Options
    Please choose an option from below:
     1. Run primary image
     2. Run backup image
     3. Change active boot image
     4. Clear Configuration
     5. Format FLASH Drive
    	6. Manually update images
    Please enter your choice:
    
    
    Bootloader menu for other controller platforms:
    Boot Options
    Please choose an option from below:
     1. Run primary image
     2. Run backup image
     3. Manually update images
     4. Change active boot image
     5. Clear Configuration 
    Please enter your choice:
    
    
    Enter 1 to run the current software, enter 2 to run the previous software, enter 4 (on a 5500 series controller), or enter 5 (on another controller platform) to run the current software and set the controller configuration to factory defaults. Do not choose the other options unless directed to do so.

    Note


    See the Installation Guide or the Quick Start Guide for your controller for more details on running the bootup script and power-on self-test.


  • Control which address(es) are sent in CAPWAP discovery responses when NAT is enabled on the Management Interface using the following command: config network ap-discovery nat-ip-only {enable | disable}
    where
    • enable—Enables use of NAT IP only in Discovery response. This is the default. Use this command if all APs are outside of the NAT gateway.
    • disable—Enables use of both NAT IP and non-NAT IP in discovery response. Use this command if APs are on the inside and outside of the NAT gateway; for example, Local Mode and OfficeExtend APs on the same controller.

    Note


    To avoid stranding APs, you must disable AP link-latency (if enabled) before you use the disable option for the config network ap-discovery nat-ip-only command. To disable AP link-latency, use the config ap link-latency disable all command.


  • You can configure 802.1p tagging by using the config qos dot1p-tag {bronze | silver | gold | platinum} tag. For the 7.2.103.0 and later releases, if you tag 802.1p packets, the tagging has impact only on wired packets. Wireless packets are impacted only by the maximum priority level set for QoS.
  • You can reduce the network downtime using the following options:
    • You can predownload the AP image.
    • For FlexConnect access points, use the FlexConnect Efficient AP upgrade feature to reduce traffic between the controller and the AP (main site and the branch).
  • Do not power down the controller or any access point during the upgrade process; otherwise, you might corrupt the software image. Upgrading a controller with a large number of access points can take as long as 30 minutes, depending on the size of your network. However, with the increased number of concurrent access point upgrades supported, the upgrade time should be significantly reduced. The access points must remain powered, and the controller must not be reset during this time.
  • If you want to downgrade to a previous release, do either of the following:
    • Delete all WLANs that are mapped to interface groups and create new ones.
    • Ensure that all WLANs are mapped to interfaces rather than interface groups.
  • After you perform these functions on the controller, you must reboot the controller for the changes to take effect:
    • Enable or disable link aggregation (LAG)
    • Enable a feature that is dependent on certificates (such as HTTPS and web authentication)
    • Add new or modify existing SNMP v3 users
    • Modify an existing SNMP v3 engine ID
    • Add a new license or modify an existing license
    • Increase the priority for a license
  • The controller bootloader stores a copy of the active primary image and the backup image. If the primary image becomes corrupted, you can use the bootloader to boot with the backup image. With the backup image stored before rebooting, be sure to choose Option 2: Run Backup Image from the boot menu to boot from the backup image. Then, upgrade with a known working image and reboot the controller.
  • The recovery image provides a backup image that can be used if an access point power-cycles during an image upgrade. The best way to avoid the need for access point recovery is to prevent an access point from power-cycling during a system upgrade. If a power-cycle occurs during an upgrade to an oversized access point image, you can recover the access point using the TFTP recovery procedure.
    To recover the access point using the TFTP recovery procedure, follow these steps:
    1. Download the required recovery image from Cisco.com (c1100-rcvk9w8-mx, c1200-rcvk9w8-mx, or c1310-rcvk9w8-mx) and install it in the root directory of your TFTP server.
    2. Connect the TFTP server to the same subnet as the target access point and power-cycle the access point. The access point boots from the TFTP image and then joins the controller to download the oversized access point image and complete the upgrade procedure.
    3. After the access point has been recovered, you can remove the TFTP server.
  • You can upgrade to a new release of the controller software or downgrade to an older release even if Federal Information Processing Standard (FIPS) is enabled.

Upgrading Controller Software (GUI)


    Step 1   Upload your controller configuration files to a server to back them up.
    Note   

    We highly recommend that you back up your configuration files of the controller prior to upgrading the controller software. Otherwise, you must manually reconfigure the controller.

    Step 2   Get the controller software image by following these steps:
    1. Browse to the Cisco Software Center: http:/​/​www.cisco.com/​cisco/​software/​navigator.html.
    2. Choose Wireless > Wireless LAN Controller.

      The following options are available: Integrated Controllers and Controller Modules and Standalone Controllers.

    3. Depending on your controller platform, click one of the above options.
    4. Click the controller model number or name. The Download Software page is displayed.
    5. Click a controller software release. The software releases are labeled as follows to help you determine which release to download:

      Early Deployment (ED)—These software releases provide new features, new hardware platform support, and bug fixes.

      Maintenance Deployment (MD)—These software releases provide bug fixes and ongoing software maintenance.

      Deferred (DF)—These software releases have been deferred. We recommend that you migrate to an upgraded release.

    6. Choose a software release number.
    7. Click the filename (filename.aes).
    8. Click Download.
    9. Read Cisco’s End User Software License Agreement and then click Agree.
    10. Save the file to your hard drive.
    11. Repeat steps a through k to download the remaining file.
    Step 3   Copy the controller software image (filename.aes) to the default directory on your TFTP or FTP server.
    Step 4   (Optional) Disable the 802.11 networks.
    Note   

    For busy networks, controllers on high utilization, or small controller platforms, we recommend that you disable the 802.11 networks as a precautionary measure.

    Step 5   Disable any WLANs on the controller.
    Step 6   Choose Commands > Download File to open the Download File to Controller page.
    Step 7   From the File Type drop-down list, choose Code.
    Step 8   From the Transfer Mode drop-down list, choose from the following options:
    • TFTP
    • FTP
    • SFTP (available in 7.4 and later releases)
    Step 9   In the IP Address text box, enter the IP address of the server.

    If you are using a TFTP server, the default values of 10 retries and 6 seconds for the Maximum Retries and Timeout text boxes should work correctly without any adjustment. However, you can change these values.

    Step 10   If you are using a TFTP server, the default values of 10 retries for the Maximum Retries text field, and 6 seconds for the Timeout text field should work correctly without any adjustment. However, you can change these values if desired. To do so, enter the maximum number of times that the TFTP server attempts to download the software in the Maximum Retries text box and the amount of time (in seconds) that the TFTP server attempts to download the software in the Timeout text box.
    Step 11   In the File Path text box, enter the directory path of the software.
    Step 12   In the File Name text box, enter the name of the controller software file (filename.aes).
    Step 13   If you are using an FTP server, follow these steps:
    1. In the Server Login Username text box, enter the username to log into the FTP server.
    2. In the Server Login Password text box, enter the password to log into the FTP server.
    3. In the Server Port Number text box, enter the port number on the FTP server through which the download occurs. The default value is 21.
    Step 14   Click Download to download the software to the controller. A message appears indicating the status of the download.
    Step 15   After the download is complete, click Reboot.
    Step 16   If prompted to save your changes, click Save and Reboot.
    Step 17   Click OK to confirm.
    Step 18   After the controller reboots, repeat step 6 to step 17 to install the remaining file.
    Step 19   Reenable the WLANs.
    Step 20   For Cisco WiSM2, reenable the controller port channel on the Catalyst switch.
    Step 21   If you have disabled the 802.11 networks in Step 4, reenable them.
    Step 22   To verify the controller software version, choose Monitor on the controller GUI and see Software Version in the Controller Summary area.

    Upgrading Controller Software (CLI)


      Step 1   Upload your controller configuration files to a server to back them up.
      Note   

      We highly recommend that you back up your controller's configuration files prior to upgrading the controller software. Otherwise, you must manually reconfigure the controller.

      Step 2   Get the controller software image by following these steps:
      1. Browse to the Cisco Software Center: http:/​/​www.cisco.com/​cisco/​software/​navigator.html.
      2. Choose Wireless > Wireless LAN Controller.

        The following options are available: Integrated Controllers and Controller Modules and Standalone Controllers.

      3. Depending on your controller platform, click one of the above options.
      4. Click the controller model number or name. The Download Software page is displayed.
      5. Click a controller software release. The software releases are labeled as follows to help you determine which release to download:

        Early Deployment (ED)—These software releases provide new features, new hardware platform support, and bug fixes.

        Maintenance Deployment (MD)—These software releases provide bug fixes and ongoing software maintenance.

        Deferred (DF)—These software releases have been deferred. We recommend that you migrate to an upgraded release.

      6. Choose a software release number.
      7. Click the filename (filename.aes).
      8. Click Download.
      9. Read Cisco’s End User Software License Agreement and then click Agree.
      10. Save the file to your hard drive.
      11. Repeat steps a through k to download the remaining file.
      Step 3   Copy the controller software image (filename.aes) to the default directory on your TFTP or FTP server.
      Step 4   (Optional) Disable the 802.11 networks.
      Note   

      For busy networks, controllers on high utilization, or small controller platforms, we recommend that you disable the 802.11 networks as a precautionary measure.

      Step 5   Disable any WLANs on the controller (using the config wlan disable wlan_id command).
      Step 6   Log onto the controller CLI.
      Step 7   Enter the ping server-ip-address command to verify that the controller can contact the TFTP or FTP server.
      Step 8   View current download settings by entering the transfer download start command. Answer n to the prompt to view the current download settings.
      Step 9   Change the download settings, if necessary by entering these commands:
      • transfer download mode {tftp | ftp | sftp}
      • transfer download datatype code
      • transfer download serverip server-ip-address
      • transfer download filename filename
      • transfer download path server-path-to-file
        Note   

        Pathnames on a TFTP or FTP server are relative to the server’s default or root directory. For example, in the case of the Solaris TFTP server, the path is “/”.

      If you are using a TFTP server, also enter these commands:

      • transfer download tftpMaxRetries retries
      • transfer download tftpPktTimeout timeout
        Note   

        The default values of 10 retries and a 6-second timeout should work correctly without any adjustment. However, you can change these values. To do so, enter the maximum number of times that the TFTP server attempts to download the software for the retries parameter and the amount of time (in seconds) that the TFTP server attempts to download the software for the timeout parameter.

      If you are using an FTP server, also enter these commands:

      • transfer download username username
      • transfer download password password
      • transfer download port port
        Note   

        The default value for the port parameter is 21.

      Step 10   View the current updated settings by entering the transfer download start command. Answer y to the prompt to confirm the current download settings and start the software download.
      Step 11   Save the code update to nonvolatile NVRAM and reboot the controller by entering this command: reset system

      The controller completes the bootup process.

      Step 12   After the controller reboots, repeat Steps 6 through 11 to install the remaining file.
      Step 13   Reenable the WLANs by entering this command:

      config wlan enable wlan_id

      Step 14   For Cisco WiSMs, re-enable the controller port channel on the Catalyst switch.
      Step 15   If you have disabled the 802.11 networks in Step 4, renable them.
      Step 16   To verify the controller software that is installed, enter the show sysinfo command and see Product Version.
      Step 17   To verify the Cisco Unified Wireless Network Controller Boot Software file that is installed on the controller, enter the show sysinfo command on the controller CLI and see Recovery Image Version or Emergency Image Version.
      Note   

      If a Cisco Unified Wireless Network Controller Boot Software ER.aes file is not installed, Recovery Image Version or Emergency Image Version show 'N/A.'


      Predownloading an Image to an Access Point

      To minimize a network outages, you can now download an upgrade image to the access point from the controller without resetting the access point or losing network connectivity. Previously, you would download an upgrade image to the controller and reset it, which causes the access point to go into discovery mode. After the access point discovers the controller with the new image, the access point downloads the new image, resets, goes into discovery mode, and rejoins the controller.

      You can now download the upgrade image to the controller and then download the image to the access point while the network is still up. You can also schedule a reboot of the controller and access points, either after a specified amount of time or at a specific date and time. When both devices are up, the access point discovers and rejoins the controller.

      Access Point Predownload Process

      The access point predownload feature works as follows:

      • The controller image is downloaded.
        • The primary image becomes the backup image of the controller and the downloaded image becomes the new primary image. Change the current boot image as the backup image by using the config boot backup command to ensure that if a system failure occurs, the controller boots with the last working image of the controller.
        • To switch over to the new downloaded image, start predownload of the upgraded image using the config ap image predownload primary all command.
        • The upgrade image is downloaded as the backup image on the access points. You can verify this by using the show ap image all command.
        • Change the boot image to primary image manually using the config boot primary command and reboot the controller for the upgrade image to be activated. or
        • You issue a scheduled reboot with the swap keyword. The swap keyword has the following importance: The swapping occurs to the primary and backup images on the access point and the currently active image on controller with the backup image.
        • When the controller reboots, the access points are disassociated and eventually come up with an upgraded image. Once the controller responds to the discovery request sent by an access point with its discovery response packet, the access point sends a join request.
      • The actual upgrade of the images occur. The following sequence of actions occur:
        • During boot time, the access point sends a join request.
        • The controller responds with the join response with the image version that the controller is running.
        • The access point compares its running image with the running image on the controller. If the versions match, the access point joins the controller.
        • If the versions do not match, the access point compares the version of the backup image and if they match, the access point swaps the primary and backup images and reloads and subsequently joins the controller.
        • If the primary image of the access point is the same as the controller image, the access point reloads and joins the controller.
        • If none of the above conditions are true, the access point sends an image data request to the controller, downloads the latest image, reloads, and joins the controller.

      Restrictions for Predownloading an Image to an Access Point

      • The maximum number of concurrent predownloads is limited to half the number of concurrent normal image downloads. This limitation allows new access points to join the controller during image downloading. If you reach the predownload limit, then the access points that cannot get an image sleep for a time between 180 to 600 seconds and then reattempt the predownload.
      • Before you predownload, you should change the active controller boot image to the backup image to ensure that if the controller reboots for some reason, it comes back up with the earlier running image, not the partially downloaded upgrade image.
      • Access points with 16-MB total available memory (1130 and 1240 access points) may not have enough free memory to download an upgrade image and may automatically delete crash info files, radio files, and any backup images to free up space. However, this limitation does not affect the predownload process because the predownload image replaces any backup image on the access point.
      • When the system time is changed by using the config time command, the time set for a scheduled reset is not valid and the scheduled system reset is canceled. You are given an option either to cancel the scheduled reset before configuring the time or retain the scheduled reset and not configure the time.
      • All the primary, secondary, and tertiary controllers should run the same images as the primary and backup images. That is, the primary image of all three controllers should be X and the secondary image of all three controllers should be Y or the feature is not effective.
      • At the time of the reset, if any AP is downloading the controller image, the scheduled reset is canceled. The following message appears with the reason why the scheduled reset was canceled:
        
        %OSAPI-3-RESETSYSTEM_FAILED: osapi_task.c:4458 System will not reset as software is being upgraded.
        
      • Predownloading a 7.2 or later version of image on a Cisco Aironet 1240 access point is not supported when upgrading from a previous controller release. If predownloading is attempted to the Cisco Aironet 1240 access point, the AP gets disconnected.

      Predownloading an Image to Access Points—Global Configuration (GUI)


        Step 1   Upload your controller configuration files to a server to back them up.
        Note   

        We highly recommend that you back up your controller's configuration files prior to upgrading the controller software. Otherwise, you must manually reconfigure the controller.

        Step 2   Follow these steps to obtain the controller software:
        1. Browse to the Cisco Software Center: http:/​/​www.cisco.com/​cisco/​software/​navigator.html
        2. Choose Wireless from the center selection window.
        3. Click Wireless LAN Controllers.

          The following options are available: Integrated Controllers and Controller Modules and Standalone Controllers.

        4. Depending on your controller platform, click one of the above options.
        5. Click the controller model number or name. The Download Software page is displayed.
        6. Click a controller software release. The software releases are labeled as follows to help you determine which release to download:

          Early Deployment (ED)—These software releases provide new features, new hardware platform support, and bug fixes.

          Maintenance Deployment (MD)—These software releases provide bug fixes and ongoing software maintenance.

          Deferred (DF)—These software releases have been deferred. We recommend that you migrate to an upgraded release.

        7. Choose a software release number.
        8. Click the filename (filename.aes).
        9. Click Download.
        10. Read Cisco’s End User Software License Agreement and then click Agree.
        11. Save the file to your hard drive.
        12. Repeat steps a through k to download the remaining file.
        Step 3   Copy the controller software file (filename.aes) to the default directory on your TFTP or FTP server.
        Step 4   (Optional) Disable the controller 802.11X networks.
        Note   

        For busy networks, controllers on high utilization, or small controller platforms, we recommend that you disable the 802.11X networks as a precautionary measure.

        Step 5   For Cisco WiSM2, shut down the controller port channel on the Catalyst switch to allow the controller to reboot before the access points start downloading the software.
        Step 6   Disable any WLANs on the controller.
        Step 7   Choose Commands > Download File to open the Download File to Controller page.
        Step 8   From the File Type drop-down list, choose Code.
        Step 9   From the Transfer Mode drop-down list, choose from the following options:
        • TFTP
        • FTP
        • SFTP (available in 7.4 and later releases)
        Step 10   In the IP Address text box, enter the IP address of the server.

        If you are using a TFTP server, the default values of 10 retries and 6 seconds for the Maximum Retries and Timeout text boxes should work correctly without any adjustment. However, you can change these values.

        Step 11   Enter the maximum number of times that the TFTP server attempts to download the software in the Maximum Retries text box and the amount of time (in seconds) that the TFTP server attempts to download the software in the Timeout text box.
        Step 12   In the File Path text box, enter the directory path of the software.
        Step 13   In the File Name text box, enter the name of the controller software file (filename.aes).
        Step 14   If you are using an FTP server, follow these steps:
        1. In the Server Login Username text box, enter the username to log into the FTP server.
        2. In the Server Login Password text box, enter the password to log into the FTP server.
        3. In the Server Port Number text box, enter the port number on the FTP server through which the download occurs. The default value is 21.
        Step 15   Click Download to download the software to the controller. A message appears indicating the status of the download.
        Step 16   To configure the predownloading of access point images globally, choose Wireless > Access Points > Global Configuration to open the Global Configuration page.
        Step 17   In the AP Image Pre-download section, perform one of the following:
        • To instruct all the access points to predownload a primary image from the controller, click Download Primary under the AP Image Pre-download.
        • To instruct all the access points to swap their primary and backup images, click Interchange Image.
        • To download an image from the controller and store it as a backup image, click Download Backup.
        • To abort the predownload operation, click Abort Predownload.
        Step 18   Click OK.
        Step 19   Click Apply.

        Configuring Predownload Image to an Access Point (GUI)


          Step 1   Upload your controller configuration files to a server to back them up.
          Note   

          We highly recommend that you back up your controller's configuration files prior to upgrading the controller software. Otherwise, you must manually reconfigure the controller.

          Step 2   Follow these steps to obtain the controller software:
          1. Browse to the Cisco Software Center: http:/​/​www.cisco.com/​cisco/​software/​navigator.html
          2. Select Wireless from the center selection window.
          3. Click Wireless LAN Controllers.

            The following options are available: Integrated Controllers and Controller Modules and Standalone Controllers.

          4. Depending on your controller platform, click one of the above options.
          5. Click the controller model number or name. The Download Software page is displayed.
          6. Click a controller software release. The software releases are labeled as follows to help you determine which release to download:

            Early Deployment (ED)—These software releases provide new features, new hardware platform support, and bug fixes.

            Maintenance Deployment (MD)—These software releases provide bug fixes and ongoing software maintenance.

            Deferred (DF)—These software releases have been deferred. We recommend that you migrate to an upgraded release.

          7. Choose a software release number.
          8. Click the filename (filename.aes).
          9. Click Download.
          10. Read Cisco’s End User Software License Agreement and then click Agree.
          11. Save the file to your hard drive.
          12. Repeat steps a through k to download the remaining file.
          Step 3   Copy the controller software file (filename.aes) to the default directory on your TFTP or FTP server.
          Step 4   (Optional) Disable the 802.11 networks.
          Note   

          For busy networks, controllers on high utilization, or small controller platforms, we recommend that you disable the 802.11 networks as a precautionary measure.

          Step 5   For Cisco WiSM2, shut down the controller port channel on the Catalyst switch to allow the controller to reboot before the access points start downloading the software.
          Step 6   Disable any WLANs on the controller.
          Step 7   Choose Commands > Download File to open the Download File to Controller page.
          Step 8   From the File Type drop-down list, choose Code.
          Step 9   From the Transfer Mode drop-down list, choose from the following options:
          • TFTP
          • FTP
          • SFTP (available from the 7.4 release onwards
          Step 10   In the IP Address text box, enter the IP address of the TFTP or FTP server.

          If you are using a TFTP server, the default values of 10 retries and 6 seconds for the Maximum Retries and Timeout text boxes should work correctly without any adjustment. However, you can change these values.

          Step 11   Enter the maximum number of times that the TFTP server attempts to download the software in the Maximum Retries text box and the amount of time (in seconds) that the TFTP server attempts to download the software in the Timeout text box.
          Step 12   In the File Path text box, enter the directory path of the software.
          Step 13   In the File Name text box, enter the name of the controller software file (filename.aes).
          Step 14   If you are using an FTP server, follow these steps:
          1. In the Server Login Username text box, enter the username to log into the FTP server.
          2. In the Server Login Password text box, enter the password to log into the FTP server.
          3. In the Server Port Number text box, enter the port number on the FTP server through which the download occurs. The default value is 21.
          Step 15   Click Download to download the software to the controller. A message appears indicating the status of the download.
          Step 16   To configure the predownloading of a specific access point, choose Wireless > All APs > AP_Name to open the All AP Details page for the selected AP.
          Step 17   Click the Advanced tab.
          Step 18   In the AP Image Pre-download section, perform one of the following:
          • To instruct the access point to predownload a primary image from the controller, click Download Primary under the AP Image Pre-download.
          • To instruct the access point to swap its primary and backup images, click Interchange Image.
          • To download an image from the controller and store it as a backup image, click Download Backup.
          • To abort the predownload operation, click Abort Predownload.
          Step 19   Click OK.
          Step 20   Click Apply.

          Predownloading an Image to Access Points (CLI)

          Using the CLI, you can predownload an image to a specific access point or to all access points.


            Step 1   Follow these steps to obtain the controller software:
            1. Browse to the Cisco Software Center: http:/​/​www.cisco.com/​cisco/​software/​navigator.html
            2. Select Wireless from the center selection window.
            3. Click Wireless LAN Controllers.

              The following options are available: Integrated Controllers and Controller Modules and Standalone Controllers.

            4. Depending on your controller platform, click one of the above options.
            5. Click the controller model number or name. The Download Software page is displayed.
            6. Click a controller software release. The software releases are labeled as follows to help you determine which release to download:

              Early Deployment (ED)—These software releases provide new features, new hardware platform support, and bug fixes.

              Maintenance Deployment (MD)—These software releases provide bug fixes and ongoing software maintenance.

              Deferred (DF)—These software releases have been deferred. We recommend that you migrate to an upgraded release.

            7. Choose a software release number.
            8. Click the filename (filename.aes).
            9. Click Download.
            10. Read Cisco’s End User Software License Agreement and then click Agree.
            11. Save the file to your hard drive.
            12. Repeat steps a through n to download the remaining file.
            Step 2   Copy the controller software file (filename.aes) to the default directory on your TFTP or FTP server.
            Step 3   (Optional) Disable the 802.11 networks.
            Note   

            For busy networks, controllers on high utilization, or small controller platforms, we recommend that you disable the 802.11a/n or 802.11b/g/n networks as a precautionary measure.

            Step 4   For Cisco WiSM2, shut down the controller port channel on the Catalyst switch to allow the controller to reboot before the access points start downloading the software.
            Step 5   Disable any WLANs on the controller using the config wlan disable wlan_id command.
            Step 6   Specify access points that will receive the predownload image.

            Use one of these commands to specify access points for predownload:

            • Specify access points for predownload by entering this command: config ap image predownload {primary | backup} {ap_name | all} The primary image is the new image; the backup image is the existing image. Access points always boot with the primary image.
            • Swap an access point’s primary and backup images by entering this command: config ap image swap {ap_name | all}
            • Display detailed information on access points specified for predownload by entering this command: show ap image {all | ap-name}

            The output lists access points that are specified for predownloading and provides for each access point, primary and secondary image versions, the version of the predownload image, the predownload retry time (if necessary), and the number of predownload attempts. The output also includes the predownload status for each device. The status of the access points is as follows:

            • None—The access point is not scheduled for predownload.
            • Predownloading—The access point is predownloading the image.
            • Not supported—The access point (1120, 1230, and 1310) does not support predownloading.
            • Initiated—The access point is waiting to get the predownload image because the concurrent download limit has been reached.
            • Failed—The access point has failed 64 predownload attempts.
            • Complete—The access point has completed predownloading.
            Step 7   Set a reboot time for the controller and the access points.

            Use one of these commands to schedule a reboot of the controller and access points:

            • Specify the amount of time delay before the devices reboot by entering this command: reset system in HH:MM:SS image {swap | no-swap} reset-aps [save-config]
              Note   

              The swap operand in the reset command will result in the swapping of the primary and backup images on both the controller and the access point.

              The controller sends a reset message to all joined access points, and then the controller resets.

            • Specify a date and time for the devices to reboot by entering this command: reset system at YYYY-MM-DD HH:MM:SS image {swap | no-swap} reset-aps [save-config] The controller sends a reset message to all joined access points, and then the controller resets.
              Note   

              The swap operand in the reset command will result in the swapping of the primary and backup images on both the controller and the access point.

            • Set up an SNMP trap message that announces the upcoming reset by entering this command: reset system notify-time minutes The controller sends the announcement trap the configured number of minutes before the reset.
            • Cancel the scheduled reboot by entering this command: reset system cancel
              Note   

              If you configure reset times and then use the config time command to change the system time on the controller, the controller notifies you that any scheduled reset times will be canceled and must be reconfigured after you set the system time.

            Use the show reset command to display scheduled resets.

            Information similar to the following appears:

            
            System reset is scheduled for Apr 08 01:01:01 2010.
            Current local time and date is Apr 07 02:57:44 2010.
            A trap will be generated 10 minutes before each scheduled system reset.
            Use 'reset system cancel' to cancel the reset.
            Configuration will be saved before the system reset.
            
            

            Transferring Files to and from a Controller

            Controllers have built-in utilities for uploading and downloading various files. Follow the instructions in these sections to import files using either the controller GUI or CLI:

            Downloading a Login Banner File

            You can download a login banner file using either the GUI or the CLI. The login banner is the text that appears on the page before user authentication when you access the controller GUI or CLI using Telnet, SSH, or a console port connection.

            You save the login banner information as a text (*.txt) file. The text file cannot be larger than 1296 characters and cannot have more than 16 lines of text.


            Note


            The ASCII character set consists of printable and nonprintable characters. The login banner supports only printable characters.


            Here is an example of a login banner:

            
            Welcome to the Cisco Wireless Controller!
            Unauthorized access prohibited.
            Contact sysadmin@corp.com for access.

            

            Follow the instructions in this section to download a login banner to the controller through the GUI or CLI. However, before you begin, make sure that you have a TFTP or FTP server available for the file download. Follow these guidelines when setting up a TFTP or FTP server:

            • If you are downloading through the service port, the TFTP or FTP server must be on the same subnet as the service port because the service port is not routable, or you must create static routes on the controller.
            • If you are downloading through the distribution system network port, the TFTP or FTP server can be on the same or a different subnet because the distribution system port is routable.
            • A third-party TFTP or FTP server cannot run on the same computer as Cisco Prime Infrastructure because the Prime Infrastructure built-in TFTP or FTP server and the third-party TFTP or FTP server require the same communication port.

              Note


              Clearing the controller configuration does not remove the login banner. See the Clearing the Login Banner (GUI) section for information about clearing the login banner using the controller GUI or CLI.



              Note


              The controller can have only one login banner file. If you download another login banner file to the controller, the first login banner file is overwritten.


            Downloading a Login Banner File (GUI)


              Step 1   Copy the login banner file to the default directory on your server.
              Step 2   Choose Commands > Download File to open the Download File to Controller page.
              Step 3   From the File Type drop-down list, choose Login Banner.
              Step 4   From the Transfer Mode drop-down list, choose from the following options:
              • TFTP
              • FTP
              • SFTP (available in 7.4 and later releases)
              Step 5   In the IP Address text box, enter the IP address of the server type you chose in Step 4.

              If you are using a TFTP server, the default values of 10 retries and 6 seconds for the Maximum Retries and Timeout text boxes should work correctly without any adjustment. However, you can change these values.

              Step 6   Enter the maximum number of times that the TFTP server attempts to download the certificate in the Maximum Retries text box and the amount of time (in seconds) that the TFTP server attempts to download the certificate in the Timeout text box.
              Step 7   In the File Path text box, enter the directory path of the login banner file.
              Step 8   In the File Name text box, enter the name of the login banner text (*.txt) file.
              Step 9   If you are using an FTP server, follow these steps:
              1. In the Server Login Username text box, enter the username to log into the FTP server.
              2. In the Server Login Password text box, enter the password to log into the FTP server.
              3. In the Server Port Number text box, enter the port number on the FTP server through which the download occurs. The default value is 21.
              Step 10   Click Download to download the login banner file to the controller. A message appears indicating the status of the download.

              Downloading a Login Banner File (CLI)


                Step 1   Log into the controller CLI.
                Step 2   Specify the transfer mode used to download the config file by entering this command:

                transfer download mode {tftp | ftp | sftp}

                Step 3   Download the controller login banner by entering this command:

                transfer download datatype login-banner

                Step 4   Specify the IP address of the TFTP or FTP server by entering this command:

                transfer download serverip server-ip-address

                Step 5   Specify the name of the config file to be downloaded by entering this command:

                transfer download path server-path-to-file

                Step 6   Specify the directory path of the config file by entering this command:

                transfer download filenamefilename.txt

                Step 7   If you are using a TFTP server, enter these commands:
                • transfer download tftpMaxRetries retries
                • transfer download tftpPktTimeout timeout
                  Note   

                  The default values of 10 retries and a 6-second timeout should work correctly without any adjustment. However, you can change these values. To do so, enter the maximum number of times that the TFTP server attempts to download the software for the retries parameter and the amount of time (in seconds) that the TFTP server attempts to download the software for the timeout parameter.

                Step 8   If you are using an FTP server, enter these commands:
                • transfer download username username
                • transfer download password password
                • transfer download port port
                  Note   

                  The default value for the port parameter is 21.

                Step 9   View the download settings by entering the transfer download start command. Enter y when prompted to confirm the current settings and start the download process.

                Clearing the Login Banner (GUI)


                  Step 1   Choose Commands > Login Banner to open the Login Banner page.
                  Step 2   Click Clear.
                  Step 3   When prompted, click OK to clear the banner.

                  To clear the login banner from the controller using the controller CLI, enter the clear login-banner command.


                  Downloading Device Certificates

                  Each wireless device (controller, access point, and client) has its own device certificate. For example, the controller is shipped with a Cisco-installed device certificate. This certificate is used by EAP-FAST (when not using PACs), EAP-TLS, PEAP-GTC, and PEAP-MSCHAPv2 to authenticate wireless clients during local EAP authentication. However, if you want to use your own vendor-specific device certificate, it must be downloaded to the controller.


                  Note


                  For more information about configuring local EAP, see the Configuring Local EAP section.


                  Follow the instructions in this section to download a vendor-specific device certificate to the controller through the GUI or CLI. However, before you begin, make sure you have a TFTP or FTP server available for the certificate download. Follow these guidelines when setting up a TFTP or FTP server:

                  • If you are downloading through the service port, the TFTP or FTP server must be on the same subnet as the service port because the service port is not routable, or you must create static routes on the controller.
                  • If you are downloading through the distribution system network port, the TFTP or FTP server can be on the same or a different subnet because the distribution system port is routable.
                  • A third-party TFTP or FTP server cannot run on the same computer as Cisco Prime Infrastructure because the Prime Infrastructure built-in TFTP or FTP server and the third-party TFTP or FTP server require the same communication port.

                    Note


                    All certificates downloaded to the controller must be in PEM format.


                  Downloading Device Certificates (GUI)


                    Step 1   Copy the device certificate to the default directory on your server.
                    Step 2   Choose Commands > Download File to open the Download File to Controller page.
                    Step 3   From the File Type drop-down list, choose Vendor Device Certificate.
                    Step 4   In the Certificate Password text box, enter the password that was used to protect the certificate.
                    Step 5   From the Transfer Mode drop-down list, choose from the following options:
                    • TFTP
                    • FTP
                    • SFTP (available in 7.4 and later releases)
                    Step 6   In the IP Address text box, enter the IP address of the server.

                    If you are using a TFTP server, the default values of 10 retries and 6 seconds for the Maximum Retries and Timeout text boxes should work correctly without any adjustment. However, you can change these values.

                    Step 7   Enter the maximum number of times that the TFTP server attempts to download the certificate in the Maximum Retries text box and the amount of time (in seconds) that the TFTP server attempts to download the certificate in the Timeout text box.
                    Step 8   In the File Path text box, enter the directory path of the certificate.
                    Step 9   In the File Name text box, enter the name of the certificate.
                    Step 10   If you are using an FTP server, follow these steps:
                    1. In the Server Login Username text box, enter the username to log into the FTP server.
                    2. In the Server Login Password text box, enter the password to log into the FTP server.
                    3. In the Server Port Number text box, enter the port number on the FTP server through which the download occurs. The default value is 21.
                    Step 11   Click Download to download the device certificate to the controller. A message appears indicating the status of the download.
                    Step 12   After the download is complete, choose Commands > Reboot > Reboot.
                    Step 13   If prompted to save your changes, click Save and Reboot.
                    Step 14   Click OK to confirm your decision to reboot the controller.

                    Downloading Device Certificates (CLI)


                      Step 1   Log onto the controller CLI.
                      Step 2   Specify the transfer mode used to download the config file by entering this command:

                      transfer download mode {tftp | ftp | sftp}

                      Step 3   Specify the type of the file to be downloaded by entering this command:

                      transfer download datatype eapdevcert

                      Step 4   Specify the certificate’s private key by entering this command:

                      transfer download certpassword password

                      Step 5   Specify the IP address of the TFTP or FTP server by entering this command:

                      transfer download serverip server-ip-address

                      Step 6   Specify the name of the config file to be downloaded by entering this command:

                      transfer download path server-path-to-file

                      Step 7   Specify the directory path of the config file by entering this command:

                      transfer download filename filename.pem

                      Step 8   If you are using a TFTP server, enter these commands:
                      • transfer download tftpMaxRetries retries
                      • transfer download tftpPktTimeout timeout
                        Note   

                        The default values of 10 retries and a 6-second timeout should work correctly without any adjustment. However, you can change these values. To do so, enter the maximum number of times that the TFTP server attempts to download the software for the retries parameter and the amount of time (in seconds) that the TFTP server attempts to download the software for the timeout parameter.

                      Step 9   If you are using an FTP server, enter these commands:
                      • transfer download username username
                      • transfer download password password
                      • transfer download port port
                        Note   

                        The default value for the port parameter is 21.

                      Step 10   View the updated settings by entering the transfer download start command. Answer y when prompted to confirm the current settings and start the download process.
                      Step 11   Reboot the controller by entering this command: reset system

                      Downloading CA Certificates

                      Controllers and access points have a Certificate Authority (CA) certificate that is used to sign and validate device certificates. The controller is shipped with a Cisco-installed CA certificate. This certificate may be used by EAP-FAST (when not using PACs), EAP-TLS, PEAP-GTC, and PEAP-MSCHAPv2 to authenticate wireless clients during local EAP authentication. However, if you want to use your own vendor-specific CA certificate, it must be downloaded to the controller.

                      Note


                      For more information about configuring local EAP, see the Configuring Local EAP section.


                      Follow the instructions in this section to download CA certificates to the controller through the GUI or CLI. However, before you begin, make sure that you have a TFTP or FTP server available for the certificate download. Follow these guidelines when setting up a TFTP or FTP server:

                      • If you are downloading through the service port, the TFTP or FTP server must be on the same subnet as the service port because the service port is not routable, or you must create static routes on the controller.
                      • If you are downloading through the distribution system network port, the TFTP or FTP server can be on the same or a different subnet because the distribution system port is routable.
                      • A third-party TFTP or FTP server cannot run on the same computer as Cisco Prime Infrastructure because the Prime Infrastructure built-in TFTP or FTP server and the third-party TFTP or FTP server require the same communication port.

                        Note


                        All certificates downloaded to the controller must be in PEM format.


                      Download CA Certificates (GUI)


                        Step 1   Copy the CA certificate to the default directory on your server.
                        Step 2   Choose Commands > Download File to open the Download File to Controller page.
                        Step 3   From the File Type drop-down list, choose Vendor CA Certificate.
                        Step 4   From the Transfer Mode drop-down list, choose from the following options:
                        • TFTP
                        • FTP
                        • SFTP (available in 7.4 and later releases)
                        Step 5   In the IP Address text box, enter the IP address of the server.

                        If you are using a TFTP server, the default values of 10 retries and 6 seconds for the Maximum Retries and Timeout text boxes should work correctly without any adjustment. However, you can change these values.

                        Step 6   Enter the maximum number of times that the TFTP server attempts to download the certificate in the Maximum Retries text box and the amount of time (in seconds) that the TFTP server attempts to download the certificate in the Timeout text box.
                        Step 7   In the File Path text box, enter the directory path of the certificate.
                        Step 8   In the File Name text box, enter the name of the certificate.
                        Step 9   If you are using an FTP server, follow these steps:
                        1. In the Server Login Username text box, enter the username to log on to the FTP server.
                        2. In the Server Login Password text box, enter the password to log on to the FTP server.
                        3. In the Server Port Number text box, enter the port number on the FTP server through which the download occurs. The default value is 21.
                        Step 10   Click Download to download the CA certificate to the controller. A message appears indicating the status of the download.
                        Step 11   After the download is complete, choose Commands > Reboot > Reboot.
                        Step 12   If prompted to save your changes, click Save and Reboot.
                        Step 13   Click OK to confirm your decision to reboot the controller.

                        Downloading CA Certificates (CLI)


                          Step 1   Log on to the controller CLI.
                          Step 2   Specify the transfer mode used to download the config file by entering this command:

                          transfer download mode {tftp | ftp | sftp}

                          Step 3   Specify the type of the file to be downloaded by entering this command: transfer download datatype eapdevcert
                          Step 4   Specify the IP address of the TFTP or FTP server by entering this command:

                          transfer download serverip server-ip-address

                          Step 5   Specify the directory path of the config file by entering this command:

                          transfer download path server-path-to-file

                          Step 6   Specify the name of the config file to be downloaded by entering this command:

                          transfer download filename filename.pem

                          Step 7   If you are using a TFTP server, enter these commands:
                          • transfer download tftpMaxRetries retries
                          • transfer download tftpPktTimeout timeout
                            Note   

                            The default values of 10 retries and a 6-second timeout should work correctly without any adjustment. However, you can change these values. To do so, enter the maximum number of times that the TFTP server attempts to download the software for the retries parameter and the amount of time (in seconds) that the TFTP server attempts to download the software for the timeout parameter.

                          Step 8   If you are using an FTP server, enter these commands:
                          • transfer download username username
                          • transfer download password password
                          • transfer download port port
                            Note   

                            The default value for the port parameter is 21.

                          Step 9   View the updated settings by entering the transfer download start command. Answer y when prompted to confirm the current settings and start the download process.
                          Step 10   Reboot the controller by entering the reset system command.

                          Uploading PACs

                          Protected access credentials (PACs) are credentials that are either automatically or manually provisioned and used to perform mutual authentication with a local EAP authentication server during EAP-FAST authentication. When manual PAC provisioning is enabled, the PAC file is manually generated on the controller.

                          Follow the instructions in this section to generate and load PACs from the controller through the GUI or CLI. However, before you begin, make sure you have a TFTP or FTP server available for the PAC upload. Follow these guidelines when setting up a TFTP or FTP server:

                          • If you are uploading through the service port, the TFTP or FTP server must be on the same subnet as the service port because the service port is not routable, or you must create static routes on the controller.
                          • If you are uploading through the distribution system network port, the TFTP or FTP server can be on the same or a different subnet because the distribution system port is routable.
                          • A third-party TFTP or FTP server cannot run on the same computer as Cisco Prime Infrastructure because the Prime Infrastructure built-in TFTP or FTP server and the third-party TFTP or FTP server require the same communication port.

                          Uploading PACs (GUI)


                            Step 1   Choose Commands > Upload File to open the Upload File from Controller page.
                            Step 2   From the File Type drop-down list, choose PAC (Protected Access Credential).
                            Step 3   In the User text box, enter the name of the user who will use the PAC.
                            Step 4   In the Validity text box, enter the number of days for the PAC to remain valid. The default setting is zero (0).
                            Step 5   In the Password and Confirm Password text boxes, enter a password to protect the PAC.
                            Step 6   From the Transfer Mode drop-down list, choose from the following options:
                            • TFTP
                            • FTP
                            • SFTP (available in 7.4 and later releases)
                            Step 7   In the IP Address text box, enter the IP address of the server.
                            Step 8   In the File Path text box, enter the directory path of the PAC.
                            Step 9   In the File Name text box, enter the name of the PAC file. PAC files have a .pac extension.
                            Step 10   If you are using an FTP server, follow these steps:
                            1. In the Server Login Username text box, enter the username to log into the FTP server.
                            2. In the Server Login Password text box, enter the password to log into the FTP server.
                            3. In the Server Port Number text box, enter the port number on the FTP server through which the upload occurs. The default value is 21.
                            Step 11   Click Upload to upload the PAC from the controller. A message appears indicating the status of the upload.
                            Step 12   Follow the instructions for your wireless client to load the PAC on your client devices. Make sure to use the password that you entered above.

                            Uploading PACs (CLI)


                              Step 1   Log on to the controller CLI.
                              Step 2   Specify the transfer mode used to upload the config file by entering this command:

                              transfer upload mode {tftp | ftp | sftp}

                              Step 3   Upload a Protected Access Credential (PAC) by entering this command:

                              transfer upload datatype pac

                              Step 4   Specify the identification of the user by entering this command:

                              transfer upload pac username validity password

                              Step 5   Specify the IP address of the TFTP or FTP server by entering this command:

                              transfer upload serverip server-ip-address

                              Step 6   Specify the directory path of the config file by entering this command:

                              transfer upload path server-path-to-file

                              Step 7   Specify the name of the config file to be uploaded by entering this command:

                              transfer upload filename manual.pac.

                              Step 8   If you are using an FTP server, enter these commands:
                              • transfer upload username username
                              • transfer upload password password
                              • transfer upload port port
                                Note   

                                The default value for the port parameter is 21.

                              Step 9   View the updated settings by entering the transfer upload start command. Answer y when prompted to confirm the current settings and start the upload process.
                              Step 10   Follow the instructions for your wireless client to load the PAC on your client devices. Make sure to use the password that you entered above.

                              Uploading and Downloading Configuration Files

                              We recommend that you upload your controller’s configuration file to a server to back it up. If you lose your configuration, you can then download the saved configuration to the controller.


                              Note


                              Do not download a configuration file to your controller that was uploaded from a different controller platform. For example, a Cisco 5500 Series Controller does not support the configuration file from a Cisco 2500 Series Controller.


                              Follow these guidelines when working with configuration files:

                              • Any CLI with an invalid value is filtered out and set to default by the XML validation engine. Validation occurs during bootup. A configuration may be rejected if the validation fails. A configuration may fail if you have an invalid CLI. For example, if you have a CLI where you try to configure a WLAN without adding appropriate commands to add the WLAN.
                              • A configuration may be rejected if the dependencies are not addressed. For example, if you try to configure dependent parameters without using the add command. The XML validation may succeed but the configuration download infrastructure will immediately reject the configuration with no validation errors.
                              • An invalid configuration can be verified by using the show invalid-config command. The show invalid-config command reports the configuration that is rejected by the controller either as part of download process or by XML validation infrastructure.

                                Note


                                You can also read and modify the configuration file.


                              • The FTP or the TFTP servers for transfer of configuration, image, and so on, must be reachable over a wired connection. The transfer cannot be performed over one of the wireless clients of the Cisco WLC. If you try to use a wireless client of the Cisco WLC, you are prompted with a system message saying that the server is not reachable. However, if you use a wireless client that is associated with another Cisco WLC, the FTP or the TFTP servers are reachable.

                              Uploading Configuration Files

                              You can upload configuration files using either the GUI or the CLI.

                              Uploading the Configuration Files (GUI)


                                Step 1   Choose Commands > Upload File to open the Upload File from Controller page.
                                Step 2   From the File Type drop-down list, choose Configuration.
                                Step 3   Encrypt the configuration file by selecting the Configuration File Encryption check box and entering the encryption key in the Encryption Key text box.
                                Step 4   From the Transfer Mode drop-down list, choose from the following options:
                                • TFTP
                                • FTP
                                • SFTP (available in 7.4 and later releases)
                                Step 5   In the IP Address text box, enter the IP address of the server.
                                Step 6   In the File Path text box, enter the directory path of the configuration file.
                                Step 7   In the File Name text box, enter the name of the configuration file.
                                Step 8   If you are using an FTP server, follow these steps:
                                1. In the Server Login Username text box, enter the username to log into the FTP server.
                                2. In the Server Login Password text box, enter the password to log into the FTP server.
                                3. In the Server Port Number text box, enter the port number on the FTP server through which the upload occurs. The default value is 21.
                                Step 9   Click Upload to upload the configuration file to the server. A message appears indicating the status of the upload. If the upload fails, repeat this procedure and try again.

                                Uploading the Configuration Files (CLI)


                                  Step 1   Specify the transfer mode used to upload the configuration file by entering this command: transfer upload mode {tftp | ftp | sftp}
                                  Step 2   Specify the type of file to be uploaded by entering this command: transfer upload datatype config
                                  Step 3   Encrypt the configuration file by entering these commands:
                                  • transfer encrypt enable
                                  • transfer encrypt set-key key, where key is the encryption key used to encrypt the file.
                                  Step 4   Specify the IP address of the server by entering this command: transfer upload serverip server-ip-address
                                  Step 5   Specify the directory path of the configuration file by entering this command: transfer upload path server-path-to-file
                                  Step 6   Specify the name of the configuration file to be uploaded by entering this command: transfer upload filename filename
                                  Step 7   If you are using an FTP server, enter these commands to specify the username and password used to log into the FTP server and the port number through which the upload occurs:
                                  • transfer upload username username
                                  • transfer upload password password
                                  • transfer upload port port
                                    Note   

                                    The default value for the port parameter is 21.

                                  Step 8   Initiate the upload process by entering this command: transfer upload start
                                  Step 9   When prompted to confirm the current settings, answer y.

                                  Information similar to the following appears:

                                  
                                  Mode............................................. TFTP  
                                  TFTP Server IP................................... 10.10.10.4
                                  TFTP Path........................................ Config/
                                  TFTP Filename.................................... AS_4402_4_2_55_8_Config.xml
                                  Data Type........................................ Config File 
                                  Encryption....................................... Disabled
                                  
                                  **************************************************
                                  ***  WARNING: Config File Encryption Disabled  ***
                                  **************************************************

                                  Are you sure you want to start? (y/N) Y
                                  File transfer operation completed successfully.

                                  

                                  If the upload fails, repeat this procedure and try again.


                                  Downloading Configuration Files

                                  You can download configuration files using either the GUI or the CLI.

                                  Downloading the Configuration Files (GUI)

                                    Step 1   Choose Commands > Download File to open the Download File to Controller page.
                                    Step 2   From the File Type drop-down list, choose Configuration.
                                    Step 3   If the configuration file is encrypted, select the Configuration File Encryption check box and enter the encryption key used to decrypt the file in the Encryption Key text box.
                                    Note   

                                    The key that you enter here should match the one entered during the upload process.

                                    Step 4   From the Transfer Mode drop-down list, choose from the following options:
                                    • TFTP
                                    • FTP
                                    • SFTP (available in 7.4 and later releases)
                                    Step 5   In the IP Address text box, enter the IP address of the server.

                                    If you are using a TFTP server, the default values of 10 retries and 6 seconds for the Maximum Retries and Timeout text boxes should work correctly without any adjustment. However, you can change these values.

                                    Step 6   Enter the maximum number of times that the TFTP server attempts to download the configuration file in the Maximum Retries text box and the amount of time (in seconds) that the TFTP server attempts to download the configuration file in the Timeout text box.
                                    Step 7   In the File Path text box, enter the directory path of the configuration file.
                                    Step 8   In the File Name text box, enter the name of the configuration file.
                                    Step 9   If you are using an FTP server, follow these steps:
                                    1. In the Server Login Username text box, enter the username to log into the FTP server.
                                    2. In the Server Login Password text box, enter the password to log into the FTP server.
                                    3. In the Server Port Number text box, enter the port number on the FTP server through which the download occurs. The default value is 21.
                                    Step 10   Click Download to download the file to the controller. A message appears indicating the status of the download, and the controller reboots automatically. If the download fails, repeat this procedure and try again.

                                    Downloading the Configuration Files (CLI)

                                    Note


                                    The controller does not support incremental configuration downloads. The configuration file contains all mandatory commands (all interface address commands, mgmtuser with read-write permission commands, and interface port or LAG enable or disable commands) required to successfully complete the download. For example, if you download only the config time ntp server index server_address command as part of the configuration file, the download fails. Only the commands present in the configuration file are applied to the controller, and any configuration in the controller prior to the download is removed.



                                      Step 1   Specify the transfer mode used to download the configuration file by entering this command: transfer download mode {tftp | ftp | sftp}
                                      Step 2   Specify the type of file to be downloaded by entering this command: transfer download datatype config
                                      Step 3   If the configuration file is encrypted, enter these commands:
                                      • transfer encrypt enable
                                      • transfer encrypt set-key key, where key is the encryption key used to decrypt the file.
                                        Note   

                                        The key that you enter here should match the one entered during the upload process.

                                      Step 4   Specify the IP address of the TFTP or FTP server by entering this command: transfer download serverip server-ip-address
                                      Step 5   Specify the directory path of the configuration file by entering this command: transfer download path server-path-to-file
                                      Step 6   Specify the name of the configuration file to be downloaded by entering this command: transfer download filename filename
                                      Step 7   If you are using a TFTP server, enter these commands:
                                      • transfer download tftpMaxRetries retries
                                      • transfer download tftpPktTimeout timeout
                                        Note   

                                        The default values of 10 retries and a 6-second timeout should work correctly without any adjustment. However, you can change these values. To do so, enter the maximum number of times that the TFTP server attempts to download the software for the retries parameter and the amount of time (in seconds) that the TFTP server attempts to download the software for the timeout parameter.

                                      Step 8   If you are using an FTP server, enter these commands to specify the username and password used to log into the FTP server and the port number through which the download occurs:
                                      • transfer upload username username
                                      • transfer upload password password
                                      • transfer upload port port
                                        Note   

                                        The default value for the port parameter is 21.

                                      Step 9   View the updated settings by entering this command: transfer download start
                                      Step 10   When prompted to confirm the current settings and start the download process, answer y.

                                      Information similar to the following appears:

                                      
                                      Mode............................................. TFTP  
                                      TFTP Server IP................................... 10.10.10.4
                                      TFTP Path........................................ Config/
                                      TFTP Filename.................................... AS_4402_4_2_55_8_Config.xml
                                      Data Type........................................ Config File 
                                      Encryption....................................... Disabled
                                      
                                      **************************************************
                                      ***  WARNING: Config File Encryption Disabled  ***
                                      **************************************************
                                      
                                      Are you sure you want to start? (y/N) y
                                      
                                      File transfer operation completed successfully.
                                      
                                      

                                      If the download fails, repeat this procedure and try again.


                                      Saving Configurations

                                      Controllers contain two kinds of memory: volatile RAM and NVRAM. At any time, you can save the configuration changes from active volatile RAM to nonvolatile RAM (NVRAM) using one of these commands:

                                      • save config—Saves the configuration from volatile RAM to NVRAM without resetting the controller.
                                      • reset system—Prompts you to confirm that you want to save configuration changes before the controller reboots.
                                      • logout—Prompts you to confirm that you want to save configuration changes before you log out.

                                      Editing Configuration Files

                                      When you save the controller’s configuration, the controller stores it in XML format in flash memory. Controller software release 5.2 or later releases enable you to easily read and modify the configuration file by converting it to CLI format. When you upload the configuration file to a TFTP/FTP/SFTP server, the controller initiates the conversion from XML to CLI. You can then read or edit the configuration file in a CLI format on the server. When you are finished, you download the file back to the controller, where it is reconverted to an XML format and saved.


                                        Step 1   Upload the configuration file to a TFTP/FTP/SFTP server by performing one of the following:
                                        • Upload the file using the controller GUI.
                                        • Upload the file using the controller CLI.
                                        Step 2   Read or edit the configuration file on the server. You can modify or delete existing CLI commands and add new CLI commands to the file.
                                        Note   

                                        To edit the configuration file, you can use either Notepad or WordPad on Windows or the VI editor on Linux.

                                        Step 3   Save your changes to the configuration file on the server.
                                        Step 4   Download the configuration file to the controller by performing one of the following:
                                        • Download the file using the controller GUI.
                                        • Download the file using the controller CLI.

                                        The controller converts the configuration file to an XML format, saves it to flash memory, and then reboots using the new configuration. CLI commands with known keywords and proper syntax are converted to XML while improper CLI commands are ignored and saved to flash memory. Any CLI commands that have invalid values are replaced with default values. To see any ignored commands or invalid configuration values, enter this command:

                                        show invalid-config

                                        Note   

                                        You cannot execute this command after the clear config or save config command.

                                        Step 5   If the downloaded configuration contains a large number of invalid CLI commands, you might want to upload the invalid configuration to the TFTP or FTP server for analysis. To do so, perform one of the following:
                                        • Upload the invalid configuration using the controller GUI. Follow the instructions in the Uploading Configuration Files (GUI) section but choose Invalid Config from the File Type drop-down list in Step 2 and skip Step 3.
                                        • Upload the invalid configuration using the controller CLI. Follow the instructions in the Uploading Configuration Files (CLI) section but enter the transfer upload datatype invalid-config command in Step 2 and skip Step 3.
                                        Step 6   The controller does not support the uploading and downloading of port configuration CLI commands. If you want to configure the controller ports, enter these commands:
                                        • config port linktrap {port | all} {enable | disable}—Enables or disables the up and down link traps for a specific controller port or for all ports.
                                        • config port adminmode {port | all} {enable | disable}—Enables or disables the administrative mode for a specific controller port or for all ports.
                                        Step 7   Save your changes by entering this command: save config

                                        Clearing the Controller Configuration


                                          Step 1   Clear the configuration by entering this command:

                                          clear config

                                          Enter y at the confirmation prompt to confirm the action.

                                          Step 2   Reboot the system by entering this command:

                                          reset system

                                          Enter n to reboot without saving configuration changes. When the controller reboots, the configuration wizard starts automatically.

                                          Step 3   Follow the instructions in the Configuring the Controller-Using the Configuration Wizard section to complete the initial configuration.

                                          Erasing the Controller Configuration


                                            Step 1   Reset the configuration by entering this command:

                                            reset system

                                            At the confirmation prompt, enter y to save configuration changes to NVRAM. The controller reboots.

                                            Step 2   When you are prompted for a username, restore the factory-default settings by entering this command:

                                            recover-config

                                            The controller reboots and the configuration wizard starts automatically.

                                            Step 3   Follow the instructions in the Configuring the Controller-Using the Configuration Wizard section to complete the initial configuration.

                                            Resetting the Controller

                                            You can reset the controller and view the reboot process on the CLI console using one of the following two methods:

                                            • Turn the controller off and then turn it back on.
                                            • On the CLI, enter reset system. At the confirmation prompt, enter y to save configuration changes to NVRAM. The controller reboots.

                                            When the controller reboots, the CLI console displays the following reboot information:

                                            • Initializing the system.
                                            • Verifying the hardware configuration.
                                            • Loading microcode into memory.
                                            • Verifying the operating system software load.
                                            • Initializing with its stored configurations.
                                            • Displaying the login prompt.