更新 Red Hat Satellite


Red Hat Satellite 6.16

将 Satellite 服务器和 Capsule 更新至新的次版本

Red Hat Satellite Documentation Team

摘要

定期更新 Red Hat Satellite 服务器和 Capsule 服务器以确保最佳性能和安全性。

对红帽文档提供反馈

我们感谢您对我们文档的反馈。让我们了解如何改进它。

使用 Red Hat Jira 中的 Create Issue 表单提供您的反馈。JIRA 问题是在 Red Hat Satellite Jira 项目中创建的,您可以在其中跟踪其进度。

先决条件

流程

  1. 单击以下链接: 创建问题。如果 Jira 显示登录错误,则登录并在您重定向到表单后继续。
  2. 完成 SummaryDescription 字段。在 Description 字段中,包含文档 URL、章节号以及问题的详细描述。不要修改表单中的任何其他字段。
  3. Create

第 1 章 将 Satellite 更新至下一个补丁版本

您可以使用 Satellite 维护工具,将 Satellite 服务器和 Capsule 服务器更新至一个新的补丁发行版本,如从 6.16.0 更新到 6.16.1。补丁版本不破坏您的操作环境,通常很快。

始终使用 satellite-maintain update 更新 Satellite Server、Capsule 服务器或操作系统。如果有待处理的 Satellite 服务器更新,更新操作系统将同时更新两者。

重要

定期执行更新以解决安全漏洞和其他问题。

第 2 章 更新 Satellite 服务器

将您连接的 Satellite 服务器更新至下一个补丁版本。您可以按照此流程更新次版本之间的底层操作系统。有关更新断开连接的 Satellite 设置的详情,请参考 第 3 章 更新断开连接的 Satellite 服务器

先决条件

警告

如果您自定义配置文件,手动或使用 Hiera 等工具,则当维护脚本在升级过程中运行或更新时,这些更改将被覆盖。您可以将-- noop 选项与 satellite-installer 一起使用来测试更改。如需更多信息,请参阅红帽知识库解决方案 如何使用 noop 选项在升级过程中检查 Satellite 配置文件中的更改。

流程

  1. 确保启用了 Satellite Maintenance 存储库:

    • 在 Red Hat Enterprise Linux 9 中:

      # subscription-manager repos --enable \
      satellite-maintenance-6.16-for-rhel-9-x86_64-rpms
      Copy to Clipboard Toggle word wrap
    • 在 Red Hat Enterprise Linux 8 中:

      # subscription-manager repos --enable \
      satellite-maintenance-6.16-for-rhel-8-x86_64-rpms
      Copy to Clipboard Toggle word wrap
  2. 使用健康检查选项来确定系统是否准备好更新。在第一次使用此命令时,satellite-maintain 会提示您输入 hammer admin 用户凭证,并将它们保存在 /etc/foreman-maintain/foreman-maintain-hammer.yml 文件中。

    # satellite-maintain update check
    Copy to Clipboard Toggle word wrap

    检查结果,并在执行更新前解决所有突出显示的错误条件。

  3. 由于更新时间较长,使用 tmux 等实用程序挂起和重新连接通信会话。然后,您可以在不持续连接到命令 shell 的情况下检查更新进度。

    如果您丢失了运行 update 命令的命令 shell,您可以在 /var/log/foreman-installer/satellite.log 文件中看到记录的消息,以检查进程是否已成功完成。

  4. 执行更新:

    # satellite-maintain update run
    Copy to Clipboard Toggle word wrap
  5. 如果 satellite-maintain 命令通知您重启,请重启系统:

    # reboot
    Copy to Clipboard Toggle word wrap

其他资源

第 3 章 更新断开连接的 Satellite 服务器

更新您的 air-gapped Satellite 设置,其中连接的 Satellite 服务器从 CDN 同步内容,将从断开连接的 Satellite 服务器到下一个补丁版本。您可以按照此流程更新次版本之间的底层操作系统。

