流程

1. 在 Satellite Web UI 中，点 Hosts > Create Host。
2. 在 Host 选项卡中，输入所需的详情。
3. 单击 Ansible Roles 选项卡，然后从 Ansible Roles 列表中选择您要添加到主机的一个或多个角色。使用 箭头图标 管理您添加或删除的角色。
4. 在 Puppet Classes 选项卡上，选择您要包含的 Puppet 类。

5. 在 Interfaces 选项卡中：

   1. 对于每个接口，点 Actions 列中的 Edit，并根据需要配置以下设置：

      • Type — 对于一个 Bond 或 BMC 接口，使用 Type 列表并选择接口类型。
      • MAC 地址 IANA- Enter the MAC 地址。
      • DNS 名称 IANA- Enter DNS 服务器已知的 DNS 名称。这用于 FQDN 的主机部分。
      • Domain — 选择置备网络的域名。这通过选择合适的 子网 自动更新子网列表。
      • 来自列表的 IPv4 子网，为主机选择 IPv4 子网。
      • IPv6 子网 IANA- the 从列表中为主机选择 IPv6 子网。
      • IPv4 address — 如果 IP address management (IPAM) 已为子网启用，IP 地址会被自动推荐。或者，您可以输入地址。如果启用了置备令牌，则可以省略该地址，如果域没有强制 DNS，如果子网不管理反向 DNS，或者子网不管理 DHCP 保留。
      • IPv6 address — 如果 IP address management (IPAM) 已为子网启用，IP 地址会被自动推荐。或者，您可以输入地址。
      • 受管 the the 复选框，以在置备过程中配置接口，以使用由 Capsule 提供的 DHCP 和 DNS 服务。
      • 主 IANA- theSelect 此复选框，将此接口的 DNS 名称用作 FQDN 的主机部分。
      • 置备 IANA- theSelect this 复选框，以使用此接口进行调配。这意味着 TFTP 引导将使用这个接口，或者在基于镜像的置备时，将通过这个接口执行置备。请注意，许多置备任务（如由 anaconda 在 %post 脚本中的 Puppet 设置下载 RPM）将使用主接口。

      • 如果这个接口不是物理设备，则 虚拟 NIC IANA-DemoSelect this 复选框。此设置有两个选项：

        • 标签 rhcs- 可选地设置 VLAN 标签。如果未设置，标签将是子网的 VLAN ID。
        • Attached to — 输入这个虚拟机要附加到的接口名称。
   2. 单击 OK 以保存接口配置。
   3. （可选）点击 Add Interface 使其包含额外的网络接口。更多信息请参阅 第 5 章 添加网络接口。
   4. 点 Submit 以应用更改并退出。
6. 在 Operating System 选项卡中，输入所需的详情。对于红帽操作系统，请选择 Synced Content for Media Selection。如果要使用非红帽操作系统，请选择 All Media，然后从 Media Selection 列表中选择安装介质。您可以从列表中选择分区表，或者在 Custom 分区表字段中输入自定义分区表。您不能同时指定。

7. 在 Parameters 选项卡中，单击 Add Parameter 以添加您要在运行时传递给作业模板的任何参数变量。这包括您要与主机关联的所有 Puppet 类、Ansible playbook 参数和主机参数。要将参数变量与 Ansible 作业模板搭配使用，您必须添加 Host 参数。

   当您创建 Red Hat Enterprise Linux 8 主机时，您可以设置系统目的属性。系统目的属性定义了在主机创建时自动附加哪些订阅。在 Host Parameters 区域中，使用对应的值输入以下参数名称。如需值列表，请参阅执行标准 RHEL 8 安装中的系统目的介绍。

   • syspurpose_role
   • syspurpose_sla
   • syspurpose_usage
   • syspurpose_addons
8. 在 Additional Information 选项卡中，输入有关主机的附加信息。
9. 点 Submit 以完成您的拉取请求。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 在 Actions 菜单中，单击 Clone。
3. 在 Host 选项卡中，确保提供与原始主机不同的名称。
4. 在 Interfaces 选项卡上，确保提供不同的 IP 地址。
5. 点 Submit 以克隆主机。

流程

1. 在 Satellite Web UI 中，导航到 Infrastructure > Compute Resources。
2. 选择计算资源。
3. 在 Virtual Machines 选项卡中，从 Actions 菜单中点 关联虚拟机。

步骤

1. 在 Satellite Web UI 中，导航到 Hosts > Content Hosts，然后点击您要编辑的 Red Hat Enterprise Linux 8 主机的名称。
2. 在 System Purpose 区域中，点您要编辑、添加或删除的系统目的属性的 Edit 或 Remove 图标。
3. 点 Save。
4. 点 Subscriptions 选项卡，然后选择 Subscriptions。
5. 点 Run Auto-Attach 自动将订阅附加到您的主机。
6. 刷新页面以验证订阅列表是否包含正确的订阅。

CLI 过程

1. 登录主机并编辑所需的系统目的属性。例如，将使用类型设置为 Production，将角色设置为 Red Hat Enterprise Linux Server，并添加 addon 附加组件。如需值列表，请参阅执行标准 RHEL 8 安装中的系统目的介绍。

   # syspurpose set-usage Production
   # syspurpose set-role Red Hat Enterprise Linux Server
   # syspurpose add-addons 'your_addon'

