O software do controlador Unifi pode lançar uma mensagem de falha na inicialização devido à falta de espaço livre na unidade do sistema. Além disso, a instalação corrompida ou desatualizada do Java ou do software do controlador Unifi também pode causar o erro em discussão.

O usuário afetado recebe o erro quando tenta iniciar o software do controlador Unifi. Em alguns casos, o usuário afetado encontrou o erro ao atualizar o software do controlador Unifi. Alguns dos afetados receberam a mensagem de erro depois que o aplicativo foi iniciado por 5 minutos ou mais. Este erro é relatado por usuários do Windows, Linux, Mac e Raspberry Pi.
Antes de prosseguir com o processo de solução de problemas, certifique-se de que seu tipo de rede seja Privado ou Domínio .
Solução 1: Feche os processos relacionados ao Unifi por meio do gerenciador de tarefas
O problema que você está encontrando pode ser causado por uma falha temporária de software / comunicação. Nesse caso, encerrar todos os processos relacionados ao Unifi e reiniciar o software pode resolver o problema. Para ilustração, discutiremos o processo para um PC com Windows.
- Feche o aplicativo do controlador Unifi.
- Agora, clique com o botão direito do mouse no botão Windows e, no menu exibido, clique em Gerenciador de Tarefas .
- Agora, na guia Processos , selecione o processo pertencente ao software do controlador Unifi e clique no botão Finalizar Processo . Repita para todos os processos pertencentes ao controlador Unifi .
- Em seguida, encerre todos os processos pertencentes a Java e MongoD.
- Em seguida, inicie o software do controlador para verificar se ele começou a funcionar normalmente. O aplicativo pode demorar um pouco para carregar, pois estará reconstruindo as dependências.
Solução 2: espaço vazio na unidade do sistema
O software do controlador Unifi requer algum espaço livre adicional na unidade do sistema para concluir sua operação. Você pode encontrar o erro em questão se não houver espaço livre suficiente disponível na unidade do sistema. Nesse contexto, a criação de algum espaço livre na unidade do sistema pode resolver o problema. Para ilustração, discutiremos o processo para Windows.
- Libere espaço na unidade C (unidade do sistema).
- Em seguida, inicie o aplicativo controlador se estiver funcionando bem.
Solução 3: Alterar o mecanismo especificado no arquivo de propriedades do sistema
Se o banco de dados foi criado pelo mecanismo de armazenamento 'mmapv1', mas o mecanismo de armazenamento especificado foi 'wiredTiger', então você pode encontrar o erro em questão. Nesse contexto, forçar o aplicativo controlador a usar o mecanismo de armazenamento mmapv1 pode resolver o problema. Para ilustração, discutiremos o processo para um PC com Windows.
- Inicie o File Explorer e navegue até o diretório de instalação do aplicativo controlador. Normalmente, é:
% USERPROFILE% \ Ubiquiti UniFi \ data
- Agora abra o arquivo System.Properties com o bloco de notas e adicione a seguinte linha no final do arquivo:
db.extraargs = - storageEngine = mmapv1
- Agora salve suas alterações e saia do Bloco de notas.
- Em seguida, inicie o aplicativo controlador e verifique se está funcionando bem.
Solução 4: use um perfil de usuário sem caracteres especiais
O controlador Unifi é conhecido por ter problemas quando o caminho para a pasta Ubiquiti Unifi tem caracteres especiais porque o perfil do usuário tem caracteres especiais em seu nome (por exemplo, C: \ Usuários \ ÄçìÞôñçò \ Ubiquiti UniFi) e, portanto, causa o erro em discussão. Nesse cenário, criar um novo perfil de usuário sem caracteres especiais pode resolver o problema. Lembre-se de que você pode alterar o nome do usuário atual, mas isso não refletirá no caminho para a pasta Ubiquiti Unifi, portanto, você deve criar uma nova conta de usuário e transferir todos os dados para esse usuário.
- Crie uma nova conta de usuário para o seu PC com Windows e transfira todos os seus dados para ele.
- Em seguida, verifique se o software do controlador está livre do erro.
Solução 5: limpar a porta padrão exigida pelo software do controlador Unifi
O aplicativo Unifi Controller requer a porta 8080 (por padrão) para operar normalmente. Você pode encontrar o erro em questão se a referida porta for usada por outro programa. Nesse caso, interromper o programa usando a referida porta ou configurar o programa problemático (ou o aplicativo Unifi Controller) para usar outra porta pode resolver o problema. Para ilustração, discutiremos o processo para um PC com Windows.
- Faça uma inicialização limpa do PC com Windows e verifique se o problema foi resolvido.
- Nesse caso, tente encontrar o programa que está criando o conflito de porta. Você também pode alterar a porta padrão para o aplicativo Unifi Controller.
Solução 6: renomear os registros Unifi
O controlador Unifi cria registros (como muitos outros aplicativos) para facilitar o processo de solução de problemas. Você pode encontrar o erro em questão se os referidos logs estiverem corrompidos. Nesse caso, renomear esses arquivos de log (arquivos de log mais novos serão criados na próxima inicialização) pode resolver o problema. Para ilustração, discutiremos o processo para Windows.
- Feche o aplicativo do controlador Unifi e elimine todos os seus processos relacionados por meio do Gerenciador de Tarefas (conforme discutido na Solução 1).
- Abra o File Explorer e navegue até o diretório de instalação . Normalmente, o seguinte caminho:
% USERPROFILE% \ Ubiquiti UniFi \ logs \
- Agora renomeie os arquivos de log. Não se esqueça de renomear os logs do mongod e do servidor (adicione .old no final da extensão do nome do arquivo). Em seguida, inicie o software para verificar se o problema foi resolvido.
Solução 7: Exclua os arquivos de diário na pasta Unifi
O software do controlador Unifi usa arquivos de diário para armazenar diferentes tipos de dados. Você pode encontrar o erro em discussão se esses arquivos de diário estiverem corrompidos. Nesse contexto, excluir esses arquivos de diário pode resolver o problema. Para elucidação, discutiremos o processo para um PC com Windows.
- Feche o software Unifi Controller e elimine todos os seus processos em execução por meio do Gerenciador de Tarefas (conforme discutido na solução 1).
- Inicie o seu Explorador de Arquivos e navegue até o diretório de instalação do aplicativo. Normalmente, é:
% USERPROFILE% \ Ubiquiti UniFi \ data \ db \ journal
- Faça backup de todos os arquivos da pasta em um local seguro (caso as coisas não funcionem).
- Agora, exclua todos os arquivos da pasta e reinicie o sistema.
- Ao reiniciar, inicie o aplicativo do controlador e verifique se ele está funcionando bem.
Solução 8: Instale o software do controlador Unifi como um serviço
O software Unifi Controller pode ter diferentes tipos de problemas se não for instalado como um serviço. O mesmo pode ser o motivo do erro atual. Nesse contexto, instalar o software do controlador como serviço pode resolver o problema.
- Saia do controlador e feche todos os seus processos em execução por meio do Gerenciador de Tarefas (conforme discutido na solução 1).
- Adicione o caminho Java nas variáveis ambientais do sistema (no final do caminho na variável Temp). Normalmente, é:
C: \ Arquivos de programas (x86) \ Java \ jre7 \ bin \ javaw.exe
- Clique na caixa de pesquisa do Windows (localizada na barra de tarefas do seu sistema) e digite Prompt de comando . Em seguida, na lista de resultados da pesquisa, clique com o botão direito em Prompt de Comando e clique em Executar como Administrador .
- Agora, digite o seguinte comando e pressione a tecla Enter :
cd "% UserProfile% \ Ubiquiti UniFi \"
- Em seguida, no diretório Unifi, digite o seguinte comando e pressione a tecla Enter :
java -jar lib \ ace.jar installsvc
- Quando disser “Instalação Completa”, digite o seguinte comando e pressione a tecla Enter :
java -jar lib \ ace.jar startsvc
- Em seguida, saia do prompt de comando.
- Para confirmar se o serviço “ Unifi ” está em execução, inicie o Gerenciador de Tarefas e verifique a guia de serviços do serviço Unifi.
- Agora acesse o IP da interface desejada do controlador e verifique se o problema foi resolvido.
Solução 9: atualize o Java para a versão mais recente
Java é essencial para a operação do software do controlador Unifi. Java é atualizado regularmente para atender a novos desenvolvimentos tecnológicos e corrigir os bugs conhecidos. Você pode encontrar o erro em questão se estiver usando uma versão desatualizada do Java. Nesse contexto, atualizar o Java para a compilação mais recente pode resolver o problema. Para elucidação, discutiremos o processo para um PC com Windows.
- Clique na caixa de pesquisa do Windows (localizada na barra de tarefas do seu sistema) e digite Java . Em seguida, na lista de resultados, clique em Configurar Java .
- Agora, clique na guia Atualizar e, em seguida, clique no botão Atualizar agora (próximo ao canto inferior direito da janela).
- Após atualizar o Java, verifique se o software do controlador Unifi está livre do erro.
Solução 10: Reinstale o Java
Se a atualização do Java não resolver o problema, o problema é causado pela instalação corrompida do Java ou por uma versão incompatível do Java. Nesse cenário, desinstalar e reinstalar o Java pode resolver o problema. Para ilustração, discutiremos o processo para Windows.
- Feche o software Unifi Controller e todos os seus processos relacionados por meio do Gerenciador de Tarefas (conforme discutido na solução 1).
- Se o aplicativo for instalado como serviço, desinstale o serviço .
- Clique na caixa de pesquisa do Windows (localizada na barra de tarefas do seu sistema) e digite Painel de controle. Em seguida, na lista de resultados, clique em Painel de controle .
- Em seguida, clique em Desinstalar um programa .
- Agora clique com o botão direito em Java e selecione Desinstalar . Em seguida, siga as instruções na tela para concluir o processo de desinstalação.
- Em seguida, reinicie o sistema, mas certifique-se de que o aplicativo controlador não seja iniciado na inicialização do sistema.
- Agora, baixe e instale a versão mais recente do Java (você deve instalar uma versão de 64 bits do Java no Windows para a operação adequada do Unifi). Se você receber um prompt do Firewall para permitir que o Java se comunique na rede, permita.
- Em seguida, inicie o aplicativo Controller e verifique se o erro está livre.
Solução 11: Reinstale o software do controlador de rede Unifi
Se reinstalar o Java não resolveu o problema, então o problema é causado por uma instalação corrompida ou desatualizada do software do controlador Unifi. Nesse cenário, desinstalar e reinstalar o software do controlador pode resolver o problema. Para elucidação, discutiremos o processo para um PC com Windows.
- Feche o aplicativo do controlador e elimine todos os seus processos relacionados por meio do Gerenciador de Tarefas (conforme discutido na solução 1).
- Inicie o Explorador de Arquivos e navegue até o seguinte caminho:
% userprofile% \ Ubiquiti UniFi \ data \ backup
- Em seguida, faça backup de seu arquivo de configuração (arquivo .unf) em um local seguro.
- Agora clique na barra de pesquisa do Windows na barra de tarefas do seu sistema e digite Painel de controle . Em seguida, na lista de resultados da pesquisa, clique em Painel de Controle .
- Em seguida, clique em Desinstalar um programa .
- Agora, na lista de aplicativos instalados, clique com o botão direito no software do controlador Unifi e clique em Desinstalar . Se você receber uma mensagem dizendo que deseja manter as configurações , clique no botão Não .
- Em seguida, siga as instruções na tela para concluir o processo de desinstalação.
- Em seguida, abra o Explorador de Arquivos e navegue até o seguinte caminho:
% userprofile% \ Ubiquiti UniFi
- Agora, exclua completamente esta pasta.
- Em seguida, remova o Java conforme discutido na solução 10.
- Agora baixe e instale o software controlador de rede Unifi mais recente.
- Em seguida, restaure as configurações do arquivo .unf (backup nas etapas 2 e 3).
- Agora, inicie o software controlador de rede Unifi e, com sorte, o erro estará livre.