管理 Red Hat Satellite

流程

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

   # hostname -f

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

   https://satellite.example.com/pub

3. 第一次访问 Satellite 时，您的网页浏览器中会显示不受信任的连接警告。接受自签名证书并添加 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. 使用您的红帽身份管理凭证，自行获取 Kerberos 票据授予票据(TGT)：

   $ kinit idm_user
   Password for idm_user@_EXAMPLE.COM:

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

   您已自动登录。

流程

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

重置管理用户密码

1. 登录到安装了 Satellite 服务器的基本操作系统。

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

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

3. 使用此密码重置卫星 Web UI 中的密码。

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

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

设置新的管理用户密码

1. 登录到安装了 Satellite 服务器的基本操作系统。

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

   # foreman-rake permissions:reset password=new_password

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

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

流程

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

1. 备份源服务器。
2. 将源服务器克隆到目标服务器。
3. 关闭源服务器。
4. 更新目标服务器上的网络配置，使其与目标服务器的 IP 地址与其新的主机名匹配。
5. 测试新目标服务器。

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 Infrastructure 订阅 中的说明，将 Satellite 订阅附加到您的服务器。

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

   # subscription-manager repos --disable '*'
   # subscription-manager repos \
   --enable=satellite-6.15-for-rhel-8-x86_64-rpms \
   --enable=satellite-maintenance-6.15-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 postgresql-contrib

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

9. 使更改持久：

   # firewall-cmd --runtime-to-permanent

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

    $ su - postgres -c psql

11. 创建三个数据库和专用角色：一个用于 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;

12. 连接到 Pulp 数据库：

    postgres=# \c pulpcore
    You are now connected to database "pulpcore" as user "postgres".

13. 创建 hstore 扩展：

    pulpcore=# CREATE EXTENSION IF NOT EXISTS "hstore";
    CREATE EXTENSION

14. 退出 postgres 用户：

    # \q

15. 从 Satellite 服务器中，测试您可以访问数据库。如果连接成功，命令会返回 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 \
   --preserve-directory \
   --skip-pulp-content \
   /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-database foreman \
   --foreman-db-host postgres.example.com \
   --foreman-db-manage false \
   --foreman-db-password Foreman_Password \
   --foreman-db-username foreman \
   --foreman-proxy-content-pulpcore-manage-postgresql false \
   --foreman-proxy-content-pulpcore-postgresql-db-name pulpcore \
   --foreman-proxy-content-pulpcore-postgresql-host postgres.example.com \
   --foreman-proxy-content-pulpcore-postgresql-password Pulpcore_Password \
   --foreman-proxy-content-pulpcore-postgresql-user pulp \
   --katello-candlepin-db-host postgres.example.com \
   --katello-candlepin-db-name candlepin \
   --katello-candlepin-db-password Candlepin_Password \
   --katello-candlepin-db-user candlepin \
   --katello-candlepin-manage-db false

流程

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

5. 可选：如果您不想启用简单内容访问(SCA)，请取消选中 简单内容访问 复选框。有关 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"

   注意

   以这种方式创建的机构默认启用了 Simple Content Access (SCA)。如果要禁用 SCA，请在命令中添加 --simple-content-access false 参数。红帽不推荐禁用 SCA，因为权利模式（不使用 SCA）已弃用。

2. 可选： 要编辑机构，请输入 hammer 机构 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----- 中。
   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. 选择 View Certificates，再单击 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. 点新位置。
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. 在 Email Preferences 选项卡中，选择 Mail Enabled。

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

   注意

   通过在 Mail Query 文本框中输入所需的查询，可以过滤 Audit Summary 通知。

6. 点 Submit。

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

流程

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

3. 在 Email Preferences 选项卡上，单击 Test email。

   测试电子邮件会立即发送到用户的电子邮件地址。

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

流程

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

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

   注意

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

流程

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/tftpboot /etc /root/ssl-build \
   /var/www/html/pub /opt/puppetlabs
   16M   /var/lib/tftpboot
   37M   /etc
   900K  /root/ssl-build
   100K  /var/www/html/pub
   2M    /opt/puppetlabs
   942M  total

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

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

   表 11.1. 备份数据压缩率

   数据类型	目录	比率	结果示例
   PostgreSQL 数据库文件	/var/lib/pgsql/data	80 – 85%	100 GB → 20 GB
   Pulp RPM 文件	/var/lib/pulp	（未压缩）	100 GB
   配置文件	/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. 将备份数据复制到 Satellite服务器的本地文件系统。使用 /var/ 或 /var/tmp/。

