Arquivo da categoria: Q-Acadêmico

Instalação do Serviço de Integração do Diploma Digital do Q-Acadêmico

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