Instalador Servidor Nway Pro v2.16.0

Instalador Servidor Nway Pro v2.16.0

O instalador server Nway Pro é utilizado para realizar o processo automatizado de instalações FULL, Atualizações dos sistemas Nway Pro e Componentes, parte Servidor, conforme requisitos descritos em https://nwaypro.atlassian.net/wiki/spaces/docs/pages/2359492609.

O instalador possibilita que o processo seja executado separadamente para cada componente e em servidores diferente como: Banco de dados, Aplicação WEB e Aplicação Webservice.

Sobre as imagens neste manual

As imagens apresentadas a seguir neste documento são apenas referencias, pois todas verticais: Corporativo, Condomínio e Educação, apresentam os mesmos processos de instalação Server.

Em cada imagem, na barra superior, poderão serem encontrados referências de versões e verticais diferentes:

  • NwayPro Condomínio - Instalador vX.Y.Z;

  • NwayPro Corporativo - Instalador vX.Y.Z e

  • NwayPro Educação - Instalador vX.Y.Z, , onde X.Y.Z é a versão das rotinas do Instalador e não a versão do produto sendo instalado.

Ainda que cada imagem poderá conter versões diferentes, porém ao instalarem enxergarão única versão.

Antes de iniciar o processo de instalação, é necessário realizar o download do arquivo instalável.

Baixar o instalador conforme a arquitetura de software do computador, atualmente apenas x64 bits.

Em https://nwaypro.atlassian.net/wiki/spaces/docs/pages/795050006/Vertical/Notas da Versão é possível realizar o seu download de acordo com cada vertical e versão.

No caso de instalação FULL (Completa), localizar sempre a última versão disponível, se não encontrar o pacote ligado nas notas de versões, poderá obter o pacote diretamente do site.

O que será instalado

Após realizar o download do instalável execute os seguintes passos:

  1. Localizar na pasta de download a aplicação, definida como NwayPro_Server_[VERTICAL]_[ARQUITETURA DO SISTEMA OPERACIONAL]_[VERSÃO DO SISTEMA].exe. Exemplo:

image-20250627-205317.png
  1. https://nwaypro.atlassian.net/wiki/spaces/docs/pages/2379743904.

  2. Executar o arquivo instalador, utilizando click duplo, caso usuário não seja administrador local do servidor, utilizar botão direito e escolher “Executar como Administrador”.

  3. Em seguida o sistema operacional irá solicitar a permissão da instalação, clicando no botão “Não” a execução será encerrada, já clicando no botão ”Sim” a instalação será confirmada.

  4. A tela inicial da instalação será exibida para iniciar a instalação do sistema Nway Pro. Clique no botão “Próximo“ para continuar com a instalação.

image-20250627-205447.png
  1. A seguinte tela mostra o termo de licença e uso do NwayPro que deverá ser aceito para prosseguir a instalação. Se necessário for e julgamos importante, clicar em “Imprimir EULA” o arquivo EULA deverá ser aberto no navegador e seu download poderá ser realizado. O EULA também poderá ser consultado diretamente na página https://nwaypro.atlassian.net/wiki/spaces/docs/pages/1692270636. Também encontrará o EULA salvo no diretório base da instalação. Clique em “Próximo“ para dar continuidade à instalação.

image-20250523-173954.png

  1. É exibido logo após, uma tela de autenticação por senha. Preencher o campo de senha para prosseguir com a instalação. A senha solicitada é a mesma utilizada para download dos produtos NwayPro e deste instalador.

image-20250523-174329.png


A senha é um pré-requisitos para dar continuidade na instalação. Caso tente prosseguir com a instalação sem os campos devidamente preenchidos a mensagem abaixo será exibida:

 

 

  1. Tela a seguir é solicitado o Código do servidor ou Código do cliente (CSER) e a Chave de acesso única de cada cliente e servidor. A mesma que é utilizada para validar o sistema NwayPro. Preencher os campos para prosseguir com a instalação. Ao final da instalação esses dados serão salvos no banco de dados.

image-20250523-195904.png


O CSER e Chave de Acesso são pré-requisitos para dar continuidade na instalação. Caso tente prosseguir com a instalação sem os campos devidamente preenchidos a mensagem abaixo será exibida:


