跳到主要内容

恢复配置文件

本节的信息仅适用于独立代理配置。

不要在 PubSub+ Cloud 中的事件代理服务中使用此程序。在 PubSub+ Cloud 中使用此程序可能导致服务性能下降。相反,请参阅备份事件代理服务以获取更多信息。

如果您需要恢复备份的配置文件,可以使用本地或外部备份。恢复配置文件可能会导致服务中断,应在对消息网络中的发布者和订阅者影响最小的时间进行。

一些配置信息未被备份,包括:

  • 产品密钥
  • TLS/SSL 服务器证书文件
  • TLS/SSL 服务器证书配置
  • 以下客户端证书:
    • 消息 VPN 桥接
    • 复制桥接
    • REST 交付点
    • 动态消息路由 (DMR)
    • 多节点路由 (MNR)
  • Kerberos Keytabs
  • 受信任的根配置(对于软件版本 8.2.0 之前的设备和版本 8.7.0 之前的软件事件代理)
  • 软件代理存储组
  • 软件代理扩展参数
  • 在代理中运行的监控代理(Datadog、SolGeneos)

此外,消息数据未被备份,包括:

  • 保证消息 spool
  • 队列消息
  • 回放日志消息

如果您在事件代理上有 spool 消息,并且需要从备份中恢复配置文件,请在使用此程序之前联系 Solace 以获得帮助。在恢复配置文件时需要小心以保持 spool 消息.

恢复的时机

恢复配置会导致服务中断,因为 reload 命令会重启事件代理。最好在服务中断对消息网络中的发布者和订阅者影响最小的时间重启事件代理.

在许多情况下可能需要恢复备份配置文件:

  • 将管理信息从一个事件代理移动到另一个事件代理(例如升级到更新的硬件平台)
  • 如果发生灾难性的硬件或软件故障,必须使用备用硬件继续网络管理
  • 在执行软件降级后将配置信息恢复到事件代理
  • 如果事件代理数据库被损坏或其完整性受到损害,例如由操作员意外删除

从备份文件恢复时,至关重要的是正在恢复的事件代理必须与备份时使用的事件代理完全相同且兼容。特别是:

  • 恢复的事件代理的软件版本必须与备份时使用的事件代理完全相同,包括维护和构建版本.
  • 恢复的事件代理上必须有足够的磁盘空间来存储恢复的配置文件.
  • 恢复的事件代理的硬件配置必须与备份时使用的事件代理相同,即必须在相同的插槽中安装相同的刀片集.

恢复到出厂默认配置

要重新加载事件代理上的默认配置文件,请按照以下步骤操作:

  1. 输入以下命令:
solace> enable
solace# reload default-config

重新加载到默认配置时,管理 IP 地址保持不变.

从本地备份恢复配置

要恢复事件代理上的本地备份配置文件,请按照以下步骤操作:

  1. 输入以下命令以显示和识别要恢复的备份文件:
solace> enable
solace# dir configs

示例响应是:

   -rw-rw----    admin solgroup  1569027 Mar 13 13:06 backup
-rw-rw-rw- root root 25749320 Mar 24 03:15 autobackup
-rw-rw-rw- root root 25749348 Mar 24 20:10 autobackup.1
-rw-rw-rw- root root 25749348 Mar 31 03:15 autobackup.2
-rw-rw-rw- root root 25749348 Mar 31 20:10 autobackup.3
  1. 输入以下命令以恢复备份文件并激活它:
solace# reload config <config-file>

其中:

  • <config-file> 是在重启时从何处获取事件代理的配置文件的位置

示例:

solace# reload config //autobackup.3

如果未指定,则事件代理在不更改配置数据库的情况下重启.

恢复配置会导致服务中断,因为 reload 命令会重启事件代理。最好在服务中断对消息网络中的发布者和订阅者影响最小的时间重启事件代理.

事件代理重启,并且之前备份的配置文件被恢复.

当重新加载使用 TLS/SSL 服务的备份配置时,TLS/SSL 服务在管理上是启用的,但在操作上是关闭的,直到配置了服务器证书。服务器证书只能在重新加载完成后安装.

使用SFTP或SCP从文件服务器恢复配置

要从外部文件服务器(使用 SFTP 或 SCP)恢复备份配置文件到事件代理,请按照以下步骤操作:

确保您有一个文件服务器在事件代理网络上,并且您有 IP 连接.

  1. 输入以下命令将所需的备份文件从外部文件服务器(使用 SFTP 或 SCP)复制到事件代理的 /configs 子目录:
solace> enable
solace# copy sftp://[<username>@]<ip-addr>/<remote-pathname> /configs/<config-file>

或者

solace> enable
solace# copy scp://[<username>@]<ip-addr>/<remote-pathname> /configs/<config-file>

其中:

  • <username> 是您的 SFTP 或 SCP 用户名,<ip-addr><remote-pathname> 指向 SFTP 或 SCP 服务器上备份配置文件的位置
  • <config-file> 是在事件代理上放置备份配置文件的位置
  1. 成功将备份文件从外部文件服务器传输到 /configs 子目录后,输入以下命令以恢复备份文件并激活它:
solace# reload config <config-file>

其中:

  • <config-file> 是在重启时从何处获取事件代理的配置文件的位置

如果未指定,则使用本地当前配置文件.

恢复配置会导致服务中断,因为 reload 命令会重启事件代理。最好在服务中断对消息网络中的发布者和订阅者影响最小的时间重启事件代理.

事件代理重启,并且之前备份的配置文件被加载到事件代理并恢复.