2. 验证此主机的系统目的属性：

   # syspurpose show

3. 自动将订阅附加到此主机：

   # subscription-manager attach --auto

4. 验证此主机的系统目的状态：

   # subscription-manager status

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Content Hosts 并选择您要编辑的 Red Hat Enterprise Linux 8 主机。
2. 单击 Select Action 列表，再选择 Manage System Purpose。

3. 选择您要分配给所选主机的系统目的属性。您可以选择以下值之一：

   • 设置所有所选主机的特定属性。
   • 没有更改 来保留所选主机上设置的属性。
   • none (Clear) 清除所选主机上的属性。
4. 点 Assign。
5. 在 Satellite Web UI 中，导航到 Hosts > Content Hosts 并选择相同的 Red Hat Enterprise Linux 8 主机来根据系统目的自动附加订阅。
6. 单击 Select Action 列表，再选择 Manage Subscriptions。
7. 点 Auto-Attach 以根据其系统角色自动将订阅附加到所有选择的主机。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Content Hosts，再点击包含您要更改的模块的主机名称。
2. 点 Module Streams 选项卡。
3. 在 Available Module Streams 列表中，找到您要更改的模块。您可以使用 Filter 字段来优化列表条目。您还可以使用 Filter Status 列表搜索具有特定状态的模块。
4. 从 Actions 列表中，选择您要对该模块所做的更改。
5. 在 作业调用 窗口中，确保作业信息准确。更改您需要的任何详细信息，然后单击 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Configure > Host Groups，再点 Create Host Group。
2. 如果您有一个要从中继承属性的现有主机组，您可以从 Parent 列表中选择主机组。如果没有，请将此字段留空。
3. 输入新 主机组的名称。
4. 输入您希望将来主机继承的任何其他信息。
5. 单击 Ansible Roles 选项卡，然后从 Ansible Roles 列表中选择您要添加到主机的一个或多个角色。使用 箭头图标 管理您添加或删除的角色。

6. 单击附加选项卡，并将您要属性的任何详细信息添加到主机组。

   注意

   在注册与生产环境中创建的 Puppet 环境关联的主机组时，Puppet 无法检索 Puppet CA 证书。

   要创建与主机组关联的适当 Puppet 环境，请手动创建目录：

   # mkdir /etc/puppetlabs/code/environments/example_environment

7. 点 Submit 保存主机组。

步骤

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 选中您要更改的主机的复选框。
3. 从 Select Action 列表中，选择 Change Group。此时会打开一个新选项窗口。
4. 从 Host Group 列表中，选择您要主机的组。
5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 选中您要更改的主机的复选框。
3. 从 Select Action 列表中，选择 Change Environment。此时会打开一个新选项窗口。
4. 从 Environment 列表中，为您的主机选择新环境。
5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 选择主机。
3. 点 Edit。
4. 单击 Manage host 或 Unmanage host 以更改主机的状态。
5. 点 Submit。

步骤

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 选中您要更改的主机的复选框。
3. 从 Select Action 列表中，选择 Assign Organization。此时会打开一个新选项窗口。

4. 从 Select Organization 列表中，选择要为其分配主机的机构。选中 Fix Organization on Mismatch。

   注意

   如果存在与主机关联的资源，如域或子网，以及与您要为其分配主机的机构不关联，则会发生不匹配的情况。选项 Fix Organization on Mismatch 将向机构添加此类资源，因此推荐的选择。Mismatch 选项 Fail 将始终产生 错误消息。例如，将主机从一个机构重新分配给另一个机构将失败，即使设置中没有实际不匹配。

5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 选中您要更改的主机的复选框。
3. 从 Select Action 列表中，选择 Assign Location。此时会打开一个新选项窗口。

4. 导航到 Select Location 列表，再选择您要主机的位置。选中 Fix Location on Mismatch。

   注意

   如果存在与主机关联的资源，如域或子网，以及与您要为其分配主机的位置不关联，则会发生不匹配的情况。选项 Fix Location on Mismatch 会将此类资源添加到位置，因此推荐的选择。Mismatch 选项 Fail 将始终产生 错误消息。例如，将主机从一个位置重新分配给另一个位置将失败，即使设置中没有实际不匹配。

5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts 或 Hosts > Content Hosts。请注意，从 All hosts 页或从 Content Hosts 页删除主机没有区别。在这两种情况下，Satellite 会完全删除主机。
2. 选择您要删除的主机。
3. 从 Select Action 列表中，选择 Delete Hosts。
4. 单击 Submit，以从 Red Hat Satellite 永久删除主机。

1. 手动创建目录：

   # mkdir /etc/puppetlabs/code/environments/example_environment

2. 在 Satellite Web UI 中，导航到 Configure > Environments，再点 Import environment from。按钮名称包括内部或外部 Capsule 的 FQDN。
3. 选择创建的目录，再单击 Update。

流程

1. 以 root 用户身份登录主机。

2. 下载脚本：

   # curl -O http://satellite.example.com/pub/bootstrap.py

3. 使脚本可执行：

   # chmod +x bootstrap.py

4. 通过查看帮助文本确认脚本可以执行：

   • 在 Red Hat Enterprise Linux 8 中：

     # /usr/libexec/platform-python bootstrap.py -h

   • 在其他 Red Hat Enterprise Linux 版本中：

     # ./bootstrap.py -h

5. 输入适合您环境的 bootstrap 命令。

   对于 --server 选项，指定 Satellite 服务器的 FQDN 或 Capsule 服务器。对于 --location、--organization 和 --hostgroup 选项，请使用带引号的名称，而不是标签，作为选项的参数。有关高级用例，请参阅 第 3.4.2 节 “高级引导脚本配置”。

   • 在 Red Hat Enterprise Linux 8 中，输入以下命令：

     # /usr/libexec/platform-python bootstrap.py \
     --login=admin \
     --server satellite.example.com \
     --location="Example Location" \
     --organization="Example Organization" \
     --hostgroup="Example Host Group" \
     --activationkey=activation_key

   • 在 Red Hat Enterprise Linux 6 或 7 中，输入以下命令：

     # ./bootstrap.py --login=admin \
     --server satellite.example.com \
     --location="Example Location" \
     --organization="Example Organization" \
     --hostgroup="Example Host Group" \
     --activationkey=activation_key

6. 输入您使用 --login 选项指定的 Satellite 用户的密码。

   脚本将进度通知发送到 stdout。

7. 脚本提示时，批准主机的 Puppet 证书。在 Satellite Web UI 中，导航到 Infrastructure > Capsules，并找到您使用 --server 选项指定的 Satellite 或 Capsule 服务器。
8. 从 Actions 列中的列表中，选择 Certificates。
9. 在 Actions 列中，单击 Sign 以批准主机的 Puppet 证书。
10. 返回到主机，以查看 bootstrap 过程完成的其余部分。
11. 在 Satellite Web UI 中，导航到 Hosts > All hosts，并确保主机连接到正确的主机组。

12. 可选：主机注册完成后，删除脚本：

    # rm bootstrap.py

流程

1. 安装 katello-agent 软件包：

   # yum install katello-agent

2. 启动 goferd 服务：

   # systemctl start goferd

流程

1. 在内容主机上安装 katello-host-tools-tracer RPM 软件包：

   # yum install katello-host-tools-tracer

2. 使用以下命令：

   # katello-tracer-upload

3. 在 Satellite Web UI 中，导航到 Hosts > All hosts，然后点所需的主机名。
4. 点 Traces 选项卡查看 Traces。如果没有安装，Enable Traces 按钮会启动安装该软件包的远程执行作业。

流程

1. 以 root 用户身份登录主机。

2. 安装 Puppet 代理软件包。

   • 在运行 Red Hat Enterprise Linux 8 及更高版本的主机上：

     # dnf install puppet-agent

   • 在运行 Red Hat Enterprise Linux 7 并以下的主机上：

     # yum install puppet-agent

3. 使用以下脚本，将 Puppet 代理添加到当前 shell 中的 PATH 中：

   . /etc/profile.d/puppet-agent.sh

4. 配置 Puppet 代理。将 environment 参数设置为主机所属的 Puppet 环境的名称：

   # puppet config set server satellite.example.com --section agent
   # puppet config set environment My_Puppet_Environment --section agent

5. 启动 Puppet 代理服务：

   # puppet resource service puppet ensure=running enable=true

6. 为主机创建证书：

   # puppet ssl bootstrap

7. 在 Satellite Web UI 中，导航到 Infrastructure > Capsules。
8. 从所需 Capsule 服务器的 Actions 列中的列表中，选择 Certificates。
9. 单击所需主机右侧的 Sign，以签署 Puppet 代理的 SSL 证书。

10. 在主机上再次运行 Puppet 代理：

    # puppet ssl bootstrap

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 点您要编辑的主机旁的 Edit。
3. 在 Interfaces 选项卡中，点 Add Interface。
4. 在 Type 列表中选择的 Interface 选项。
5. 指定 MAC 地址。此设置是必需的。
6. 指定 设备标识符， 如 eth0。标识符用于创建绑定接口、VLAN 和别名时指定此物理接口。
7. 指定与主机 IP 地址关联的 DNS 名称。Satellite 将此名称保存在与所选域(DNS A"字段)和与所选子网关联的 Capsule 服务器(DNS PTR"字段)关联的 Capsule 服务器中。因此，单个主机可以有多个 DNS 条目。
8. 从 Domain 列表中选择一个域。要创建和管理域，请导航到 Infrastructure > Domains。
9. 从 Subnet 列表中选择子网。要创建和管理子网，请导航到 Infrastructure > Subnets。
10. 指定 IP 地址。带有分配的 DHCP Capsule 服务器的受管接口需要此设置来创建 DHCP 租期。启用 DHCP 的受管接口由建议的 IP 地址自动提供。
11. 选择接口是否为 Managed。如果接口被管理，则在置备过程中从关联的 Capsule 服务器拉取配置，并创建 DNS 和 DHCP 条目。如果使用 kickstart 置备，则会为接口自动创建配置文件。
12. 选择这是否 为主机 的主接口。主接口的 DNS 名称用作 FQDN 的主机部分。
13. 选择这是否为主机的 Provision 接口。TFTP 引导使用置备接口进行。对于基于镜像的调配，用于完成调配的脚本通过调配接口执行。
14. 选择是否将接口用于远程执行。
15. 保持 虚拟 NIC 复选框清除。
16. 单击 OK 以保存接口配置。
17. 点 Submit 将更改应用到主机。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 点您要编辑的主机旁的 Edit。
3. 在 Interfaces 选项卡中，点 Add Interface。
4. 在 Type 列表中选择的 Interface 选项。