Caso seja preenchido o CSER e Chave de Acesso vencida ou inválida a mensagem será exibida:

  1. Em seguida, selecione um local de destino onde serão armazenados os arquivos do instalador. Certificar que possui espaço na unidade selecionada. O diretório e pasta por padrão já vem pré-selecionado, então apenas clique em “Próximo“ para prosseguir. É recomendado não instarem nos locais “Arquivos de Programas”, “Arquivos de Programas x86“, “Program Files”, “Programa Filex x86”, isso deve-se ao fato que são áreas com maior rigidez de segurança dos sistemas operacionais, o que provocará instabilidade da nossa solução. Por isso é indicado como padrão utilizar uma pasta “NwayPro”, podendo ser selecionado outra unidade de disco.

image-20250523-174441.png


Se existir no mesmo servidor outros produtos instalados referentes ao sistema NwayPro como: Drivers e Readers estes estarão na pasta padrão NwayPro e por esse motivo será exibido o pop-up de aviso a seguir: Clique em Sim, para prosseguir com a instalação.

inst2-14-0 (6).png

 

  1. A seguinte tela será exibida, onde é possível selecionar componente(s) a ser(em) instalado(s) ou atualizado(s) na máquina. É preciso atentar-se ao primeiro campo de seleção no qual é subdividido por 3 opções: Banco de dados, WEB e Webservice (orientamos que WEB e Webservice, fiquem no mesmo servidor). Caso encontre opções desativadas (não é possível marcar), significa que não se encontra liberada ou o foi desativada porque o componente já esta instalado. Depois da opção escolhida, clique em “Próximo“.

image-20250523-174616.png

 

  1. Full installation: realizará uma instalação do zero do sistema na máquina;

  2. Compact installation: atualização dos pacotes (WEB e WebService);

  3. Custom installation: atualização dos pacotes individuais (Scriptcase + WEB) e (Apache Tomcat + Arquivo WebService).

  4. A próxima tela informa que os atalhos serão criados dentro da pasta já definida. Basta clicar em “Próximo“ para dar continuidade.

image-20250523-174707.png

  1. A tela seguinte é utilizada para realizar a configuração do banco de dados PostgreSQL. Preencha conforme o valor padrão de cada um dos campos. Exceto se o servidor tiver restrição de uso de IP, utilizar “127.0.0.1”. Após campos preenchidos, clique em “Próximo“ para continuar.

image-20250523-174812.png

  1. IP: Endereço IP do servidor que deve instalar o PostgreSQL. Padrão: “127.0.0.1”;

  2. Porta: Porta definida para utilização do gerenciador de banco de dados. Padrão: “5432”, apenas informativo não pode ser alterada;

  3. Nome do Banco de Dados: Nome definido para criação da base de dados. Padrão:nwaypro”, não utilizar caracteres especiais, máximo “-” ou “_” para separação de nomes compostos;

  4. Usuário: “postgres”, apenas informativo não pode ser alterado;

  5. Senha: Definir senha para acesso a base de dados. Lembrar de utilizar uma senha forte para devida proteção dos dados e guardar em arquivo e local seguro para não esquecer.

  6. Visualiza: Possibilita visualização de senha digitada no campo senha para averiguar se todos os caracteres foram digitados corretamente.

  7. A seguinte tela é exibida, onde é possível adicionar a configuração da aplicação WEB Nway Pro conforme padrão estabelecido abaixo.

image-20250523-175151.png
  1. IP: Endereço IP do servidor que deve instalar a aplicação WEB. Padrão: “127.0.0.1”;

  2. Porta: Porta definida para utilização do sistema WEB. Padrão:8090”. Importante que a rotina que cria o certificado digital irá modificar essa porta para “443”;

  3. E-mail do Administrador do Apache WEB: Usuário pode adicionar um e-mail de um usuário preferência genérico do suporte ou usuário administrador para em caso de necessidade o Apache WEB possa enviar alguma notificação;

  4. Usuário Administrador do Apache WEB: Adicionar um nome para o usuário administrador acessar o sistema WEB. Padrão: “admin”;

  5. Senha: Definir senha para Apache WEB;

  6. Visualiza: Possibilita visualização de senha digitada no campo senha para averiguar se todos os caracteres foram digitados corretamente.

  7. A próxima tela será exibida, nela é possível adicionar a configuração para Webservice conforme padrão estabelecido abaixo.

