Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 04-H3C AP Upgrade Failure Troubleshooting Guide | 139.98 KB |
H3C AP Upgrade Failure Troubleshooting Guide
Copyright © 2023 New H3C Technologies Co., Ltd. All rights reserved.
No part of this manual may be reproduced or transmitted in any form or by any means without prior written consent of New H3C Technologies Co., Ltd.
Except for the trademarks of New H3C Technologies Co., Ltd., any trademarks that may be mentioned in this document are the property of their respective owners.
The information in this document is subject to change without notice.
Contents
Troubleshooting AP upgrade failures
Identifying AP upgrade methods
Manual upgrade from the BootWare menu
Troubleshooting automatic upgrade failures
Troubleshooting intra-Comware automatic upgrade failures
Troubleshooting inter-Comware automatic upgrade failures
Troubleshooting failures of upgrade from the BootWare menu
Troubleshooting intra-Comware upgrade failures
Troubleshooting inter-Comware upgrade failures
Troubleshooting AP upgrade failures
Overview
This document describes how to troubleshot AP upgrade failures in a WLAN network based on AP upgrade methods.
Identifying AP upgrade methods
As a best practice, use the automatic upgrade method provided by ACs to upgrade APs. If you cannot upgrade APs by using automatic upgrade, upgrade APs manually from the BootWare menu.
Automatic upgrade from the AC
Before troubleshooting, identify whether the upgrade is an upgrade between different Comware platforms or within the same Comware platform.
· The following upgrades are considered to be within the same Comware platform:
¡ Upgrade from one Comware 5 fit version to another Comware 5 fit version.
¡ Upgrade from one Comware 7 fit version to another Comware 7 fit version.
· The following upgrades are considered to be between different Comware platforms:
¡ Upgrade from a Comware 5 fit version to a Comware 7 fit version.
¡ Upgrade from a Comware 5 fat version to a Comware 7 fit version.
Manual upgrade from the BootWare menu
Before troubleshooting, identify whether the upgrade is an upgrade between different Comware platforms or within the same Comware platform.
· The following upgrades are considered to be within the same Comware platform:
¡ Upgrade from one Comware 5 fat/fit version to another Comware 5 fat/fit version.
¡ Upgrade from one Comware 7 fat/fit version to another Comware 7 fat/fit version.
· The following upgrades are considered to be between different Comware platforms:
¡ Upgrade from a Comware 5 fat/fit version to a Comware 7 fit version.
Comware image files
In Comware 5, the image files (.bin files) for ACs and APs are separate in the software package.
In Comware 7, the image files (.ipe files) for ACs and APs are in packaged in the same IPE package file. After you load an IPE package file onto an AC, the AC automatically decompresses it to multiple IPE files and loads them after reboot to complete the upgrade of itself and APs.
A .btw file is used to upgrade the BootWare from the BootWare menu.
Troubleshooting automatic upgrade failures
Troubleshooting intra-Comware automatic upgrade failures
Troubleshooting failures of upgrade from one Comware 5 fit version to another Comware 5 fit version
1. Use the display version command to identify whether the AC has been successfully upgraded. APs are upgraded only after the AC is successfully upgraded. If the AC fails to be upgraded, upgrade the AC again.
[AC] display version
H3C Comware Platform Software
Comware Software, Version 5.20, Release 2509P58
2. Identify whether the correct AP image file has been uploaded to the AC. You can see the fit AP compability table in the release notes to view the correct image file for each AP model. For example, the .bin file for the WA4330-ACN AP is wa4300_fit.bin.
<AC> dir
Directory of cfa0:/
0 -rw- 9061376 Jan 23 2017 14:25:54 wa4600_fit.bin
1 -rw- 7759872 Jan 23 2017 14:25:12 wa4300_fit.bin
2 -rw- 7971840 Nov 23 2016 18:30:50 wa4300s_fit.bin
If the bin file has not been uploaded to the AC, download the software package from the official website, decompress it, and upload the bin file to the root directory of the AC.
3. Identify whether the software upgrade feature is disabled in system view, AP group view, or AP template view. If the software upgrade feature is disabled in any of the views, enable it in that view.
# Enable the software upgrade feature in system view.
<AC> system-view
[AC] wlan ap-firmware-update enable
# Enable the software upgrade feature in AP template view.
[AC] wlan ap ap1 model WA4320-ACN
[AC-wlan-ap-ap1] firmware-update enable
[AC-wlan-ap-ap1] quit
# Enable the software upgrade feature for APs in AP group office.
[AC-group-office] firmware-update enable
4. Delete the wlan apdb and wlan image-load filepath local commands if they have been executed.
5. If you have uploaded an AP image file that is different from the AC image file in version, use the wlan apdb command to specify the version of the AP image file.
# Configure the mapping between software version R1508P08 and hardware version Ver.A of fit AP model WA4330-ACN.
<AC> system-view
[AC] wlan apdb WA4330-ACN Ver.A R1508P08
[AC] wlan image-load filepath local
If the software version you expect for an AP is consistent with the software version specified for the AP model stored in the APDB, you must delete the APDB user script and the wlan image-load filepath local command.
Troubleshooting failures of upgrade from one Comware 7 fit version to another Comware 7 fit version.
1. Use the display version command to identify whether the AC has been successfully upgraded. APs are upgraded only after the AC is successfully upgraded. If the AC fails to be upgraded, upgrade the AC again.
2. Identify whether the correct AP IPE file has been uploaded to the AC. The IPE files for APs is packaged in the IPE file for the AC. After the AC loads its IPE file, it automatically decompresses the IPE files for APs and saves them to the apimge folder. To identify whether the IPE files for APs exist on the AC, use the following commands:
# Access the apimge folder from the root directory.
<AC> cd apimge
# Display all visible files and directories in the apimge folder.
<AC> dir
Directory of cfa0:/apimge
0 -rw- 14138368 Oct 08 2019 08:42:36 wa2600a.ipe
1 -rw- 14505984 Oct 08 2019 08:43:42 wa3600.ipe
2 -rw- 18514944 Oct 08 2019 08:42:52 wa4300.ipe
3 -rw- 14611456 Oct 08 2019 08:47:32 wa4300h.ipe
4 -rw- 14559232 Oct 08 2019 08:43:08 wa4300s.ipe
5 -rw- 17926144 Oct 08 2019 08:43:24 wa4600.ipe
6 -rw- 21670912 Oct 08 2019 08:47:14 wa5300.ipe
7 -rw- 19332096 Oct 08 2019 08:46:54 wa5600.ipe
8 -rw- 36600832 Oct 08 2019 08:48:44 wa6500.ipe
9 -rw- 43108352 Oct 08 2019 08:44:54 wt1010.ipe
10 -rw- 43470848 Oct 08 2019 08:44:12 wt1020.ipe
11 -rw- 46026752 Oct 08 2019 08:48:04 wt1024q.ipe
12 -rw- 52344832 Oct 08 2019 08:45:42 wt1024x.ipe
13 -rw- 37735424 Oct 08 2019 08:46:26 wt2024u.ipe
The IPE package files for some AC series do not contain the IPE files for some AP models. For more information, see the release notes. To upgrade these AP models, download the IPE files from the official website and upload them to the AC.
3. Identify whether the software upgrade feature is disabled in global configuration view, AP group view, or AP view. If the software upgrade feature is disabled in any of the views, use the firmware-upgrade enable command enable it in that view.
4. Delete the wlan apdb and wlan image-load filepath local commands if they have been executed.
5. If you have uploaded an AP image file that is different from the AC image file in version, use the wlan apdb command to specify the version of the AP image file.
<Sysname> system-view
[Sysname] wlan apdb WA4330-ACN Ver.A R5205P02
[Sysname] wlan image-load filepath local
Troubleshooting inter-Comware automatic upgrade failures
Troubleshooting failures of upgrade from a Comware 5 fit version to a Comware 7 fit version
|
|
NOTE: · An AP upgrade from a Comware 5 fit version to a Comware 7 fit version requires the upgrade of both the BootWare and Comware. · An AP will be formatted during the upgrade. |
To troubleshoot an upgrade failure:
1. Identify whether the IPE files for APs exist on the AC.
# Access the apimge folder from the root directory.
<AC> cd apimge
# Display all visible files and directories in the apimge folder.
<AC> dir
Directory of cfa0:/apimge
0 -rw- 14138368 Oct 08 2019 08:42:36 wa2600a.ipe
1 -rw- 14505984 Oct 08 2019 08:43:42 wa3600.ipe
2 -rw- 18514944 Oct 08 2019 08:42:52 wa4300.ipe
3 -rw- 14611456 Oct 08 2019 08:47:32 wa4300h.ipe
4 -rw- 14559232 Oct 08 2019 08:43:08 wa4300s.ipe
5 -rw- 17926144 Oct 08 2019 08:43:24 wa4600.ipe
6 -rw- 21670912 Oct 08 2019 08:47:14 wa5300.ipe
7 -rw- 19332096 Oct 08 2019 08:46:54 wa5600.ipe
8 -rw- 36600832 Oct 08 2019 08:48:44 wa6500.ipe
9 -rw- 43108352 Oct 08 2019 08:44:54 wt1010.ipe
10 -rw- 43470848 Oct 08 2019 08:44:12 wt1020.ipe
11 -rw- 46026752 Oct 08 2019 08:48:04 wt1024q.ipe
12 -rw- 52344832 Oct 08 2019 08:45:42 wt1024x.ipe
13 -rw- 37735424 Oct 08 2019 08:46:26 wt2024u.ipe
2. Identify whether the software upgrade feature is enabled and whether a software-to-hardware mapping is configured. If the software version in the mapping is not the expected version, you must delete the mapping.
3. Identify whether the AP registers with the AC across a Layer 3 network. If the AP registers with the AC across a Layer 3 network and cannot obtain the AC IP address through Option 43, you must log in to the AP, specify the AC IP address on the AP, and save the configuration.
# Specify the AC IP address 192.168.0.100.
<AP> system-view
[AP] wlan ac ip 192.168.0.100
[AP] save
|
|
NOTE: If the AP version is old, the AP might fail to register with the AC because the AC IP address is deleted during formatting. In this case, downgrade Comware 7 BootWare to Comware 5 BootWare on the AP, install the latest Comware 5 version, and reconfigure the AC IP address. In new Comware 5 versions, the wlan ac ip command will be retained after formatting. For an old Comware 5 version, you can upgraded it to a new Comware 5 version and then to a Comware 7 version if you specify the AC IP address manually. |
Identify whether the AP registers with the AC and comes online. If the AP comes online, the upgrade succeeds. If the AP does not come online, log in to the AP to identify whether the BootWare has been upgraded to Comware 7.
****************************************************************************
* *
* H3C WA4330-ACN BootWare, Version 7.19 *
* *
****************************************************************************
Copyright (c) 2004-2019 New H3C Technologies Co., Ltd.
Compiled Date : Jun 20 2018
CPU Type : ATHEROS AR9557
CPU L1 Cache : 32KB
CPU Clock Speed : 720MHz
Memory Type : DDR2 SDRAM
Memory Size : 256MB
Memory Speed : 560MHz
BootWare Size : 512KB
Flash Size : 32MB
PCB Version : Ver.B
If the BootWare has been upgraded to Comware 7 but the AP fails to obtain the image file, troubleshoot the failure. If the BootWare fails to be upgraded to Comware 7, continue to troubleshoot the BootWare upgrade failure.
Troubleshooting failures of upgrade from a Comware 5 fat version to a Comware 7 fit version
Some APs might fail to be upgraded from a Comware 5 fat version to a Comware 7 fit version. As a best practice, change the AP from fat mode to fit mode. If you delete the image file for the fat AP and then power cycle it, the upgrade might fail.
Some AP models might fail to change from fat mode to fit mode. For example, if the WA2610H-Fat AP uses E1507P06 or earlier version, it will fail to change from fat mode to fit mode because its BootWare (1.03) cannot automatically download the fit-mode image file from the AC. The AP will restart repeatedly and cannot register with the AC. To solve the problem, first upgrade the AP to R1508P07 or a later version or manually upload the fit-mode image file to change the mode.
Troubleshooting failures of upgrade from the BootWare menu
Troubleshooting intra-Comware upgrade failures
Troubleshooting failures of upgrade from one Comware 5 fat/fit version to another Comware 7 fat/fit version
1. Identify whether the correct AP image file has been uploaded to the AC.
2. Identify whether the Ethernet parameters are configured correctly in the BootWare menu.
Power on the AP and press Ctrl+B to access the extended BootWare menu.
==========================<ETHERNET PARAMETER SET>==========================
|Note: '.' = Clear field. |
| '-' = Go to previous field. |
| Ctrl+D = Quit. |
===========================================================================
Protocol (FTP or TFTP) :tftp tftp
Load File Name :wa4300_fit.bin
:wa4300_fit.bin
Target File Name :wa4300_fit.bin
:wa4300_fit.bin
Server IP Address :1.1.1.1 192.168.0.1
Local IP Address :1.1.1.1 192.168.0.2
Gateway IP Address :0.0.0.0
Examine the following parameters (the TFTP protocol is used):
¡ Load File Name: Name of the image file to be downloaded.
¡ Target File Name: New name of the downloaded file, which can only be wa4300_fit.bin or wa4300_fat.bin.
¡ Server IP Address: IP address of the server connected to the PC.
¡ Local IP Address: IP address of the AP, which must be on the same subnet as the server IP address.
¡ Gateway IP Address: Use the default for this parameter (0.0.0.0).
Select 2 in the Enter Ethernet SubMenu.
==========================<Enter Ethernet SubMenu>==========================
|Note:the operating device is flash |
|<1> Download Application Program To SDRAM And Run |
|<2> Update Main Application File |
|<3> Modify Ethernet Parameter |
|<0> Exit To Main Menu |
|<Ensure The Parameter Be Modified Before Downloading!> |
===========================================================================
Enter your choice(0-3): 2
If Loading...Failed! is prompted, make sure:
¡ The TFTP download path is correct.
¡ The TFTP port is in listening state.
¡ The PC and the AP can reach each other at Layer 2.
¡ The server IP address is correct.
¡ The local IP address is on the same subnet as the server IP address.
The normal output is as follows:
Enter your choice(0-3): 2
Loading.....................................................................
............................................................................
........................................................................
Done!
10963968 bytes downloaded!
3. Identify whether the uploaded image file is correct in the following menu.
==========================<EXTENDED-BOOTWAREMENU>======================
|<1> Boot System |
|<2> Enter Serial SubMenu |
|<3> Enter Ethernet SubMenu |
|<4> File Control |
|<5> Restore to Factory Default Configuration |
|<6> Skip Current System Configuration |
|<7> BootWare Operation Menu |
|<8> Skip Authentication for Console Login |
|<9> Storage Device Operation |
|<0> Reboot |
============================================================================
Ctrl+Z: Access EXTENDED ASSISTANT MENU
Ctrl+F: Format File System
Ctrl+C: Display Copyright
Enter your choice(0-9): 4
===============================<File CONTROL>===============================
|Note:the operating device is cfa0 |
|<1> Display All File(s) |
|<2> Set Image File type |
|<3> Set Bin File type |
|<4> Set Configuration File type |
|<5> Delete File |
|<0> Exit To Main Menu |
============================================================================
Enter your choice(0-5): 1
Display all file(s) in cfa0:
'M' = MAIN 'B' = BACKUP 'N/A' = NOT ASSIGNED
============================================================================
|NO. Size(B) Time Type Name
1 2566144 May/11/2017 09:11:51 M flash:/wa4300-boot.bin
2 13744128 May/11/2017 09:14:24 M flash:/wa4300-system.bin
============================================================================
4. Troubleshoot according to the following error messages:
¡ Something wrong with the file!—Make sure:
- The target file name is correct. Do not use a underscore (_) as a hyphen (-) in the name.
- Do not upload a fat-mode image file for a fat AP, and vice versa.
- The image file is complete.
- The image file matches the AP model.
If the image file is correct, the Booting App fails! Message is displayed upon AP startup.
¡ The space is not enough.Failed!—Delete the unused files from the AP or format the AP and upload the image file again.
The normal output is as follows:
Enter your choice(0-3): 2
Loading.....................................................................
............................................................................
...............................Done!
10963968 bytes downloaded!
Updating File flash:/wa4300_fit.bin.........................................
...........................Done!
The following information appears when the AP starts up:
BootWare Validating...
Press Ctrl+B to enter extended boot menu...
Starting to get the main application file--flash:/wa4300_fit.bin!...........
........................................................
The main application file is self-decompressing.............................
...........................................................................
................Done!
System application is starting...
Startup configuration file does not exist.
User interface con0 is available.
Press ENTER to get started.
Troubleshooting failures of upgrade from one Comware 7 fat/fit version to another Comware 7 fat/fit version
Identify whether the correct AP image file has been imported through the BootWare menu. You can download the image file from the apimge folder on the AC or contact H3C Support to obtain it. The process for importing the image file is the same as that in Comware 5, except that the file extension is .ipe instead of .bin. For more information, see "Troubleshooting failures of upgrade from one Comware 5 fat/fit version to another Comware 7 fat/fit version."
Troubleshooting inter-Comware upgrade failures
|
|
NOTE: This upgrade method supports only upgrading from a Comware 5 fat or fit version to a Comware 7 fit version. |
Troubleshooting failures of upgrade from a Comware 5 fat/fit version to a Comware 7 fit version
1. Identify whether the BootWare has been upgraded successfully.
To upgrade the BootWare, upload the BootWare image file (a .btw file) from the Comware 5 BootWare menu. You can upgrade Comware only after you upgrade the BootWare.
2. Format the AP before you upgrade the BootWare.
System is starting...
Press Ctrl+D to access BASIC-BOOTWARE MENU
Booting Normal Extend BootWare
The Extend BootWare is self-decompressing...................................
....Done!
****************************************************************************
* *
* H3C WA4320X BootWare, Version 7.12 *
* *
****************************************************************************
Copyright (c) 2004-2018 New H3C Technologies Co., Ltd.
Compiled Date : Jul 24 2018
CPU Type : ATHEROS AR9550
CPU L1 Cache : 32KB
CPU Clock Speed : 720MHz
Memory Type : DDR2 SDRAM
Memory Size : 256MB
Memory Speed : 560MHz
BootWare Size : 512KB
Flash Size : 128MB
PCB Version : Ver.B
BootWare Validating...
Press Ctrl+B to access EXTENDED-BOOTWARE MENU...
Password recovery capability is enabled.
Note: The current operating device is flash
Enter < Storage Device Operation > to select device.
==========================<EXTENDED-BOOTWARE MENU>==========================
|<1> Boot System |
|<2> Enter Serial SubMenu |
|<3> Enter Ethernet SubMenu |
|<4> File Control |
|<5> Restore to Factory Default Configuration |
|<6> Skip Current System Configuration |
|<7> BootWare Operation Menu |
|<8> Skip Authentication for Console Login |
|<9> Storage Device Operation |
|<0> Reboot |
============================================================================
Ctrl+Z: Access EXTENDED ASSISTANT MENU
Ctrl+F: Format File System
Ctrl+C: Display Copyright
Enter your choice(0-9):
Warning:All files on flash will be lost! Are you sure to format? [Y/N]Y.....
............................................................................
...............................................
Format success.
3. Select 7 to upgrade the BootWare. Make sure the BootWare image file is correct. You can obtain the BootWare image file from H3C Support.
==========================<EXTENDED-BOOTWARE MENU>==========================
|<1> Boot System |
|<2> Enter Serial SubMenu |
|<3> Enter Ethernet SubMenu |
|<4> File Control |
|<5> Restore to Factory Default Configuration |
|<6> Skip Current System Configuration |
|<7> BootWare Operation Menu |
|<8> Skip Authentication for Console Login |
|<9> Storage Device Operation |
|<0> Reboot |
============================================================================
Ctrl+Z: Access EXTENDED ASSISTANT MENU
Ctrl+F: Format File System
Ctrl+C: Display Copyright
Enter your choice(0-9): 7
=========================<BootWare Operation Menu>==========================
|Note:the operating device is flash |
|<1> Backup Full BootWare |
|<2> Restore Full BootWare |
|<3> Update BootWare By Serial |
|<4> Update BootWare By Ethernet |
|<0> Exit To Main Menu |
============================================================================
Enter your choice(0-4): 4
===================<BOOTWARE OPERATION ETHERNET SUB-MENU>===================
|<1> Update Full BootWare |
|<2> Update Extended BootWare |
|<3> Update Basic BootWare |
|<4> Modify Ethernet Parameter |
|<0> Exit To Main Menu |
============================================================================
Enter your choice(0-4): 4
==========================<ETHERNET PARAMETER SET>==========================
|Note: '.' = Clear field. |
| '-' = Go to previous field. |
| Ctrl+D = Quit. |
============================================================================
Protocol (FTP or TFTP) :tftp
Load File Name :wa4300.ipe
:apwa430038263_v7.13.btw
Target File Name :wa4300.ipe
:
Server IP Address :192.168.1.10
Local IP Address :192.168.1.1 -
Server IP Address :192.168.1.10 192.168.4.54
Local IP Address :192.168.1.1 192.168.4.4
Subnet Mask :0
Gateway IP Address :0
===================<BOOTWARE OPERATION ETHERNET SUB-MENU>===================
|<1> Update Full BootWare |
|<2> Update Extended BootWare |
|<3> Update Basic BootWare |
|<4> Modify Ethernet Parameter |
|<0> Exit To Main Menu |
============================================================================
Enter your choice(0-4): 1
Loading...........Done.
459776 bytes downloaded!
Updating Basic BootWare? [Y/N]Y
Updating Basic BootWare..........Done.
Updating Extended BootWare? [Y/N]Y
Updating Extended BootWare...........Done.
4. Identify whether you have obtained the correct AP IPE file.
You can obtain the AP IPE file from the apimge folder on the AC or contact H3C Support.
5. Upload the AP IPE image file and restart the AP to complete the upgraded.
