Configurar os parâmetros do serviço de integração:
Deve-se configurar o serviço através do arquivo “appSettings.json” com as informações sobre o RAP Connector e Banco de Dados, entre outras. Alguns parâmetros importantes:
- Ambiente: Deve ser um dos seguintes valores: “Homologação” ou “Produção”.
- RAPConnectorBase: URL do RAP Connector.
- RAPClientId: Identificador único do cliente para utilização do RAP Connector.
- UserId: Identidade do usuário do SQL Server criptografado com o algoritmo AES.
- Password: Senha do suário do SQL Server criptografada com o algoritmo AES.
- ConexaoAcademico: String de conexão padrão do SQL Server para conexão com os bancos de dados.
- ConexaoLog: String de conexão padrão do SQL Server para conexão com os bancos de dados.
- ConexaoBinarios: String de conexão padrão do SQL Server para conexão com os bancos de dados.
- Serilog: Configurações do componente de log.
Arquivo de Configuração da API
Deve-se configurar a API através do arquivo “appSettings.json” com as informações sobre o RAP Connector e Banco de Dados, entre outras. Alguns parâmetros importantes:
- IpSafeList: Lista de endereços IP’s autorizados a acessar a API, separados pelo caractere ‘;’.
- UserId: Identidade do usuário do SQL Server criptografado com o algoritmo AES.
- Password: Senha do suário do SQL Server criptografada com o algoritmo AES.
- ConexaoAcademico: String de conexão padrão do SQL Server para conexão com os bancos de dados.
- ConexaoLog: String de conexão padrão do SQL Server para conexão com os bancos de dados.
- ConexaoBinarios: String de conexão padrão do SQL Server para conexão com os bancos de dados.
- Serilog: Configurações do componente de log.
Instalação do Serviço
A instalação deve ser feita com o uso do comando sc.exe do Windows num prompt de comando em modo Administrador. Por exemplo:
sc.exe create QDiplomaDigital start= delayed-auto binpath= “C:\Qualidata\Serviços\QDiplomaDigital\QDiplomaDigital.Worker.exe”
O Comando acima cria uma nova entrada de registro de serviço com nome “QDiplomaDigital” que inicia automaticamente (delayed-auto) apontando para o arquivo executável em “C:\Qualidata\Serviços\QDiplomaDigital\QDiplomaDigital.Worker.exe”.
Desinstalação do Serviço
A desinstalação deve ser feita com o uso do comando sc.exe do Windows num prompt de comando em modo Administrador. O serviço deve ser inicialmente parado e em seguida deletado. Por exemplo:
sc.exe stop QDiplomaDigital
sc.exe delete QDiplomaDigital
O primeiro comando para a execução do serviço com o nome “QDiplomaDigital” e o segundo remove sua entrada de registro de serviço.
Múltiplas Instalações
Em certos clientes pode haver a necessidade de mais de uma instalação do serviço. Cada serviço deve ter sua pasta e configurações distintas e os comandos executados em cada uma de suas respectivas pastas. Por exemplo:
sc.exe create QDiplomaDigital-Prod start= delayed-auto binpath= “C:\Qualidata\Serviços\QDiplomaDigital-Prod\QDiplomaDigital.Worker.exe”
sc.exe create QDiplomaDigital-Homo start= delayed-auto binpath= “C:\Qualidata\Serviços\QDiplomaDigital-Homo\QDiplomaDigital.Worker.exe”
Os Comandos acima criam duas novas entradas de registro de serviço com nomes “QDiplomaDigital-Prod” e “QDiplomaDigital-Homo” que iniciam automaticamente (delayed-auto) apontando cada uma para um arquivo executável diferente de acordo com suas respectivas pastas.
Para maiores informações sobre a instalação de serviços com o comando sc.exe visite https://docs.microsoft.com/pt-br/windows-server/administration/windows-commands/sc-create