5. 指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。

   为受管虚拟接口指定 MAC 地址，以便正确生成用于置备的配置文件。但是，不管理的虚拟接口不需要 MAC 地址。

   如果创建 VLAN，在 Device Identifier 字段中指定 eth1.10 格式的 ID。如果创建别名，请使用 eth1:10 格式的 ID。

6. 选择 Virtual NIC 复选框。特定于虚拟接口的其他配置选项会附加到表单中：

   • 标签 ：可选地设置 VLAN 标签，将来自物理网络的网络段中继到虚拟接口。如果没有指定标签，则受管接口会继承相关子网的 VLAN 标签。此字段中的用户指定的条目不适用于别名接口。
   • 附加到 ：指定虚拟接口所属的物理接口的标识符，如 eth1。此设置是必需的。
7. 单击 OK 以保存接口配置。
8. 点 Submit 将更改应用到主机。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 点您要编辑的主机旁的 Edit。
3. 在 Interfaces 选项卡中，点 Add Interface。
4. 从 Type 列表中选择 Bond。其他特定于类型的配置选项会附加到表单中。

5. 指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。

   绑定接口在 Device Identifier 字段中以 bond0 的形式使用 ID。

   单个 MAC 地址 就足够了。

6. 指定特定于绑定接口的配置选项：

   • 模式 ：选择绑定模式来定义容错和负载平衡策略。如需了解每个绑定模式的简短描述，请参阅 第 5.4 节 “Satellite 中可用的绑定模式”。
   • 附加设备 ：指定以逗号分隔的附加设备的标识符列表。可以是物理接口或 VLAN。
   • 绑定选项 ：指定以空格分隔的配置选项列表，如 miimon=100。如需了解您可以为绑定接口指定的配置选项的详细信息，请参阅 Red Hat Enterprise Linux 7 网络指南。
7. 单击 OK 以保存接口配置。
8. 点 Submit 将更改应用到主机。

流程

1. 如果还没有启用，在 Capsule 服务器上启用 BMC：

   1. 使用以下选项运行 satellite-installer 脚本，在 Capsule 服务器上配置 BMC 电源管理：

      # satellite-installer --foreman-proxy-bmc=true \
      --foreman-proxy-bmc-default-provider=ipmitool

   2. 在 Satellite Web UI 中，导航到 Infrastructure > Capsules。
   3. 从 Actions 列中的列表中，单击 Refresh。Features 列中的列表现在应包含 BMC。
2. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
3. 点您要编辑的主机旁的 Edit。
4. 在 Interfaces 选项卡中，点 Add Interface。
5. 从 Type 列表中选择 BMC。特定于类型的配置选项会附加到表单中。
6. 指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。

7. 指定特定于 BMC 接口的配置选项：

   • 用户名和密码 ： 指定 BMC 所需的任何身份验证凭证。
   • Provider ：指定 BMC 供应商。
8. 单击 OK 以保存接口配置。
9. 点 Submit 将更改应用到主机。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts 并选择您要使用 RHEL web 控制台管理和监控的主机。
2. 在主机窗口右上角，单击 Web 控制台。

步骤

1. 运行这个 satellite-installer 命令：

   satellite-installer --no-enable-foreman-plugin-remote-execution-cockpit

2. 在 Satellite Web UI 中，导航到 Administer > Settings 并点 Remote execution 选项卡。
3. 在 Cockpit URL 行中，清除 Value 下的设置，然后单击 Submit。这会从 Satellite Web UI 中删除 Web 控制台 按钮。

4. 从 Satellite 卸载 RHEL web 控制台软件包：

   yum remove rubygem-foreman_remote_execution-cockpit

1. 将 RedHatinsights.insights-client 角色添加到主机。

   对于新主机，请参阅 第 2.1 节 “在 Red Hat Satellite 中创建主机”。

   对于现有主机，请参阅配置 Satellite 来使用 Ansible 中的 在 Satellite 主机上使用 Ansible 角色自动重复任务。

2. 要在主机上运行 RedHatinsights.insights-client 角色，请导航到 Hosts > All Hosts，然后点击您要使用的主机名称。
3. 单击 Run Ansible roles 按钮。

1. 在 Satellite Web UI 中，导航到 Configure &gt ; Insights。
2. 点 Start Recommendations Sync 按钮。

流程

1. 在 Satellite Web UI 中，导航到 Configure &gt ; Insights。

2. 在 Red Hat Insights 页面中，选择您要包含在 Insights 计划中的建议数。

   您只能选择具有关联 playbook 的建议。

3. 点 Remediate。
4. 在 Remediation Summary 窗口中，您可以选择要应用的解决方案。使用 Filter 字段搜索特定的关键字。
5. 点 Remediate。
6. 在 Job Invocation 页面中，不要更改预完成字段的内容。
7. 可选。如需远程执行作业的更多高级配置，请单击 Show Advanced Fields。
8. 选择您需要的 查询类型。
9. 选择您需要的 Schedule。
10. 点 Submit。

