管理 Red Hat Satellite

流程

1. 识别 Satellite 服务器的完全限定域名：

   # hostname -f

2. 使用指向完全限定域名的 Web 浏览器访问卫星服务器上的 pub 目录：

   https://satellite.example.com/pub

3. 当您第一次访问 Satellite 时，Web 浏览器中会显示不受信任的连接警告。接受自签名证书，并将 Satellite URL 添加为安全例外，以覆盖设置。此过程可能因所使用的浏览器而异。在接受安全例外前，请确保 Satellite URL 有效。
4. 选择 katello-server-ca.crt。
5. 将证书作为证书颁发机构导入到您的浏览器中，并信任它来识别网站。

CLI 过程

1. 在 Satellite CLI 中，将 katello-server-ca.crt 文件复制到您用于访问 Satellite Web UI 的机器：

   # scp /var/www/html/pub/katello-server-ca.crt username@hostname:remotefile

2. 在浏览器中，将 katello-server-ca.crt 证书导入为证书颁发机构，并信任它来识别网站。

流程

1. 使用指向完全限定域名的 Web 浏览器访问 Satellite 服务器：

   https://satellite.example.com/

2. 输入配置过程中创建的用户名和密码。如果在配置过程中没有创建用户，则默认用户名为 admin。如果登录时遇到问题，可以重置密码。更多信息请参阅 第 1.8 节 “重置管理用户密码”。

流程

1. 代表 Satellite 用户获取 Kerberos 票据授予票据(TGT)：

   $ kinit idm_user

   警告

   如果您要将 Red Hat Identity Management 设置为身份验证提供程序时，您启用了对 Satellite API 和 Satellite Web UI 的访问，攻击者可以在用户收到 Kerberos TGT 后获取 API 会话。即使用户之前没有在任何位置输入 Satellite 登录凭据，例如在浏览器中，也可以受到攻击。

2. 如果没有启用自动协商身份验证，请使用 TGT 手动对hammer 进行身份验证：

   $ hammer auth login negotiate

3. 可选：销毁集合中所有缓存的 Kerberos 票据：

   $ kdestroy -A

流程

1. 使用您的 Red Hat Identity Management 凭证为您获取 Kerberos 票据授予票据(TGT)：

   $ kinit idm_user
   Password for idm_user@EXAMPLE.COM:

2. 在浏览器地址栏中，输入 Satellite 服务器的 URL。

   您已自动登录。

流程

1. 启用 Chrome 浏览器使用 Kerberos 身份验证：

   $ google-chrome --auth-server-whitelist="*.example.com" --auth-negotiate-delegate-whitelist=”*.example.com"

   注意

   您还可以列出特定的 Satellite 服务器，而不是列出整个域。

2. 使用您的 Red Hat Identity Management 凭证为您获取 Kerberos 票据授予票据(TGT)：

   $ kinit idm_user
   Password for idm_user@_EXAMPLE.COM:

3. 在浏览器地址栏中，输入 Satellite 服务器的 URL。

   您已自动登录。

流程

1. 点击右上角的您的用户名。
2. 从菜单中选择 My Account。
3. 在 Current Password 字段中，输入当前密码。
4. 在 Password 字段中，输入新密码。
5. 在 Verify 字段中，再次输入新密码。
6. 单击提交按钮 保存新密码。

要重置管理用户密码

1. 登录安装卫星服务器的基本操作系统。

2. 输入以下命令重置密码：

   # foreman-rake permissions:reset
   Reset to user: admin, password: qwJxBptxb7Gfcjj5

3. 使用此密码在 Satellite Web UI 中重置密码。

4. 编辑卫星服务器上的 ~/.hammer/cli.modules.d/foreman.yml 文件以添加新密码：

   # vi ~/.hammer/cli.modules.d/foreman.yml

要设置新的管理用户密码

1. 登录安装卫星服务器的基本操作系统。

2. 要设置密码，请输入以下命令：

   # foreman-rake permissions:reset password=new_password

3. 编辑卫星服务器上的 ~/.hammer/cli.modules.d/foreman.yml 文件以添加新密码：

   # vi ~/.hammer/cli.modules.d/foreman.yml

流程

1. 在 Satellite Web UI 中，导航到 Administer > Settings，然后点击 General 选项卡。
2. 单击登录页面 页页文本 旁边的编辑按钮，然后输入要在登录页面中显示所需的文本。例如，贵公司所需的此文本可能是警告消息。
3. 点 Save。
4. 从 Satellite Web UI 注销，并验证自定义文本现在显示在 Satellite 版本号下的登录页面中。

