Na versão 9.0.1, a IBM introduziu o recurso de um console web no IBM MQ, que ficou mais conhecido como "MQ Console".
O MQ Console é uma interface que pode ser acessada por um navegador web (browser), e permite que tarefas comuns, como criar filas, canais, dentre outros objetos do MQ, possam ser executados de forma intuitiva, sem a necessidade de ferramentas externas, tais como o MQ Explorer.
Nas versões seguintes do IBM MQ, o MQ Console passou por diversas melhorias significativas. Na versão 9.2 foi introduzida uma nova versão do console web, que trouxe melhorias significativas na experiência do usuário, com uma interface mais moderna e recursos aprimorados no gerenciamento dos objetos do MQ. Nas versões 9.3.x, foram introduzidos avanços importantes em usabilidade, observabilidade e integração com ambientes modernos.
Nesse documento vamos mostrar a instalação e configuração do MQ Console num servidor Linux.
Este post em Inglês:
https://community.ibm.com/community/user/blogs/carlos-guilherme-do-nascimento-arantes/2025/05/21/installing-and-configuring-the-mq-console-on-ibm-m
Pré-requisitos
· Qualquer distribuição Linux suportada pelo IBM MQ
veja em: https://www.ibm.com/support/pages/system-requirements-ibm-mq
· Antes de começar a usar MQ Console, você deve verificar se os componentes (pacotes) corretos estão instalados: MQSeriesRuntime, MQSeriesServer e MQSeriesWeb (Este é o pacote essencial para o MQ Console).
Se necessário, segue um exemplo de comando para instalação de um pacote:
rpm -ivh MQSeries*.rpm
· O usuário que executa o console (mqm por padrão) precisa ter permissão de leitura/escrita em “/var/mqm” e permissão de leitura no diretório de configuração do mqweb.
· Verificar se regras de firewall precisam ser aplicadas para acesso a console, pois a porta configurada para a conexão é 9443 em cada servidor que a console foi iniciada.
Configurando o MQ Console
Usando o usuário mqm, substitua o arquivo de configuração existente (mqwebuser.xml) pelo arquivo de amostra de registro básico (basic registry sample file) que está configurado para oferecer segurança básica.
Copie o arquivo basic_registry.xml do diretório:
MQ_INSTALLATION_PATH/web/mq/samp/configuration
para o diretório
var/mqm/web/installations/installationName/servers/mqweb
e renomeie o arquivo para mqwebuser.xml.
|
cd /var/mqm/web/installations/Installation1/servers/mqweb/
cp /opt/mqm/web/mq/samp/configuration/basic_registry.xml .
cp mqwebuser.xml mqwebuser_old.xml
rm mqwebuser.xml
cp basic_registry.xml mqwebuser.xml
|
Acerte as permissões do arquivo mqwebuser.xml com o comando:
Por padrão, a API REST e o IBM MQ Console estão disponíveis apenas no mesmo host que o servidor mqweb. Ative as conexões remotas com o servidor mqweb com o seguinte comando:
|
setmqweb properties -k httpHost -v "*"
|
Ainda na pasta de exemplos de configurações do MQ console, podemos encontrar outros arquivos com outros exemplos (templates) de possíveis configurações:
Analisando o arquivo “ldap_registry.xml”, podemos verificar o exemplo de configuração para utilizar o MQ console com autenticação pelo LDAP:
No exemplo desta documentação, utilizamos o arquivo “basic_registry.xml” para obter um padrão de segurança básica. Mas, para configurar a autenticação do MQ console com o LDAP, devemos utilizar como base o arquivo “ldap_registry.xml”. O arquivo mqwebuser.xml deve ser criado com base no tipo de autenticação desejada para a sua instalação do IBM MQ:
|
Arquivo / Template
|
Objetivo
|
|
basic_registry.xml
|
Segurança básica, usuários definidos no arquivo xml.
|
|
ldap_registry.xml
|
Segurança com autenticação via LDAP.
|
|
local_os_registry.xml
|
Segurança com autenticação dos usuários locais do sitema operacional.
|
|
no_security.xml
|
Sem segurança / autenticação no MQ Console.
|
Os perfis de usuário para o MQ Console
O arquivo de amostra basic_registry.xml configura quatro usuários:
- mqadmin: Um usuário administrativo que é membro da função MQWebAdmin.
- mqreader: Um usuário administrativo somente leitura que é membro da função MQWebAdminRO.
- mftadmin: Um usuário administrativo que é membro da função MFTWebAdmin.
- mftreader: Um usuário administrativo somente leitura que é membro da função MFTWebAdminRO.
Todos os usuários também são membros da função MQWebUser.
Para obter mais informações sobre as funções disponíveis, consulte:
Roles on the IBM MQ Console and REST API
https://www.ibm.com/docs/en/ibm-mq/9.2?topic=roles-mq-console-rest-api
Acessando o MQ Console
No nosso exemplo, usando o usuário root, desabilitamos o firewall do servidor Linux:
|
systemctl stop firewalld
systemctl disable firewalld
systemctl status firewalld
|
Usando o usuário mqm, inicie o MQ Console com o comando strmqweb.
Executando o comando dspmqweb, é possível verificar o status do MQ Web e também o endereço do console web.
Para acessar o MQ Console, utilize o usuário mqadmin (senha inicial: mqadmin).
Conclusão
Este documento contém uma demonstração dos procedimentos para realizar a instalação e configuração do MQ Console no sistema operacional Linux, e não deve ser considerado como um manual de instalação / atualização. O objetivo deste material é servir de referência para os profissionais de suporte e administração dos ambientes onde a solução é executada. Assume-se que o leitor tenha familiaridade com o sistema operacional Linux.
Referências