1. 在 Satellite Web UI 中，导航到 Hosts &gt ; All Hosts。
2. 选择主机。
3. 在 Host 详情页面上，单击 Recommendations。
4. 在 Red Hat Insights 页面中，选择您要包含在 Insights 计划中的建议数量，如以前一样。

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates。
2. 在您要使用的报告模板右侧，点 Generate。
3. 可选： 要在 Generate at 字段右侧调度报告，请点击图标来选择您要生成报告的日期和时间。
4. 可选： 要将报告发送到电子邮件地址，请选择 通过电子邮件 复选框发送报告，并在 发送到电子邮件地址 字段中输入所需的电子邮件地址。
5. 可选：应用搜索查询过滤器。要查看所有可用的结果，请不要使用任何值填充 filter 字段。
6. 点 Submit。包含报告的 CSV 文件会被下载。如果您选择了 通过电子邮件发送报告， 主机监控报告将发送到您的电子邮件地址。

CLI 过程

1. 列出所有可用报告模板：

   # hammer report-template list

2. 生成一个报告：

   # hammer report-template generate --id My_Template_ID

   此命令会等待报告在完成前完全生成。如果要将报告生成为后台任务，您可以使用 hammer report-template schedule 命令。

   注意

   如果要生成订阅授权报告，则必须使用 Now 选项中的 Days 指定权利订阅的最新过期时间。您可以使用 no limit 值显示所有权利。

   显示所有权利

   # hammer report-template generate \
   --inputs "Days from Now=no limit" \
   --name "Subscription - Entitlement Report"

   显示在 60 天后将过期的所有权利

   # hammer report-template generate \
   --inputs "Days from Now=60" \
   --name "Subscription - Entitlement Report"

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates，然后点 Create Template。
2. 在 Name 字段中输入报告模板的唯一名称。
3. 如果您希望模板可用于所有位置和组织，请选择 Default。
4. 在模板编辑器中直接创建模板，或通过单击 Import 从文本文件导入模板。有关导入模板的更多信息，请参阅 第 10.5 节 “导入报告模板”。
5. 可选：在 Audit 注释 字段中，您可以添加有关此模板的任何有用信息。
6. 单击 Input 选项卡，在 Name 字段中输入您可以在模板中以以下格式引用输入的名称： input ('name')。请注意，您必须在模板正文中引用此输入值前保存该模板。
7. 选择输入值是否是必需的。如果输入值是必需的，请选择 Required 复选框。
8. 从 Value Type 列表中，选择用户必须输入的输入值类型。
9. 可选：如果要使用事实进行模板输入，请选择 高级 复选框。
10. 可选：在 Options 字段中，定义用户可以从中选择的选项。如果此字段保持未定义，用户会收到一个自由文本字段，其中可以输入他们所需的值。
11. 可选：在 Default 字段中输入值，如主机名，您要设置为默认模板输入。
12. 可选：在 Description 字段中，您可以在生成报告时输入您要显示的信息作为内联帮助。
13. 可选：点 Type 选项卡，然后选择此模板是否为要包含在其他模板中的代码片段。
14. 点 Location 选项卡，再添加您要使用模板的位置。
15. 单击 Organizations 选项卡，再添加您要使用该模板的组织。
16. 点 Submit 保存您的更改。

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates。
2. 找到您要导出的模板，从 Actions 列中的列表中，选择 Export。
3. 对您要下载的每个报告模板重复此操作。

CLI 过程

1. 要查看可用于导出的报告模板，请输入以下命令：

   # hammer report-template list

   请注意您要在此命令的输出中导出的模板的模板 ID。

2. 要导出报告模板，请输入以下命令：

   # hammer report-template dump --id My_Template_ID > example_export.erb

流程

1. 使用以下请求来检索可用报告模板列表：

   请求示例：

   $ curl --insecure --user admin:redhat \
   --request GET \
   --config https://satellite.example.com/api/report_templates \
   | json_reformat

   在本例中，json_reformat 工具用于格式化 JSON 输出。

   响应示例：

   {
       "total": 6,
       "subtotal": 6,
       "page": 1,
       "per_page": 20,
       "search": null,
       "sort": {
           "by": null,
           "order": null
       },
       "results": [
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Applicable errata",
               "id": 112
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Applied Errata",
               "id": 113
           },
           {
               "created_at": "2019-11-30 16:15:24 UTC",
               "updated_at": "2019-11-30 16:15:24 UTC",
               "name": "Hosts - complete list",
               "id": 158
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Host statuses",
               "id": 114
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Registered hosts",
               "id": 115
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Subscriptions",
               "id": 116
           }
       ]
   }

2. 请注意您要导出的模板的 id，并使用以下请求导出模板：

   请求示例：

   $ curl --insecure --output /tmp/_Example_Export_Template.erb_ \
   --user admin:password --request GET --config \
   https://satellite.example.com/api/report_templates/My_Template_ID/export

   请注意，158 是要导出的模板的示例 ID。

   在本例中，导出的模板重定向到 host_complete_list.erb。

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates。
2. 在 Report Templates 窗口的右上角，单击 Create Template。
3. 在 Editor 选项卡右上角，单击文件夹图标，然后选择您要导入的 .erb 文件。
4. 编辑模板以符合您的要求。
5. 点 Submit。

流程