1. 备份源服务器。
2. 将源服务器克隆到目标服务器。
3. 关闭源服务器。
4. 更新目标服务器上的网络配置，使其与其新主机名匹配目标服务器的 IP 地址。
5. 如果有任何内容主机使用已弃用的 Katello Agent，请在所有这些内容主机及其 Capsules 上重启 goferd 服务来刷新连接。
6. 测试新目标服务器。

1. 对处于活跃状态的 PostgreSQL 数据库执行备份，不包括 Pulp 数据：

   # satellite-maintain backup offline --skip-pulp-content \
   --assumeyes /var/backup

2. 停止并禁用 Satellite 服务：

   # satellite-maintain service stop
   # satellite-maintain service disable

3. 将 Pulp 数据复制到目标服务器：

   # rsync --archive --partial --progress --compress \
   /var/lib/pulp/ target_server.example.com:/var/lib/pulp/

流程

1. 使用附加 Satellite 基础架构订阅 中的说明，将 Satellite 订阅附加到您的服务器。

2. 禁用所有软件仓库并只启用以下软件仓库：

   # subscription-manager repos --disable '*'
   # subscription-manager repos \
   --enable=satellite-6.13-for-rhel-8-x86_64-rpms \
   --enable=satellite-maintenance-6.13-for-rhel-8-x86_64-rpms \
   --enable=rhel-8-for-x86_64-baseos-rpms \
   --enable=rhel-8-for-x86_64-appstream-rpms

3. 启用以下模块：

   # dnf module enable satellite:el8

   注意

   启用模块 satellite:el8 会警告与 postgresql:10 和 ruby:2.5 冲突，因为这些模块在 Red Hat Enterprise Linux 8 中被设置为默认模块版本。模块 satellite:el8 依赖于模块 postgresql:12 和 ruby:2.7，它将通过 satellite:el8 模块启用。这些警告不会导致安装过程失败，因此可以安全地忽略。有关 Red Hat Enterprise Linux 8 中的模块和生命周期流的更多信息，请参阅 Red Hat Enterprise Linux Application Streams 生命周期。

流程

1. 要安装 PostgreSQL，请输入以下命令：

   # dnf install postgresql-server postgresql-evr

2. 要初始化 PostgreSQL，请输入以下命令：

   # postgresql-setup initdb

3. 编辑 /var/lib/pgsql/data/postgresql.conf 文件：

   # vi /var/lib/pgsql/data/postgresql.conf

   请注意，需要调整外部 PostgreSQL 的默认配置才能与 Satellite 一起工作。推荐的外部数据库配置调整如下：

   • checkpoint_completion_target: 0.9
   • max_connections: 500
   • shared_buffers: 512MB
   • work_mem: 4MB

4. 删除 # 并编辑 以侦听入站连接：

   listen_addresses = '*'

5. 编辑 /var/lib/pgsql/data/pg_hba.conf 文件：

   # vi /var/lib/pgsql/data/pg_hba.conf

6. 在文件中添加以下行：

     host  all   all   Satellite_ip/32   md5

7. 要启动并启用 PostgreSQL 服务，请输入以下命令：

   # systemctl enable --now postgresql

8. 打开外部 PostgreSQL 服务器上的 postgresql 端口：

   # firewall-cmd --add-service=postgresql
   # firewall-cmd --runtime-to-permanent

9. 切换到 postgres 用户并启动 PostgreSQL 客户端：

   $ su - postgres -c psql

10. 创建三个数据库和专用角色：一个用于 Satellite，一个用于 Candlepin，另一个用于 Pulp ：

    CREATE USER "foreman" WITH PASSWORD 'Foreman_Password';
    CREATE USER "candlepin" WITH PASSWORD 'Candlepin_Password';
    CREATE USER "pulp" WITH PASSWORD 'Pulpcore_Password';
    CREATE DATABASE foreman OWNER foreman;
    CREATE DATABASE candlepin OWNER candlepin;
    CREATE DATABASE pulpcore OWNER pulp;

11. 退出 postgres 用户：

    # \q

12. 从卫星服务器，测试您可以访问数据库。如果连接成功，命令会返回 1。

    # PGPASSWORD='Foreman_Password' psql -h postgres.example.com  -p 5432 -U foreman -d foreman -c "SELECT 1 as ping"
    # PGPASSWORD='Candlepin_Password' psql -h postgres.example.com -p 5432 -U candlepin -d candlepin -c "SELECT 1 as ping"
    # PGPASSWORD='Pulpcore_Password' psql -h postgres.example.com -p 5432 -U pulp -d pulpcore -c "SELECT 1 as ping"

流程

1. 在 Satellite 服务器中，停止 Satellite 服务：

   # satellite-maintain service stop

2. 启动 PostgreSQL 服务：

   # systemctl start postgresql

3. 备份内部数据库：

   # satellite-maintain backup online --skip-pulp-content --preserve-directory -y /var/migration_backup