先决条件

  • 备份 Satellite 服务器。如需更多信息,请参阅 管理 Red Hat Satellite 中的 备份 Satellite 服务器和 Capsule 服务器
  • 安装更新过程所需的 reposync

    # dnf install 'dnf-command(reposync)'
    Copy to Clipboard Toggle word wrap

您可以通过同步连接的 Satellite 上的所需存储库来更新 Red Hat Enterprise Linux 8 上的断开连接的 Satellite,并使用 reposync 将内容同步到断开连接的 Satellite 中。

在连接的 Satellite 服务器上的步骤

  1. 确保您已在连接的 Satellite 服务器中同步了以下软件仓库:

    • rhel-8-for-x86_64-baseos-rpms
    • rhel-8-for-x86_64-appstream-rpms
    • satellite-6.16-for-rhel-8-x86_64-rpms
    • satellite-maintenance-6.16-for-rhel-8-x86_64-rpms
  2. 下载组织的调试证书,并将其存储在 /etc/pki/katello/certs/org-debug-cert.pem 或您选择的位置。如需更多信息,请参阅管理 Red Hat Satellite 中的 创建机构调试证书
  3. /etc/yum.repos.d 下创建一个 Yum 配置文件,如 satellite-disconnected.repo,其内容如下:

    [rhel-8-for-x86_64-baseos-rpms]
    name=Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)
    baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel8/8/x86_64/baseos/os
    enabled = 1
    sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
    sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
    sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
    sslverify = 1
    
    [rhel-8-for-x86_64-appstream-rpms]
    name=Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)
    baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel8/8/x86_64/appstream/os
    enabled = 1
    sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
    sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
    sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
    sslverify = 1
    
    [satellite-6.16-for-rhel-8-x86_64-rpms]
    name=Red Hat Satellite 6.16 for RHEL 8 RPMs x86_64
    baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/layered/rhel8/x86_64/satellite/6.16/os
    enabled = 1
    sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
    sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
    sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
    sslverify = 1
    
    [satellite-maintenance-6.16-for-rhel-8-x86_64-rpms]
    name=Red Hat Satellite Maintenance 6.16 for RHEL 8 RPMs x86_64
    baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/layered/rhel8/x86_64/sat-maintenance/6.16/os
    enabled = 1
    sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
    sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
    sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
    sslverify = 1
    Copy to Clipboard Toggle word wrap
  4. 在配置文件中完成以下步骤:

    • 对于 sslclientcertsslclientkey 选项,将 /etc/pki/katello/certs/org-debug-cert.pem 替换为下载的机构调试证书的位置。
    • 对于 baseurl 选项,将 satellite.example.com 替换为您连接的 Satellite 服务器的正确 FQDN。
    • 对于 baseurl 选项,将 My_Organization 替换为您的机构标签。
  5. 获取机构标签:

    # hammer organization list
    Copy to Clipboard Toggle word wrap
  6. 输入 reposync 命令:

    # dnf reposync \
    --delete \
    --disableplugin=foreman-protector \
    --download-metadata \
    --repoid rhel-8-for-x86_64-appstream-rpms \
    --repoid rhel-8-for-x86_64-baseos-rpms \
    --repoid satellite-maintenance-6.16-for-rhel-8-x86_64-rpms \
    --repoid satellite-6.16-for-rhel-8-x86_64-rpms \
    -n \
    -p ~/Satellite-repos
    Copy to Clipboard Toggle word wrap

    这会从连接的 Satellite 服务器下载存储库的内容,并将其存储在 ~/Satellite-repos 目录中。

  7. 验证 RPM 是否已下载,并且 ~/Satellite-repos 的每个子目录中都会生成存储库数据目录。
  8. 归档目录的内容:

    # tar czf Satellite-repos.tgz -C ~ Satellite-repos
    Copy to Clipboard Toggle word wrap
  9. 使用生成的 Satellite-repos.tgz 文件在断开连接的 Satellite 服务器中更新。