1. 使用以下示例格式化您要导入到 .json 文件的模板：

   # cat Example_Template.json
   {
       "name": "Example Template Name",
       "template": "
       Enter ERB Code Here
   "
   }

   带有 ERB 模板的 JSON 文件示例：

   {
       "name": "Hosts - complete list",
       "template": "
   <%#
   name: Hosts - complete list
   snippet: false
   template_inputs:
   - name: host
     required: false
     input_type: user
     advanced: false
     value_type: plain
     resource_type: Katello::ActivationKey
   model: ReportTemplate
   -%>
   <% load_hosts(search: input('host')).each_record do |host| -%>
   <%
         report_row(
             'Server FQND': host.name
         )
   -%>
   <%  end -%>
   <%= report_render %>
   "
   }

2. 使用以下请求导入模板：

   $ curl --insecure --user admin:redhat \
   --data @Example_Template.json --header "Content-Type:application/json" \
   --request POST --config https://satellite.example.com/api/report_templates/import

3. 使用以下请求来检索报告模板列表，并验证您可以在 Satellite 中查看模板：

   $ curl --insecure --user admin:redhat \
    --request GET --config https://satellite.example.com/api/report_templates | json_reformat

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates，然后点 Create Template。

2. 可选：在 Editor 字段中，使用 <%# > 标签添加注释，其中的信息可能有助于以后参考。例如：

   <%#
   name: Entitlements
   snippet: false
   model: ReportTemplate
   require:
   - plugin: katello
     version: 3.14.0
   -%>

3. 使用 load_hosts （） 宏添加一行，并使用以下方法和变量填充宏：

   <%- load_hosts(includes: [:lifecycle_environment, :operatingsystem, :architecture, :content_view, :organization, :reported_data, :subscription_facet, :pools => [:subscription]]).each_record do |host| -%>

   要查看您可以使用的变量列表，请点 Help 选项卡，在 Safe 模式方法和变量 表中，找到 Host::Managed 行。

4. 添加一个带有 each 方法的 host.pools 变量的一行，例如：

   <%- host.pools.each do |pool| -%>

   注意

   池 只适用于非简单内容访问(SCA)组织。

5. 使用 report_row （） 方法添加一行，以创建报告并添加您要作为报告的一部分目标的变量：

   <%-     report_row(
             'Name': host.name,
             'Organization': host.organization,
             'Lifecycle Environment': host.lifecycle_environment,
             'Content View': host.content_view,
             'Host Collections': host.host_collections,
             'Virtual': host.virtual,
             'Guest of Host': host.hypervisor_host,
             'OS': host.operatingsystem,
             'Arch': host.architecture,
             'Sockets': host.sockets,
             'RAM': host.ram,
             'Cores': host.cores,
             'SLA': host_sla(host),
             'Products': host_products(host),
             'Subscription Name': sub_name(pool),
             'Subscription Type': pool.type,
             'Subscription Quantity': pool.quantity,
             'Subscription SKU': sub_sku(pool),
             'Subscription Contract': pool.contract_number,
             'Subscription Account': pool.account_number,
             'Subscription Start': pool.start_date,
             'Subscription End': pool.end_date,
             'Subscription Guest': registered_through(host)
             ) -%>

6. 在模板中添加 end 语句：

   <%-   end -%>
   <%- end -%>

7. 要生成报告，您必须添加 <% = report_render -%> 宏：

   <%= report_render -%>

8. 点 Submit 保存模板。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 单击 New Host Collection。
3. 添加主机聚合 的名称。
4. 清除 kiosk Content Hosts，然后在 Limit 字段中输入所需的最大主机数量。
5. 添加主机聚合 的描述。
6. 点击 Save。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 在左侧面板中，点您要克隆的主机控制器。
3. 点 Copy Collection。
4. 为克隆的集合指定一个名称。
5. 点 Create。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 选择要删除的主机控制器。

3. 单击 Remove。此时会出现警报框：

   Are you sure you want to remove host collection Host Collection Name?

4. 单击 Remove。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 选择应添加主机的主机集合。
3. 在 Hosts 选项卡上，选择 Add 子选项卡。
4. 从表中选择要添加的主机，然后单击 Add Selected。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 选择所需的主机聚合。
3. 在 Hosts 选项卡上，选择 List/Remove 子选项卡。
4. 选择您要从主机集合中删除的主机，然后单击 Remove Selected。

1. Satellite 找到选择了 Remote execution 复选框的主机接口。
2. Satellite 找到这些接口的子网。
3. Satellite 找到分配给这些子网的远程执行胶囊。
4. 从这一组 Capsules 中，Satellite 选择具有最少运行作业的 Capsule。通过这样做，Satellite 可确保在远程执行胶囊之间平衡作业负载。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Job templates。
2. 单击 New Job Template。
3. 点 Template 选项卡，在 Name 字段中输入作业模板的唯一名称。
4. 选择 Default，使模板可用于所有机构和位置。
5. 在模板编辑器中直接创建模板，或通过单击 Import 从文本文件上传该模板。
6. 可选：在 Audit 注释 字段中，添加有关更改的信息。
7. 单击 Job 选项卡，并在 Job category 字段中输入您自己的类别，或者从 Default Job Template Categories 中列出的默认类别中选择。
8. 可选：在 Description Format 字段中输入描述模板。例如，安装 package %{package_name}。您还可以在模板中使用 %{template_name} 和 %{job_category}。
9. 从 Provider Type 列表中，为 shell 脚本选择 SSH，为 Ansible 任务或 playbook 选择 Ansible。
10. 可选：在 Timeout to kill 字段中，输入超时值来终止作业（如果它未完成）。
11. 可选：点 Add Input 来定义输入参数。执行作业时请求参数，且不必在模板中定义参数。例如，请参阅 Help 选项卡。
12. 可选：点击 Foreign 输入集 来在此作业中包含其他模板。
13. 可选： 在 Effective 用户 区域中，如果命令无法使用默认的 remote_execution_effective_user 设置，则配置用户。
14. 可选：如果此模板是包含在其他模板中的代码片段，点 Type 选项卡并选择 Snippet。
15. 点 Location 选项卡，再添加您要使用模板的位置。
16. 单击 Organizations 选项卡，再添加您要使用该模板的组织。
17. 点 Submit 保存您的更改。

