¶ Comunicado Oficial – Alteração na Execução do nWeb a partir da Versão 25.6.0.0
Com a atualização do sistema para a versão 25.6.0.0, o componente nWeb – responsável pela comunicação com o Questor Zen e disponibilização da API para integração com o Questor Gestão Contábil – não poderá mais ser executado como serviço do Windows.
Essa mudança se dá pela atualização do framework mORMot para a versão 2, que removeu o suporte nativo à execução como serviço. A partir dessa versão, o nWeb deverá ser executado exclusivamente como aplicação (modo aplicação).
¶ O que muda?
Antes (versões anteriores à 25.6.0.0):
- Era possível configurar e executar o nWeb como serviço do Windows.
Agora (a partir da versão 25.6.0.0):
- O nWeb deve ser executado manualmente ou via atalho, como aplicação (ex: nWeb.exe).
- A configuração será semelhante à usada para executar o componente Cloud como aplicação, conforme manual a seguir.
Observação: Para quem já utiliza o nWeb com o nServerConfig para integração via API ou com o Zen2, nenhuma ação de manutenção é necessária.
Já os usuários do Zen1 devem obrigatoriamente executar o nWeb como aplicação, pois a integração não é compatível com o nServerConfig.
¶ Manual de Migração – nWeb de Serviço para Aplicação
Clientes que ainda utilizam o Zen 1 devem migrar o nWeb como aplicação sem o "nServerConfig". Seguindo o manual descrito abaixo.
Clientes que não possuem o Zen ou utilizam o Zen 2 devem migrar o nWeb com o "nServerConfig". Criar Manual para clientes que vão utilizar o nServerConfig.
¶ 1. Parar o serviço nWeb (caso esteja configurado como serviço):
Acesse o Gerenciador de Serviços do Windows (services.msc);
Localize o serviço com nome similar a nWeb;
Clique com o botão direito e selecione Parar;
Após isso, exclua o serviço, se desejar, via prompt de comando:
sc delete NomeDoServico
¶ 1.1 Excluir o serviço nWeb
Acessar as configurações do sistema, na aba de serviços;
Selecionar o serviço nWeb e Excluir.
¶ 2. Preparar a execução como aplicação:
Acesse a pasta onde o nWeb.exe está localizado (geralmente dentro da pasta nQuestor);
Execute o aplicativo como administrador:
- nWeb /auto /con:NomeDaConexao /usu:NomeUsuario /sen:SenhaUsuario /porta:8080 /limiteclients:256 /reservaportaini:8081 /reservaportafim:8999
Parâmetros disponíveis:
- /auto: Especifica que será conectado automaticamente sem demonstrar a tela de login do sistema. Caso não informado, exibirá a tela de login para seleção da base de dados e informar o usuário e a senha para login;
- /con: NomeDaConexão - Apelido da configuração da conexão com o banco de dados;
- /usu: NomeUsuario - Nome do usuário com o qual será logado o aplicativo;
- /sen: SenhaUsuario - Senha do usuário com o qual será logado o aplicativo;
- /porta: XXXX – Define a porta HTTP;
- /phttps: XXXX – (opcional) Define a porta HTTPS (se certificado estiver configurado);
- /limiteclients: XXX – define o limite de conexões simultâneas, máximo 256.
- /reservaportaini: XXXX - Define o intervalo inicial de portar utilizadas para o processamento.
- /reservaportafim: XXXX - Define o intervalo final de portar utilizadas para o processamento.
- /log: (opcional) Habilita logs das requisições no prompt;
Importante: Mantenha o prompt de comando aberto enquanto a aplicação estiver em execução. Caso deseje automatizar o início, crie um atalho na pasta de Inicialização do Windows ou utilize uma tarefa agendada.
Exemplo execução como aplicação:
¶ HTTPS (Opcional, recomendado para acesso externo)
Se sua aplicação exige HTTPS:
- Instale um certificado válido no Gerenciador de Certificados do Computador (certmgr.msc);
- Vincule o certificado a uma porta com o comando:
netsh http add sslcert ipport=IP:443 certhash=HASH_CERT appid={GUID} certstorename=my
¶ Verificando se está funcionando
Acesse no navegador ou via ferramenta de testes:
http://IP:PORTA/TnInfo/Info
Exemplo: http://localhost:8080/tnInfo/Info
Deve retornar um JSON com informações do serviço.
Exemplo teste funcionamento:
