Instalação automática - Windows

Este guia descreve a instalação da plataforma Navixy On-Premise utilizando um script automatizado. Este tipo de instalação é projetado para servidores Windows.

Para servidores Linux, utilize as instruções apropriadas.

Pré-requisitos da instalação

Primeiro, você precisa ter o seguinte antes de iniciar a instalação:

Um servidor (ou servidores) que atenda a todos os Hardware do servidor requisitos. Observe que servidores Windows geralmente consomem mais recursos, portanto é sempre recomendável fornecer RAM e CPU adicionais.
Windows Server na versão mais recente disponível para você. O script de instalação foi desenvolvido no Windows Server 2025, mas usa PowerShell, portanto é aplicável a qualquer versão de SO atualizada.
Pacote de software Navixy e chave de licença fornecidos pela equipe Navixy.
Nome(s) de domínio registrado(s) que você usará para sua instância Navixy.

Se você não pretende usar domínios dedicados para a API e o painel administrativo, o configurador irá configurar o acesso a esses componentes como subdiretórios do domínio principal.

Este processo automático instalará todos os pré-requisitos de software listados em Software do servidor documento, o que significa que você não precisará instalá-los manualmente. No entanto, para Windows, é recomendado utilizar software de terceiros, como:

Editor de texto avançado para lidar com configurações e arquivos de log grandes (como Notepad++).
Qualquer compactador capaz de trabalhar com tar.gz arquivos (como 7zip). As versões mais recentes do Windows são capazes de lidar com esse tipo de arquivo nativamente, portanto o compactador de terceiros pode não ser necessário.

Todo o processo de instalação deve ser realizado como administrador.

Configuração de rede

Dependendo das configurações iniciais do seu servidor, ele pode não ter portas abertas necessárias para o funcionamento normal da plataforma. Pode ser necessário abrir explicitamente essas portas no firewall do Windows.

Isto normalmente inclui portas como:

Portas HTTP/HTTPS 80 e 443.
Porta 32233 para verificação de licença.
Quaisquer portas dedicadas para conectar dispositivos de rastreamento.
Porta 3306 para trabalhar com o banco de dados em um servidor dedicado.

Para mais informações, consulte a página de Rede em nossas instruções.

Pacote Navixy

O pacote de distribuição Navixy On-premise está sempre disponível para download no link direto:

⬇️ Download do pacote Navixy

Seu navegador pode avisar que o download não é seguro – isso é normal para arquivos tar.gz. Ignore o aviso e faça o download do arquivo com segurança.

Descompacte o arquivo recém-baixado e navegue até a pasta chamada \navixy-package. Esta será a pasta principal com a qual esta instrução trabalha, e quaisquer caminhos aninhados se referirão a ela, a menos que especificado explicitamente.

Script de instalação

Prossiga para \navixy-package\windows pasta e execute o NavixyInstaller.ps1 script com PowerShell:

Isto iniciará o processo de instalação, e você verá o menu de seleção do tipo de instalação:

Você pode optar por instalar todos os componentes em um único servidor ou implantar banco de dados e aplicação em servidores dedicados.

As etapas seguintes dependerão do tipo de instalação que você escolher.

Todos os componentes em um servidor

Para implantar a plataforma inteira em um único servidor, selecione Install All Components (Full Installation) - digite o número correspondente 1 e pressione Enter.

Se você pretende implantar o banco de dados em um servidor dedicado separado da aplicação, pule esta seção e prossiga para Dois servidores seção abaixo.

O script solicitará os seguintes valores:

Chave de licença - insira a combinação de caracteres recebida do Suporte Técnico Navixy. Se você não possuir uma chave de licença, encerre a instalação e contate seu Gerente de Conta ou o Suporte Técnico.
Senha do banco de dados - esta senha será atribuída ao usuário do banco de dados navixy e será usada pelos serviços backend para acessar o banco de dados.
Domínio do serviço - domínio básico da sua instância. Será usado por seus clientes para acessar o serviço de rastreamento.
Domínio da API (opcional) - se especificado, será usado para acessar a API. Se não for necessário, pressione Enter para pular.
Domínio do painel (opcional) - se especificado, será usado para acessar o painel administrativo. Se não for necessário, pressione Enter para pular.
Configuração SSL - y para HTTPS, n para HTTP.
Caminhos dos certificados SSL - caminhos completos para os certificados (no formato crt ) e chaves privadas (no formato key ) para cada um dos domínios especificados. Os arquivos de certificado e chave privada devem estar localizados em qualquer pasta no servidor.

Após especificar os parâmetros necessários, o script instalará a plataforma e todo o software necessário. Aqui você precisará aguardar algum tempo. A seguir estão as ações automáticas que você verá na interface do PowerShell:

Instalação do JDK
Download do Nginx
Instalação do MySQL
Configuração do MySQL
Carregamento da estrutura do banco de dados
Configuração do site
Configuração dos serviços backend

Nenhuma participação ativa é necessária de sua parte. Se o script encontrar algum erro, ele irá notificá-lo.

Neste ponto, a instalação está concluída. Prossiga para a seção Passos finais para verificar o funcionamento da plataforma.

Instalação em dois servidores

Esta seção descreve a instalação da plataforma dividida em dois servidores - um servidor de banco de dados dedicado e um servidor de aplicação dedicado. Aqui você precisa descompactar /navixy-package em ambos os servidores e começar implantando o banco de dados.

Servidor de banco de dados

Execute o NavixyInstaller.ps1 script com PowerShell e selecione Install Database Only - digite o número correspondente 2 e pressione Enter.

O script solicitará os seguintes valores:

Chave de licença - insira a combinação de caracteres recebida do Suporte Técnico Navixy. Se você não possuir uma chave de licença, encerre a instalação e contate seu Gerente de Conta ou o Suporte Técnico.
Senha do banco de dados - esta senha será atribuída ao usuário do banco de dados navixy e será usada pelos serviços backend para acessar o banco de dados. Salve esta senha!

Após especificar os parâmetros necessários, o script instalará o MySQL, importará a estrutura do banco de dados e a preencherá com valores padrão. Aguarde algum tempo até que o script termine sua operação.

Salve os seguintes valores:

Endereço IP do servidor
Senha do banco de dados

Você precisará desses valores na próxima etapa.

Servidor de aplicação

Execute o NavixyInstaller.ps1 script com PowerShell e selecione Instalar Frontend e Backend - digite o número correspondente 3 e pressione Enter.

O script solicitará os seguintes valores:

Endereço do servidor de banco de dados - insira o endereço IP do seu servidor de banco de dados. Pode ser um IP privado ou público dependendo da sua configuração de rede e firewall.
Porta do banco de dados - a porta padrão é 3306, portanto se você não a alterou intencionalmente ao instalar o banco de dados, pode pular esta etapa pressionando Enter.
Senha do banco de dados - esta senha será atribuída ao usuário do banco de dados navixy e será usada pelos serviços backend para acessar o banco de dados.
Domínio do serviço - domínio básico da sua instância. Será usado por seus clientes para acessar o serviço de rastreamento.
Domínio da API (opcional) - se especificado, será usado para acessar a API. Se não for necessário, pressione Enter para pular.
Domínio do painel (opcional) - se especificado, será usado para acessar o painel administrativo. Se não for necessário, pressione Enter para pular.
Configuração SSL - y para HTTPS, n para HTTP.
Caminhos dos certificados SSL - caminhos completos para os certificados (no formato crt ) e chaves privadas (no formato key ) para cada um dos domínios especificados. Os arquivos de certificado e chave privada devem estar localizados em qualquer pasta no servidor.

Depois que os parâmetros necessários forem especificados, o script instalará a plataforma e todo o software necessário. Aguarde algum tempo até que o script instale o JDK e o Nginx e então configure a aplicação. Se o script encontrar algum erro, ele irá notificá-lo.

Neste ponto, a instalação está concluída. Prossiga para a seção Passos finais.

Passos finais

Depois que o script concluir a implantação da aplicação, a janela Serviços do Windows será aberta. Aguarde alguns minutos, atualize a janela e verifique os status dos serviços Navixy:

Navixy api-server
Navixy sms-server
Navixy tcp-server

Os três devem estar ativos (em execução), como na captura de tela abaixo:

Se Navixy tcp-server encerrar, isto geralmente indica uma chave de licença incorreta. Entre em contato com o suporte técnico Navixy para instruções adicionais.

Acesso ao painel administrativo

Uma vez que tudo esteja instalado e os serviços funcionando, você precisa verificar a disponibilidade do domínio do seu painel administrativo no navegador. Ao especificá-lo na linha de endereço, você deverá ser direcionado para a página de login.

As credenciais de login são as padrão:

nome de usuário: admin
senha: admin

Considere alterar sua senha do painel administrativo logo após o login por motivos de segurança.

Acessando a interface do usuário

Para que a interface do usuário esteja disponível, você precisa especificar seu domínio primeiro em Admin panel → Service Preferences, conforme descrito neste documento: Nome do domínio.

Se o acima não for feito, a interface do usuário não poderá ser aberta.

Atualizações

Para atualizar o Navixy implantado em sistema Windows para a versão mais recente, consulte este documento: Atualização no Windows

Solução de problemas

Se você encontrar quaisquer problemas durante o processo de instalação ou configuração, consulte as Solução de problemas páginas para possíveis soluções.

AnteriorWindows PróximoInstalação manual - Windows

Atualizado há 4 meses

Isto foi útil?