Instalação do portal de mensageria

Guia de instalação do portal mensageria. 1 - Introdução 2 - Back-end 3 - Front-end

• 1. INTRODUÇÃO
• 2. BACK-END
• 3. FRONT-END

1. INTRODUÇÃO

O portal de mensageria é disponibilizado com os seguintes artefatos:

1. servico.mensageria.jar é o back-end da aplicação responsável por prover os serviços de envio e processamentos de mensagens.
2. mensageria.rar é o front-end de administração da aplicação
3. application.properties arquivo de configuração do back-end
4. log4j.xml arquivo de configuração dos logs do back-end
5. configPortal.json arquivo de configuração do front-end de administração
6. mensageria.service arquivo de configuração do back-end como serviço do Linux

2. BACK-END

1. Definir o local e transferir o arquivo “servico.mensageria.jar”

2. Configurar a execução do arquivo como serviço:

a. Criar um usuário responsável pela execução do serviço (opcional)

b. Copiar o arquivo de script (edição opcional) “mensageria.service” para o path “/etc/systemd/system”

c. Para iniciar / parar o serviço execute o comando abaixo:
    i. “sudo systemctl start mensageria.service”
    ii. “sudo systemctl stop mensageria.service”

Observações:
1. A versão mínima do Java para a execução da aplicação deve ser 1.8.0_292
2. No arquivo mensageria.service é indicado o path do arquivo de configuração do programa, o mesmo deve apontar para o local onde foi colocado o arquivo “application.properties”

3. O arquivo application.properties possui as configurações de conexão ao banco de dados que devem ser ajustadas conforme o ambiente instalado. Em caso de senha do banco diferente do padrão utilizado pela MD2 utilizar o programa encryptpassword.jar para gerar a nova senha executando conforme abaixo:
       a. Java -jar encryptpassword.jar <nova senha>

O resultado deverá ser substituído no arquivo application.properties conforme imagem abaixo:

3. FRONT-END

1. Descompactar o arquivo mensageria.rar dentro da pasta webapps do Tomcat
2. Configurar o arquivo configPortal.json da pasta “conf” criada em webapps para o endereço do Back-End da aplicação.

{
    "production": true,
    "config": {
      "portal": {
          "apiURLBase": "http://localhost:8081/servico-mensageria",
          "clientId": "angular-app",
          "clientSecret": "@321"
      }
    }
}

 

O Portal de administração é inicializado juntamente com o Tomcat

3. Configuração do Tomcat
      a. No diretório <tomcat>\conf editar o arquivo server.xml conforme abaixo:

<Valve className="org.apache.catalina.valves.rewrite.RewriteValve" />

Incluir a tag do RewriteValve conforme marcado na imagem acima.
     b. No diretório <tomcat>\conf\Catalina\localhost\ inserir o arquivo “rewrite.config” entregue junto do pacote da aplicação.

* Neste arquivo está descrito o nome do path da aplicação para que o tomcat consiga localizar em caso de redirecionamento, caso o path da aplicação seja alterado o novo caminho deve ser configurado neste arquivo também.

Observações: A versão mínima do Tomcat para a execução do portal de administração é a 8.5.16

Observações gerais

• O portal de administração e o back-end devem ficar em portas diferentes caso estejam utilizando o mesmo servidor.
• O banco de dados da aplicação caso não seja o mesmo do mensageria deve ser o Postgres versão mínima 12