CLI 过程

1. 要使用模板确定的文件创建作业模板，请输入以下命令：

   # hammer job-template create \
   --file "path_to_template_file" \
   --name "template_name" \
   --provider-type SSH \
   --job-category "category_name"

流程

1. 在 Satellite Web UI 中，导航到 Administer > Settings。
2. 点 Remote Execution。
3. 将 Fallback 配置为任何 Capsule 设置。

流程

1. 在 Satellite Web UI 中，导航到 Administer > Settings。
2. 点 Remote Execution。
3. 配置 Enable Global Capsule 设置。

流程

1. 创建新目录，如 new_place ：

   # mkdir /remote_working_dir

2. 从默认 var 目录中复制 SELinux 上下文：

   # chcon --reference=/var /remote_working_dir

3. 配置系统：

   # satellite-installer --foreman-proxy-plugin-remote-execution-ssh-remote-working-dir /remote_working_dir

1. 第 12.9 节 “手动分发用于远程执行的 SSH 密钥”.
2. 第 12.10 节 “使用 Satellite API 获取远程执行的 SSH 密钥”.
3. 第 12.11 节 “在置备过程中将 Kickstart 模板配置为分布式 SSH 密钥”.
4. 对于新的 Satellite 主机，您可以在使用全局注册模板注册过程中将 SSH 密钥部署到 Satellite 主机。如需更多信息，请参阅使用全局注册模板将主机注册到 Red Hat Satellite。

流程

1. 在 Capsule 上输入以下命令。对您要管理的每个目标主机重复：

   # ssh-copy-id -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy.pub root@target.example.com

2. 要确认密钥已成功复制到目标主机，请在 Capsule 上输入以下命令：

   # ssh -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy root@target.example.com

流程

1. 在目标主机上，创建 ~/.ssh 目录来存储 SSH 密钥：

   # mkdir ~/.ssh

2. 从 Capsule 下载 SSH 密钥：

   # curl https://capsule.example.com:9090/ssh/pubkey >> ~/.ssh/authorized_keys

3. 为 ~/.ssh 目录配置权限：

   # chmod 700 ~/.ssh

4. 为 authorized_keys 文件配置权限：

   # chmod 600 ~/.ssh/authorized_keys

流程

1. 查找 foreman-proxy 用户的 ID：

   # id -u foreman-proxy

2. 修改 umask 值，以便新文件具有权限 600 ：

   # umask 077

3. 为 keytab 创建目录：

   # mkdir -p "/var/kerberos/krb5/user/USER_ID"

4. 创建 keytab 或将现有 keytab 复制到目录中：

   # cp your_client.keytab /var/kerberos/krb5/user/USER_ID/client.keytab

5. 将目录所有者改为 foreman-proxy 用户：

   # chown -R foreman-proxy:foreman-proxy "/var/kerberos/krb5/user/USER_ID"

6. 确保 keytab 文件是只读的：

   # chmod -wx "/var/kerberos/krb5/user/USER_ID/client.keytab"

7. 恢复 SELinux 上下文：

   # restorecon -RvF /var/kerberos/krb5

流程

1. 要为远程执行安装并启用 Kerberos 身份验证，请输入以下命令：

   # satellite-installer --scenario satellite \
    --foreman-proxy-plugin-remote-execution-ssh-ssh-kerberos-auth true

2. 要编辑用于远程执行的默认用户，在 Satellite Web UI 中进入 Administer > Settings 并点 Remote Execution 选项卡。在 SSH 用户 行中，编辑第二列并为 Kerberos 帐户添加用户名。
3. 导航到 remote_execution_effective_user，再编辑第二列，为 Kerberos 帐户添加用户名。

流程

1. 要克隆模板，请在 Actions 列中选择 Clone。
2. 输入克隆的唯一名称，然后点 Submit 以保存更改。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts，再选择您要在其上执行远程作业的目标主机。您可以使用 search 字段过滤主机列表。
2. 从 Select Action 列表中，选择 Schedule Remote Job。
3. 在 Job 调用 页面中，定义主作业设置：
4. 选择要使用的 Job category 和 Job template。
5. 可选：在 书签 列表中选择存储的搜索字符串，以指定目标主机。
6. 可选：通过输入搜索查询来限制目标主机。Resolves to 行显示受查询影响的主机数量。更改查询后，使用刷新按钮重新计算数字。preview 图标列出目标主机。
7. 剩余的设置取决于所选作业模板。有关 在模板中添加 自定义参数的信息，请参阅创建作业模板。

