Atualizar redes EWC não homogêneas com servidores TFTP e SFTP via APs
Contents
Introdução
Este documento descreve em detalhes o processo de download da imagem do ponto de acesso para redes EWC não homogêneas com servidores TFTP e SFTP.
Pré-requisitos
Requisitos
A Cisco recomenda que você tenha conhecimento destes tópicos:
- Generais do processo de união AP
- Controladores LAN sem fio incorporados nos APs Catalyst 9100 Series
- Transferências de arquivos TFTP
- Transferências de arquivos SFTP
- Uso da interface de linha de comando do Linux
Componentes Utilizados
As informações neste documento são baseadas nestas versões de software e hardware:
- WLC Catalyst 9800 integrado em um AP Catalyst 9120AXI, Cisco IOS® XE Cupertino 17.9.3
- AP Catalyst 9105AXI
- TFTPD-64 versão 4.64
- Pacote Linux TFTPD-HPA
- Pacote SSH Linux
As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.
Informações de Apoio
Os access points que atuam como EWC só podem fornecer seu próprio tipo de imagem de AP para outros access points quando eles se unem à rede. Se sua rede consiste em uma implantação não homogênea (APs de uma imagem diferente do AP que atua como EWC), você precisa implantar um servidor TFTP ou SFTP e hospedar as imagens de AP lá para que os APs façam o download a partir daí.
Note: Isso se aplica apenas aos processos de atualização de imagem do AP que fazem download da imagem localmente de dentro da rede. Os APs também podem baixar imagens diretamente da Internet através da atualização do CCO.
Configurar
Diagrama de Rede
Diagrama de Rede
Download de imagem via TFTP
TFTPD-64 (Windows)
O TFTPD-64 é um utilitário FOS (Free and Open Source) bem conhecido que inclui recursos de TFTP. Consulte seu site para fazer o download e a instalação.
Certifique-se de descompactar a imagem do pacote AP na pasta adequada para o servidor TFTP.
Arquivos descompactados na pasta TFTP
Uma vez que o AP começa a fazer o download de sua imagem do servidor TFTP, uma janela pop-up do TFTP é exibida e detalha o progresso da transferência da imagem.
Progresso da transferência de arquivos TFTPD-64
TFTPD-HPA (Linux)
TFTPD-HPA é um pacote básico e bem conhecido que pode ser obtido dos repositórios APT. Consulte a documentação do Ubuntu TFTP para obter mais informações.
Certifique-se de que suas configurações TFTP estejam apontadas adequadamente para sua pasta TFTP e que a imagem do pacote AP esteja descompactada.
Configurações de TFTP e arquivos descompactados no Ubuntu
Você pode acompanhar o processo de transferência de imagem registrado por padrão em /var/lib/syslog no Ubuntu.
Logs de transferência de arquivos TFTP no Ubuntu
Configuração de WLC
Na GUI do WLC, vá para Administration > Software Management > Software Upgrade. Selecione TFTP na lista suspensa em Mode e forneça as informações do seu servidor TFTP.
Escolha Save para salvar o perfil de descarregamento de imagens e permitir o descarregamento de imagens para novos AP que ingressam na rede EWC ou clique em Save & Download para ativar imediatamente o processo de descarregamento em todos os AP, incluindo o AP EWC do EWC.
Configuração de TFTP para atualização de software
Configuração de 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>
Download de imagem via SFTP
Servidor SFTP (Linux)
Como o SFTP funciona no SSH, você pode usar o pacote Linux SSH para configurar um servidor SFTP simples no Linux.
Certifique-se de fornecer as configurações adequadas para o SFTP no arquivo /etc/ssh/ssh_config. Adicione permissões para os usuários (ou grupos) aos diretórios SFTP conforme necessário e descompacte o arquivo de imagem do pacote AP no caminho desejado.
Configuração do SFTP no Ubuntu
Semelhante ao servidor TFTP no Linux, você também pode rastrear a atividade do SFTP. Por padrão, os logs são configurados para serem armazenados em /var/log/auth.log. Certifique-se de adicionar as configurações de nível de log conforme necessário.
Atividade e configuração do log SFTP no Ubuntu.
Note: O dispositivo que se conecta ao servidor SFTP é o EWC, não o AP que solicita a imagem. Tal deve-se ao fato de as credenciais serem fornecidas no CER e não nos AP antes de aderirem ao CEE. A imagem então é encaminhada para o AP real que a solicita.
Configuração de WLC
Na GUI do WLC, navegue para Administration > Software Management > Software Upgrade. Selecione SFTP na lista suspensa em Mode e forneça as informações e credenciais do seu servidor STFTP.
Escolha Save para salvar o perfil de download de imagem e permitir o download de imagem para novos APs que ingressam na rede EWC ou clique em Save & Download para disparar imediatamente o processo de download em todos os APs, incluindo o AP do EWC.
Configuração do SFTP na GUI
Configuração de 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>
Verificar
A CAPWAP State Machine registra o fluxo de APs como você normalmente esperaria para qualquer outro processo de download de imagem de 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.'
No Syslog da WLC, o download da imagem é marcado como Bem-sucedido.
*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
Download de imagem AP
Depois de iniciar um processo de atualização, você pode rastrear o processo de pré-download de imagem do AP com o comando show ap image no EWC. Quando todos os APs terminarem de fazer o download da imagem, você poderá ver a imagem de destino na Imagem de Backup do 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
Como alternativa, na GUI, a barra de progresso alcança a etapa Ativate, na qual somente o recarregamento é necessário para trocar o EWC para o novo código.
Barra de Progresso de Atualização da IU da Web do EWC
Abaixo, o EWC mostra o status de pré-download dos APs.
Status de Pré-download da Imagem de APs de IU da Web do EWC
Troubleshooting
No processo de download da imagem do AP, você pode ver nos registros da máquina de estado do CAPWAP no AP que o download não pode iniciar.
[*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).
Para entender por que o AP não consegue fazer o download da imagem, você pode verificar o Syslog no EWC. É comum ver downloads de imagem com falha devido a caminhos especificados errados para os servidores TFTP e SFTP, que são refletidos corretamente nos logs.
Para 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
Para 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
Certifique-se de que seu servidor TFTP ou SFTP esteja acessível pelos APs e pelo EWC. Caso contrário, um log Timed Out pode ser visto no Syslog 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: Certifique-se de que a porta UDP 69 para TFTP e a porta TCP 22 para SFTP não estejam bloqueadas entre os APs e EWC e seu servidor TFTP ou SFTP.
Informações Relacionadas
- White Paper sobre Cisco Embedded Wireless Controller em Catalyst Access Points (EWC)
- Dados técnicos do Cisco Embedded Wireless Controller em Pontos de Acesso Catalyst
- Perguntas frequentes sobre o Cisco Embedded Wireless Controller em pontos de acesso Catalyst
- Entender o processo de ingresso no AP com o Catalyst 9800 WLC
- Notas de versão do Cisco Catalyst 9800 Series Wireless LAN Controller, Cisco IOS XE
Histórico de revisões
| Revisão | Data de publicação | Comentários |
|---|---|---|
2.0 |
05-Aug-2025
|
Formatação, verificação de PII, estilo |
1.0 |
16-Feb-2024
|
Versão inicial |
FeedbackContate a Cisco
- Abrir um caso de suporte
- (É necessário um Contrato de Serviço da Cisco)