4. 将数据传送到新的外部数据库中：

   PGPASSWORD='Foreman_Password' pg_restore -h postgres.example.com -U foreman -d foreman < /var/migration_backup/foreman.dump
   PGPASSWORD='Candlepin_Password' pg_restore -h postgres.example.com -U candlepin -d candlepin < /var/migration_backup/candlepin.dump
   PGPASSWORD='Pulpcore_Password' pg_restore -h postgres.example.com -U pulp -d pulpcore < /var/migration_backup/pulpcore.dump

5. 使用 satellite-installer 命令更新 Satellite 以指向新数据库：

   satellite-installer --scenario satellite \
       --foreman-db-host postgres.example.com \
       --foreman-db-password Foreman_Password \
       --foreman-db-database foreman \
       --foreman-db-manage false \
       --foreman-db-username foreman \
       --katello-candlepin-db-host postgres.example.com \
       --katello-candlepin-db-name candlepin \
       --katello-candlepin-db-password Candlepin_Password \
       --katello-candlepin-manage-db false \
       --katello-candlepin-db-user candlepin \
       --foreman-proxy-content-pulpcore-manage-postgresql false \
       --foreman-proxy-content-pulpcore-postgresql-host postgres.example.com \
       --foreman-proxy-content-pulpcore-postgresql-db-name pulpcore \
       --foreman-proxy-content-pulpcore-postgresql-password Pulpcore_Password \
       --foreman-proxy-content-pulpcore-postgresql-user pulp

流程

1. 在 Satellite Web UI 中，导航到 Administer > Organizations。
2. 单击 New Organization。
3. 在 Name 字段中输入机构的名称。
4. 在 Label 字段中输入机构的唯一标识符。这用于创建和映射某些资产，如内容存储的目录。使用字母、数字、下划线和横线，但没有空格。

5. 可选：如果您不想启用简单内容访问(SCA)，请取消选中 Simple Content Access 复选框。有关 SCA 的更多信息，请参阅 简单内容访问。

   注意

   红帽不推荐禁用 SCA，因为授权模式已弃用。

6. 可选：在 Description 字段中输入机构的描述。
7. 点 Submit。
8. 如果您分配了没有机构的主机，请选择您要添加到机构的主机，然后点 Proceed to Edit。
9. 在 Edit 页面中，分配您要添加到机构的基础架构资源。这包括网络资源、安装介质、Kickstart 模板和其他参数。您可以随时返回到此页面，导航到 Administer > Organizations，然后选择要编辑的机构。
10. 点 Submit。

CLI 过程

1. 运行以下命令来创建机构：

   # hammer organization create \
   --name "My_Organization" \
   --label "My_Organization_Label" \
   --description "My_Organization_Description"

   注意

   以这种方式创建的组织默认启用简单内容访问(SCA)。如果要禁用 SCA，请在命令中添加 --simple-content-access false 参数。红帽不建议禁用 SCA，因为授权模式（不使用 SCA）已被弃用。

2. 可选： 要编辑机构，请输入 hammer organization update 命令。例如，以下命令将计算资源分配给机构：

   # hammer organization update \
   --name "My_Organization" \
   --compute-resource-ids 1

流程

1. 在 Satellite Web UI 中，导航到 Administer > Organizations。
2. 选择您要为其生成调试证书的机构。
3. 点 Generate and Download。
4. 将证书文件保存到安全的位置。

流程

1. 将私钥和公钥从证书分成两个文件。

   1. 为默认机构打开 X.509 证书：

      $ vi 'Default Organization-key-cert.pem'

   2. 将文件的内容从 -----BEGIN RSA PRIVATE KEY----- 复制到 -----END RSA PRIVATE KEY-----，到 key.pem 文件中。
   3. 将文件的内容从 -----BEGIN CERTIFICATE----- 复制到 -----END CERTIFICATE----- 到 cert.pem 文件中。
2. 要使用浏览器，您必须首先将 X.509 证书转换为浏览器支持的格式，然后导入证书。

对于 Firefox 用户

1. 使用以下命令将证书转换为 PKCS12 格式：

   $ openssl pkcs12 -keypbe PBE-SHA1-3DES -certpbe PBE-SHA1-3DES -export -in cert.pem -inkey key.pem -out My_Organization_Label.pfx -name My_Organization

2. 在 Firefox 浏览器中，导航到 Edit > Preferences > Advanced Tab。
3. 选择 查看证书 并点 Your Certificates 选项卡。
4. 单击 Import，再选择要加载的 .pfx 文件。

5. 在地址栏中输入以下 URL，以浏览所有存储库的可访问路径并检查其内容：

   https://satellite.example.com/pulp/content/

流程

1. 在 Satellite Web UI 中，导航到 Administer > Organizations。
2. 从您要删除的机构名称右侧的列表中，选择 Delete。
3. 单击 OK 以删除该组织。

