RabbitMQ

O RabbitMQ é o software de mensageria responsável pela troca de mensagens entre o ambiente do cliente e a nuvem da Senior.

Para realizar a sua instalação, o pré-requisito é ter o Erlang instalado.

Erlang

O Erlang é a linguagem de programação utilizada pelo RabbitMQ e o OTP é o conjunto de bibliotecas e frameworks responsáveis pela execução do Erlang.

1. Efetue o download do software para o Windows 32 bits ou 64 bits;
2. Armazene o software em uma pasta temporária. Por exemplo: C:\plataforma\instalacao;
3. Execute o instalador com as configurações padrões.

Instalação do Rabbit

1. Efetue o download do software de mensageria;
2. Armazene o software em uma pasta temporária. Por exemplo, C:\plataforma\instalacao;
3. Execute o instalador com as configurações padrões.

Após instalação, o RabbitMQ cria as pastas C:\Program Files\RabbitMQ Server\rabbitmq_server-3.6.9\ e %APPDATA%\RabbitMQ com os arquivos de configuração e persistência dos dados.

Gerenciador web

O gerenciador web do RabbitMQ está desabilitado por padrão. Para visualizar o funcionamento do RabbitMQ é necessário ativá-lo:

1. Através do prompt de comando, em modo Administrador, acesse a pasta C:\Program Files\RabbitMQ Server\rabbitmq_server-3.6.9\sbin de onde está instalado o RabbitMQ, ou no menu do Windows, crie um atalho para o RabbitMQ Command Prompt;
2. Execute o comando que habilita o gerenciador web: rabbitmq-plugins enable rabbitmq_management. No prompt será exibida uma mensagem de configuração sendo aplicada e realizada com sucesso.

Usuário administrador

Como recomendação de segurança, é importante desativar o usuário padrão guest e criar um específico de administração do RabbitMQ, pois ele estará exposto na internet conforme os bloqueios de firewall:

1. Através de um navegador, acesse o gerenciador web em http://localhost:15672, informando os dados de acesso:
   • Usuário: guest
   • Senha: guest

   Observação

   A porta 15672 é para acesso via HTTP, depois da instalação do integrador, a porta para acesso do administrador do RabbitMQ passará a ser 15671 (HTTPS) por conta da configuração do certificado digital no RabbitMQ pelo instalador.

2. Acesse Admin e em Add a user:
   • Informe um Username;
   • Informe uma senha forte no campo Password e a confirme. Não utilize caracteres especiais, por exemplo "@", "/" e/ou ":";
   • No campo Tags, informe administrator, para que esse usuário seja o administrador do RabbitMQ;
   • Clique em Add User.
3. Acesse Admin > Users e selecione o usuário administrador recém-criado para atribuir as permissões para ele;
4. Clique no botão Set Permissions e defina as permissões completas ao usuário administrador;
5. Faça logoff do usuário guest e teste o acesso com o usuário administrador criado;
6. Acesse Admin > Users e selecione o usuário guest;
7. Acesse a sessão Permissions e clique no botão Clear para remover as permissões deste usuário padrão.
8. Na sessão Update this user, informe a senha guest, remova a tag administrator e clique no botão Update user.

Particularidades dos produtos

eDocs

A instalação manual do RabbitMQ não é o procedimento padrão a ser utilizado no processo de implantação. É recomendável a instalação descrita anteriormente.

Esse conteúdo não se aplica em todos os cenários, somente para usuários que possuem o sistema eDocs e a senior X Platform no mesmo servidor:

Variáveis rabbitmq-env.bat:

set ERLANG_HOME=C:\Program Files\erl9.2

set RABBITMQ_BASE=C:\Program Files\RabbitMQ Server\rabbitmq_server-3.6.14

set RABBITMQ_NODE_PORT=6672

set RABBITMQ_NODENAME=SeniorX

set RABBITMQ_SERVICENAME=SeniorXRabbitMQ

set RABBITMQ_CONFIG_FILE=%RABBITMQ_BASE%\etc\rabbitmq

set RABBITMQ_MNESIA_BASE=%RABBITMQ_BASE%\db

set RABBITMQ_MNESIA_DIR=%RABBITMQ_MNESIA_BASE%%RABBITMQ_NODENAME%

set RABBITMQ_LOG_BASE=%RABBITMQ_BASE%\log

set RABBITMQ_LOGS=%RABBITMQ_LOG_BASE%%RABBITMQ_NODENAME%.log

set RABBITMQ_SASL_LOGS=%RABBITMQ_LOG_BASE%%RABBITMQ_NODENAME%-sasl.log

set RABBITMQ_PLUGINS_DIR=%RABBITMQ_BASE%\plugins

set RABBITMQ_ENABLED_PLUGINS_FILE=%RABBITMQ_BASE%\enabled_plugins

Os diretórios podem mudar conforme a instalação no ambiente.