English
Español
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.
Importante
Todas as aplicações que necessitem do RabbitMQon-premises para integração com a Senior X devem utilizar o mesmo RabbitMQ. Portanto, caso ele já esteja instalado, não é necessário realizar a instalação novamente.
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.
- Efetue o download do software para o Windows 32 bits ou 64 bits;
- Armazene o software em uma pasta temporária. Por exemplo: C:\plataforma\instalacao;
- Execute o instalador com as configurações padrões.
Instalação do Rabbit
- Efetue o download do software de mensageria;
- Armazene o software em uma pasta temporária. Por exemplo, C:\plataforma\instalacao;
- 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.
Importante
O usuário utilizado para fazer a instalação do RabbitMQ deve ser o mesmo utilizado para fazer as instalações/atualizações dos sistemas Senior.
Gerenciador web
O gerenciador web do RabbitMQ está desabilitado por padrão. Para visualizar o funcionamento do RabbitMQ é necessário ativá-lo:
- 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;
- 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:
- 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.
- 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.
- Acesse Admin > Users e selecione o usuário administrador recém-criado para atribuir as permissões para ele;
- Clique no botão Set Permissions e defina as permissões completas ao usuário administrador;
- Faça logoff do usuário guest e teste o acesso com o usuário administrador criado;
- Acesse Admin > Users e selecione o usuário guest;
- Acesse a sessão Permissions e clique no botão Clear para remover as permissões deste usuário padrão.
- Na sessão Update this user, informe a senha guest, remova a tag administrator e clique no botão Update user.
Homologação e atualização do RabbitMQ on-premises
A versão homologada atualmente do RabbitMQ para uso on-premises com os sistemas da Senior é a versão 4.0.x.
A seguir, descrevemos o processo de homologação e o passo a passo recomendado para realizar a migração de forma segura e compatível com os nossos serviços.
Homologação
O RabbitMQ foi atualizado da versão 3.8.x para a versão 4.0.x. Essa homologação confirma a compatibilidade dos sistemas Senior com versões mais recentes do RabbitMQ, incluindo a versão 4.0.x.
Importante
Todos os serviços continuaram funcionando normalmente durante e após o processo de atualização.
Requisitos para Atualização
A atualização deve ser gradual, passando por cada versão minor intermediária.
Exemplo: 3.8.x → 3.9.x → 3.10.x → 3.11.x → 3.12.x → 3.13.x →4.0.x
Não é possível pular versões.
Em cada etapa, é obrigatório ativar as feature flags disponíveis antes de seguir para a próxima versão.
Ativação de Feature Flags
Após atualizar para cada versão, ative todas as feature flags executando o seguinte comando:
rabbitmqctl enable_feature_flag all
Depois disso, reinicie o serviço RabbitMQ. Só então prossiga para a próxima versão.
Passo a Passo para Migração do RabbitMQ
- Realize um backup completo do ambiente RabbitMQ antes de iniciar o processo de atualização;
- Atualize gradualmente por versão minor, seguindo esta rota:
- 3.8.x → 3.9.x
- 3.9.x → 3.10.x
- 3.10.x → 3.11.x
- 3.11.x → 3.12.x
- 3.12.x → 3.13.x
- 3.13.x → 4.0.x
- Para cada versão, siga os passos abaixo:
- Baixe e instale a versão desejada do RabbitMQ;
- Execute o comando:
rabbitmqctl enable_feature_flag all
- Reinicie o serviço RabbitMQ;
- Valide o funcionamento do serviço;
- Prossiga somente se tudo estiver funcionando corretamente.
- Após cada atualização, verifique:
- Conexão com os aplicativos integrados;
- Preservação das filas existentes;
- Processamento correto das mensagens.
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 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.
English
Español
