Configurar a Ferramenta de Descoberta Ubiquiti no Windows: Um Guia Passo a Passo

Você tem um novo switch, roteador ou ponto de acesso Ubiquiti que está ansioso para configurar? Se sim, você está com sorte. Neste artigo, você vai aprender como configurar um controlador Ubiquiti Unifi e usar a ferramenta de descoberta Ubiquiti para instalar seu equipamento de rede Ubiquiti em pouco tempo.

Vamos começar instalando e configurando o controlador UniFi. Enquanto estivermos nisso, você também vai aprender como atualizar um controlador!

Instalando o Controlador Ubiquiti

Para gerenciar dispositivos de rede Ubiquiti, é necessário configurar a ferramenta de descoberta e o controlador Ubiquiti. Este controlador se conecta e gerencia todos os dispositivos em sua rede. Vamos configurar um.

Como o controlador é compatível com Windows, Mac OS X e algumas distribuições do Linux, vamos cobrir duas opções diferentes para instalar o controlador: instalação no Windows e Linux.

Instalando o Controlador Unifi no Windows Server

O uso do Windows Server ou até mesmo de um desktop com Windows é um hospedeiro comum para um Controlador Unifi. Configurar o controlador é tão fácil quanto instalar o software e iniciá-lo. O instalador vai configurar um servidor web básico no qual você pode fazer login e começar a gerenciar dispositivos.

Por padrão, o servidor web que o software do controlador instala será executado como um aplicativo. Por padrão, um usuário precisa estar logado para o controlador funcionar. Para resolver isso, você aprenderá como configurá-lo para ser executado como um serviço, removendo assim o requisito de login.

Pré-requisitos

Antes de começar, certifique-se de ter os seguintes pré-requisitos:

  • Windows Server 2019 – Todos esses passos também funcionarão na maioria das outras versões do Windows.
  • Software Unifi Controller para Windows – Este artigo usará a versão 5.13.29.
  • Amazon Corretto 8 – O Java 8 também é aceitável, desde que você atenda aos requisitos de licenciamento ou outros pacotes OpenJDK.
  • Uma conta para unifi.ui.com.

Instalando o Controlador

Para executar a ferramenta de descoberta Ubiquiti, você primeiro precisa instalar o software do controlador. Primeiro, você precisará instalar o Java se ainda não o tiver. O software do controlador requer Java. Neste artigo, você vai instalar o Amazon Corretto em vez do download típico do Java da Oracle. Se você precisar remover o Java por algum motivo, confira este artigo.

O Amazon Corretto é um instalador pré-empacotado do OpenJDK. Como a Oracle alterou os requisitos de licenciamento para o Java em uso não doméstico, muitas organizações optarão por usar o OpenJDK em vez do Java SE da Oracle.

Supondo que você já baixou o Corretto, execute o MSI para instalar o OpenJDK e siga as instruções, garantindo que você deixe tudo como padrão para concluir a instalação do OpenJDK.

Depois de instalar o Coretto, execute o software Unifi Controller que você já deve ter baixado. Aceite todas as configurações padrão e conclua a instalação. O software Unifi Controller será iniciado e, após cerca de um minuto, mostrará que está iniciado.

The Ubiquiti Unifi Controller software running

Uma vez que o controlador seja iniciado (veja acima), feche a janela e clique em Sim na confirmação para fechar o controlador. Isso interrompe o controlador para que você possa instalar o serviço.

Criando o Serviço do Windows

Depois de instalar o software do controlador, ele só funcionará se alguém estiver conectado. Para fazê-lo funcionar o tempo todo, você precisa configurá-lo para ser executado como um serviço do Windows. Mas primeiro, certifique-se de remover o atalho do Unifi na área de trabalho.

Se você executar o atalho padrão na área de trabalho, poderá interromper o serviço inadvertidamente fechando o aplicativo iniciado com o atalho.

The Unifi Windows shortcut

Para criar o serviço, abra um prompt de comando administrativo e execute os comandos abaixo. Você pode ver o que cada comando faz nos comentários.

Changes to the default Unifi Controller directory
 cd "%UserProfile%\Ubiquiti UniFi\"
 Configures Java to run the controller as a service and to start on boot
 java -jar lib\ace.jar installsvc
 Starts the Unifi service
 net start unifi

Agora que você configurou o serviço, verifique se ele está em execução usando o comando sc query unifi. Você não deve receber um erro e verá que o serviço está em execução.