image-20250523-175343.png

  1. IP: Endereço IP do servidor que deve instalar o Webservice (Apache Tomcat). Padrão: “127.0.0.1”;

  2. Porta: Porta definida para utilização do servidor Webservice. Padrão:8082”. Importante que a rotina que cria o certificado digital irá modificar essa porta para “8443”;

  3. Usuário: Adicionar um nome para o usuário administrador acessar a aplicação Webservice. Exemplo: “admin”;

  4. Senha: Definir senha para acesso a aplicação Webservice;

  5. Visualiza: Possibilita visualização de senha digitada no campo senha para averiguar se todos os caracteres foram digitados corretamente.

  6. A tela abaixo informa os componentes selecionados que serão instalados na máquina juntamente com a informação dos diretórios definidos para eles. Clique em “Instalar“ para permitir a instalação.

image-20250523-175709.png

  1. A tela abaixo informa o processamento da extração dos arquivos. Aguarde todos os componentes serem extraídos até que o próximo passo seja apresentado.

image-20250523-175749.png

  1. Após a instalação do servidor WEB e NwayPro, precisará ser realizada a configuração da conexão do banco de dados para o sistema WEB, sendo assim será aberta a página de https://nwaypro.atlassian.net/wiki/spaces/docs/pages/610828428 SEGUIR A PARTIR DO PASSO 7 DESTA PÁGINA. Será exibida a seguinte mensagem de alerta, a sua leitura é importante para a finalização do processo. Para confirmar e seguir com o processo clique em “OK”.

image-20250523-195246.png

Caso não seja aberto as páginas por problemas de liberação da internet, acessar manualmente:

  1. O item 1 da mensagem exibida é nossa página que a A PARTIR DO PASSO 7, mostra como configurar a conexão, utilizar a página: https://nwaypro.atlassian.net/wiki/spaces/docs/pages/610828428.

  2. O item 2 é a página do Scriptcase recém instalada, utilizar: https://127.0.0.1/v9.

  3. Após finalizadas as configurações do servidor WEB, clicar em Ok a seguinte tela será exibida. Este passo é a Execução, validação e atualização do servidor Webservice.

image-20250523-195459.png
image-20250523-195610.png

Orientações após a conclusão da instalação

Ao finalizar a instalação o NwayPro WEB estará pronto para iniciar seu uso.

Os passos da instalação são salvos no arquivo “NwayPro Setup Log AAAA-MM-DD #SEQ.txt“, diretório padrão escolhido, exemplo “C:\NwayPro”, além de consulta do usuário este arquivo é necessário caso precise acessar nosso suporte através de chamado.

A seguir temos algumas orientações para validações iniciais:

Validação da interface dos usuários (WEB):

Seguindo o padrão de instalação o sistema NwayPro WEB pode ser acessado pela URL https://127.0.0.1/v9/app/nwaypro, caso faça a validação de outra máquina substituir o IP ou dependendo da rede utilizar o nome do servidor, por padrão o acesso é SSL/TLS internamente responde na porta 443, caso cliente precise precisará ajustar os redirecionamentos para porta desejada.

Para acessar o sistema logo após a instalação, insira as credenciais padrões:

Login: admin

Senha: nwaypro

inst2-14-0 (17).png

Validação da aplicação de regras de negócios (Webservice):

Para verificar se o webservice está respondendo e retornando as informações corretas do banco de dados pode ser realizada a seguinte requisição no browser:

“https://127.0.0.1:8443/NwayPro_<Vertical>/business/config”, como retorno serão exibidas as configurações dos parâmetros do sistema web, caso faça a validação de outra máquina substituir o IP ou dependendo da rede utilizar o nome do servidor. Substituir “<Vertical>” por “Corporativo”, ”Condominio” ou “Educacao”.

Uma resposta no formato a seguir significa que o servidor esta pronto para receber conexões dos drivers das controladoras.