For the complete documentation index, see llms.txt. This page is also available as Markdown.

Assistente de configuração

Execute o assistente de configuração do Ubuntu para o Navixy On-Premise para definir domínios, SSL, gateways de SMS e e-mail, Chaves de API do Google Maps e a chave de licença.

A plataforma Navixy oferece um assistente de configuração que os usuários podem usar para configurar a plataforma inicialmente ou modificar algumas configurações comuns. Embora todas as configurações descritas abaixo possam ser aplicadas diretamente às configurações do banco de dados e do serviço, fazer isso pode ser arriscado se não for tratado com cuidado. Para evitar qualquer risco potencial, é altamente recomendável usar o configurador.

O assistente de configuração só pode ser usado para instâncias da Navixy implantadas com o script de instalação no Ubuntu. Esse assistente não se aplica a outros métodos de implantação.

Iniciando o assistente de configuração

Para executar o assistente, vá para o /navixy-package diretório e execute ./configure.sh

Você verá o menu principal:

On-Premise - assistente de configuração

A seguir está a explicação de cada menu e submenu:

1. Configurações de nome de domínio e SSL

1.1. Nomes de domínio

A única opção aqui é alterar os nomes de domínio e o SSL.

Os nomes de domínio e os certificados SSL são especificados durante a instalação inicial. No entanto, pode haver situações em que você precise alterar alguns deles em uma plataforma existente.

O assistente de configuração permite que você faça a configuração com um único nome de domínio para toda a plataforma ou com três nomes de domínio - separados para a API, para o painel de administração e para a interface do usuário.

No caso de um único nome de domínio, você só precisa especificar o domínio do seu serviço na primeira etapa e deixar os outros dois domínios em branco. Nesse caso, a API e o painel de administração serão configurados como subdiretórios (isso é feito automaticamente). Exemplos:

Se você estiver realizando uma configuração com três nomes de domínio , você precisa especificar sequencialmente:

  • Domínio do serviço (usado para a interface do usuário e Ativar novo rastreador). Ex.: my.domain.com

  • Domínio da API (usado para todas as operações da API). Ex.: api.domain.com

  • Domínio do painel de administração (usado para acessar o painel de administração). Ex.: panel.domain.com

On-Premise - Configurações de domínio
On-Premise - Configurações da API
On-Premise - Configurações do painel

Depois que todos os domínios forem especificados, o assistente mostrará os resultados da sua configuração. Se precisar alterar algo, execute o assistente novamente

On-Premise - Finalizando a configuração

Você pode obter mais informações sobre nomes de domínio nesta página: Domínios

1.2. Certificados SSL

Depois que os nomes de domínio forem configurados, você verá um menu de instalação de certificado SSL.

On-Premise - Certificados SSL

Se você não pretende usar SSL de forma alguma, basta selecionar Não e o script será encerrado, salvando apenas a configuração do nome de domínio.

Se você selecionar Sim, sua plataforma será configurada para usar HTTPS.

Em seguida, o script perguntará se você vai usar certificados SSL gratuitos do Let's Encrypt ou se deseja usar os seus próprios certificados.

On-Premise - Renovação de certificados SSL

Certificado gratuito do Let's Encrypt

Selecione Sim para instalar certificados SSL gratuitos do Let's Encrypt para os seus domínios. Isso também configurará a renovação automática dos certificados, para que você não precise renová-los manualmente.

O script instalará o software necessário para emitir o certificado (isso pode levar algum tempo).

Será solicitado que você especifique seu endereço de e-mail. Isso não é necessário, mas é recomendável.

On-Premise - Let's Encrypt

O script reconhecerá automaticamente os nomes de domínio (obtendo-os das configurações), gerará e instalará os certificados. Depois disso, o script será encerrado.

Agora você configurou os nomes de domínio e seu site está protegido por SSL.

Seu próprio certificado SSL

Selecionar a Não opção em resposta à pergunta sobre certificados SSL do Let's Encrypt levará você ao menu de instalação dos seus próprios certificados SSL. Para prosseguir, você deve ter um certificado válido de cadeia completa, bem como sua chave privada. Coloque-os em algum lugar no seu servidor. O local padrão é /etc/nginx/ssl.

Primeiro, você precisa especificar o caminho para o arquivo do certificado:

On-Premise - Certificado próprio

Em seguida, especifique o caminho para o arquivo da chave privada do seu certificado SSL:

On-Premise - Chave do certificado próprio

Os caminhos dos seus certificados serão inseridos na configuração do Nginx.

Os certificados agora estão instalados, e seus domínios estão protegidos por SSL.

2. Configurações de SMS

Aqui você pode aplicar as configurações do seu gateway de SMS e também especificar as credenciais do remetente de mensagens SMS de serviço.

On-Premise - Gateway de SMS

2.1. Configurar gateway de SMS

A primeira opção neste menu permite desativar o gateway de SMS se você já tiver um configurado e não precisar mais usá-lo.

As outras opções permitem aplicar as configurações de um provedor específico de serviço de gateway de SMS.

A última opção permite conectar o gateway de SMS via protocolo SMPP. Essa opção também é adequada se o seu provedor de gateway não estiver na lista, mas oferecer suporte a SMPP do lado dele.

On-Premise - Configuração do gateway de SMS

Você pode saber mais sobre gateways de SMS na página Gateways de mensagens.