Instalando no Linux

Embora seja possível usar um servidor Windows para o controlador Unifi, a Ubiquiti também oferece uma opção para executar o controlador no Linux. Vamos descobrir como fazer isso.

Pré-requisitos

Se você estiver instalando no Linux, verifique se possui o seguinte antecipadamente:

  • A current Debian or Ubuntu OS with root access – The steps will use Debian 10
  • Uma conta para unifi.ui.com

E é isso. Todo o resto será tratado durante o processo de instalação.

Instalando a Ferramenta de Descoberta e o Controlador Ubiquiti

Para instalar o controlador no Linux, você tem várias opções. A Ubiquiti tem algumas instruções sobre como instalar o controlador em seu site, mas elas cobrem apenas a instalação para algumas versões específicas do Linux. Para usar o Debian, use o script que foi postado nos fóruns Unifi pelo membro AmazedMender16.

Para iniciar a instalação, primeiro faça ssh no servidor Debian ou acesse o servidor a partir do console. Faça login como root ou como outro usuário com acesso root e execute su.

Atualize os repositórios do apt.

> apt-get update

Em seguida, instale os pacotes ca-certificates e wget.

> apt-get update && apt-get install ca-certificates wget -y

Baixe e execute o script de instalação do Controlador Unifi. Este script cuidará da instalação das dependências e do software do controlador para várias distribuições do Linux, incluindo o servidor Debian 10 que estamos usando.

## Baixa o script Shell
> wget https://get.glennr.nl/unifi/install/install_latest/unifi-latest.sh
## Executa o script
> bash unifi-latest.sh

Você será solicitado a fornecer algumas informações durante a execução do script. Primeiro, ele perguntará se você deseja manter o script baixado após a instalação. Na maioria dos casos, isso não é necessário, então você deve digitar n e pressionar Enter.

Ensuring the Unifi controller software is kept up to date

Você pode receber um prompt para atualizar os pacotes durante a instalação. Digite y e depois pressione enter.

Confirming it’s OK to update packages

Por fim, você será solicitado a adicionar o repositório apt para Unifi para atualizar o controlador de apt. Digite y e pressione enter, pois isso permitirá que as atualizações sejam realizadas através do apt.

Adding the Unifi Network Controller repo to apt

Assim que a instalação for concluída, o script exibirá a versão do controlador instalado e a URL a ser usada para iniciar a configuração do controlador.

Configurando a Ferramenta de Descoberta e Controlador Ubiquiti

Assim que você tiver o software do controlador instalado no servidor que estiver usando, as configurações serão as mesmas.

Vá para o site https://<ServerIP>:8443/ e você será apresentado com uma janela como abaixo.

Unifi controller home page

Insira o nome do controlador ou deixe-o como o padrão Unifi Network, aceite o EULA e a licença e clique no botão Next.

Em seguida, você será apresentado com um prompt de login onde deverá inserir seu nome de usuário e senha para unifi.ui.com. Autenticar com uma conta Ubiquiti é o padrão.

Se desejar usar uma conta local, clique em Alternar para Configuração Avançada e desmarque a opção Usar sua conta Ubiquiti para acesso local. Note que você ainda precisará de uma conta Ubiquiti, apenas estará usando uma conta diferente para fazer login localmente.

Será apresentado a você duas opções. Se estiver configurando um ponto de acesso Wi-Fi, por padrão, o Controlador Unifi tentará melhorar o desempenho do Wi-Fi em uma rede com carga pesada usando seus produtos Unifi. Isso inclui desligar a transmissão e multicast quando o(s) ponto(s) de acesso estiverem sobrecarregados. Você pode controlar essa configuração ativando a opção Optimizar automaticamente minha rede.

Nesta tela, você também pode optar por fazer backup automático do seu controlador. Se escolher essa opção, pode configurar um servidor para fazer backup e restaurar no menu de configurações do controlador. Se desejar desativar qualquer uma dessas opções, basta desmarcá-las.

UniFi Network Setup

Depois de definir as configurações acima, será solicitado que adote quaisquer dispositivos Unifi que estejam pendentes de adoção em sua rede. Se estiver configurando o controlador com um novo dispositivo Unifi, eles deverão aparecer na lista.

Se eles já foram adotados por outro controlador ou pelo aplicativo móvel Unifi, é necessário esquecê-los antes de poder adotá-los com este novo Controlador Unifi. Para solucionar problemas de adoção, consulte a documentação da Ubiquiti aqui.