断开连接的 Satellite 服务器上的步骤

  1. 将生成的 Satellite-repos.tgz 文件复制到您的断开连接的 Satellite 服务器中。
  2. 将存档 提取到 root 用户可以访问的任何地方。在以下示例中,/root 是提取位置。

    # tar zxf Satellite-repos.tgz -C /root
    Copy to Clipboard Toggle word wrap
  3. 使用以下存储库信息在 /etc/yum.repos.d 下创建一个 Yum 配置文件:

    [rhel-8-for-x86_64-baseos-rpms]
    name=Red Hat Enterprise Linux 8 for x86_64 - BaseOS (RPMs)
    baseurl=file:///root/Satellite-repos/rhel-8-for-x86_64-baseos-rpms
    enabled = 1
    
    [rhel-8-for-x86_64-appstream-rpms]
    name=Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)
    baseurl=file:///root/Satellite-repos/rhel-8-for-x86_64-appstream-rpms
    enabled = 1
    
    [satellite-6.16-for-rhel-8-x86_64-rpms]
    name=Red Hat Satellite 6 for RHEL 8 Server RPMs x86_64
    baseurl=file:///root/Satellite-repos/satellite-6.16-for-rhel-8-x86_64-rpms
    enabled = 1
    
    [satellite-maintenance-6.16-for-rhel-8-x86_64-rpms]
    name=Red Hat Satellite Maintenance 6 for RHEL 8 Server RPMs x86_64
    baseurl=file:///root/Satellite-repos/satellite-maintenance-6.16-for-rhel-8-x86_64-rpms
    enabled = 1
    Copy to Clipboard Toggle word wrap
  4. 在配置文件中,将 /root/Satellite-repos 替换为提取的位置。
  5. 使用健康检查选项来确定系统是否准备好更新。在第一次使用此命令时,satellite-maintain 会提示您输入 hammer admin 用户凭证,并将它们保存在 /etc/foreman-maintain/foreman-maintain-hammer.yml 文件中。

    # satellite-maintain update check \
    --whitelist="check-upstream-repository,repositories-validate"
    Copy to Clipboard Toggle word wrap
  6. 检查结果,并在执行更新前解决所有突出显示的错误条件。
  7. 由于更新时间过长,使用 tmux 等实用程序来暂停和重新连接通信会话。然后,您可以在不持续连接到命令 shell 的情况下检查更新进度。

    如果您丢失了运行 update 命令的命令 shell,您可以在 /var/log/foreman-installer/satellite.log 文件中看到记录的消息,以检查进程是否已成功完成。

  8. 执行更新:

    # satellite-maintain update run \
    --whitelist="check-upstream-repository,repositories-setup,repositories-validate"
    Copy to Clipboard Toggle word wrap
  9. 如果 satellite-maintain 命令通知您重启,请重启系统:

    # reboot
    Copy to Clipboard Toggle word wrap

其他资源

您可以通过在连接的 Satellite 上同步所需的软件仓库来更新 Red Hat Enterprise Linux 9 上的断开连接的 Satellite,并使用 reposync 将内容同步到断开连接的 Satellite 中。