CLI 过程

1. 输入以下命令检索您要删除的机构的 ID：

   # hammer organization list

   从输出中，记下您要删除的组织的 ID。

2. 输入以下命令删除机构：

   # hammer organization delete --id Organization_ID

流程

1. 在 Satellite Web UI 中，导航到 Administer > Locations。
2. 单击 New Location。
3. 可选：从 Parent 列表中选择一个父位置。这会创建一个位置层次结构。
4. 在 Name 字段中输入位置的名称。
5. 可选：在 Description 字段中输入位置描述。
6. 点 Submit。
7. 如果您没有分配位置的主机，请添加您要分配给新位置的任何主机，然后单击 Proceed to Edit。
8. 分配您要添加到位置的任何基础架构资源。这包括网络资源、安装介质、Kickstart 模板和其他参数。您可以随时返回到此页面，导航到 Administer > Locations，然后选择要编辑的位置。
9. 单击 Submit 以保存您的更改。

流程

1. 在 Satellite Web UI 中，导航到 Administer > Locations。
2. 从您要删除的位置名称右侧的列表中选择 Delete。
3. 单击 OK 以删除该位置。

CLI 过程

1. 输入以下命令检索您要删除的位置的 ID：

   # hammer location list

   从输出中，记下您要删除的位置的 ID。

2. 输入以下命令删除位置：

   # hammer location delete --id Location ID

流程

1. 在 Satellite Web UI 中，进入到 Administer > Users。
2. 点您要编辑的用户的 Username。
3. 在 User 选项卡上，验证 Mail 字段的值。在此字段中，电子邮件通知将发送到地址。
4. 在 电子邮件首选项 选项卡上，选择 邮件已启用。

5. 选择您希望用户使用通知类型旁边的下拉菜单接收的通知。

   注意

   通过在 Mail Query 文本框中输入所需的查询，可以过滤 审计概述 通知。

6. 点 Submit。

   用户将开始接收通知电子邮件。

流程

1. 在 Satellite Web UI 中，进入到 Administer > Users。
2. 点用户名。

3. 在 电子邮件首选项 选项卡上，单击测试电子邮件。

   将立即向用户的电子邮件地址发送测试电子邮件消息。

1. 验证用户的电子邮件地址。
2. 验证卫星服务器的电子邮件配置。
3. 检查防火墙和邮件服务器日志。

4. 如果您的 Satellite 服务器使用 Postfix 服务进行电子邮件发送，测试电子邮件可能会在队列中保存。要进行验证，请输入 mailq 命令列出当前的邮件队列。如果测试电子邮件在队列中保存，mail q 会显示以下信息：

   postqueue: warning: Mail system is down -- accessing queue directly
   -Queue ID-  --Size-- ----Arrival Time---- -Sender/Recipient-------
   BE68482A783    1922 Thu Oct  3 05:13:36  satellite-noreply@example.com

   要解决这个问题，请在您的 Satellite 服务器上启动 Postfix 服务：

   # systemctl start postfix

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts，找到您要查看的主机，并在 Actions 列中点 Edit。
2. 进入 Additional Information 选项卡。如果选中了在 Satellite 报告中包含此主机的 复选框，则会在该主机上启用电子邮件通知。

3. 可选：切换复选框以启用或禁用电子邮件通知。

   注意

   如果要接收电子邮件通知，请确保在用户设置中设置了电子邮件地址。

Ansible 部署的步骤

1. 导入 foreman.foreman_scap_client Ansible 角色。

   如需更多信息，请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置。

2. 将创建的策略和 foreman.foreman_scap_client Ansible 角色分配到主机或主机组。

3. 若要触发部署，请手动对主机或主机组运行 Ansible 角色，或者使用远程执行进行常规策略更新来设置周期性作业。

   如需更多信息，请参阅管理主机中的配置和设置远程作业。

Puppet 部署的步骤

1. 确保 Puppet 已启用。
2. 确保主机上安装了 Puppet 代理。

3. 导入包含 foreman_scap_client Puppet 模块的 Puppet 环境。

   如需更多信息，请参阅在 Red Hat Satellite 中使用 Puppet 集成管理配置。

4. 将创建的策略和 foreman_scap_client Puppet 类分配给主机或主机组。

   Puppet 会触发下一次常规运行的部署，也可以手动运行 Puppet。Puppet 默认每 30 分钟运行一次。

流程

1. 导航到 Hosts > All Hosts。
2. 点所需主机的主机名。
3. 在主机详情页面上，展开 Schedule a job 下拉菜单。
4. 选择 Run OpenSCAP scan。

验证

1. 在主机详情概述中找到 Recent 作业 卡。
2. 选择 Running 选项卡。除非作业已完成，表 显示所有 OpenSCAP 策略的 Run scan 作业。
3. 在 Recent jobs 卡中，选择 Finished 选项卡。
4. 如果作业成功完成，您应该在作业所在行中看到 succeeded 状态。
5. 可选：点击作业名称来查看调用详情。

流程

1. 输入 du 命令，以估算包含 Satellite 数据库和配置文件的未压缩目录的大小：

   # du -sh /var/lib/pgsql/data /var/lib/pulp
   100G    /var/lib/pgsql/data
   100G	/var/lib/pulp
   
   # du -csh /var/lib/qpidd /var/lib/tftpboot /etc /root/ssl-build \
   /var/www/html/pub /opt/puppetlabs
   886M  /var/lib/qpidd
   16M   /var/lib/tftpboot
   37M   /etc
   900K  /root/ssl-build
   100K  /var/www/html/pub
   2M    /opt/puppetlabs
   942M  total

2. 计算存储压缩数据所需的空间量。

   下表描述了备份中包含的所有数据项目的压缩率：

   表 12.1. 备份数据压缩率

   数据类型	目录	ratio	结果示例
   PostgreSQL 数据库文件	/var/lib/pgsql/data	80 – 85%	100 GB → 20 GB
   Pulp RPM 文件	/var/lib/pulp	（未压缩）	100 GB
   配置文件	/var/lib/qpidd /var/lib/tftpboot /etc /root/ssl-build /var/www/html/pub /opt/puppetlabs	85%	942 MB → 141 MB

   在本例中，压缩备份数据总占用 120 GB。

3. 要计算您存储备份所需的可用空间量，请计算压缩和未压缩备份数据的预计值总和，再添加一个额外的 20% 以确保备份可靠。

   这个示例需要 201 GB 加上 120 GB 用于未压缩备份数据 321 GB。具有 64 GB 的额外空间，必须为备份位置分配 385 GB。

流程

1. 要执行完全离线备份，请输入以下命令：

   # satellite-maintain backup offline /var/backup_directory

2. 要在备份目录中创建目录来存储第一个增量备份，请使用 --incremental 选项输入 satellite-maintain backup 命令：

   # satellite-maintain backup offline --incremental /var/backup_directory/full_backup /var/backup_directory

3. 要创建第二个增量备份，请使用 --incremental 选项输入 satellite-maintain backup 命令，并包含第一个增量备份的路径来指示下一次递增的起点。这会为备份目录中第二个增量备份创建一个目录：

   # satellite-maintain backup offline --incremental /var/backup_directory/first_incremental_backup /var/backup_directory

4. 可选： 如果要指向不同版本的备份，并在开始时对这个备份版本进行一系列增量，您可以随时执行此操作。例如，如果要从完整备份而不是第一个或者第二个增量备份中创建新的增量备份，请指向完整备份目录：

   # satellite-maintain backup offline --incremental /var/backup_directory/full_backup /var/backup_directory

流程

1. 选择安装 Satellite 或 Capsule 的适当方法：

   • 要从连接的网络中安装 Satellite 服务器，请按照 在 连接的网络环境中安装 Satellite 服务器 中的步骤操作。
   • 要从断开连接的网络中安装 Satellite 服务器，请按照 在断开连接的网络环境中安装 Satellite 服务器 中的步骤。
   • 要安装胶囊服务器，请按照 安装胶囊式服务器 中的步骤操作。
2. 将备份数据复制到卫星服务器的本地文件系统。使用 /var/ 或 /var/tmp/.

3. 运行恢复脚本。

   # satellite-maintain restore /var/backup_directory

   其中 backup_directory 是时间戳的目录或包含备份数据的子目录。

   恢复过程可能需要很长时间才能完成，因为要复制的数据量。

流程

1. 使用 第 13.1 节 “从全备份中恢复” 中的说明恢复最后的完整备份。
2. 从卫星服务器的本地文件系统中删除完整的备份数据，例如 /var/ 或 /var/tmp/。
3. 将增量备份数据复制到卫星服务器的本地文件系统中，如 /var/ 或 /var/tmp/。

4. 按照相同的顺序恢复增量备份：

   # satellite-maintain restore /var/backup_directory/FIRST_INCREMENTAL
   # satellite-maintain restore /var/backup_directory/SECOND_INCREMENTAL

流程

1. 在命令行中，运行 satellite-change-hostname 脚本，并提供新的主机名。选择以下任一方法：

   • 如果您的 Satellite 服务器安装了默认自签名 SSL 证书，请输入以下命令：

     # satellite-change-hostname new-satellite \
     --username admin \
     --password password

   • 如果您的 Satellite 服务器安装有自定义 SSL 证书：

     # satellite-change-hostname new-satellite \
     --username admin \
     --password password \
     --custom-cert "/root/ownca/test.com/test.com.crt" \
     --custom-key "/root/ownca/test.com/test.com.key"

2. 如果您已经为新的 Satellite 服务器主机名创建了自定义 SSL 证书，请运行 Satellite 安装脚本来安装证书。有关安装自定义 SSL 证书的更多信息，请参阅 在 连接的网络环境中安装 Satellite 服务器 中的 向 Satellite 服务器部署自定义 SSL 证书。
3. 重新注册所有 Satellite 主机。如需更多信息， 请参阅管理主机中的 注册主机。

4. 在所有胶囊服务器中，运行 Satellite 安装脚本以更新对新主机名的引用：

   # satellite-installer \
   --foreman-proxy-foreman-base-url https://new-satellite.example.com \
   --foreman-proxy-trusted-hosts new-satellite.example.com \
   --puppet-server-foreman-url https://new-satellite.example.com

5. 在本地服务器上，列出所有胶囊式服务器：

   # hammer capsule list

6. 在 Satellite 服务器中，同步每个 Capsule 服务器的内容：

   # hammer capsule content synchronize \
   --id My_capsule_ID

7. 如果使用 virt-who 代理，请使用新的主机名更新 virt-who 配置文件。如需更多信息，请参阅在 Red Hat Satellite 中配置虚拟机订阅 中的 修改 virt-who 配置 。
8. 如果使用外部身份验证，请在运行 satellite-change-hostname 脚本后重新配置 Satellite 服务器以进行外部身份验证。如需更多信息，请参阅 在 连接的网络环境中安装 Satellite 服务器 中的 配置 外部身份验证。

流程

1. 在卫星服务器上，为胶囊服务器生成一个新的证书存档文件。

   • 如果您使用默认 SSL 证书，请输入以下命令：

     # capsule-certs-generate \
     --foreman-proxy-fqdn new-capsule.example.com \
     --certs-tar /root/new-capsule.example.com-certs.tar

     确保输入 .tar 文件的完整路径。

   • 如果您使用自定义 SSL 证书，请为 Capsule Server 创建新的 SSL 证书。如需更多信息，请参阅安装 Capsule 服务器 中的 使用自定义 SSL 证书配置 Capsule 服务器。

2. 在受管主机上，将证书存档文件复制到胶囊服务器。例如，将存档文件复制到 root 用户的主目录：

   # scp /root/new-capsule.example.com-certs.tar root@capsule.example.com:

3. 在 Capsule 服务器上，运行 satellite-change-hostname 脚本，并提供主机的新名称、Satellite 凭据和证书存档文件名。

   # satellite-change-hostname new-capsule.example.com --username admin \
   --password password \
   --certs-tar /root/new-capsule.example.com-certs.tar

   确保输入 .tar 文件的完整路径。

4. 如果您为 Capsule 服务器创建了自定义证书，请输入在上一步中返回的 satellite-installer 命令，在 Capsule 服务器上部署证书。如需更多信息，请参阅 安装 Capsule 服务器 中的 将自定义 SSL 证书部署到 Capsule 服务器。

5. 在所有胶囊客户端上，输入以下命令重新安装 bootstrap RPM、重新注册客户端并刷新其订阅。

   您可以使用远程执行功能执行此步骤。如需更多信息，请参阅管理主机中的配置和设置远程作业。

   # dnf remove katello-ca-consumer*
   
   # dnf install http://new-capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpm
   
   # subscription-manager register --org="My_Organization" \
   --environment="Library" \
   --force
   
   # subscription-manager refresh

6. 在 Satellite Web UI 中更新 Capsule 主机名。

   1. 在 Satellite Web UI 中，导航到 Infrastructure > Capsules。
   2. 在列表中找到 Capsule Server，然后单击 Edit。
   3. 编辑 Name 和 URL 字段，以匹配 Capsule Server 的新主机名，然后单击 Submit。
   4. 在 DNS 服务器上，为您的胶囊服务器的新主机名添加记录，并删除之前主机名的记录。

流程

1. 在 Satellite Web UI 中，导航到 Administer > Settings。
2. 在 General 选项卡中，找到 Saved audits interval 设置。
3. 将值设为您希望 Satellite 删除审计记录的天数。

流程

1. 使用 SSH 连接到您的 Satellite 服务器：

   # ssh root@satellite.example.com

2. 可选：查看任务：

   # hammer task info --id My_Task_ID

3. 删除任务：

   # foreman-rake foreman_tasks:cleanup TASK_SEARCH="id=My_Task_ID"

4. 可选：确保任务已从 Satellite Server 中删除：

   # hammer task info --id My_Task_ID

   请注意，由于删除了任务，这个命令会返回一个非零退出代码。

流程

1. 运行 Pulp 任务完成，但不会触发任何新的任务，因为它们可能会因为完整磁盘而失败。

2. 确保具有 /var/lib/pulp 目录的 LV 具有足够的可用空间。实现这一点的方法如下：

   1. 删除孤立的内容：

      # foreman-rake katello:delete_orphaned_content RAILS_ENV=production

      这每周运行，因此不会释放大量空间。

   2. 尽可能将下载策略从 Immediate 更改为 On Demand，并删除已下载的软件包。具体步骤请查看红帽知识库解决方案 如何将 Satellite 上存储库的同步策略从"Immediate"改为红帽客户门户网站上的"On-Demand "。

   3. 使用 /var/lib/pulp 目录在 LV 上增大文件系统。如需更多信息，请参阅 在 Red Hat Enterprise Linux 8 中扩展逻辑卷和文件系统 配置和管理逻辑卷。

      注意

      如果您使用不写的文件系统（例如 ext3、ext4 或 xfs），您可能需要卸载文件系统，使其不使用。在这种情况下，请完成以下步骤：

      1. 停止 Satellite 服务：

         # satellite-maintain service stop

      2. 在 LV 上增大文件系统。

      3. 启动 Satellite 服务：

         # satellite-maintain service start

3. 如果某些 Pulp 任务因为完整磁盘而失败，请再次运行它们。

流程

1. 停止除 postgresql 服务外的所有服务：

   # satellite-maintain service stop --exclude postgresql

2. 切换到 postgres 用户并回收数据库上的空间：

   # su - postgres -c 'vacuumdb --full --all'

3. 在 vacuum 完成后启动其他服务：

   # satellite-maintain service start

验证

1. 从本地机器访问 Satellite Web UI。例如： https://satellite.example.com。
2. 在您的浏览器中，查看证书详情以验证部署的证书。

流程

1. 在 Satellite 服务器上，验证自定义 SSL 证书输入文件：

   # katello-certs-check -t capsule \
   -b /root/capsule_cert/ca_cert_bundle.pem \
   -c /root/capsule_cert/capsule_cert.pem \
   -k /root/capsule_cert/capsule_cert_key.pem

2. 在 Satellite 服务器上，为您的 Capsule 服务器生成证书存档文件：

   capsule-certs-generate --foreman-proxy-fqdn "capsule.example.com" \
   --certs-tar  "/root/My_Certificates/capsule.example.com-certs.tar" \
   --server-cert "/root/My_Certificates/capsule_cert.pem" \
   --server-key "/root/My_Certificates/capsule_cert_key.pem" \
   --server-ca-cert "/root/My_Certificates/ca_cert_bundle.pem" \
   --certs-update-server

3. 在 Satellite 服务器上，将证书归档文件复制到您的 Capsule 服务器中：

   # scp /root/My_Certificates/capsule.example.com-certs.tar user@capsule.example.com:

   如果需要，您可以将复制的文件移到适用路径中。

4. 保留 Capsule- certs-generate 命令返回的 satellite- installer 命令的副本，以将证书部署到您的胶囊服务器。

5. 使用 Capsule- certs-generate 命令返回的 satellite-installer 命令将证书部署到 Capsule 服务器上：

   # satellite-installer --scenario capsule \
   --foreman-proxy-register-in-foreman "true" \
   --foreman-proxy-foreman-base-url "https://satellite.example.com" \
   --certs-tar-file "/root/My_Certificates/capsule.example.com-certs.tar" \
   --certs-update-server

流程

1. 要启用 debug 日志记录，请输入以下命令：

   # satellite-installer --foreman-logging-level debug

2. 完成调试后，将日志级别重置为默认值：

   # satellite-installer --reset-foreman-logging-level

流程

1. 在 Satellite Web UI 中，导航到 Administer > About。
2. 在 Smart Proxies 选项卡上，您可以查看所有胶囊的状态。
3. 在 Compute Resources 选项卡中，您可以查看附加的计算资源提供程序的状态。
4. 在后端 系统状态 表中，您可以查看所有后端服务的状态。

流程

1. 启用您想要的单个日志记录器。例如，要启用 sql 和 ldap loggers，请输入以下命令：

   # satellite-installer \
   --foreman-loggers ldap:true \
   --foreman-loggers sql:true

2. 可选： 要将日志记录器重置为默认值，请输入以下命令：

   # satellite-installer --reset-foreman-loggers

使用日志配置日志的步骤

1. 输入以下 satellite-installer 命令，将日志记录配置为 journald 服务：

   # satellite-installer \
   --foreman-logging-layout pattern \
   --foreman-logging-type journald \
   --foreman-proxy-log JOURNAL

2. 可选： 要检查日志消息，请使用 journalctl 实用程序。例如：

   • journalctl --unit foreman 和 journalctl --unit foreman-proxy 显示 foreman 和 foreman-proxy 单元的消息
   • journalctl REQUEST=request_ID 显示指定请求的消息

