管理主机

流程

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 选项卡中，单击 Associate VMs 来关联所有虚拟机，或者从 Actions 菜单中选择关联虚拟机以关联单个虚拟机。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 在 Overview 选项卡中，点 System purpose 卡上的 Edit。
4. 为您的主机选择系统目的属性。
5. 点击 Save。

CLI 过程

1. 登录主机并编辑所需的系统目的属性。例如，将 usage 类型设置为 Production，将角色设置为 Red Hat Enterprise Linux Server。有关值列表，请参阅 自动安装 RHEL 8 中的 使用 subscription-manager 命令行工具配置系统目的。

   # subscription-manager syspurpose set usage 'Production'
   # subscription-manager syspurpose set role 'Red Hat Enterprise Linux Server'

   Copy to Clipboard Toggle word wrap

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

   # subscription-manager syspurpose

   Copy to Clipboard Toggle word wrap

流程

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

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

   • 设置所有选择的主机的特定属性。
   • 没有更改 在所选主机上保留属性。
   • none (Clear) 清除所选主机上的属性。
4. 单击 分配。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 单击 Content 选项卡，然后单击 Module streams 选项卡。
4. 点模块旁边的垂直 ellipsis，然后选择您要执行的操作。远程执行作业完成后，您会收到 REX 作业通知。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts 并选择主机。
2. 选择 Content 选项卡，然后选择 Repository sets。
3. 从下拉菜单中，您可以将 Repository type 列过滤到 Custom。
4. 选中所需的存储库数量，或者单击 Select All 复选框来选择所有存储库，然后单击垂直 ellipsis，然后选择 Override to Enabled。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 单击 Edit 按钮旁边的垂直 ellipsis 图标，再选择 Change content source。
4. 从列表中选择 Content Source,Lifecycle Content View, 和 Content Source。

5. 点更改内容源。

   注意

   如果一些生命周期环境没有在所选内容源上同步，则它们无法进行选择。如需更多信息，请参阅管理内容中的将生命周期环境添加到 胶囊服务器 。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 在 Content view 环境 卡中，点选项图标并选择 Edit content view environments。
4. 选择环境。
5. 选择内容视图。
6. 点击 Save。

流程

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. 在 Traces 选项卡上，单击 Enable Traces。
4. 从列表中选择要安装 katello-host-tools-tracer 的供应商。
5. 单击 Enable Tracer。在远程执行作业完成后，您会收到 REX 作业通知。
6. 如果您获取需要重启的应用程序列表，请选择您要重启的应用程序。

7. 点 Restart app，然后点以下按钮之一：

   • 通过远程执行重启

   • 通过自定义远程执行重启

     第一个选项会立即重新启动应用，而第二个选项则允许您检查和自定义 REX 作业。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 选择 Traces 选项卡。
4. 选择您要重启的应用程序。
5. 从 Restart app 列表中选择 Restart via remote execution。远程执行作业完成后，您将收到 REX 作业通知。

流程

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

4. 在 Select Organization 列表中，选择要为其分配主机的组织。选中 Fix Organization on Mismatch 的复选框。

   注意

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

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 可将这样的资源添加到位置，因此推荐的选择。Fail on Mismatch 选项始终会产生错误消息。例如，将主机从一个位置重新分配给另一个位置将失败，即使设置中没有实际不匹配。

5. 点 Submit。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > Content Hosts
2. 点击您要查看的内容主机。
3. 选择 Details 选项卡查看主机详情页面。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 单击 Manage columns。

3. 选择您要显示的列。您可以选择单独的列或列类别。选择或取消选择类别选择或取消选择该类别中的所有列。

   注意

   有些列包含多个类别，但您只能显示特定类型的列。通过选择或取消选择特定列，您可以选择或取消选择该列的所有实例。

流程

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

流程

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

6. 点附加标签页，将您要属性的任何详情添加到主机组中。

   注意

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

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

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

   Copy to Clipboard Toggle word wrap
7. 单击 Submit 以保存主机组。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 点 Edit。
4. 从 Host Group 列表中选择主机组。
5. 点 Submit。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 点 Edit。
4. 从 Host Group 列表中选择新的主机组。
5. 点 Submit。

1. 手动创建目录：

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

   Copy to Clipboard Toggle word wrap
2. 在 Satellite Web UI 中，进入到 Configure > Puppet ENC > Environments。
3. 单击 Import environment from。
4. 选择您的 Capsule。
5. 选择创建的目录，然后单击 Update。

流程

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

2. 下载脚本：

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

   Copy to Clipboard Toggle word wrap