8. 可选： 要为作业配置高级设置，请点击 Display advanced fields。一些高级设置取决于作业模板，以下设置通常是常规设置：

   • 有效的用户 定义了用于执行作业的用户，默认为 SSH 用户。
   • 并发级别 定义一次执行的最大作业数量，这可以防止在大量主机上执行作业时过载系统资源。
   • 终止的超时时间 （以秒为单位）定义作业应该被终止的时间间隔（如果还没有完成）。在定义的间隔期间无法启动的任务（例如，如果上一任务用时过长才能完成），则取消了。
   • 查询 类型定义何时评估搜索查询。这有助于保留已调度任务的查询最新。

   • 执行顺序 决定在主机上执行作业的顺序：字母或随机化。

     通过 并发级别 和超时 来终止 设置，您可以定制作业执行以适应您的基础架构硬件和需求。

9. 要立即运行作业，请确保将 Schedule 设置为 Execute now。您还可以定义一次性作业，或设置重复的作业。对于重复任务，您可以定义开始和结束日期、运行次数和频率。您还可以使用 cron 语法来定义重复性。有关 cron 的更多信息，请参阅 Red Hat Enterprise Linux 7 系统管理员指南中的自动化系统 任务 部分。
10. 点 Submit。这将显示 Job Overview 页面，作业完成后也会显示作业的状态。

1. 查找您要使用的作业模板的 ID：

   # hammer job-template list

2. 显示模板详情以查看模板所需的参数：

   # hammer job-template info --id template_ID

3. 使用自定义参数执行远程作业：

   # hammer job-invocation create \
   --job-template "template_name" \
   --inputs key1="value",key2="value",... \
   --search-query "query"

   使用定义主机的过滤器表达式替换 query，如 "name ~ rex01 "。有关使用 hammer 执行远程命令的更多信息，请输入 hammer job-template --help 和 hammer job-invocation --help。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts，再选择您要在其上执行远程作业的目标主机。
2. 在 Ansible 选项卡中，选择 Jobs。
3. 点 Scheduleduplicate job。
4. 在 Create New Recurring Ansible Run 窗口中定义第一次运行的重复频率、开始时间和日期。
5. 点 Submit。
6. 可选：在主机概述中查看调度的 Ansible 作业，或者导航到 Ansible > Jobs。

流程

1. 在 Satellite Web UI 中，导航到 Configure > Host groups。
2. 在 Actions 列中，为您要为其调度 Ansible 角色运行的主机组选择 Configure Ansible Job。
3. 点 Scheduleduplicate job。
4. 在 Create New Recurring Ansible Run 窗口中定义第一次运行的重复频率、开始时间和日期。
5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Jobs。如果您使用 Execute now 设置触发作业，则会自动显示此页面。要监控调度的作业，请导航到 Monitor > Jobs 并选择您要检查的作业运行。
2. 在 Job 页面中，点 Hosts 选项卡。这将显示在其上运行作业的主机列表。
3. 在 Host 列中，点您要检查的主机的名称。这将显示 Commands 页面的详情，您可以在其中实时监控作业执行。
4. 随时点 Back to Job 以返回到 Job Details 页面。

1. 查找作业的 ID：

   # hammer job-invocation list

2. 监控作业输出：

   # hammer job-invocation output \
   --id job_ID \
   --host host_name

3. 可选： 要取消作业，请输入以下命令：

   # hammer job-invocation cancel \
   --id job_ID

流程

1. 要在 Satellite 服务器上启用插件，请输入以下命令：

   # satellite-installer --enable-foreman-plugin-templates

2. 要验证插件是否已正确安装，请确保 Administer > Settings 包含 TemplateSync 菜单。

流程

1. 使用 Satellite 安装程序禁用插件：

   # satellite-installer --no-enable-foreman-plugin-templates

2. 清理插件的自定义数据。该命令不会影响您创建的任何模板。

   # foreman-rake templates:cleanup

3. 卸载插件：

   # satellite-maintain packages remove foreman-plugin-templates

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts,
2. 选择主机名。
3. 单击 Content 选项卡。
4. 单击 Repository Sets 选项卡。
5. 点垂直 ellipsis。
6. 选择 Override to disabled 或 Override to enabled 来在主机上启用或禁用仓库。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 选择您要安装的软件包的主机。
3. 选择 Content 选项卡，然后选择 Packages 选项卡。
4. 单击页面顶部的垂直 ellipsis，然后选择 Install Packages。
5. 在 Install packages 弹出窗口中，选择您要在主机上安装的软件包。
6. 点 Install。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 选择 Content 选项卡，然后选择 Packages 选项卡。

4. 从 Status 框中选择 Upgradable 过滤器，以列出可升级的软件包。

   如果软件包有多个可用的升级版本，则只显示最新的可升级版本。

5. 单击 Upgrade。远程执行作业会立即启动。

   您还可以通过从下拉菜单中选择 Upgrade via custom remote execution 来自定义 远程执行。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 选择您要从中删除软件包的主机。
3. 选择 Content 选项卡，然后选择 Packages 选项卡。
4. 检查您要删除的软件包。
5. 从顶部的垂直 ellipsis 中，单击 Remove。