升级程序
在本节中，您将找到将PubSub+软件事件代理升级到10.10.1或更早支持版本的所需程序。
您可以将任何处于完全支持或技术支持状态的版本升级到任何更新的处于完全支持状态的版本。您可以升级到预览版本，直到该预览版本被其生产版本所取代。有关更多信息，请参见solace.com/support。
由于数据库不兼容，目前不支持以下升级路径：
-
从版本10.0.1到代理版本10.1.1、10.2.1、10.3.1、10.5.1的升级。
-
从版本10.4.1到版本10.5.1的升级。
不支持降级软件事件代理。
开始之前
在升级到10.2.0或更高版本之前，请确保没有配置名称以#telemetry-开头的队列、客户端配置文件或ACL配置文件。作为一般规则，不应配置以#开头的对象，因为Solace使用此类对象名称进行内部使用。
如果消息缓冲已作为备份启用，但无法从配置的HA冗余组节点确定mate-router-name，则事件代理将在升级后无法启动。在升级之前，请确保HA冗余组节点配置正确，或者消息缓冲没有作为备份启用。
在将冗余（HA）系统升级到10.6.1或更高版本之前，请确保您移除了所有版本早于10.6.1的Kafka桥接配置。
在升级到10.9.1或更高版本之前，请移除任何错误配置的LAG接口，这些接口没有配置为lacp或active-backup模式。这些接口始终是非功能性的，但如果不移除，事件代理将在升级后无法启动。
您有足够的空闲空间吗？
您需要验证您要升级的所有事件代理上都有足够的空闲空间。
在开始升级程序之前，请仔细审查系统资源需求，并确保有足够的资源可用。
在Docker镜像升级期间，如果可用的薄池最小空闲空间不足，安装新的PubSub+软件事件代理将不会成功。在Docker主机上执行docker info命令将显示Space Available和Thin Pool Minimum Free Space。有关管理Docker中可用空间的更多信息，请参考Docker文档。
为了释放磁盘空间，请考虑以下选项：
- 取消缓冲一些缓冲的消息
- 删除一些缓冲的消息（一旦删除，消息无法恢复）
- 迁移到更大的消息缓冲
要检查可用的空闲空间量，请执行以下操作：
- 运行
show storage-element *CLI命令。 - 验证
spool存储元素在可用列中至少 报告2.2 Mi。
solace> show storage-element *
Last Refreshed : Feb 22 2024 18:41:07
Storage Element Device 1K-blocks Used Available Use%
-------------------- ------------------ ------------ ------------ ------------ -----
root /dev/dm-6 6.0 Mi 1.2 Mi 4.8 Mi 20%
spool-cache /dev/dm-0 9.8 Mi 1.1 Mi 8.7 Mi 11%
spool-cache-backup /dev/dm-0 9.8 Mi 1.1 Mi 8.7 Mi 11%
config /dev/dm-0 9.8 Mi 1.1 Mi 8.7 Mi 11%
diagnostics /dev/dm-0 9.8 Mi 1.1 Mi 8.7 Mi 11%
jail /dev/dm-0 9.8 Mi 1.1 Mi 8.7 Mi 11%
spool /dev/dm-0 9.8 Mi 1.1 Mi 8.7 Mi 11%
var /dev/dm-0 9.8 Mi 1.1 Mi 8.7 Mi 11%
升级到9.13.0或更高版本
使用此表选择升级您的Solace PubSub+软件事件代理到SolOS-TR版本9.13.0或更高版本（当前版本是10.10.1）的程序。
对于不支持的升级路径，您必须先按照程序升级到源版本所属支持升级路径中的最后一个SolOS-TR版本，然后再按照程序升级到目标版本。
| 镜像 | 版本 | 配置 | 遵循的程序 |
|---|---|---|---|
| Docker | 9.12.0+ | 独立 | 从版本9.12.0+升级独立Docker镜像 |
| Docker | 9.12.0+ | 冗余 | 从版本9.12.0+升级冗余Docker镜像组 |
| 使用编排工具从版本9.12.0+升级冗余Docker镜像组 | |||
| AWS云 | 所有 | 独立 | 升级独立AWS云镜像 |
| AWS云 | 所有 | 冗余 | 升级冗余AWS云镜像组 |