Mentor mensageria - Serviço de envio de mensagens

O Mentor mensageria é uma aplicação que roda como um serviço no servidor. Ele é responsável pelo envio de mensagens geradas pelo Mentor web.

Mensagens suportadas:

  • E-mail
  • SMS
  • WhatsApp
  • Push Notification

Partindo do pressuposto que a instalação foi realizada utilizando o tutorial da Edusoft: Serviço de envio de e-mail

Remoção em ambiente windows

Para remover o serviço é necessário apenas executar o arquivo “C:\edusoft\servicos\envio_email\Uninstall.bat”.

Remoção em ambiente linux

Para remover o serviço basta executar o comando “update-rc.d EdusoftEnvioDeEmail remove” e excluir o arquivo EdusoftEnvioDeEmail da pasta de inicialização do sistema (/ etc / init . d).

Instalação em ambiente windows

1 - Copiar o arquivo “mensageria_windows.rar” para dentro da pasta de serviços da instalação do Mentor Web. Geralmente essa pasta fica em “C:\edusoft\servicos”.
2 - Descompactar o arquivo “mensageria_windows.rar” de modo que a estrutura de pastas onde os arquivos do serviço fiquem desta maneira “C:\edusoft\servicos\mensageria”.


3 - Copie o arquivo “C:\edusoft\servicos\mensageria\prunsrv.exe” para a pasta “c:\windows\system32”.

4 - Na pasta “C:\edusoft\servicos\mensageria” tem dois arquivos de configuração de banco “conexaodb_MSSQL.xml” e “conexaodb_ORACLE.xml”. Escolha o arquivo conforme o seu tipo de banco e renomeie para “conexaodb.xml”. Após renomear o arquivo edite o mesmo e configure as conexões para os banco do Mentor Web, Security e Mensagens.

5 - Edite o arquivo “C:\edusoft\servicos\mensageria\context.xml” e e configurar as propriedades conforme abaixo:

Onde:

  • logLevelGeral - Nível de log do serviço;
  • tempoChecaMensagemGeral - Intervalo de tempo em que o serviço realiza uma checagem para envio de novas mensagens (Em minutos);
  • tempoChecaStatus - Intervalo de tempo em que o serviço realiza uma checagem de situação da mensagem (Apenas para SMS e WhatsApp) (Em minutos);
  • urlServidorCache - IP e Porta onde estão instalados o mencached (Utilizar os mesmos configurados no XML do Mentor Web);
  • idCache - ID do mencached (Utilizar o mesmo configurado no XML do Mentor Web);
  • iniciaEmModoTeste - Aplicação em modo teste (Quando “true”, não envia mensagens do sistema, apenas mensagens de teste). Neste primeiro momento vamos manter como “true” até validarmos as configurações.

6 - Edite o arquivo “C:\edusoft\servicos\mensageria\Install.bat” e verifique se os caminho e pastas destacados na imagem abaixo estão corretos.

Onde é necessário:

- Verificar se o caminho está apontando para o arquivo “prunsrv.exe”

  • set PR_INSTALL=C:\edusoft\servicos\mensageria\amd64\prunsrv.exe

- Verificar se os caminhos estão apontando para a pasta “logs” dentro da pasta mensageria. Caso os arquivos “stdout.txt” e “stderr.txt” não existam na pasta não se preocupe eles serão criados automaticamente pelo serviço.

  • set PR_LOGPATH=C:\edusoft\servicos\mensageria\logs
  • set PR_STDOUTPUT=C:\edusoft\servicos\mensageria\logs\stdout.txt
  • set PR_STDERROR=C:\edusoft\servicos\mensageria\logs\stderr.txt

- Verificar se o caminho está apontando para o arquivo “jvm.dll”, em alguns clientes podem apresentar variações para está pasta como por exemplo “C:\edusoft\java\jre\bin\server\jvm.dll”

  • set PR_JVM=C:\edusoft\java\bin\server\jvm.dll

- Verificar se o caminho está apontando para o arquivo “ServicoMensageria.jar”

  • set PR_CLASSPATH=C:\edusoft\servicos\mensageria\ServicoMensageria.jar

- Verificar se os parâmetros “contextServico” e “conexoesServico”, estão apontando corretamente para o caminho dos arquivos “context.xml” e “conexaodb.xml”

  • set PR_STARTPARAMS=–contextServico=C:\edusoft\servicos\mensageria\context.xml;–conexoesServico=C:\edusoft\servicos\mensageria\conexaodb.xml