3. 运行恢复脚本。

   # satellite-maintain restore /var/backup_directory

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

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

流程

1. 使用 第 12.1 节 “从完整备份中恢复” 中的说明恢复最后一个完整备份。
2. 从 Satellite 服务器的本地文件系统中删除完整备份数据，例如 /var/ 或 /var/tmp/。
3. 将增量备份数据复制到 Satellite服务器的本地文件系统，例如 /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 My_Username \
     --password My_Password

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

     # satellite-change-hostname new-satellite \
     --username My_Username \
     --password My_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. 在所有 Capsule 服务器上，运行 Satellite 安装脚本来更新对新主机名的引用：

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

5. 在 Satellite 服务器上，列出所有 Capsule 服务器：

   # hammer capsule list

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

   # hammer capsule content synchronize \
   --id My_capsule_ID

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

流程

1. 在受管主机上，为您的胶囊服务器生成新的证书存档文件。

   • 如果您使用默认 SSL 证书，请重新生成默认 SSL 证书：

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

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

   • 如果您使用自定义 SSL 证书，请为您的胶囊服务器创建新的 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 \
   --certs-tar /root/new-capsule.example.com-certs.tar \
   --password My_Password \
   --username My_Username

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

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

5. 在注册到 Capsule 服务器的所有主机上，输入以下命令重新安装 bootstrap RPM、重新注册客户端并刷新其订阅。

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

   # dnf remove katello-ca-consumer*
   
   # dnf install http://new-capsule.example.com/pub/katello-ca-consumer-latest.noarch.rpm
   
   # subscription-manager register \
   --environment="My_Lifecycle_Environment" \
   --force \
   --org="My_Organization"
   
   # 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 服务器中删除：

   # 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"更改为"按需" 以了解相关说明。

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

      注意

      如果您使用 untypical 文件系统（除 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 \
   --certs-tar "/root/My_Certificates/capsule.example.com-certs.tar" \
   --certs-update-server \
   --foreman-proxy-fqdn "capsule.example.com" \
   --server-ca-cert "/root/My_Certificates/ca_cert_bundle.pem" \
   --server-cert "/root/My_Certificates/capsule_cert.pem" \
   --server-key "/root/My_Certificates/capsule_cert_key.pem"

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 \
   --certs-tar-file "/root/My_Certificates/capsule.example.com-certs.tar" \
   --certs-update-server \
   --foreman-proxy-foreman-base-url "https://satellite.example.com" \
   --foreman-proxy-register-in-foreman "true"

使用日志配置日志的步骤

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

   # satellite-installer \
   --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-type \
   --reset-foreman-proxy-log

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

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

将日志记录配置为 JSON 输出的步骤

1. 在 Satellite 服务器上，为 satellite-installer 启用日志记录到 JSON 输出：

   # satellite-installer \
   --foreman-logging-layout json \
   --foreman-logging-type file

2. 可选：使用 jq 检查日志消息：

   # cat /var/log/foreman/production.log | jq

流程

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

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

2. 可选：将所有日志记录器重置为默认值：

   # satellite-installer --reset-foreman-loggers

配置 RSS 源通知

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

流程

1. 在 Satellite Web UI 中，进入到 Monitor > Audits 来查看审计记录。

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

   # foreman-rake audits:list_attributes

流程

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

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

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

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

5. 可选：输入 description 和 audit 注释。
6. 分配机构和位置。
7. 点 Submit。

流程

1. 在 Satellite Web UI 中，进入到 Administer > Webhook > Webhooks。
2. 点 Create new。
3. 从 Subscribe to 列表中选择一个事件。
4. 输入 webhook 的 Name。
5. 输入 Target URL。Webhook 向预先配置的 URL 发出 HTTP 请求。目标 URL 可以是动态 URL。
6. 单击 Template 以选择模板。Webhook 模板用于在触发 webhook 时生成到 Satellite 服务器的 HTTP 请求的正文。
7. 输入 HTTP 方法。
8. 可选：如果您在创建 Webhook 时不想激活 Webhook，请取消选中 Enabled 标志。
9. 点 Credentials 选项卡。
10. 可选：如果需要 HTTP 身份验证，请输入 User 和 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 > Webhook > Webhooks。
3. 点 Create new。
4. 从 Subscribe to 列表中，选择 Actions Remote Execution Run Host Job Succeeded。
5. 输入 webhook 的 Name。

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 标头 字段中输入以下文本：

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

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

验证

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

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

   # 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!