3. 使脚本可执行：

   # chmod +x bootstrap.py

   Copy to Clipboard Toggle word wrap

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

   • 在 Red Hat Enterprise Linux 8 中：

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

     Copy to Clipboard Toggle word wrap

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

     # ./bootstrap.py -h

     Copy to Clipboard Toggle word wrap

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

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

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

     # /usr/libexec/platform-python bootstrap.py \
     --login=admin \
     --server satellite.example.com \
     --location="My_Location" \
     --organization="My_Organization" \
     --hostgroup="My_Host_Group" \
     --activationkey="My_Activation_Key"

     Copy to Clipboard Toggle word wrap

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

     # ./bootstrap.py --login=admin \
     --server satellite.example.com \
     --location="My_Location" \
     --organization="My_Organization" \
     --hostgroup="My_Host_Group" \
     --activationkey="My_Activation_Key"

     Copy to Clipboard Toggle word wrap

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

    Copy to Clipboard Toggle word wrap

流程

1. 在 Satellite Web UI 中，进入到 Configure > Global Parameters 以全局添加主机参数。或者，您可以进入到 Configure > Host Groups 并编辑或创建主机组，来仅将主机参数添加到主机组中。

2. 使用全局参数或主机组中的 host 参数启用 Puppet 代理。

   添加名为 enable-puppet7 的主机参数，选择 boolean 类型，然后将值设为 true。

3. 在全局参数或主机组中使用以下主机参数为 Puppet 代理指定配置：

   • 添加名为 puppet_server 的主机参数，选择字符串类型，并将值设为 Puppet 服务器的主机名，如 puppet.example.com。
   • 可选：添加名为 puppet_ca_server 的主机参数，选择字符串类型，并将值设为 Puppet CA 服务器的主机名，如 puppet-ca.example.com。如果没有设置 puppet_ca_server，则 Puppet 代理将使用与 puppet_server 相同的服务器。
   • 可选：添加名为 puppet_environment 的主机参数，选择字符串类型，并将值设置为您希望主机使用的 Puppet 环境。

   在 BZ2177730 被解决前，您需要使用 host 参数来指定 Puppet 代理配置，即使 Puppet 服务器是 Capsule 服务器。

4. 进入到 Hosts > Register Host，并使用适当的激活码注册您的主机。如需更多信息，请参阅 管理主机 中的 使用全局注册注册主机。
5. 进入到 Infrastructure > Capsules。
6. 从所需胶囊服务器的 Actions 列中的列表中，选择 Certificates。
7. 单击所需主机右侧的 Sign to，为 Puppet 代理签署 SSL 证书。

流程

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

2. 安装 Puppet 代理软件包。

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

     # dnf install puppet-agent

     Copy to Clipboard Toggle word wrap

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

     # yum install puppet-agent

     Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

5. 启动 Puppet 代理服务：

   # puppet resource service puppet ensure=running enable=true

   Copy to Clipboard Toggle word wrap

6. 为主机创建证书：

   # puppet ssl bootstrap

   Copy to Clipboard Toggle word wrap
7. 在 Satellite Web UI 中，进入到 Infrastructure > Capsules。
8. 从所需胶囊服务器的 Actions 列中的列表中，选择 Certificates。
9. 单击所需主机右侧的 Sign to，为 Puppet 代理签署 SSL 证书。

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

    # puppet ssl bootstrap

    Copy to Clipboard Toggle word wrap

流程

1. 使用 Ansible 角色创建主机组。如需更多信息，请参阅 第 3.3 节 “创建主机组”。
2. 使用主机组和分配的 Ansible 角色注册主机。如需更多信息，请参阅 第 4.3.3 节 “注册主机”。

流程

1. 进入 Add Interface 表单：

   1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
   2. 点击您要编辑的主机旁边的 Edit。
   3. 在 Interfaces 选项卡中，点 Add Interface。

2. 指定常规接口设置：

   1. 指定 MAC 地址。需要此设置。
   2. 指定 设备标识符，如 eth0。

3. 配置网络和 DNS 设置：

   1. 指定与主机的 IP 地址关联的 DNS 名称。
   2. 从 Domain 列表中选择一个域。
   3. 在 IPv4 Subnet 或 IPv6 Subnet 列表中选择一个子网。

   4. 指定 IPv4 地址或 IPv6 地址。

      注意

      带有分配的 DHCP 胶囊服务器的受管接口需要此设置来创建 DHCP 租期。启用 DHCP 的受管接口由推荐的 IP 地址自动提供。

4. 指定接口管理选项：

   1. 选择接口是 Managed。
   2. 选择这是否 为主机 的主接口。
   3. 选择这是否是主机的 Provision 接口。
   4. 选择是否将接口用于远程执行。
5. 单击 OK 以保存接口配置。
6. 点 Submit 将更改应用到主机。

流程

1. 进入 Add Interface 表单：

   1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
   2. 点击您要编辑的主机旁边的 Edit。
   3. 在 Interfaces 选项卡中，点 Add Interface。

2. 指定常规接口设置：

   1. 如果管理虚拟接口，请指定 MAC 地址。

   2. 在 Device Identifier 字段中指定 ID。

      • 对于 VLAN，请使用 eth1.10 格式。
      • 对于别名，请使用 eth1:10 格式。

3. 配置虚拟 NIC：

   1. 选中 Virtual NIC 复选框。
   2. （可选）指定 VLAN 标签。
   3. 指定虚拟接口附加到 的物理接口标识符，如 eth1。需要此设置。
4. 单击 OK 以保存接口配置。
5. 点 Submit 将更改应用到主机。

流程

1. 进入 Add Interface 表单：

   1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
   2. 点击您要编辑的主机旁边的 Edit。
   3. 在 Interfaces 选项卡中，点 Add Interface。
2. 从 Type 列表中选择 Bond。

3. 指定常规接口设置：

   1. 在 Device Identifier 字段中，以 bond0 格式指定接口 ID。
   2. 指定 MAC 地址。
   3. 如果要配置二级接口，请选择 Managed。否则，Satellite 不会应用配置。

4. 添加特定于绑定接口的配置：

   1. 模式 ：选择绑定模式。
   2. attached devices: 指定以逗号分隔的附加设备的标识符列表。这些可以是物理接口或 VLAN。
   3. 绑定选项 ：指定一个以空格分隔的配置选项列表，如 miimon=100。
5. 单击 OK 以保存接口配置。
6. 点 Submit 将更改应用到主机。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点击您要编辑的主机旁边的 Edit。
3. 在 Interfaces 选项卡中，点 Add Interface。
4. 从 Type 列表中选择 Bridge。
5. 指定 MAC 地址。
6. 在 Device Identifier 字段中，以 bridge0 格式指定接口 ID。
7. 如果要配置二级接口，请选择 Managed。
8. 在 Attached devices 字段中，指定附加设备的以逗号分隔的标识符列表。可以是物理或者虚拟以太网设备、绑定或 VLAN 设备。
9. 单击 OK 以保存接口配置。
10. 点 Submit 将更改应用到主机。

流程

1. 在 Capsule 上启用 BMC 电源管理：

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

   Copy to Clipboard Toggle word wrap
2. 在 Satellite Web UI 中，进入到 Infrastructure > Subnets。
3. 选择主机的子网。
4. 在 Capsules 选项卡中，选择您的 Capsule 作为 BMC Capsule。
5. 点 Submit。

6. 进入 Add Interface 表单：

   1. 导航到 Hosts > All Hosts。
   2. 点击您要编辑的主机旁边的 Edit。
   3. 在 Interfaces 选项卡中，点 Add Interface。
7. 从 Type 列表中选择 BMC。

8. 指定常规接口设置：

   1. 如果管理 BMC，请指定 MAC 地址。
   2. 指定 设备标识符。

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

   1. Username and Password ：指定 BMC 所需的任何身份验证凭证。
   2. Provider: 指定 BMC 供应商。
10. 单击 OK 以保存接口配置。
11. 点 Submit 将更改应用到主机。

流程

1. 在 Satellite Web UI 中，进入到 Monitor > Jobs。
2. 点 Run Job。
3. 从 Job category 列表中，选择 Commands。
4. 从 Job template 列表中，选择 Download and run a script。
5. 点 Next。
6. 选择您要在其上执行作业的主机。

7. 在 url 字段中输入以下 URL：

   https://satellite.example.com/unattended/public/foreman_ca_refresh

   Copy to Clipboard Toggle word wrap

   将 satellite.example.com 替换为您的 Satellite 服务器的 FQDN。

   当 CA 证书过期时，您可以使用 HTTP。

8. 可选：点 Next 和 configure advanced 字段和调度。
9. 单击 Run on selected hosts。

流程

1. 在 Satellite Web UI 中，进入到 Monitor > Jobs。
2. 点 Run Job。
3. 从 Job category 列表中，选择 Ansible Commands。
4. 从 Job template 列表中，选择 Download and execute a script。
5. 点 Next。
6. 选择您要在其上执行作业的主机。

7. 在 url 字段中输入以下 URL：

   https://satellite.example.com/unattended/public/foreman_ca_refresh

   Copy to Clipboard Toggle word wrap

   将 satellite.example.com 替换为您的 Satellite 服务器的 FQDN。

   当 CA 证书过期时，您可以使用 HTTP。

8. 可选：点 Next 和 configure advanced 字段和调度。
9. 单击 Run on selected hosts。

流程

1. 在您的 Satellite 服务器中下载证书：

   # curl -o "satellite_ca_cert.crt" https://satellite.example.com/unattended/public/foreman_raw_ca

   Copy to Clipboard Toggle word wrap

   将 satellite.example.com 替换为您的 Satellite 服务器的 FQDN。

