搜索 <book_title>...

Veritas NetBackup™ 故障排除指南

Last Published: 2021-07-28

Product(s): NetBackup (9.1)

对 NetBackup Messaging Broker（或 nbmqbroker）服务问题进行故障排除

NetBackup Messaging Broker 服务未运行

执行以下操作：

确保已在主服务器上配置并启动该服务。要配置该服务，请运行 configureMQ 命令。
请参考 NetBackup 命令参考指南。

NetBackup Messaging Broker 服务无法启动

原因：

为该服务配置的端口正由某个其他进程使用。
配置文件已损坏。

执行以下操作：

检查 configureMQ 命令日志，了解失败信息。
检查 nbmqbroker 服务日志，了解失败信息。
运行 configureMQ 命令。
请参考 NetBackup 命令参考指南。

NetBackup Messaging Broker 服务未连接到 NAT 客户端

原因：

为该服务配置的端口无法使用。
连接失败，并出现某个 SSL 异常。
在主服务器上运行 configureWebServerCerts 命令后，未重新启动 nbmqbroker 服务。

执行以下操作：

确保为 nbmqbroker 服务配置的端口可供使用，且可由 NetBackup 主机访问。
使用 nbcertcmd -ping 命令检查主服务器和 NAT 客户端之间的连接。
- 如果该命令未成功执行，请参考 NetBackup Web 服务的故障排除部分。
- 如果该命令成功执行，请运行 configureMQ 命令以配置 nbmqbroker 服务。
重新启动 nbmqbroker 服务。

订户或发布者无法连接到 NetBackup Messaging Broker 服务

原因：

无法刷新 NAT 客户端的 JSON Web 令牌 (JWT)。
NAT 客户端的安全证书已吊销。
NetBackup Web 管理控制台（或 nbwmc）服务未运行。

执行以下操作：

请参考订户故障排除步骤。
如果客户端的安全证书已吊销，请重新发布证书。
启动 nbwmc服务。

NetBackup Messaging Broker 服务在灾难恢复后无法启动

原因：

灾难恢复软件包丢失。
configureMQ 命令在安装灾难恢复 (DR) 后未运行。

执行以下操作：

运行 configureMQ 或 configureMQ -defaultPorts 命令。
请参考 NetBackup 命令参考指南。

如果在安装 NetBackup 的卷上禁用 8dot3 短文件名设置，则 NetBackup Messaging Broker 服务无法在 Windows 上启动

要检查安装根文件夹是否已启用 8dot3 文件名设置，请从您的文件夹运行以下命令：

>dir /x

示例：Program Files 目录已启用 8dot3 文件名设置，因此会生成短名称 PROGRA~1。

但对于 not8 Dot3 目录却有所不同。

C:\>dir /x

驱动器 C 中的卷没有标签。

卷序列号为 FE21-2F8E

C:\ 的目录

-5.6.3

12/06/2019  02:24 PM    <DIR>   	            not8 Dot3

12/02/2019  06:35 AM    <DIR>   PROGRA~1     Program Files

12/02/2019  10:44 AM    <DIR>   PROGRA~2     Program Files (x86)

要解决该问题，请执行以下操作：

使用 fsutil 命令为 NetBackup 安装根文件夹启用 8dot3 文件名设置。
请参考以下文章：Fsutil 8dot3name
如果此问题仍然存在，请与技术支持联系。

在使用外部 CA 设置的情况下，还原灾难恢复软件包后，NetBackup Messaging Broker 服务无法正常运行

设想以下情形：

NetBackup 配置为在目录库备份时仅使用外部 CA 签名证书。因此，在目录库备份期间创建的灾难恢复软件包包含所需的外部证书。如果在安装 NetBackup 后使用此类灾难恢复软件包恢复主机标识，则 nbmqbroker 服务可能会由于安装期间颁发的 NetBackup CA 签名证书而无法正常运行。

解决此问题

验证您的 NetBackup 环境是否仅使用外部 CA 签名证书。运行以下命令：
nbcertcmd -getSecConfig -caUsage
检查 nbmqbroker 服务使用的证书。运行以下命令：
在 Unix 上：cat /usr/openv/var/global/mqbroker/mqbroker.config | grep ssl_options
在 Windows 上：type "NetBackup_Install_path\var\global\mqbroker\mqbroker.config" | findstr "ssl_options"
如果在您的环境中仅使用外部 CA 签名证书，则该命令将显示带有 externalcacreds 条目的路径。
如果该命令显示带有 nbcacreds 条目的路径，则表示使用了 NetBackup CA 签名证书。
例如：
{ssl_options, [{cacertfile, "/usr/openv/var/global/mqbroker/certstore/nbcacreds/ca.pem"}, {ssl_options, [{cacertfile, "/usr/openv/var/global/mqbroker/certstore/nbcacreds/ca.pem"},
需要删除 NetBackup 证书，以便 nbmqbroker 服务能够正常工作。
运行以下命令以删除 NetBackup 证书：
configureWebServerCerts -removeNBCert
重新启动 NetBackup 网页管理操作界面 (nbwmc) 服务和 nbqmbroker 服务，以反映这些更改。
检查 nbmqbroker 服务使用的证书。运行以下命令：
在 Unix 上：cat /usr/openv/var/global/mqbroker/mqbroker.config | grep ssl_options
在 Windows 上：type "NetBackup_Install_path\var\global\mqbroker\mqbroker.config" | findstr "ssl_options"
仅外部证书模式的预期输出：
{ssl_options, [{cacertfile, "/usr/openv/var/global/mqbroker/certstore/externalcacreds/ca.pem"}, {ssl_options, [{cacertfile, "/usr/openv/var/global/mqbroker/certstore/externalcacreds/ca.pem"},
请参见在 UNIX 上还原灾难恢复软件包。
请参见在 Windows 上还原灾难恢复软件包。

在 Linux 上，NetBackup Web UI 中未显示特定于 nbmqbroker 服务的新通知

nbmqbroker 服务日志显示以下错误：

escript: exception error: undefined function rabbitmqctl_escript:main/1

in function  escript:run/2 (escript.erl, line 758)

in call from escript:start/1 (escript.erl, line 277)

in call from init:start_em/1

in call from init:do_boot/3

根本原因：

主服务器上某些配置更改可能导致 nbmqbroker 服务配置不一致。要解决此问题，需要重新配置 nbmqbroker 服务。

重新配置 nbmqbroker 服务

通过运行以下命令停止 nbmqbroker 服务：
/usr/openv/mqbroker/bin/nbmqbroker stop
运行以下命令以配置 nbmqbroker 环境：
/usr/openv/mqbroker/bin/install/configureMQEnv
运行以下命令以配置 nbmqbroker 服务：
/usr/openv/mqbroker/bin/install/configureMQ
通过运行以下任一命令启动 nbmqbroker 服务：
- /usr/openv/mqbroker/bin/nbmqbroker start
- bp.start_all command
有关命令的更多信息，请参考 NetBackup 命令参考指南。