在连接的 Satellite 服务器上的步骤

  1. 确保您已在连接的 Satellite 服务器中同步了以下软件仓库:

    • rhel-9-for-x86_64-baseos-rpms
    • rhel-9-for-x86_64-appstream-rpms
    • satellite-6.16-for-rhel-9-x86_64-rpms
    • satellite-maintenance-6.16-for-rhel-9-x86_64-rpms
  2. 下载组织的调试证书,并将其存储在 /etc/pki/katello/certs/org-debug-cert.pem 或您选择的位置。如需更多信息,请参阅管理 Red Hat Satellite 中的 创建机构调试证书
  3. /etc/yum.repos.d 下创建一个 Yum 配置文件,如 satellite-disconnected.repo,其内容如下:

    [rhel-9-for-x86_64-baseos-rpms]
    name=Red Hat Enterprise Linux 9 for x86_64 - BaseOS (RPMs)
    baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel9/9/x86_64/baseos/os
    enabled = 1
    sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
    sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
    sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
    sslverify = 1
    
    [rhel-9-for-x86_64-appstream-rpms]
    name=Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs)
    baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/rhel9/9/x86_64/appstream/os
    enabled = 1
    sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
    sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
    sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
    sslverify = 1
    
    [satellite-6.16-for-rhel-9-x86_64-rpms]
    name=Red Hat Satellite 6.16 for RHEL 9 RPMs x86_64
    baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/layered/rhel9/x86_64/satellite/6.16/os
    enabled = 1
    sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
    sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
    sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
    sslverify = 1
    
    [satellite-maintenance-6.16-for-rhel-9-x86_64-rpms]
    name=Red Hat Satellite Maintenance 6.16 for RHEL 9 RPMs x86_64
    baseurl=https://satellite.example.com/pulp/content/My_Organization/Library/content/dist/layered/rhel9/x86_64/sat-maintenance/6.16/os
    enabled = 1
    sslclientcert = /etc/pki/katello/certs/org-debug-cert.pem
    sslclientkey = /etc/pki/katello/certs/org-debug-cert.pem
    sslcacert = /etc/pki/katello/certs/katello-server-ca.crt
    sslverify = 1
    Copy to Clipboard Toggle word wrap
  4. 在配置文件中完成以下步骤:

    • 对于 sslclientcertsslclientkey 选项,将 /etc/pki/katello/certs/org-debug-cert.pem 替换为下载的机构调试证书的位置。
    • 对于 baseurl 选项,将 satellite.example.com 替换为您连接的 Satellite 服务器的正确 FQDN。
    • 对于 baseurl 选项,将 My_Organization 替换为您的机构标签。
  5. 获取机构标签:

    # hammer organization list
    Copy to Clipboard Toggle word wrap
  6. 输入 reposync 命令:

    # dnf reposync \
    --delete \
    --disableplugin=foreman-protector \
    --download-metadata \
    --repoid rhel-9-for-x86_64-appstream-rpms \
    --repoid rhel-9-for-x86_64-baseos-rpms \
    --repoid satellite-maintenance-6.16-for-rhel-9-x86_64-rpms \
    --repoid satellite-6.16-for-rhel-9-x86_64-rpms \
    -n \
    -p ~/Satellite-repos
    Copy to Clipboard Toggle word wrap

    这会从连接的 Satellite 服务器下载存储库的内容,并将其存储在 ~/Satellite-repos 目录中。

  7. 验证 RPM 是否已下载,并且 ~/Satellite-repos 的每个子目录中都会生成存储库数据目录。
  8. 归档目录的内容:

    # tar czf Satellite-repos.tgz -C ~ Satellite-repos
    Copy to Clipboard Toggle word wrap
  9. 使用生成的 Satellite-repos.tgz 文件在断开连接的 Satellite 服务器中更新。