2. 安全地将 CA 证书传输到您的主机，例如使用 scp。
3. 使用 SSH 登录您的主机。

4. 将证书复制到 Subscription Manager 配置目录中：

   # cp -u satellite_ca_cert.crt /etc/rhsm/ca/katello-server-ca.pem

   Copy to Clipboard Toggle word wrap

5. 将证书复制到信任存储中：

   # cp satellite_ca_cert.crt /etc/pki/ca-trust/source/anchors

   Copy to Clipboard Toggle word wrap

6. 更新信任存储：

   # update-ca-trust

   Copy to Clipboard Toggle word wrap

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts，再选择您要使用 RHEL web 控制台管理和监控的主机。
2. 在主机窗口的右上角，单击垂直 ellipsis，然后选择 Web Console。

流程

1. 在 Satellite Web UI 中，进入到 Host > All Hosts。
2. 选择您要更改值的任何主机。
3. 在 Parameters 选项卡中，点 host_registration_insights 的编辑按钮。
4. 将值设为 False。

流程

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

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

   对于现有主机，请参阅使用 Ansible 集成管理配置中的 使用 Ansible 角色在客户端上自动化重复的任务。

2. 要在主机上运行 RedHatInsights.insights-client 角色，请导航到 Hosts > All Hosts，然后点击您要使用的主机的名称。
3. 在主机详细信息页面上，展开 Schedule a job 下拉菜单。
4. 单击 Run Ansible roles。

流程

1. 在 Satellite Web UI 中，进入到 Insights > Inventory Upload。
2. 启用自动不匹配删除 设置。

流程

1. 在 Satellite Web UI 中，进入到 Insights > Recommendations。

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

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

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

1. 在 Satellite Web UI 中，进入到 Hosts &gt ; All Hosts。
2. 选择主机。
3. 在 Host details 页面中，单击 Recommendations。
4. 在 Red Hat Insights 页面中，选择您要包含在 Insights 计划中的建议数量，然后继续。

流程

1. 在 Satellite Web UI 中，进入到 Monitor > Reports > Report Templates。例如，Host - Installed Products 模板会生成带有已安装产品信息的报告，以及其他指标，包括系统目的属性。
2. 在您要使用的报告模板右侧，单击 Generate。
3. 可选： 要调度报告，在 Generate at 字段右侧，点图标选择要生成报告的日期和时间。
4. 可选： 要向电子邮件地址发送报告，请通过电子邮件 复选框选择发送报告，然后在 传输至电子邮件地址 字段中，输入所需的电子邮件地址。
5. 可选：应用搜索查询过滤器。要查看所有可用结果，请不要使用任何值填充 filter 字段。
6. 点 Submit。包含报告的 CSV 文件会被下载。如果您选择了 通过电子邮件发送报告 复选框，则主机监控报告将发送到您的电子邮件地址。

CLI 过程

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

   $ hammer report-template list

   Copy to Clipboard Toggle word wrap

2. 生成一个报告：

   $ hammer report-template generate --id My_Template_ID

   Copy to Clipboard Toggle word wrap

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

   注意

   如果要生成 订阅 - 常规 报告，则必须使用 now 选项中的日期 来指定常规订阅的最新过期时间。

   显示所有订阅

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

   Copy to Clipboard Toggle word wrap

   显示将在 60 天内过期的所有订阅

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

   Copy to Clipboard Toggle word wrap

流程

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

流程

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

CLI 过程

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

   $ hammer report-template list

   Copy to Clipboard Toggle word wrap

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

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

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

   Copy to Clipboard Toggle word wrap

流程

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

   请求示例：

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

   Copy to Clipboard Toggle word wrap

   在本例中，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
           }
       ]
   }

   Copy to Clipboard Toggle word wrap

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

   Copy to Clipboard Toggle word wrap

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

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

流程

1. 在 Satellite Web UI 中，进入到 Monitor > Reports > 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
   "
   }

   Copy to Clipboard Toggle word wrap

   带有 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 FQDN': host.name
         )
   -%>
   <%  end -%>
   <%= report_render %>
   "
   }

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

流程

1. 在 Satellite Web UI 中，进入到 Monitor > Reports > Report Templates。
2. 在 Host - All Installed Packages 右侧，单击 Generate。
3. 可选： 使用 Hosts filter search 字段搜索并应用特定主机过滤器。
4. 点 Generate。
5. 如果下载没有自动启动，请单击 Download。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > Host Collections。
2. 单击新建主机集合。
3. 添加 主机集合的名称。
4. 清除 Unlimited 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. 在 Select Action 下，单击 Remove。
4. 点 Delete 删除主机集合。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 点您要修改的主机的名称。
3. 在 Host collections 卡中，单击垂直 ellipsis，再选择 Add host to collections。
4. 选择主机集合。
5. 点 Add。

流程

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。