7 - Para realizar a importar as configurações de envio de e-mail existentes no serviço anterior, seguir os passo deste tutorial: Importação das configurações do envio de e-mail para o Mentor mensageria .

8 - Execute o arquivo “C:\edusoft\servicos\mensageria\Install.bat” como administrador.

9 - Execute o arquivo “C:\edusoft\servicos\mensageria\Iniciar serviço.bat” como administrador.

10 - Verificar se não foi apresentado nenhuma mensagem de erro nos logs do mensageria “C:\edusoft\servicos\mensageria\logs” e se o mesmo está executando como serviço do windows.

Instalação em ambiente linux

1 - Copiar o arquivo “mensageria_linux.rar” para dentro da pasta de serviços da instalação do Mentor Web. Geralmente essa pasta fica em “/edusoft/servicos”.
2 - Descompactar o arquivo “mensageria_windows.rar” de modo que a estrutura de pastas onde os arquivos do serviço fiquem desta maneira “/edusoft/servicos/mensageria”.

3 - Na pasta “C:\edusoft\servicos\mensageria” tem dois arquivos de configuração de banco “conexaodb_MSSQL.xml” e “conexaodb_ORACLE.xml”. Escolha o arquivo conforme o seu tipo de banco e renomeie para “conexaodb.xml”. Após renomear o arquivo edite o mesmo e configure as conexões para os banco do Mentor Web, Security e Mensagens.

4 - Edite o arquivo “C:\edusoft\servicos\mensageria\context.xml” e e configurar as propriedades conforme abaixo:



Onde:

  • logLevelGeral - Nível de log do serviço;
  • tempoChecaMensagemGeral - Intervalo de tempo em que o serviço realiza uma checagem para envio de novas mensagens (Em minutos);
  • tempoChecaStatus - Intervalo de tempo em que o serviço realiza uma checagem de situação da mensagem (Apenas para SMS e WhatsApp) (Em minutos);
  • urlServidorCache - IP e Porta onde estão instalados o mencached (Utilizar os mesmos configurados no XML do Mentor Web);
  • idCache - ID do mencached (Utilizar o mesmo configurado no XML do Mentor Web);
  • iniciaEmModoTeste - Aplicação em modo teste (Quando “true”, não envia mensagens do sistema, apenas mensagens de teste). Neste primeiro momento vamos manter como “true” até validarmos as configurações.

5 - Edite o arquivo “/edusoft/servicos/mensageria/start_ServicoMensageria .sh” e verifique se os caminho e pastas destacados na imagem abaixo estão corretos.

Onde é necessário:

- Verificar se o caminho está apontando para o arquivo “java”

  • /edusoft/java/bin/java

- Verificar se o caminho está apontando para o arquivo “ServicoMensageria.jar”

  • /edusoft/servicos/mensageria/ServicoMensageria.jar

- Verificar se os parâmetros “contextServico” e “conexoesServico”, estão apontando corretamente para o caminho dos arquivos “context.xml” e “conexaodb.xml”

  • -contextServico=/edusoft/servicos/mensageria/context.xml -conexoesServico=/edusoft/servicos/mensageria/conexaodb.xml

6 - Para realizar a importar as configurações de envio de e-mail existentes no serviço anterior, seguir os passo deste tutorial: Importação das configurações do envio de e-mail para o Mentor mensageria .

7 - Copiar o arquivo “EdusoftServicoMensageria” para a pasta de inicialização do linux (Padrão Debian/Ubuntu: / etc / init . d) e dar permissão de execução.

8 - Acessar a pasta de inicialização do linux (/ etc / init. d) e rodar o comando “update-rc.d EdusoftServicoMensageria defaults”.

9 - Após seguir o procedimento para iniciar ou parar o serviço basta usar o comando padrão do sistema "/ etc / init .d / EdusoftServicoMensageria start" ou "/ etc / init .d / EdusoftServicoMensageria stop". Em caso de reinicialização do servidor o serviço será inicializado automaticamente.

Para o processo de configuração e instalação do Mentor Mensageria , é necessário que você leia o procedimento de configuração e em seguida baixe os arquivos de instalação.Para baixar os arquivos de instalação, clique aqui.

Para verificar a documentação de configuração dos processos no sistema, selecione as opções abaixo:

Mensageria envio de Email

Mensageria envio de SMS



Documentação técnica (Acesso restrito) :!: