安装胶囊服务器

流程

1. 在卫星服务器上，若要为您的胶囊服务器存储所有源证书文件，创建一个只能被 root 用户访问的目录，如 / root /capsule_cert ：

   # mkdir /root/capsule_cert

2. 在 Satellite 服务器上，为您的 Capsule 服务器生成 /root/capsule_cert/prompt.example.com-certs.tar 证书存档：

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

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

   capsule-certs-generate输出示例

   output omitted
   satellite-installer --scenario capsule \
   --certs-tar-file "/root/capsule.example.com-certs.tar" \
   --foreman-proxy-register-in-foreman "true" \
   --foreman-proxy-foreman-base-url "https://satellite.example.com" \
   --foreman-proxy-trusted-hosts "satellite.example.com" \
   --foreman-proxy-trusted-hosts "capsule.example.com" \
   --foreman-proxy-oauth-consumer-key "s97QxvUAgFNAQZNGg4F9zLq2biDsxM7f" \
   --foreman-proxy-oauth-consumer-secret "6bpzAdMpRAfYaVZtaepYetomgBVQ6ehY" \
   --puppet-server-foreman-url "https://satellite.example.com"

3. 在卫星服务器上，将证书归档文件复制到您的胶囊服务器中：

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

4. 在胶囊服务器上，要部署证书，请输入 capsule-certs-generate 命令返回的 satellite-installer 命令。

   如果尚未打开到 Satellite 的网络连接或端口，您可以将 --foreman-proxy-register-in-foreman 选项设置为 false，以防止胶囊尝试连接到 Satellite 并报告错误。正确配置网络和防火墙时，通过此选项设置来再次运行安装程序。

   重要

   部署证书后，请勿删除证书存档文件。例如，在升级胶囊服务器时，需要它。

1. 第 2.7.2.1 节 “为胶囊服务器创建自定义 SSL 证书”
2. 第 2.7.2.2 节 “将自定义 SSL 证书部署到胶囊服务器”
3. 第 2.7.2.3 节 “将自定义 SSL 证书部署到主机”

流程

1. 在 Red Hat Enterprise Linux 服务器服务器中，安装 ISC DHCP Service 和 Berkeley Internet Name Domain (BIND)软件包：

   # yum install dhcp bind

2. 生成安全令牌：

   # dnssec-keygen -a HMAC-MD5 -b 512 -n HOST omapi_key

   因此，在当前目录中创建由两个文件组成的密钥对。

3. 从密钥复制 secret 哈希：

   # cat Komapi_key.+*.private |grep ^Key|cut -d ' ' -f2

4. 编辑所有子网的 dhcpd 配置文件并添加该密钥。以下是一个示例：

   # cat /etc/dhcp/dhcpd.conf
   default-lease-time 604800;
   max-lease-time 2592000;
   log-facility local7;
   
   subnet 192.168.38.0 netmask 255.255.255.0 {
   	range 192.168.38.10 192.168.38.100;
   	option routers 192.168.38.1;
   	option subnet-mask 255.255.255.0;
   	option domain-search "virtual.lan";
   	option domain-name "virtual.lan";
   	option domain-name-servers 8.8.8.8;
   }
   
   omapi-port 7911;
   key omapi_key {
   	algorithm HMAC-MD5;
   	secret "jNSE5YI3H1A8Oj/tkV4...A2ZOHb6zv315CkNAY7DMYYCj48Umw==";
   };
   omapi-key omapi_key;

   请注意，选项路由器 值是您要用于外部 DHCP 服务的卫星或胶囊 IP 地址。

5. 从在其中创建的目录中删除这两个密钥文件。

6. 在卫星服务器上，定义各个子网。暂时不要为定义的子网设置 DHCP 胶囊。

   要防止冲突，请单独设置租期和保留范围。例如，如果租期范围是 192.168.38.10 到 192.168.38.100，在卫星 Web UI 中将保留范围定义为 192.168.38.101 到 192.168.38.250。

7. 配置外部对 DHCP 服务器的防火墙：

   # firewall-cmd --add-service dhcp \
   && firewall-cmd --runtime-to-permanent

8. 在卫星服务器上，确定 foreman 用户的 UID 和 GID：

   # id -u foreman
   993
   # id -g foreman
   990

9. 在 DHCP 服务器上，使用与上一步中确定相同的 ID 创建 foreman 用户和组：

   # groupadd -g 990 foreman
   # useradd -u 993 -g 990 -s /sbin/nologin foreman

10. 为确保配置文件可以访问，请恢复读取和执行标志：

    # chmod o+rx /etc/dhcp/
    # chmod o+r /etc/dhcp/dhcpd.conf
    # chattr +i /etc/dhcp/ /etc/dhcp/dhcpd.conf

11. 启动 DHCP 服务：

    # systemctl start dhcpd

12. 使用 NFS 导出 DHCP 配置和租期文件：

    # yum install nfs-utils
    # systemctl enable rpcbind nfs-server
    # systemctl start rpcbind nfs-server nfs-lock nfs-idmapd

13. 为您要使用 NFS 导出的 DHCP 配置和租期文件创建目录：

    # mkdir -p /exports/var/lib/dhcpd /exports/etc/dhcp

14. 要为创建的目录创建挂载点，请在 /etc/fstab 文件中添加以下行：

    /var/lib/dhcpd /exports/var/lib/dhcpd none bind,auto 0 0
    /etc/dhcp /exports/etc/dhcp none bind,auto 0 0

15. 在 /etc/fstab 中挂载文件系统：

    # mount -a

16. 确保 /etc/exports 中存在以下行：

    /exports 192.168.38.1(rw,async,no_root_squash,fsid=0,no_subtree_check)
    
    /exports/etc/dhcp 192.168.38.1(ro,async,no_root_squash,no_subtree_check,nohide)
    
    /exports/var/lib/dhcpd 192.168.38.1(ro,async,no_root_squash,no_subtree_check,nohide)

    请注意，您输入的 IP 地址是卫星或胶囊 IP 地址，您要用于外部 DHCP 服务。

17. 重新载入 NFS 服务器：

    # exportfs -rva

18. 配置 DHCP omapi 端口 7911 的防火墙：

    # firewall-cmd --add-port="7911/tcp" \
    && firewall-cmd --runtime-to-permanent

19. 可选：配置对 NFS 外部访问的防火墙。客户端使用 NFSv3 配置。

    # firewall-cmd --zone public --add-service mountd \
    && firewall-cmd --zone public --add-service rpc-bind \
    && firewall-cmd --zone public --add-service nfs \
    && firewall-cmd --runtime-to-permanent

流程

1. 安装 nfs-utils 工具：

   # yum install nfs-utils

2. 为 NFS 创建 DHCP 目录：

   # mkdir -p /mnt/nfs/etc/dhcp /mnt/nfs/var/lib/dhcpd

3. 更改文件所有者：

   # chown -R foreman-proxy /mnt/nfs

4. 验证与 NFS 服务器和远程过程调用(RPC)通信路径的通信：

   # showmount -e DHCP_Server_FQDN
   # rpcinfo -p DHCP_Server_FQDN

5. 在 /etc/fstab 文件中添加以下几行：

   DHCP_Server_FQDN:/exports/etc/dhcp /mnt/nfs/etc/dhcp nfs
   ro,vers=3,auto,nosharecache,context="system_u:object_r:dhcp_etc_t:s0" 0 0
   
   DHCP_Server_FQDN:/exports/var/lib/dhcpd /mnt/nfs/var/lib/dhcpd nfs
   ro,vers=3,auto,nosharecache,context="system_u:object_r:dhcpd_state_t:s0" 0 0

6. 在 /etc/fstab 上挂载文件系统：

   # mount -a

7. 要验证 foreman-proxy 用户可以访问通过网络共享的文件，显示 DHCP 配置和租期文件：

   # su foreman-proxy -s /bin/bash
   bash-4.2$ cat /mnt/nfs/etc/dhcp/dhcpd.conf
   bash-4.2$ cat /mnt/nfs/var/lib/dhcpd/dhcpd.leases
   bash-4.2$ exit

8. 输入 satellite-installer 命令，对 /etc/foreman-proxy/settings.d/dhcp.yml 文件进行以下持久更改：

   # satellite-installer --foreman-proxy-dhcp=true \
   --foreman-proxy-dhcp-provider=remote_isc \
   --foreman-proxy-plugin-dhcp-remote-isc-dhcp-config /mnt/nfs/etc/dhcp/dhcpd.conf \
   --foreman-proxy-plugin-dhcp-remote-isc-dhcp-leases /mnt/nfs/var/lib/dhcpd/dhcpd.leases \
   --foreman-proxy-plugin-dhcp-remote-isc-key-name=omapi_key \
   --foreman-proxy-plugin-dhcp-remote-isc-key-secret=jNSE5YI3H1A8Oj/tkV4...A2ZOHb6zv315CkNAY7DMYYCj48Umw== \
   --foreman-proxy-plugin-dhcp-remote-isc-omapi-port=7911 \
   --enable-foreman-proxy-plugin-dhcp-remote-isc \
   --foreman-proxy-dhcp-server=DHCP_Server_FQDN

9. 重启 foreman-proxy 服务：

   # systemctl restart foreman-proxy

10. 登录卫星服务器 Web UI。
11. 导航到 Infrastructure > Capsules，找到胶囊服务器，然后从 Actions 列中的列表中，选择 Refresh。
12. 将 DHCP 服务与适当的子网和域关联。

在 IdM 服务器中创建 Kerberos 主体