配置基于文件的日志记录的步骤

1. 输入以下 satellite-installer 命令来配置基于文件的日志记录：

   # satellite-installer \
   --reset-foreman-logging-layout \
   --reset-foreman-logging-type \
   --reset-foreman-proxy-log

2. 可选： 要检查日志消息，请查看这些文件：

   • /var/log/foreman/production.log
   • /var/log/foreman-proxy.log

配置 RSS Feed 通知：

1. 在 Satellite Web UI 中，导航到 Administer > Settings 并选择 Notifications 选项卡。
2. 在 RSS URL 行中，点 Value 栏中的编辑图标，然后输入所需的 URL。
3. 在 RSS 启用行中，点 Value 列中的编辑图标来启用或禁用此功能。

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Audits 以查看审计记录。

2. 要获取所有审计属性的列表，请使用以下命令：

   # foreman-rake audits:list_attributes

流程

1. 在 Satellite Web UI 中，导航到 Administer > Webhook Templates。
2. 单击 Clone a existing template 或 Create Template。
3. 输入模板的名称。

4. 使用编辑器更改模板有效负载。

   必须使用 Satellite 模板语法创建 webhook HTTP 有效负载。webhook 模板可以使用一个名为 @object 的特殊变量来代表事件的主对象。如果某些事件，可以缺少 @object。您可以确定哪些数据实际上可通过 @payload 变量使用。

   如需更多信息， 请参阅管理主机中的模板编写参考 ，以及可用的模板宏和方法，请访问 Satellite 服务器上的 /templates_doc。

5. 可选：输入描述和审计注释。
6. 分配组织和位置。
7. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Administer > Webhooks。
2. 点 Create new。
3. 从 Subscribe to 列表中选择一个事件。
4. 输入 webhook 的名称。
5. 输入 目标 URL。Webhook 对预先配置的 URL 发出 HTTP 请求。目标 URL 可以是动态 URL。
6. 单击 Template 以选择模板。Webhook 模板用于在触发 Webhook 时向 Satellite 服务器生成 HTTP 请求正文。
7. 输入 HTTP 方法。
8. 可选：如果您不希望在创建 Webhook 时激活 Webhook，请取消选择 Enabled 标志。
9. 点 Credentials 标签页。
10. 可选：如果需要 HTTP 身份验证，请输入 User and Password。
11. 可选： 如果您不想根据系统证书存储或 Satellite CA 验证服务器证书，请取消检查 验证 SSL。
12. 在 Additional 选项卡中，输入 HTTP Content Type。例如，您定义的有效负载上的 application/json、application/xml 或 text/plain。应用程序不会尝试转换内容以匹配指定的内容类型。
13. 可选：提供 HTTP 标头作为 JSON。也允许 ERB。

流程

1. 修改 /var/lib/foreman-proxy/shellhooks/print_args 脚本，以将参数打印到标准错误输出，以便您可以在 Capsule 日志中看到它们：

   #!/bin/sh
   #
   # Prints all arguments to stderr
   #
   echo "$@" >&2

2. 在 Satellite Web UI 中，导航到 Administer > Webhooks。
3. 点 Create new。
4. 从 Subscribe to 列表中，选择 Actions Remote Execution Run Host Job Succeeded。
5. 输入 webhook 的名称。

6. 在 Target URL 字段中，输入您的 Capsule 服务器的 URL，后跟 :9090/shellhook/print_args ：

   https://capsule.example.com:9090/shellhook/print_args

   请注意，URL 中的 shellhook 是单数的，这与 shellhooks 目录不同。

7. 从 Template 列表中，选择 Empty Payload。
8. 在 Credentials 选项卡上，选中 Capsule Authorization。

9. 在 Additional 选项卡中，在 Optional HTTP headers 字段中输入以下文本：

   {
       "X-Shellhook-Arg-1": "Hello",
       "X-Shellhook-Arg-2": "World!"
   }

10. 点 Submit。现在，您已成功创建了一个 shellhook，它会在每次远程执行作业都成功时将"Hello World!"打印到 Capsule 日志。

验证

1. 在任何主机上运行远程执行作业。您可以使用 时间 作为命令。如需更多信息 ，请参阅管理主机中的 执行远程作业。

2. 验证 shellhook 脚本是否已触发，并将"Hello World!"输出到 Capsule 服务器日志：

   # tail /var/log/foreman-proxy/proxy.log

   您应该在日志末尾找到以下行：

   [I] Started POST /shellhook/print_args
   [I] Finished POST /shellhook/print_args with 200 (0.33 ms)
   [I] [3520] Started task /var/lib/foreman-proxy/shellhooks/print_args\ Hello\ World\!
   [W] [3520] Hello World!