断开连接的 Satellite 服务器上的步骤

  1. 将生成的 Satellite-repos.tgz 文件复制到您的断开连接的 Satellite 服务器中。
  2. 将存档 提取到 root 用户可以访问的任何地方。在以下示例中,/root 是提取位置。

    # tar zxf Satellite-repos.tgz -C /root
    Copy to Clipboard Toggle word wrap
  3. 使用以下存储库信息在 /etc/yum.repos.d 下创建一个 Yum 配置文件:

    [rhel-9-for-x86_64-baseos-rpms]
    name=Red Hat Enterprise Linux 9 for x86_64 - BaseOS (RPMs)
    baseurl=file:///root/Satellite-repos/rhel-9-for-x86_64-baseos-rpms
    enabled = 1
    
    [rhel-9-for-x86_64-appstream-rpms]
    name=Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs)
    baseurl=file:///root/Satellite-repos/rhel-9-for-x86_64-appstream-rpms
    enabled = 1
    
    [satellite-6.16-for-rhel-9-x86_64-rpms]
    name=Red Hat Satellite 6 for RHEL 9 Server RPMs x86_64
    baseurl=file:///root/Satellite-repos/satellite-6.16-for-rhel-9-x86_64-rpms
    enabled = 1
    
    [satellite-maintenance-6.16-for-rhel-9-x86_64-rpms]
    name=Red Hat Satellite Maintenance 6 for RHEL 9 Server RPMs x86_64
    baseurl=file:///root/Satellite-repos/satellite-maintenance-6.16-for-rhel-9-x86_64-rpms
    enabled = 1
    Copy to Clipboard Toggle word wrap
  4. 在配置文件中,将 /root/Satellite-repos 替换为提取的位置。
  5. 使用健康检查选项来确定系统是否准备好更新。在第一次使用此命令时,satellite-maintain 会提示您输入 hammer admin 用户凭证,并将它们保存在 /etc/foreman-maintain/foreman-maintain-hammer.yml 文件中。

    # satellite-maintain update check \
    --whitelist="check-upstream-repository,repositories-validate"
    Copy to Clipboard Toggle word wrap
  6. 检查结果,并在执行更新前解决所有突出显示的错误条件。
  7. 由于更新时间过长,使用 tmux 等实用程序来暂停和重新连接通信会话。然后,您可以在不持续连接到命令 shell 的情况下检查更新进度。

    如果您丢失了运行 update 命令的命令 shell,您可以在 /var/log/foreman-installer/satellite.log 文件中看到记录的消息,以检查进程是否已成功完成。

  8. 执行更新:

    # satellite-maintain update run \
    --whitelist="check-upstream-repository,repositories-setup,repositories-validate"
    Copy to Clipboard Toggle word wrap
  9. 如果 satellite-maintain 命令通知您重启,请重启系统:

    # reboot
    Copy to Clipboard Toggle word wrap

其他资源

第 4 章 更新 Capsule 服务器

将 Capsule 服务器更新至下一个补丁版本。

流程

  1. 同步 Satellite 服务器中的 satellite-capsule-6.16-for-rhel-8-x86_64-rpms 存储库。
  2. 发布和提升注册胶囊的内容视图的新版本。
  3. 确保启用了 Satellite Maintenance 存储库:

    • 在 Red Hat Enterprise Linux 9 中:

      # subscription-manager repos --enable \
      satellite-maintenance-6.16-for-rhel-9-x86_64-rpms
      Copy to Clipboard Toggle word wrap
    • 在 Red Hat Enterprise Linux 8 中:

      # subscription-manager repos --enable \
      satellite-maintenance-6.16-for-rhel-8-x86_64-rpms
      Copy to Clipboard Toggle word wrap
  4. 使用健康检查选项来确定系统是否准备好更新:

    # satellite-maintain update check
    Copy to Clipboard Toggle word wrap

    检查结果,并在执行更新前解决所有突出显示的错误条件。

  5. 由于更新时间较长,使用 tmux 等实用程序挂起和重新连接通信会话。然后,您可以在不持续连接到命令 shell 的情况下检查更新进度。

    如果您丢失了运行 update 命令的命令 shell,您可以在 /var/log/foreman-installer/capsule.log 文件中看到日志记录的消息,以检查进程是否已成功完成。

  6. 执行更新:

    # satellite-maintain update run
    Copy to Clipboard Toggle word wrap
  7. 如果 satellite-maintain 命令通知您重启,请重启系统:

    # reboot
    Copy to Clipboard Toggle word wrap

法律通告

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2026 Red Hat
返回顶部