管理 Red Hat Satellite

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

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

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

   Copy to Clipboard Toggle word wrap

2. 停止并禁用 Satellite 服务：

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

流程

1. 在您的新数据库服务器中安装 PostgreSQL：

   # dnf install postgresql-server postgresql-contrib

   Copy to Clipboard Toggle word wrap

2. 初始化 PostgreSQL 数据库：

   # postgresql-setup --initdb

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

   请注意，需要调整外部 PostgreSQL 的默认配置，才能使用 Satellite。以下是推荐进行的外部数据库配置调整：

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

4. 删除 #，编辑相关内容以侦听入站连接：

   listen_addresses = '*'

   Copy to Clipboard Toggle word wrap

5. 在文件末尾添加以下行以使用 SCRAM 进行身份验证：

   password_encryption=scram-sha-256

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

     host  all   all   Satellite_ip/32   scram-sha-256

   Copy to Clipboard Toggle word wrap

8. 启动并启用 PostgreSQL 服务：

   # systemctl enable --now postgresql

   Copy to Clipboard Toggle word wrap

9. 打开 postgresql 端口：

   # firewall-cmd --add-service=postgresql

   Copy to Clipboard Toggle word wrap

10. 使更改具有持久性：

    # firewall-cmd --runtime-to-permanent

    Copy to Clipboard Toggle word wrap

11. 切换到 postgres 用户，启动 PostgreSQL 客户端：

    $ su - postgres -c psql

    Copy to Clipboard Toggle word wrap

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

    Copy to Clipboard Toggle word wrap

13. 退出 postgres 用户：

    # \q

    Copy to Clipboard Toggle word wrap

14. 在 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"

    Copy to Clipboard Toggle word wrap

流程

1. 在 Satellite 服务器上，停止除 PostgreSQL 的所有 Satellite 服务：

   # satellite-maintain service stop --exclude postgresql

   Copy to Clipboard Toggle word wrap

2. 为 Satellite 备份创建目标目录：

   # mkdir /var/My_Migration_Backup_Directory

   Copy to Clipboard Toggle word wrap

3. 备份内部数据库：

   # satellite-maintain backup online \
   --preserve-directory \
   --skip-pulp-content \
   /var/My_Migration_Backup_Directory

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

   # satellite-installer \
   --katello-candlepin-manage-db false \
   --katello-candlepin-db-host postgres.example.com \
   --katello-candlepin-db-name candlepin \
   --katello-candlepin-db-user candlepin \
   --katello-candlepin-db-password Candlepin_Password \
   --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-user pulp \
   --foreman-proxy-content-pulpcore-postgresql-password Pulpcore_Password \
   --foreman-db-manage false \
   --foreman-db-host postgres.example.com \
   --foreman-db-database foreman \
   --foreman-db-username foreman \
   --foreman-db-password Foreman_Password

   Copy to Clipboard Toggle word wrap

6. 删除 Satellite 服务器上的 PostgreSQL 软件包：

   # satellite-maintain packages remove postgresql-server

   Copy to Clipboard Toggle word wrap

7. 删除 PostgreSQL 数据目录：

   # rm -fr /var/lib/pgsql/data

   Copy to Clipboard Toggle word wrap

流程

1. 将敏感变量存储在加密的文件中：

   1. 创建 Ansible 库。例如，创建名为 My_Vault.yml 的库：

      $ ansible-vault create My_Vault.yml

      Copy to Clipboard Toggle word wrap

   2. 在 ansible-vault create 命令打开编辑器后，以键:value 格式提供所需的参数。

      如果要使用 Satellite 用户名和密码进行身份验证：

      My_Username: My_Admin_User_Account
      My_Password: My_Admin_Password
      My_Server_URL: https://satellite.example.com

      Copy to Clipboard Toggle word wrap

      如果要使用 Satellite 用户名和个人访问令牌(PAT)进行身份验证：

      My_Username: My_Admin_User_Account
      My_Password: My_PAT
      My_Server_URL: https://satellite.example.com

      Copy to Clipboard Toggle word wrap

   3. 如果您使用 HTTP 代理访问 Satellite API，也将其存储在密码库中：

      My_HTTP_Proxy: "http://proxy.example.com:8080"

      Copy to Clipboard Toggle word wrap
   4. 保存更改并关闭编辑器。Ansible 加密 vault 中的数据。

2. 创建引用 vault 文件的 playbook 文件：

   注意

   以下 YAML 片段包括 module_defaults 关键字，将 vault 变量作为参数传递给来自 redhat.satellite.satellite 组的所有模块。模块默认组允许您为模块组定义常用参数来简化参数管理，而不必单独将参数传递给每个模块。

   1. 提供有关如何对 Satellite API 进行身份验证的详细信息。

      如果您使用 Satellite 用户名和密码或 PAT 进行身份验证，请将 用户名、password 和 server_url 参数映射到 My_Vault.yml 的内容：

      - name: My Playbook
        hosts: localhost
        vars_files:
          - My_Vault.yml
        module_defaults:
          group/redhat.satellite.satellite:
            username: "{{ My_Username }}"
            password: "{{ My_Password }}"
            server_url: "{{ My_Server_URL }}"
        tasks:

      Copy to Clipboard Toggle word wrap

   2. 如果您需要使用 HTTP 代理访问 Satellite API，请设置 https_proxy 环境变量：

      - name: My Playbook
        hosts: localhost
        vars_files:
          - My_Vault.yml
        environment:
          https_proxy: "{{ My_HTTP_Proxy }}"
        module_defaults:
          group/redhat.satellite.satellite:
            username: "{{ My_Username }}"
            password: "{{ My_Password }}"
            server_url: "{{ My_Server_URL }}"
        tasks:

      Copy to Clipboard Toggle word wrap
   3. 在 tasks: 部分中，定义您希望 playbook 的任务。

