[Windows]

Configurando um gerenciador de filas para telemetria no Windows

Siga estas etapas para configurar MQ Telemetry manualmente. Se você só precisa de uma configuração simples que use o ID do usuário convidado, você pode, em vez disso, executar o assistente de suporte MQ Telemetry em IBM® MQ Explorer.

Antes de Começar

Se você precisar apenas de uma configuração simples, considere usar o suporte MQ Telemetry em IBM MQ Explorer. Este suporte inclui um assistente e um procedimento de comando de amostra sampleMQM. Esses recursos configuram uma configuração inicial usando o ID do usuário convidado. Veja Verificando a instalação de MQ Telemetry usando IBM MQ Explorer e MQ Telemetry Transport programas de amostra.

Se você precisar de uma configuração mais complexa que use um método de autenticação diferente, use as etapas nesta tarefa. Comece com as seguintes etapas iniciais:
  1. Veja Considerações de instalação para MQ Telemetry para obter informações sobre como instalar IBM MQ, e o recurso MQ Telemetry .
  2. Crie e inicie um gerenciador de filas. O gerenciador de filas é referido como qMgr nesta tarefa.
  3. Como parte desta tarefa você configurar o serviço de telemetria (MQXR). As configurações de propriedade MQXR são armazenadas em um arquivo de propriedades específicas da plataforma: mqxr_win.properties. Normalmente você não precisa editar o arquivo de propriedades MQXR diretamente, pois quase todas as configurações podem ser configuradas por meio de comandos admin do MQSC ou IBM MQ Explorer. Se você decidir editar o arquivo diretamente, pare o gerenciador de filas antes de fazer suas mudanças. Veja Propriedades MQXR.

Sobre esta tarefa

Siga os passos nesta tarefa para configurar MQ Telemetry manualmente, usando diferentes esquemas de autorização.

Procedimento

  1. Abra uma janela de comando no diretório de amostra de telemetria.

    O diretório de amostras de telemetria é WMQ program installation directory\mqxr\samples.

  2. Crie a fila de transmissão de telemetria.

    Se SYSTEM.MQTT.TRANSMIT.QUEUE não existir, ele é criado automaticamente quando o serviço de telemetria (MQXR) é iniciado pela primeira vez, e configurado para usar o ID do usuário convidado. No entanto esta tarefa configura MQ Telemetry para usar um esquema de autorização diferente. Para esta tarefa você cria SYSTEM.MQTT.TRANSMIT.QUEUE, e configure o acesso a ele, antes de iniciar o serviço de telemetria (MQXR).

    Execute o seguinte comando:

    echo DEFINE QLOCAL('SYSTEM.MQTT.TRANSMIT.QUEUE') USAGE(XMITQ) MAXDEPTH(100000) | runmqsc qMgr
  3. Configure a fila de transmissão padrão.

    É mais fácil enviar mensagens diretamente para os clientes MQTT se SYSTEM.MQTT.TRANSMIT.QUEUE for a fila de transmissão padrão. Caso contrário, você tem que adicionar uma definição de fila remota para cada cliente que recebe mensagens IBM MQ ; veja Sendando uma mensagem para um cliente diretamente. Observe que alterar a fila de transmissão padrão pode interferir na sua configuração existente.

    Quando o serviço de telemetria (MQXR) é iniciado pela primeira vez, ele não configura SYSTEM.MQTT.TRANSMIT.QUEUE como a fila de transmissão padrão para o gerenciador de filas. Para configurar essa configuração, você altera a propriedade de fila de transmissão padrão. Você faz isso seja usando o IBM MQ Explorer, ou executando o seguinte comando:

    echo ALTER QMGR DEFXMITQ('SYSTEM.MQTT.TRANSMIT.QUEUE') | runmqsc qMgr
  4. Siga um procedimento em Autorização de clientes MQTT para acessar IBM MQ objetos para criar um ou mais IDs de usuário. Os IDs de usuários têm autoridade para publicar, assinar e enviar publicações para clientes MQTT .
  5. Edite o arquivo installMQXRService_win.mqsc para configurar o arquivo-chave que é usado para criptografar passphrase para canais TLS do MQTT:
    1. Abra o arquivo WMQ program installation directory\mqxr\samples\installMQXRService_win.mqsc .
    2. Localize a linha que inclui o parâmetro STARTARGe edite a opção -sf para especificar o local do arquivo-chave de credenciais.
      Por padrão, o arquivo installMQXRService_win.mqsc usa um arquivo-chave padrão denominado [DEFAULT] O arquivo-chave padrão é o mesmo para todas as instalações do IBM MQ , portanto, deve-se fornecer um arquivo-chave que seja exclusivo para sua instalação ao criptografar passphrases..

      Consulte também o código de exemplo em Criando SYSTEM.MQXR.SERVICE..

  6. Instale o serviço de telemetria (MQXR) executando o seguinte comando:
    type installMQXRService_win.mqsc | runmqsc qMgr
  7. Inicie o serviço.
    echo START SERVICE(SYSTEM.MQXR.SERVICE) | runmqsc qMgr

    O serviço de telemetria (MQXR) é iniciado automaticamente quando o gerenciador de filas é iniciado. Ele é iniciado manualmente nesta tarefa porque o gerenciador de filas já está em execução.

  8. Usando IBM MQ Explorer, configure canais de telemetria para aceitar conexões de MQTT clientes.

    Os canais de telemetria devem ser configurados de tal forma que suas identidades sejam um dos IDs de usuário definidos na etapa 4.

    Veja também DEFINE CANAL (MQTT).

  9. Verifique a configuração executando o cliente de amostra.

    Para o cliente de amostra trabalhar com seu canal de telemetria, o canal deve autorizar o cliente a publicar, subscrever-se e receber publicações. O cliente de amostra se conecta ao canal de telemetria na porta 1883 por padrão. Veja também MQ Telemetry Transport programas de amostra.

Criando SYSTEM.MQXR.SERVICE

Use o comando runMQXRService para criar o SYSTEM.MQXR.SERVICE.


DEF	SERVICE(SYSTEM.MQXR.SERVICE) +
CONTROL(QMGR) +
DESCR('Manages clients using MQXR protocols such as MQTT') +
SERVTYPE(SERVER) +
STARTCMD('+MQ_INSTALL_PATH+\mqxr\bin\runMQXRService.bat') +
STARTARG('-m +QMNAME+ -d "+MQ_Q_MGR_DATA_PATH+\." -g "+MQ_DATA_PATH+\." -sf "c:\keyFileLocation\keyFile.txt"') +
STOPCMD('+MQ_INSTALL_PATH+\mqxr\bin\endMQXRService.bat') +
STOPARG('-m +QMNAME+') +
STDOUT('+MQ_Q_MGR_DATA_PATH+\mqxr.stdout') +
STDERR('+MQ_Q_MGR_DATA_PATH+\mqxr.stderr')