[UNIX、Linux、Windows、IBM i]

配置队列管理器以与 IBM Cloud Private 上的测量服务实例配合使用

为队列管理器设置安全性和 IBM Cloud® 注册信息，然后连接到已创建的测量服务实例。

关于本任务

IBM Cloud Private 测量服务 实例仪表板仅显示配置为包含安全性和 IBM Cloud Private 注册信息的队列管理器的数据。

过程

  1. 遵循 IBM Cloud Private 记录的步骤在以下位置创建服务标识:
    使用 IBM Cloud Private CLI 创建服务标识。
  2. 遵循 IBM Cloud Private 记录的步骤，在以下位置创建 API 密钥:
    API 密钥管理 API。
  3. 从 IBM Cloud Private 集群下载 TLS 证书。
    记下将证书下载到的位置。 您可以在步骤 9中将下载的证书添加到队列管理器的密钥存储库。
  4. 创建文本文件 apikeyfile.txt 并添加在先前任务中复制的 API key 值。
    请注意 apikeyfile.txt 的位置，以便可以在 步骤 8中包含其路径。 此文件必须可供队列管理器用户 ( AIX® and Linux® 系统上的"mqm") 读取。 该文件必须仅包含 API key 本身，而不是 JSON 有效内容，例如 d9c11b45-4dda-4de4-c0b2-2e4e1004dc64。
  5. 创建队列管理器，例如 QM1。
    有关更多信息，请参阅 在 Multiplatforms 版上创建和管理队列管理器。
  6. 启动队列管理器 QM1。
    有关更多信息，请参阅启动队列管理器。
  7. 请记住，在运行 IBM MQ 命令之前，先设置好 IBM® MQ 命令行环境。
    运行 setmqenv 命令。
    [AIX] 在 AIX上:
    . /usr/mqm/bin/setmqenv -s
    [Linux] 在 Linux上:
    . /opt/mqm/bin/setmqenv -s
    [Windows]在 Windows上:
    "C:\Program Files\IBM\MQ\bin\setmqenv.cmd" -n installation name
  8. 为队列管理器创建 SSL 信任库 QM1。
    [AIX]开始在 AIX上创建信任库:
    runmqakm -keydb -create -db MQ data directory/qmgrs/QM1/ssl/key.kdb -pw password -type cms -expire 30 -stash
    [Linux]在 Linux上:
    runmqakm -keydb -create -db MQ data directory/qmgrs/QM1/ssl/key.kdb -pw password -type cms -expire 30 -stash
    [Windows]在 Windows上:
    runmqakm -keydb -create -db "MQ data directory\qmgrs\QM1\ssl\key.kdb" -pw password -type cms -expire 30 -stash
  9. 将您在步骤 3中下载的数字证书添加到队列管理器的密钥存储库。
    [AIX]在 AIX上:
    runmqakm -cert -add -db MQ data directory/qmgrs/QM1/ssl/key.kdb -pw password -type cms -label RootCA 
         -file Download_location/RootCA.crt -format ascii -trust enable

runmqakm -cert -add -db MQ data directory/qmgrs/QM1/ssl/key.kdb -pw password -type cms -label ServerCert 
         -file Download_location/CERT.crt -format ascii -trust enable
    [Linux]在 Linux上:
    runmqakm -cert -add -db MQ data directory/qmgrs/QM1/ssl/key.kdb -pw password -type cms -label RootCA 
         -file Download_location/RootCA.crt -format ascii -trust enable

runmqakm -cert -add -db MQ data directory/qmgrs/QM1/ssl/key.kdb -pw password -type cms -label ServerCert  
         -file Download_location/CERT.crt -format ascii -trust enable
    [Windows]在 Windows上:
    runmqakm -cert -add -db "MQ data directory\qmgrs\QM1\ssl\key.kdb" -pw password -type cms -label RootCA 
         -file "Download_location\RootCA.crt" -format ascii -trust enable

runmqakm -cert -add -db "C:\ProgramData\IBM\MQ\qmgrs\QM1\ssl\key.kdb" -pw password -type cms -label ServerCert  
         -file "Download_location\CERT.crt" -format ascii -trust enable
  10. 将具有 apikeyfile 路径的新 ReportingService 节添加到队列管理器的 qm.ini 文件: 
    ReportingService:
   APIKeyFile=APIKey file location/apikeyfile.txt
  11. 将 API host 值添加到 qm.ini 文件。
    ReportingService 节现在包含 apikeyfile 和 API host (ServiceURL) 值的路径:
    ReportingService:
   APIKeyFile=APIKey file location/apikeyfile.txt 
   ServiceURL=https://productinsights-api.ng.bluemix.net
    保存并退出 qm.ini 文件。
  12. 重新启动队列管理器以使更改生效。
    可能会要求您授予队列管理器进程 amqzmur0 访问网络的许可权。 需要此访问权才能使队列管理器与测量服务联系。
  13. 在测量服务实例中查看有关队列管理器 QM1 的信息。
    当报告状态为 active 时，将向测量服务报告指定集成节点上所有集成服务器的启动和使用情况信息。 每 15 分钟更新一次使用信息。
  14. 可选: 通过从队列管理器的 qm.ini 文件中除去 ReportingService 节并重新启动队列管理器，阻止队列管理器向测量服务报告。
  15. 可选: 如果队列管理器未能向测量服务报告启动或使用情况信息，请检查队列管理器日志文件中的诊断信息。
    [AIX]在 AIX上:
    /var/mqm/qmgrs/QM1/errors/AMQERR0*.log
    [Linux]在 Linux上:
    /var/mqm/qmgrs/QM1/errors/AMQERR0*.log
    [Windows]在 Windows上:
    C:\ProgramData\IBM\MQ\errors\AMQERR0*.log

结果

您创建了测量服务实例，并配置了队列管理器以连接到该实例。 您可以在测量服务实例仪表板中查看有关队列管理器的信息。