Configurar “nome do remetente” e “número de telefone do remetente”

Neste menu, você pode especificar o número e o nome do remetente das mensagens SMS de serviço, se necessário.

On-Premise - Número de telefone do gateway de SMS
On-Premise - Identificador do gateway de SMS

3. Configurações do gateway de e-mail

Aqui você pode configurar apenas as configurações de e-mail de feedback. Observe: As principais configurações do gateway de e-mail são definidas no painel de administração (Gateways de mensagens).

O script solicitará que você especifique o endereço de e-mail para receber os feedbacks dos usuários da seção de ajuda (endereço de e-mail PARA).

On-Premise - Gateway de e-mail

Em seguida, será perguntado sobre a substituição do e-mail do usuário.

On-Premise - Configuração do gateway de e-mail

Selecione SIM para usar o endereço de e-mail do usuário para enviar solicitações de feedback.

Selecione NÃO para substituir o endereço de e-mail do remetente por um específico. Nesse caso, o script solicitará que você especifique esse endereço de e-mail (endereço de e-mail DE).

On-Premise - Feedback do gateway de e-mail

4. Configurações da API do Google Maps

Aqui você pode especificar a chave da API do Google Maps se você não adquiriu o pacote Premium GIS da Navixy, mas preferiu usar a chave que comprou por conta própria (GIS)

On-Premise - Chaves de API do Google Maps

Primeiro, você precisa especificar a chave JavaScript da API do Google (necessária para a disponibilidade dos mapas).

On-Premise - Chave JavaScript da API do Google Maps

Em seguida, aplique a chave do servidor da API do Google (necessária para operações de geocodificação).

On-Premise - Chaves de API do Google Maps

5. Chave de licença da Navixy

Esta seção contém duas opções.

On-Premise - Chave de licença da Navixy

5.1. Alterar a chave de licença

Aqui você pode especificar a chave de licença para sua instância On-Premise. A chave de licença é aplicada durante a instalação inicial da plataforma ou, se for perdida ou corrompida por algum motivo (geralmente como consequência de uma alteração indevida no banco de dados). A chave de licença é emitida e fornecida pelo suporte técnico.

Após selecionar esta opção, você verá um aviso de que alterar a chave de licença sem cuidado pode tornar a plataforma inoperante.

On-Premise - Alterar a chave de licença

Depois disso, você precisa aplicar a chave de licença recebida. Trata-se de uma combinação de caracteres bastante longa, então pode ser difícil digitá-la manualmente. Você pode colar a chave da área de transferência usando a combinação Shift+Insert . Como alternativa, você pode manter Shift e use clique com o botão direito do mouse.

On-Premise - Inserir chave de licença

A chave será inserida no banco de dados, e sua instância terá uma licença válida.

5.2. Solicitar chave de avaliação

Esta opção só pode ser usada para obter uma chave de avaliação única. A chave é válida por 30 dias. Não use esta opção se você já tiver uma chave válida.

On-Premise - Solicitar chave de avaliação
  • Você não pode reemitir ou renovar a chave de avaliação dessa maneira.

  • Você não pode restaurar uma chave perdida dessa maneira.

  • Você não pode restaurar uma licença desativada dessa maneira.

Depois que sua avaliação expirar e você quiser continuar usando sua instância On-Premise, entre em contato com nossa equipe de sucesso do cliente para obter a chave de licença comercial.

6. Configurações de plugins

Os plugins permitem modificar ou habilitar várias funções da plataforma. Como o configurador foi projetado para a configuração básica da plataforma, você encontrará apenas três plugins neste menu.

On-Premise - Configurações de plugins

6.1. Configurações do código de ativação

Aqui você pode ativar ou desativar o uso de códigos de ativação obrigatórios para o registro do dispositivo. Se a opção “Obrigatório” estiver ativada, os usuários não poderão registrar um dispositivo sem um código de ativação.

On-Premise - Configurações de códigos de ativação

6.2. Configurações de logotipo personalizado

Aqui você pode definir um logotipo especial para um usuário individual.

Observe: o logotipo de toda a plataforma é personalizado no painel de administração.

O assistente de configuração solicitará que você especifique o ID do usuário (ele pode ser encontrado no painel de administração ou na interface do usuário)

On-Premise - Configurações do logotipo

Em seguida, você precisa especificar um link para o logotipo do usuário. Ele pode estar localizado em um recurso externo ou localmente no servidor, em um diretório do site. O logotipo deve estar no formato PNG, e o tamanho recomendado é 400x400.

On-Premise - Logotipo

O logotipo será aplicado à interface do usuário e aos Relatórios.

6.3. Configurações da seção de ajuda

Aqui você pode escolher ocultar ou exibir a seção de ajuda na interface do usuário (ela é exibida por padrão). A seção de ajuda leva ao site da Navixy, então desativá-la pode ser útil para marca branca.

On-Premise - Configurações da seção de ajuda

7. Configurações de armazenamento de arquivos

Esta seção permite ativar e desativar o armazenamento de arquivos.

On-Premise - Configurações de armazenamento de arquivos

Ele é usado para armazenar anexos de arquivos e imagens aos formulários de Tarefa e aos trabalhos de Manutenção. O diretório padrão para armazenamento de arquivos é /home/java/api-server/files.

Atualizado

Isto foi útil?