Atualizar APs em redes EWC não homogêneas com servidores TFTP e SFTP

Atualizado:16 de fevereiro de 2024
ID do documento:221705

Linguagem imparcial

O conjunto de documentação deste produto faz o possível para usar uma linguagem imparcial. Para os fins deste conjunto de documentação, a imparcialidade é definida como uma linguagem que não implica em discriminação baseada em idade, deficiência, gênero, identidade racial, identidade étnica, orientação sexual, status socioeconômico e interseccionalidade. Pode haver exceções na documentação devido à linguagem codificada nas interfaces de usuário do software do produto, linguagem usada com base na documentação de RFP ou linguagem usada por um produto de terceiros referenciado. Saiba mais sobre como a Cisco está usando a linguagem inclusiva.

Sobre esta tradução

A Cisco traduziu este documento com a ajuda de tecnologias de tradução automática e humana para oferecer conteúdo de suporte aos seus usuários no seu próprio idioma, independentemente da localização. Observe que mesmo a melhor tradução automática não será tão precisa quanto as realizadas por um tradutor profissional. A Cisco Systems, Inc. não se responsabiliza pela precisão destas traduções e recomenda que o documento original em inglês (link fornecido) seja sempre consultado.

    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.
    • TFTPD-HPA Pacote Linux.
    • 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 do AP para que os APs façam o download a partir daí.

    note-icon

    Observação: isso se aplica somente a 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

    Network DiagramDiagrama 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.

    Unzipped Files in the TFTP FolderArquivos 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.

    TFTPD-64 File Transfer ProgressProgresso 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 TFTP do Ubuntu 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.

    TFTP Configurations and Unzipped Files in UbuntuConfigurações de TFTP e arquivos descompactados no Ubuntu

    Você pode rastrear o processo de transferência de imagem registrado por padrão em /var/lib/syslog no Ubuntu.

    TFTP File Transfer Logs on UbuntuLogs 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 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.

    TFTP Configuration for Software UpgradeConfiguraçã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 SSH do Linux 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.

    SFTP Configuration in UbuntuConfiguração do SFTP no Ubuntu

    Da mesma forma que o 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.

    SFTP Log Activity and Configuration in Ubuntu.Atividade e configuração do log SFTP no Ubuntu.

    note-icon

    Observação: 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, vá 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.

    SFTP Configuration in the GUIConfiguraçã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 da 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 dos APs.

    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.

    EWC Web UI Upgrade Progress BarBarra de Progresso de Atualização da IU da Web do EWC

    Abaixo, o EWC mostra o status de pré-download dos APs.

    EWC Web UI APs Image Predownload StatusStatus 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 registros:

    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-icon

    Observação: 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

    Histórico de revisões

    Revisão Data de publicação Comentários
    1.0
    16-Feb-2024
    Versão inicial
    TAC Authored

    Colaborado por engenheiros da Cisco

    • Executivo Moreno Avila

    Este documento lhe foi útil?

    FeedbackFeedback

    Contate a Cisco

    Este documento se refere a estes produtos