Após a adoção do dispositivo, configure sua rede Wi-Fi fornecendo o SSID e a senha. Você pode pular esta configuração e concluí-la posteriormente clicando no botão Pular. Você também tem a opção de usar o mesmo SSID e senha para as redes Wi-Fi de 2,4 GHz e 5 GHz. Todas essas configurações podem ser alteradas no controlador após a configuração.

Setting up Wifi on the Unifi Controller

Em seguida, valide as configurações de instalação e clique em Concluir. Isso irá logá-lo no controlador e perguntar se você gostaria de fornecer dados de uso para Ubiquiti. Se você não se importa de fornecer dados anonimizados, selecione Enviar para Ubiquiti ou para optar por não enviar os dados, selecione Não Enviar. Isso também pode ser alterado nas páginas de configurações posteriormente.

Sending diagnostics and usage data to Ubiquiti

Depois de estar logado no Controlador Unifi, vá para o Site da Nuvem Unifi para acessar seu controlador pela internet usando sua conta Unifi. Você pode usar o site da Nuvem Unifi para acessar seu controlador mesmo se estiver na mesma rede. Aqui você pode usar a ferramenta de descoberta Ubiquiti para descobrir dispositivos e gerenciar todos os aspectos de seus dispositivos Ubiquiti!

Your Unifi Network

É isso aí! Você tem um novo controlador Unifi pronto para usar e configurado!

Atualizando o Controlador

Vamos supor que você já tenha um controlador instalado. Já faz um tempo desde que você o instalou e algumas atualizações foram lançadas. Você precisa saber como atualizá-lo.

A atualização de um controlador difere um pouco entre os sistemas operacionais. Independentemente disso, as atualizações são algo que precisa ser planejado para permanecer nas versões atuais e suportadas do controlador.

Atualizando o Controlador Unifi no Windows Server

Para atualizar o Controlador Unifi no Windows, primeiro vá para a página de download do Unifi e baixe o Controlador de Rede Unifi para Windows. Isso irá baixar a versão mais recente do software do controlador. Se precisar voltar para uma versão mais antiga, você pode selecionar Ver Software Anterior para baixar uma versão mais antiga do controlador também.

Assim que tiver o instalador baixado, desinstale o serviço que foi instalado durante a configuração, abrindo um prompt de comando administrativo e executando o seguinte.

## Alterações para o diretório padrão do controlador
> cd "%UserProfile%\Ubiquiti UniFi\"
## Remove o serviço do Windows
> java -jar lib\ace.jar uninstallsvc

Isso garantirá que todos os processos estejam funcionando conforme o esperado e que todos os arquivos sejam atualizados.

Assim que a desinstalação estiver concluída, execute o instalador baixado na etapa anterior. Depois que estiver completo, inicie o controlador através do atalho na área de trabalho que foi criado automaticamente durante a atualização e feche-o.

Agora vá para o prompt de comando e execute os comandos abaixo.

## Executa a nova versão do controlador como um serviço
> java -jar lib\ace.jar installsvc
## Inicia o serviço
> net start unifi

Depois que o serviço for instalado novamente, faça login novamente no controlador através da página da web em https://<IPdoServidor>:8443/.

Atualizando o Controlador Unifi no Linux

Atualizar o Controlador Unifi no Linux é muito menos problemático do que no Windows.

Acesse o servidor que está executando o controlador como root ou como um usuário que tenha acesso root.

Execute sudo apt upgrade unifi -y e aguarde a conclusão. Este comando usará apt para atualizar o pacote Unifi para a versão mais recente. Após ele indicar que a atualização foi concluída, você pode fazer login novamente no controlador através da página web.

Upgrading Unifi Controller on Linux

Conclusão

Embora haja muitas diferenças entre os Controladores Unifi do Windows e do Linux durante o processo de instalação e atualização de um Controlador Unifi, o resultado final não apresenta diferenças perceptíveis. Decidir se você deseja usar um Servidor Windows ou um Servidor Linux se resume a preferência pessoal e ao modelo de licenciamento do sistema operacional.

Para uso doméstico ou em laboratório, o Linux oferece uma pegada pequena e é gratuito para uso. Para uma empresa que requer suporte ao nível do sistema operacional e já possui um contrato de suporte existente com a Microsoft, o Windows Server pode ser a melhor opção.

Source:
https://adamtheautomator.com/ubiquiti-discovery-tool/