使用TFTP和SFTP服务器升级非同构EWC网络中的AP

已更新: 2024 年 2 月 16 日
文档 ID:221705

非歧视性语言

此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。

关于此翻译

思科采用人工翻译与机器翻译相结合的方式将此文档翻译成不同语言，希望全球的用户都能通过各自的语言得到支持性的内容。 请注意：即使是最好的机器翻译，其准确度也不及专业翻译人员的水平。 Cisco Systems, Inc. 对于翻译的准确性不承担任何责任，并建议您总是参考英文原始文档（已提供链接）。

    简介

    本文档详细介绍使用TFTP和SFTP服务器的非同类EWC网络的接入点映像下载过程。

    先决条件

    要求

    Cisco 建议您了解以下主题：

    • AP加入过程的将军。
    • Catalyst 9100系列AP上的嵌入式无线局域网控制器。
    • TFTP文件传输。
    • SFTP文件传输
    • Linux命令行界面使用。

    使用的组件

    本文档中的信息基于以下软件和硬件版本：

    • Catalyst 9120AXI AP中的嵌入式Catalyst 9800 WLC，Cisco IOS® XE Cupertino 17.9.3。
    • Catalyst 9105AXI接入点。
    • TFTPD-64版本4.64。
    • TFTPD-HPA Linux程序包。
    • SSH Linux程序包

    本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

    背景信息.

    当接入点加入网络时，充当EWC的接入点只能向其他接入点提供自己的AP映像类型。如果网络包含非同构部署（AP来自与EWC不同的AP），您需要部署TFTP或SFTP服务器，并在此托管AP映像，以便AP从那里下载。

    note-icon

    注意：这仅适用于从网络内部本地下载映像的AP映像升级过程。AP还可以通过CCO升级直接从互联网下载映像。

    配置

    网络图

    Network Diagram网络图

    通过TFTP下载映像

    TFTPD-64(Windows)

    TFTPD-64是众所周知的自由开源(FOSS)实用程序，包括TFTP功能。请访问其网站进行下载和安装。

    确保将AP捆绑映像解压缩到TFTP服务器的适当文件夹中。

    Unzipped Files in the TFTP FolderTFTP文件夹中的解压缩文件

    一旦AP开始从TFTP服务器下载其映像，就会显示一个来自TFTP的弹出窗口，详细介绍映像传输过程。

    TFTPD-64 File Transfer ProgressTFTPD-64文件传输进度

    TFTPD-HPA(Linux)

    TFTPD-HPA是一个基本的、众所周知的软件包，可以从APT存储库获取。有关详细信息，请参阅Ubuntu的TFTP文档。

    确保您的TFTP配置已充分指向您的TFTP文件夹，并且AP捆绑包映像已解压。

    TFTP Configurations and Unzipped Files in UbuntuUbuntu中的TFTP配置和解压缩文件

    您可以在Ubuntu上跟踪默认记录在/var/lib/syslog中的映像传输进程。

    TFTP File Transfer Logs on UbuntuUbuntu上的TFTP文件传输日志

    WLC 配置

    在WLC的GUI中，转至Administration > Software Management > Software Upgrade。在模式下的下拉列表中选择TFTP并提供您的TFTP服务器的信息。

    选择Save以保存映像下载配置文件并为加入EWC网络的新AP启用映像下载，或单击Save & Download以立即触发所有AP（包括EWC的AP）上的下载过程。

    TFTP Configuration for Software Upgrade软件升级的TFTP配置

    CLI 配置：

    9120-EWC(config)#wireless profile image-download default
    9120-EWC(config-wireless-image-download-profile)#image-download-mode tftp
    9120-EWC(config-wireless-image-download-profile)#tftp-image-server <TFTP-server>
    9120-EWC(config-wireless-image-download-profile-tftp)#tftp-image-path <path>

    通过SFTP下载映像

    SFTP服务器(Linux)

    由于SFTP通过SSH工作，因此您可以使用Linux的SSH包在Linux中配置简单的SFTP服务器。

    确保在/etc/ssh/ssh_config文件中为SFTP提供充分的配置。根据需要将用户（或组）的权限添加到SFTP目录，然后解压缩所需路径中的AP捆绑包映像文件。

    SFTP Configuration in UbuntuUbuntu中的SFTP配置

    与Linux中的TFTP服务器类似，您也可以跟踪SFTP活动。默认情况下，日志配置为存储在/var/log/auth.log中。确保根据需要添加日志级别配置。

    SFTP Log Activity and Configuration in Ubuntu.Ubuntu中的SFTP日志活动和配置。

    note-icon

    注：连接到SFTP服务器的设备是EWC，而不是请求映像的AP。这是因为凭证是在EWC中调配的，而不是在AP中调配之后加入EWC。然后，该映像被转发到请求该映像的实际AP。

    WLC 配置

    在WLC的GUI中，转至Administration > Software Management > Software Upgrade。在模式下的下拉列表中选择SFTP，并提供STFTP服务器的信息和凭证。

    选择Save以保存映像下载配置文件并为加入EWC网络的新AP启用映像下载，或单击Save & Download以立即触发所有AP（包括EWC的AP）上的下载过程。

    SFTP Configuration in the GUIGUI中的SFTP配置

    CLI 配置：

    9120-EWC(config)#wireless profile image-download default
    9120-EWC(config-wireless-image-download-profile)#image-download-mode sftp
    9120-EWC(config-wireless-image-download-profile-sftp)#sftp-image-server <SFTP-Server>
    9120-EWC(config-wireless-image-download-profile-sftp)#sftp-image-path <path>
    9120-EWC(config-wireless-image-download-profile-sftp)#sftp-username <user>
    9120-EWC(config-wireless-image-download-profile-sftp)#sftp-password 0 <password>

    验证

    CAPWAP状态机按照您通常希望的任何其他AP映像下载过程的方式登录AP流程。

    [*01/30/2024 21:41:35.1120] CAPWAP State: Image Data
    [*01/30/2024 21:41:35.1130] AP image version 17.3.3.26 backup 8.10.130.0, Controller 17.9.4.27
    [*01/30/2024 21:41:35.1130] Version does not match.
    [*01/30/2024 21:41:35.1130] Request to close the file..
    [*01/30/2024 21:41:35.1130] wtpOpenImgFile: image file closed, dcb->fd set to -1.
    [*01/30/2024 21:41:35.2040] status 'upgrade.sh: Script called with args:[PRECHECK]'
    [*01/30/2024 21:41:35.3020] do PRECHECK, part2 is active part
    [*01/30/2024 21:41:35.3350] status 'upgrade.sh: Cleanup tmp files ...'
    [*01/30/2024 21:41:35.4620] status 'upgrade.sh: /tmp space: OK available 96064, required 50000 '
    [*01/30/2024 21:41:35.4630] wtpOpenImgFile: request ap1g8, local /tmp/part.tar
    [*01/30/2024 21:41:35.4630] wtpOpenImgFile: open (/tmp/part.tar) image file success
    [*01/30/2024 21:41:35.4630] Using fd(37559296) for image writing to file(/tmp/part.tar)
    [*01/30/2024 21:41:35.4650] Image Data Request sent to 172.16.4.26, fileName [ap1g8], replicaStatus 1
    [*01/30/2024 21:41:35.4690] Image Data Response from 172.16.4.26
    [*01/30/2024 21:41:35.4690] AC accepted previous sent request with result code: 0
    [*01/30/2024 21:41:35.4760] <.......................................Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).
    [*01/30/2024 21:41:50.6190] ...........
    [*01/30/2024 21:41:54.7060] ..............................................Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).
    [*01/30/2024 21:42:14.0820] ....
    [*01/30/2024 21:42:15.5860] Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).
    [*01/30/2024 21:42:15.6430] .............................................
    [*01/30/2024 21:42:34.2800] ...............................Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).
    [*01/30/2024 21:42:46.0420] ...................
    [*01/30/2024 21:42:53.0610] ..................................................
    [*01/30/2024 21:43:11.6480] ......> 70512640 bytes, 51208 msgs, 601 last
    [*01/30/2024 21:43:13.3940] Last block stored, IsPre 0, WriteTaskId 0
    [*01/30/2024 21:43:13.3940] Request to close the file..
    [*01/30/2024 21:43:13.3940] wtpOpenImgFile: image file closed, dcb->fd set to -1.
    [*01/30/2024 21:43:13.3940] Image transfer completed from WLC, last 1
    [*01/30/2024 21:43:13.3940] Request to close the file..
    [*01/30/2024 21:43:13.3940] wtpOpenImgFile: image file closed, dcb->fd set to -1.
    [*01/30/2024 21:43:13.3950] in (CAPWAP_MSGELE_IMAGE_DATA_msg_dec_cb) Enabling radCfg.is_oob_image_dnld_supported 
    [*01/30/2024 21:43:13.4190] wtp_delayed_event_handle_write_image_to_storage(10): fileName ap1g8, pre 0
    [*01/30/2024 21:43:13.4190] wtp_delayed_event_handle_write_image_to_storage(10): fileName ap1g8, pre 0
    [*01/30/2024 21:43:13.5110] status 'upgrade.sh: Script called with args:[PREDOWNLOAD]'
    [*01/30/2024 21:43:13.6100] do PREDOWNLOAD, part2 is active part
    [*01/30/2024 21:43:13.6420] status 'upgrade.sh: Creating before-upgrade.log'
    [*01/30/2024 21:43:13.6990] status 'upgrade.sh: Start doing upgrade arg1=PREDOWNLOAD arg2= arg3= ...'
    [*01/30/2024 21:43:13.8610] status 'upgrade.sh: Using image /tmp/part.tar on ax-bcm32 ...'
    [*01/30/2024 21:43:20.9990] status 'Image signing verify success.'

    在WLC系统日志中，映像下载标记为成功。

    *Feb 1 17:05:37.108: %INSTALL-5-INSTALL_COMPLETED_INFO: Chassis 1 R0/0: install_engine: Completed install add sftp://******@172.16.5.62/Documents/sftp_files/EWC_17_9_4a/ap3g3
    *Feb 1 17:07:00.720: %CAPWAPAC_SMGR_TRACE_MESSAGE-5-AP_JOIN_DISJOIN: Chassis 1 R0/0: wncd: AP Event: AP Name: AP-POD-2-2 Mac: 2c5a.0f40.6920 Session-IP: 172.16.4.33[5248] 172.16.4.26[5246] Disjoined Image Download Success

    AP映像下载

    启动升级过程后，您可以在EWC上使用“show ap image”命令跟踪AP映像预下载过程。所有AP完成下载映像后，您便可以在AP的备份映像中看到目标映像。

    9120-EWC#show ap image
    Total number of APs  : 3

    Number of APs
            Initiated                  : 0
            Downloading                : 0
            Predownloading             : 0
            Completed downloading      : 0
            Completed predownloading   : 3
            Not Supported              : 0
            Failed to Predownload      : 0
            Predownload in progress    : No

    AP Name                           Primary Image          Backup Image            Predownload Status   Predownload Version  Next Retry Time   Retry Count   Method
    ------------------------------------------------------------------------------------------------------------------------------------------------------------------
    AP-POD-2-2                        17.9.4.27              17.12.1.5                  Complete              17.12.1.5             0                 0                 CAPWAP
    AP6C41.0E16.E79C                  17.9.4.27              17.12.1.5                  Complete              17.12.1.5             0                 0                 CAPWAP
    9105-emorenoa                     17.9.4.27              17.12.1.5                  Complete              17.12.1.5             0                 0                 CAPWAP

    或者，在GUI中，进度条到达激活阶段，此时仅需要重新加载才能将EWC交换为新代码。

    EWC Web UI Upgrade Progress BarEWC Web UI升级进度条

    下面，EWC显示AP的预下载状态。

    EWC Web UI APs Image Predownload StatusEWC Web UI AP映像预下载状态

    故障排除

    在AP映像下载过程中，您可以在AP的CAPWAP状态机日志中看到下载无法启动。

    [*07/12/2023 07:41:00.7960] CAPWAP State: Image Data
    [*07/12/2023 07:41:00.7970] AP image version 17.3.3.26 backup 8.10.130.0, Controller 17.9.4.27
    [*07/12/2023 07:41:00.7970] Version does not match.
    [*07/12/2023 07:41:00.8580] upgrade.sh: Script called with args:[PRECHECK]
    [*07/12/2023 07:41:00.9540] do PRECHECK, part2 is active part
    [*07/12/2023 07:41:01.0070] upgrade.sh: /tmp space: OK available 101272, required 40000 
    [*07/12/2023 07:41:01.0080] wtpImgFileReadRequest: request ap1g8, local /tmp/part.tar
    [*07/12/2023 07:41:01.0100] Image Data Request sent to 172.16.4.26, fileName [ap1g8], slaveStatus 0
    [*07/12/2023 07:41:01.0140] Image Data Response from 172.16.4.26
    [*07/12/2023 07:41:01.0140] AC accepted join request with result code: 0
    [*07/12/2023 07:41:09.5930] Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).
    [*07/12/2023 07:41:28.7700] Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: Image Data(10).
    [*07/12/2023 07:41:29.7500] 
    [*07/12/2023 07:41:29.7500] Going to restart CAPWAP (reason : image download cannot start)...
    [*07/12/2023 07:41:29.7500] 
    [*07/12/2023 07:41:29.7570] Restarting CAPWAP State Machine.
    [*07/12/2023 07:41:29.7600] Image Data Request sent to 172.16.4.26, fileName [ap1g8], slaveStatus 1
    [*07/12/2023 07:41:29.7970] 
    [*07/12/2023 07:41:29.7970] CAPWAP State: DTLS Teardown
    [*07/12/2023 07:41:29.8330] Aborting image download(0x0): Dtls cleanup, ap1g8
    [*07/12/2023 07:41:29.9560] upgrade.sh: Script called with args:[ABORT]
    [*07/12/2023 07:41:30.0570] do ABORT, part2 is active part
    [*07/12/2023 07:41:30.1050] upgrade.sh: Cleanup tmp files ...
    [*07/12/2023 07:41:30.1590] Discarding msg CAPWAP_WTP_EVENT_REQUEST(type 9) in CAPWAP state: DTLS Teardown(4).

    要了解AP无法下载映像的原因，您可以检查EWC中的Syslog。由于到TFTP和SFTP服务器的指定路径错误（正确反映在日志中），经常会看到映像下载失败：

    对于SFTP:

    *Feb 1 20:29:14.108: %CAPWAPAC_SMGR_TRACE_MESSAGE-5-AP_JOIN_DISJOIN: Chassis 1 R0/0: wncd: AP Event: AP Name: AP-9117 Mac: 0cd0.f897.ade0 Session-IP: 172.16.4.34[5248] 172.16.4.26[5246] Disjoined Image Download Failed
    *Feb 1 20:29:17.325: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R0/0: install_engine: Started install add sftp://******@172.16.5.62/Documents/Wrong-Path/ap1g6
    *Feb 1 20:29:25.730: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 1 R0/0: install_engine: Failed to install_add package sftp://******@172.16.5.62/Documents/Wrong-Path/ap1g6, Error: Failed to download file sftp://******@172.16.5.62/Documents/Wrong-Path/ap1g6: No such file or directory

    对于TFTP:

    *Feb 1 20:52:08.742: %CAPWAPAC_SMGR_TRACE_MESSAGE-5-AP_JOIN_DISJOIN: Chassis 1 R0/0: wncd: AP Event: AP Name: AP-9117 Mac: 0cd0.f897.ade0 Session-IP: 172.16.4.34[5248] 172.16.4.26[5246] Disjoined Image Download Failed
    *Feb 1 20:52:11.894: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R0/0: install_engine: Started install add tftp://172.16.5.27/Wrong-Path/ap1g6
    *Feb 1 20:52:13.977: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 1 R0/0: install_engine: Failed to install_add package tftp://172.16.5.27/Wrong-Path/ap1g6, Error: Failed to download file tftp://172.16.5.27/Wrong-Path/ap1g6: No such file or directory

    确保AP和EWC可以访问TFTP或SFTP服务器。否则，在EWC系统日志中可以看到超时日志。

    *Feb 1 20:55:03.359: %CAPWAPAC_SMGR_TRACE_MESSAGE-5-AP_JOIN_DISJOIN: Chassis 1 R0/0: wncd: AP Event: AP Name: AP-9117 Mac: 0cd0.f897.ade0 Session-IP: 172.16.4.34[5248] 172.16.4.26[5246] Disjoined Image Download Failed
    *Feb 1 20:55:06.512: %INSTALL-5-INSTALL_START_INFO: Chassis 1 R0/0: install_engine: Started install add tftp://172.16.5.199/EWC/17_9_4a/ap1g6
    *Feb 1 20:55:46.579: %INSTALL-3-OPERATION_ERROR_MESSAGE: Chassis 1 R0/0: install_engine: Failed to install_add package tftp://172.16.5.199/EWC/17_9_4a/ap1g6, Error: Failed to download file tftp://172.16.5.199/EWC/17_9_4a/ap1g6: Timed out
    note-icon

    注意：确保AP与EWC与TFTP或SFTP服务器之间没有阻止UDP端口69和TCP端口22。

    相关信息

    修订历史记录

    版本 发布日期 备注
    1.0
    16-Feb-2024
    初始版本
    TAC Authored

    由思科工程师提供

    • 莫雷诺·阿维拉行政长官

    此文档是否有帮助?

    Feedback反馈

    联系我们

    本文档适用于以下产品