1. 为从 IdM 管理员获取的帐户获取了一个 Kerberos ticket：

   # kinit idm_user

2. 为胶囊服务器创建新的 Kerberos 主体，以用于在 IdM 服务器中进行身份验证。

   # ipa service-add capsule.example.com

安装和配置 IdM 客户端

1. 在管理部署的 DNS 服务的 Satellite 或 Capsule 的基本操作系统上，安装 ipa-client 软件包：

   # satellite-maintain packages install ipa-client

2. 运行安装脚本并根据屏幕提示来配置 IdM 客户端：

   # ipa-client-install

3. 获取Kerberos ticket：

   # kinit admin

4. 删除任何预先存在的 keytab ：

   # rm /etc/foreman-proxy/dns.keytab

5. 获取此系统的 keytab:

   # ipa-getkeytab -p capsule/satellite.example.com@EXAMPLE.COM \
   -s idm1.example.com -k /etc/foreman-proxy/dns.keytab

   注意

   当在服务中使用与原始系统相同的主机名添加 keytab 系统时，添加 r 选项以防止生成新凭证并在原始系统中呈现凭证无效。

6. 对于 dns.keytab 文件，请将组和拥有者设置为 foreman-proxy ：

   # chown foreman-proxy:foreman-proxy /etc/foreman-proxy/dns.keytab

7. 可选： 要验证 keytab 文件是否有效，请输入以下命令：

   # kinit -kt /etc/foreman-proxy/dns.keytab \
   capsule/satellite.example.com@EXAMPLE.COM

在 IdM web UI 中配置 DNS 区域

1. 创建并配置您要管理的区域：

   1. 导航到 Network Services > DNS > DNS Zones。
   2. 选择 Add 并输入区名称。例如： example.com。
   3. 点 Add and Edit。

   4. 点 Settings 选项卡并在 BIND 更新策略 框中，将以下内容添加到分号分开的列表：

      grant capsule/047satellite.example.com@EXAMPLE.COM wildcard * ANY;

   5. 将 Dynamic update 设置为 True。
   6. 启用 允许 PTR 同步。
   7. 点 Save 保存更改。

2. 创建并配置反向区：

   1. 导航到 Network Services > DNS > DNS Zones。
   2. 点 Add。
   3. 选择 Reverse zone IP 网络，并以 CIDR 格式添加网络地址以启用反向查找。
   4. 点 Add and Edit。

   5. 点 Settings 选项卡并在 BIND 更新策略 框中，将以下内容添加到分号分开的列表：

      grant capsule\047satellite.example.com@EXAMPLE.COM wildcard * ANY;

   6. 将 Dynamic update 设置为 True。
   7. 点 Save 保存更改。

配置管理域的 DNS 服务的卫星或胶囊服务器

1. 使用 satellite-installer 命令配置管理域的 DNS 服务的 Satellite 或 Capsule：

   • 在 Satellite 上输入以下命令：

     satellite-installer --scenario satellite \
     --foreman-proxy-dns=true \
     --foreman-proxy-dns-managed=true \
     --foreman-proxy-dns-provider=nsupdate_gss \
     --foreman-proxy-dns-server="idm1.example.com" \
     --foreman-proxy-dns-tsig-principal="capsule/satellite.example.com@EXAMPLE.COM" \
     --foreman-proxy-dns-tsig-keytab=/etc/foreman-proxy/dns.keytab \
     --foreman-proxy-dns-reverse="55.168.192.in-addr.arpa" \
     --foreman-proxy-dns-zone=example.com \
     --foreman-proxy-dns-ttl=86400

   • 在 Capsule 上输入以下命令：

     satellite-installer --scenario capsule \
     --foreman-proxy-dns=true \
     --foreman-proxy-dns-managed=true \
     --foreman-proxy-dns-provider=nsupdate_gss \
     --foreman-proxy-dns-server="idm1.example.com" \
     --foreman-proxy-dns-tsig-principal="capsule/satellite.example.com@EXAMPLE.COM" \
     --foreman-proxy-dns-tsig-keytab=/etc/foreman-proxy/dns.keytab \
     --foreman-proxy-dns-reverse="55.168.192.in-addr.arpa" \
     --foreman-proxy-dns-zone=example.com \
     --foreman-proxy-dns-ttl=86400

2. 重启 Satellite 或 Capsule 的 Proxy 服务。

   # systemctl restart foreman-proxy

在卫星 Web UI 中更新配置

1. 导航到 Infrastructure > Capsules，找到胶囊服务器，然后从 Actions 列中的列表中，选择 Refresh。

2. 配置域：

   1. 导航到 Infrastructure > Domains 并选择域名。
   2. 在 Domain 选项卡中，确保将 DNS Capsule 设置为连接子网的胶囊。

