> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/device-activation.md). # Ativação do dispositivo Ativar dispositivos Navixy on-premise segue o mesmo processo da versão PaaS, com uma exceção: a ativação ocorre em seu servidor, e a troca e o processamento de dados acontecem dentro da sua infraestrutura. Garantindo funcionalidade contínua ao mesmo tempo em que mantém a segurança dos dados, essa distinção oferece controle total e maior flexibilidade. Portanto, as etapas fundamentais de solução de problemas permanecem consistentes, e você pode encontrá-las em nossa página do Centro de Especialistas. [Possíveis problemas durante a ativação do dispositivo](broken://spaces/0UK7kSlbuUoXpMxbDcGT/pages/b5b0bd61a7cf684179c5e06cb252a5bb932efd4e) Se você encontrar problemas de ativação, recomendamos consultar este manual abrangente para orientação de solução de problemas. Ele cobre os problemas mais prevalentes e suas respectivas soluções. Além disso, desafios específicos podem surgir em instâncias On-premise devido aos aspectos únicos envolvidos na instalação e operação da plataforma em servidores dedicados. Nas seções seguintes, iremos detalhar esses problemas e explorar resoluções eficazes para cada um. ## Gateway de SMS A plataforma On-premise não possui um gateway SMS pré-instalado, nem mesmo para fins de teste. Assim, é necessário ter um gateway SMS ativo configurado para habilitar a ativação automática. Sem ele, somente a ativação manual é possível. No caso de você estar tentando auto-ativar o dispositivo em uma plataforma recém-instalada ou se nunca configurou um gateway SMS, o processo de ativação não ocorrerá. Nessa situação, você tem duas opções: configurar o gateway SMS ou ativar o dispositivo manualmente. Se você possui um gateway SMS e ele funcionava anteriormente, verifique seu funcionamento de acordo com esta página: [Solução de problemas do gateway SMS On-Premise](/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/on-premise-sms-gateway-troubleshooting.md) ## Serviços de backend Dois serviços Java de backend estão envolvidos no processo de ativação do dispositivo: SMS-server e TCP-server. Antes de tudo, é necessário certificar-se de que os serviços estão ativos e em execução. [Verificação dos status dos serviços](/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/checking-service-statuses.md) Quando você tiver certeza de que os serviços estão operacionais, poderá abordar o problema de forma mais precisa. #### SMS-server Tudo o que você precisa verificar para este serviço são seus logs. Lá você deve procurar entradas contendo o número de telefone do dispositivo. Se houver qualquer problema por parte do SMS-server, você verá entradas começando com `WARN` ou `ERROR`. Se o conteúdo dessas entradas não revelar a essência do problema, encaminhe-as ao suporte técnico para receber assistência adicional. #### TCP-server Novamente, examine os logs do serviço em busca de entradas começando com `WARN` ou `ERROR`, mas desta vez use o IMEI do dispositivo para a busca. Se você observar erros de processamento de dados nos registros, reporte-os ao suporte técnico. Além disso, o servidor TCP inicializa portas para conexão de dispositivos na inicialização. Se alguma porta não puder ser inicializada, a conexão a ela e a ativação do dispositivo ficarão indisponíveis. Um registro desse problema também estará presente no log. O número da porta necessária pode ser encontrado em [descrição do dispositivo](https://www.navixy.com/devices/). ## Rede A ativação é realizada em um servidor localizado em uma infraestrutura separada, que geralmente é protegida por um firewall e outros sistemas de segurança. Embora a segurança seja crucial, ela às vezes pode impedir o recebimento de dados. Certifique-se de que a porta do seu dispositivo esteja disponível externamente e que a comunicação bidirecional com o servidor seja permitida. Ferramentas para ajudar a verificar isso: * *comando telnet* - ferramenta básica para verificar a disponibilidade da porta. * *tcpdump* - analisador de dados útil para verificar se pacotes de dados estão chegando ao servidor. ## Versão da plataforma Como a plataforma Navixy On-premise é atualizada apenas mediante solicitação, versões instaladas anteriormente tornam-se progressivamente obsoletas. Essas versões desatualizadas podem causar diversos problemas no funcionamento dos dispositivos e podem não suportar a ativação de novos modelos. Consequentemente, torna-se cada vez mais difícil garantir funcionalidade e compatibilidade ideais. Verifique sua versão da plataforma conforme as instruções nesta página: [Versão atual](/docs/on-premise/pt-br/qa/software-updates/current-version.md) Se estiver desatualizada, entre em contato com o suporte técnico da Navixy para solicitar uma nova build. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/troubleshooting/device-activation.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.