3. 验证 playbook 语法：

   $ ansible-playbook --syntax-check --ask-vault-pass My_Playbook.yml

   Copy to Clipboard Toggle word wrap

   请注意，这个命令只验证语法。它不会防止有效但不正确的配置。

4. 运行 playbook：

   $ ansible-playbook --ask-vault-pass My_Playbook.yml

   Copy to Clipboard Toggle word wrap

流程

1. 在 Satellite Web UI 中，进入到 Administer > Organizations。
2. 单击新建组织。
3. 在 Name 字段中输入机构的名称。
4. 在 Label 字段中输入机构的唯一标识符。这用于创建和映射某些资产，如内容存储的目录。使用字母、数字、下划线和短划线，但没有空格。
5. 可选：在 Description 字段中输入机构的描述。
6. 点 Submit。
7. 如果您主机没有分配机构，请选择您要添加到机构中的主机，然后单击 Proceed to Edit。
8. 在 Edit 页面中，分配您要添加到机构的基础架构资源。这包括网络资源、安装介质、Kickstart 模板和其他参数。您可以随时返回到此页面，方法是进入到 Administer > Organizations，然后选择要编辑的机构。
9. 点 Submit。

CLI 过程

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

流程

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

流程

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

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

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

      Copy to Clipboard Toggle word wrap
   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

   Copy to Clipboard Toggle word wrap
2. 在 Firefox 浏览器中，进入到 Edit > Preferences > Advanced Tab。
3. 选择 查看证书，然后单击 您的证书 选项卡。
4. 点 Import 并选择要加载的 .pfx 文件。

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

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

   Copy to Clipboard Toggle word wrap

流程

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

CLI 过程

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

   $ hammer organization list

   Copy to Clipboard Toggle word wrap

   从输出中，记下您要删除的机构的 ID。

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

   $ hammer organization delete --id Organization_ID

   Copy to Clipboard Toggle word wrap

流程

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

   Copy to Clipboard Toggle word wrap

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

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

   $ hammer location delete --id Location ID

   Copy to Clipboard Toggle word wrap

流程

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

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

   注意

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

6. 点 Submit。

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

流程

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

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

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

1. 验证用户的电子邮件地址。
2. 验证 Satellite 服务器的电子邮件配置。
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

   Copy to Clipboard Toggle word wrap

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

   # systemctl start postfix

   Copy to Clipboard Toggle word wrap

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts，找到您要查看的主机，然后点击 Actions 列中的 Edit。
2. 转至 附加信息选项卡。如果选中了 此主机在 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

   Copy to Clipboard Toggle word wrap

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

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

   Expand

   表 11.1. 备份数据压缩率

   数据类型	目录	ratio	结果示例
   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

   Show more

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

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

   这个示例需要 201 GB，以及未压缩备份数据 120 GB，总计需要 321 GB。对于 64 GB 的额外空间，必须为备份位置分配 385 GB。

流程

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

   # satellite-maintain backup offline /var/backup_directory

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

4. 可选：如果要指向不同的备份版本，并使用该备份版本生成一系列递增，作为起点，您可以随时完成此操作。例如，如果要从完整备份而不是第一个或第二增量备份进行新的增量备份，指向完整备份目录：

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

   Copy to Clipboard Toggle word wrap

流程

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

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

3. 运行恢复脚本。

   # satellite-maintain restore /var/backup_directory

   Copy to Clipboard Toggle word wrap

   其中 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

   Copy to Clipboard Toggle word wrap

流程

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

   • 如果您的 Satellite 服务器安装了默认的自签名 SSL 证书：

     # satellite-change-hostname new-satellite \
     --username My_Username \
     --password 'My_Password'

     Copy to Clipboard Toggle word wrap

   • 如果您的 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"

     Copy to Clipboard Toggle word wrap
2. 如果您已为新的 Satellite 服务器主机名创建了自定义 SSL 证书，请运行 Satellite 安装脚本来安装证书。有关安装自定义 SSL 证书的更多信息，请参阅在连接的网络环境中安装 Satellite 服务器中的将自定义 SSL 证书部署到 Satellite 服务器。
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

   Copy to Clipboard Toggle word wrap

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

   # hammer capsule list

   Copy to Clipboard Toggle word wrap

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

   # hammer capsule content synchronize \
   --id My_Capsule_ID

   Copy to Clipboard Toggle word wrap
7. 如果您使用 virt-who 代理，请使用新主机名更新 virt-who 配置文件。如需更多信息，请参阅 为虚拟机订阅 配置 virt-who 中的 修改 virt-who 配置。
8. 如果使用外部身份验证，请在运行 satellite-change-hostname 脚本后重新配置 Satellite 服务器以进行外部身份验证。如需更多信息，请参阅为 Red Hat Satellite 用户配置身份验证。