Visão geral
Este artigo descreve como fazer upgrade ou downgrade da versão do firmware em dispositivos UniFi (pontos de acesso, switches, gateways), incluindo instruções sobre a atualização mais comum para a versão mais recente via GUI, bem como alterar manualmente a versão do firmware, seja para uma versão não lançada ou revertendo para uma versão de firmware mais antiga. Consulte nossos artigos relacionados abaixo se estiver procurando informações sobre como atualizar o software do controlador de rede UniFi ou como alterar a versão do firmware do Cloud Key.
NOTAS E REQUISITOS:
Se você estiver planejando usar uma versão de firmware diferente da oferecida pelo controlador de rede UniFi, desative as atualizações automáticas no controlador primeiro. As atualizações programadas reverterão o firmware para a versão oferecida pela Content Delivery Network (CDN), desde que o Controlador tenha acesso à Internet.
Atualização simples para a versão de firmware mais recente
Uma atualização simples do dispositivo para a versão mais recente pode ser feita no Controlador, na seção Devices. Quando houver uma atualização disponível, uma opção de atualização aparecerá quando você passar o mouse sobre cada dispositivo junto com as opções Locate e Restart (se estiver no modo de exibição de lista). Se estiver usando a visualização em grade, um pequeno ícone de atualização aparecerá no canto superior direito de cada dispositivo, conforme aplicável.
Também existe a opção de atualização contínua para dispositivos sem fio. Para usar este recurso, vá até a guia Devices e clique em Wireless. Um botão aparecerá na parte superior direita da tela, oferecendo a opção de Start Rolling Upgrade se houver algum dispositivo sem fio com atualizações pendentes na lista.
O restante deste artigo descreve como alterar o firmware quando uma simples atualização de dispositivo não é o que você está procurando. Você pode precisar de uma versão mais antiga ou não lançada. Isso pode ser útil para ajudar com problemas de adoção, solução de problemas ou simplesmente atualizar para o firmware mais recente disponível em desenvolvimento. É possível executar uma versão diferente de firmware em qualquer dispositivo UniFi. Normalmente, você executaria a mesma versão em cada tipo de dispositivo, mas, em alguns casos, talvez você só queira testar um novo firmware em um determinado local antes de implementá-lo em todo o site (ou em vários sites).
Como alterar o firmware por meio da IU da Web do controlador
Dispositivos com acesso à Internet
Para dispositivos não adotados, você verá uma opção de atualização na guia Devices do Controlador ao passar o mouse sobre esse dispositivo na lista. Você poderá realizar a ação de atualização antes de adotar o dispositivo, o que é especialmente útil se você estiver tendo problemas de adoção.
Para qualquer dispositivo UniFi adotado, você pode facilmente atualizar ou alterar o firmware do dispositivo na janela Propriedades do dispositivo. Na guia Devices, clique no dispositivo para expandir o painel Propriedades. Configtab >Manage Device > Custom Upgrade.
Nesta seção, você pode inserir um link que aponta para a nova versão do firmware. Os links de Firmware .bin (ou .tar para USGs) podem ser encontrados em nossa página oficial de Downloads, na seção Firmware , ou na seção Releases em nossa Comunidade. Se estiver usando a página Downloads:
1. Use o menu à esquerda para selecionar seu dispositivo.
2. Clique no firmware mais recente disponível (mostrado sob o cabeçalho Firmware, ao contrário dos cabeçalhos Software ou Documentação). Isso irá expandir as informações do firmware.
3. Clique em Download e leia e aceite os termos apresentados.
4. A próxima janela pop-up fornecerá o nome do firmware (agora é um bom momento para verificar se este é um arquivo .bin de firmware se estiver atualizando um UAP ou USW, ou um arquivo .tar se estiver atualizando um USG) - mas definitivamente não um arquivo de software (.exe, .pkg, .deb), um botão Download e um Direct URL . O URL direto é o link que você deve copiar para este método.
ATENÇÃO: Ao atualizar da versão de firmware 3.7.56 ou anterior, use http: // em vez de https: // no URL. Também é recomendável testar usando http: // se asatualizações de https estiverem falhando.
NOTA:Ao usar um link para um binário de firmware em nosso CDN, o dispositivo UniFi precisará ser capaz de resolver corretamente o host via DNS / acessar a WAN. A atualização personalizada também funcionaria para um servidor FTP ou HTTP hospedado localmente.
Dispositivos sem acesso à Internet (cache)
Se os dispositivos não têm acesso à internet, mas o UniFi Network Controller tem, uma boa opção é armazenar o firmware em cache, o que basicamente permite que o UniFi Network Controller forneça o link do firmware diretamente para atualização. O armazenamento em cache do firmware também pode ser usado como uma ferramenta quando outros métodos de atualização estão falhando, mantendo tudo dentro do controlador.
1. Faça o cache do firmware acessando Settings > Maintenance > Firmware e selecionando a guia All .
2. Você pode selecionar para visualizar Todos os dispositivos UniFi, apenas os dispositivos conhecidos ou apenas os dispositivos do local.
3. Selecione o (s) firmware (s) aplicável (is) e clique em Cache na coluna de ações para adicionar esse firmware à guia Em cache.
4. Depois de verificar se o firmware agora está na guia Em cache, vá para a seção Devices e passe o mouse sobre o dispositivo em questão. Uma opção "Upgrade" agora deve aparecer junto com o habitual Locate e Restart.
Como alterar o firmware usando atualização local via SSH
Aplicável para: UniFi AP / UniFi Switch
Dispositivos com acesso à Internet
Se o UAP / USW tiver conectividade com a Internet, é mais fácil permitir que ele baixe o arquivo de atualização (URL direto) e instale-o. SSH para o dispositivo e , em seguida, execute o seguinte comando substituindo o URL por Direct URL encontrado na página Downloads . Você poderá copiar este link assim que localizar o arquivo do firmware, clicar em Download e ler e aceitar os termos. Verifique se você está usando o arquivo .bin do firmware específico para o seu dispositivo (UAP, USW, etc) e não o software do controlador de rede UniFi.
Ele irá baixar o arquivo especificado, atualizá-lo e reinicializar com a nova versão.
Dispositivos sem acesso à Internet
1. Baixe o arquivo .bin do firmware em nossa página de Downloads . Verifique se você está baixando o arquivo .bin do firmware específico para o seu dispositivo (UAP, USW, etc) e não o software do controlador de rede UniFi.
2. Usando um terminal como o aplicativo Terminal no macOS / Linux ou PuTTY no Windows, emita o comando abaixo para transferir o arquivo .bin para o dispositivo e colocá-lo no sistema de arquivos do dispositivo UniFi. Lembre-se de fazer as substituições apropriadas antes de executar o comando:
scp /foldername/firmwarefile.bin user @ IP-of-UAP-or-Switch : /tmp/fwupdate.bin
Veja abaixo um exemplo deste comando para um UAP-FlexHD com o arquivo da versão 4.0.80 do firmware baixado e salvo em um desktop Macbook Pro, onde o endereço IP do UAP é 192.168.1.219:
scp /Users/alexpro/Desktop/BZ.mt7621.v4.0.80.10875.200111.1635.bin Alex@192.168.1.219: /tmp/fwupdate.bin
3. Agora você será solicitado a inserir a senha que usa para o acesso SSH. Se você não tiver certeza do usuário de autenticação SSH ou senha de seus dispositivos, dê uma olhada neste artigo .
Conforme você digita, nenhum caractere aparecerá na tela para fins de segurança. Insira com cuidado a senha correta e pressione Enter.
4. Em seguida, conecte-se ao dispositivo via SSH e emita o seguinte comando para iniciar uma atualização local.
syswrapper.sh upgrade2 &
Dica do usuário: O erro "Firmware inválido" ao atualizar via SSH pode ser causado pela instalação de uma versão incorreta primeiro. Corrija isso indo para a pasta tmp e excluindo fwupdate.bin primeiro e, em seguida, tentando o comando de atualização mais uma vez (certificando-se de que ele esteja na pasta correta no Controlador).
Aplicável para: UniFi Security Gateway / UniFi Security Gateway Pro
Todos os modelos de USG permitem atualização local, embora usem um arquivo .tar em vez do .bin usado pelos APs e switches. Existem duas opções para uma atualização local, um download via HTTP ou HTTPS (HTTPS altamente recomendado) do próprio USG e um método de fazer uma atualização offline.
Atualização de Internet
Se o USG tiver conectividade com a Internet, é mais fácil permitir que ele baixe o arquivo de atualização e instale-o. Via SSH para USG, execute o seguinte, substituindo o URL por um encontrado na página Downloads . Verifique se você está baixando o arquivo .tar do firmware específico para o seu dispositivo e não o software do controlador de rede UniFi.
Ele irá baixar o arquivo especificado, atualizá-lo e reinicializar com a nova versão.
Atualização offline
Onde o USG ainda não está conectado à Internet, você pode baixar o arquivo tar que corresponde ao seu modelo USG da página Downloads para o seu sistema local e, em seguida, usar o SCP para copiá-lo para o USG.
scp /foldername/upgrade-vX.Y.Z.tar user@<IP-of-USG>:~/upgrade.tar
Em seguida, SSH para o USG e execute o seguinte para realizar a atualização usando esse arquivo.
sudo syswrapper.sh upgrade upgrade.tar
Aplicável a: UniFi Dream Machine / UniFi Dream Machine Pro
Conecte-se ao dispositivo UDM via SSH e execute um dos comandos a seguir, substituindo o URL por um encontrado na página Downloads . Verifique se você está baixando o arquivo .bin do firmware específico para o seu modelo UDM e não o software do controlador de rede UniFi.
Este comando puxa o firmware diretamente, baixando-o e usando-o para atualizar seu UDM-Pro. Se você tiver um link para o arquivo .bin do firmware, este é um bom método a ser usado:
ubnt-upgrade https://fw-download.ubnt.com/data/udm/e649-udmpro-1.6.6-0761feeda3504456bdb80e09527ab56a.bin
Para o método a seguir, baixe o arquivo .bin do firmware e coloque-o no dispositivo (UDM-Pro neste exemplo) usando o SCP conforme descrito nas instruções acima para Dispositivos sem acesso à Internet . Em seguida, emita o comando ubnt-upgrade seguido pelo caminho de onde ele está armazenado. Recomenda-se que seja armazenado em / mnt / data / para que o comando se pareça com isto (substituindo "firmware-name.bin" pelo nome do arquivo de firmware real):
ubnt-upgrade /mnt/data/firmware-name.bin
Fonte: https://help.ui.com/hc/en-us/articles/204910064-UniFi-Upgrade-the-Firmware-of-a-UniFi-Device