3. 配置子网：

   1. 导航到 Infrastructure > Subnets 并选择子网名称。
   2. 在 子网 选项卡中，将 IPAM 设置为 None。
   3. 在 Domains 选项卡中，选择您要使用 IdM 服务器管理的域。
   4. 在 Capsules 选项卡中，确保 Reverse DNS Capsule 设置为连接子网的胶囊。
   5. 单击 Submit 以保存更改。

为 IdM 服务器中的 DNS 区启用外部更新

1. 在 IdM 服务器中，将以下内容添加到 /etc/named.conf 文件的顶部：

   ########################################################################
   
   include "/etc/rndc.key";
   controls  {
   inet _IdM_Server_IP_Address_ port 953 allow { _Satellite_IP_Address_; } keys { "rndc-key"; };
   };
   ########################################################################

2. 重新载入 命名的 服务以使更改生效：

   # systemctl reload named

3. 在 IdM web UI 中，进入 Network Services > DNS > DNS Zones 并点区的名称。在 Settings 选项卡中，应用以下更改：

   1. 在 BIND 更新策略 框中添加以下内容：

      grant "rndc-key" zonesub ANY;

   2. 将 Dynamic update 设置为 True。
   3. 点 Update 保存更改。

4. 将 /etc/rndc.key 文件从 IdM 服务器复制到 Satellite 服务器的基本操作系统。输入以下命令：

   # scp /etc/rndc.key root@satellite.example.com:/etc/rndc.key

5. 要为 rndc.key 文件设置正确的所有权、权限和 SELinux 上下文，请输入以下命令：

   # restorecon -v /etc/rndc.key
   # chown -v root:named /etc/rndc.key
   # chmod -v 640 /etc/rndc.key

6. 手动将 foreman-proxy 用户分配给 指定组。通常，satellite-installer 可确保 foreman-proxy 用户属于指定的 UNIX 组，但是在这种情况下，卫星不管理用户和组，因此您需要将 foreman-proxy 用户手动分配给指定组。

   # usermod -a -G named foreman-proxy

7. 在 Satellite 服务器中，输入以下 satellite-installer 命令，将 Satellite 配置为使用外部 DNS 服务器：

   # satellite-installer --scenario satellite \
   --foreman-proxy-dns=true \
   --foreman-proxy-dns-managed=false \
   --foreman-proxy-dns-provider=nsupdate \
   --foreman-proxy-dns-server="IdM_Server_IP_Address" \
   --foreman-proxy-keyfile=/etc/rndc.key \
   --foreman-proxy-dns-ttl=86400

在 IdM 服务器中测试到 DNS 区的外部更新

1. 确保 Satellite Server 中的 /etc/rndc.key 文件中的键是 IdM 服务器中使用的相同密钥文件：

   key "rndc-key" {
           algorithm hmac-md5;
           secret "secret-key==";
   };

2. 在卫星服务器上，为主机创建测试 DNS 条目。例如，在位于 192.168.25.1 的 IdM 服务器上的 A 记录为 192.168.25.20 的主机 test.example.com。

   # echo -e "server 192.168.25.1\n \
   update add test.example.com 3600 IN A 192.168.25.20\n \
   send\n" | nsupdate -k /etc/rndc.key

3. 在 Satellite 服务器中测试 DNS 条目：

   # nslookup test.example.com 192.168.25.1
   Server:		192.168.25.1
   Address:	192.168.25.1#53
   
   Name:	test.example.com
   Address: 192.168.25.20

4. 要在 IdM web UI 中查看条目，请导航至 Network Services > DNS > DNS Zones。单击区域的名称，再按名称搜索主机。

5. 如果成功解决，请删除测试 DNS 条目：

   # echo -e "server 192.168.25.1\n \
   update delete test.example.com 3600 IN A 192.168.25.20\n \
   send\n" | nsupdate -k /etc/rndc.key

6. 确认删除了 DNS 条目：

   # nslookup test.example.com 192.168.25.1

   以上 nslookup 命令会失败，并在成功删除记录时返回 SERVFAIL 错误消息。

在卫星 Web UI 中更新配置

1. 导航到 Infrastructure > Capsules。
2. 对于您要更新的每个胶囊，请从 Actions 列表中选择 Refresh。

3. 配置域：

   1. 进入 Infrastructure > Domains 并点您要配置的域名。
   2. 在 Domain 选项卡中，将 DNS Capsule 设置为连接子网的胶囊。

4. 配置子网：

   1. 导航到 Infrastructure > Subnets 并选择子网名称。
   2. 在 Subnet 选项卡中，将 IPAM 设置为 DHCP 或内部数据库。
   3. 在 Domains 选项卡中，选择您要使用卫星或胶囊管理的域。
   4. 在 Capsules 选项卡中，将 Reverse DNS Capsule 设置为连接子网的胶囊。
   5. 单击 Submit 以保存更改。