Chapter 4. Configuring Capsule Servers for Load Balancing

Procedure

1. On Capsule Server, create a directory to contain all the source certificate files, accessible to only the root user:

   # mkdir /root/capsule_cert
   # cd /root/capsule_cert

   Copy to Clipboard Toggle word wrap

2. Create a private key with which to sign the Certificate Signing Request (CSR).

   Note that the private key must be unencrypted. If you use a password-protected private key, remove the private key password.

   If you already have a private key for this Capsule Server, skip this step.

   # openssl genrsa -out /root/capsule_cert/capsule_cert_key.pem 4096

   Copy to Clipboard Toggle word wrap

3. Create the certificate request configuration file with the following content:

   [ req ]
   default_bits       = 4096
   distinguished_name = req_distinguished_name
   req_extensions     = req_ext
   prompt = no
   
   [ req_distinguished_name ]
   countryName=2 Letter Country Code
   stateOrProvinceName=State or Province Full Name
   localityName=Locality Name
   0.organizationName=Organization Name
   organizationalUnitName=Capsule Organization Unit Name
   commonName=capsule.example.com  

   1

   
   emailAddress=Email Address
   
   [ req_ext ]
   #authorityKeyIdentifier=keyid,issuer
   #basicConstraints=CA:FALSE
   keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
   subjectAltName = @alt_names
   
   [alt_names]                  

   2

   
   DNS.1 = loadbalancer.example.com
   DNS.2 = capsule.example.com

   Copy to Clipboard Toggle word wrap

   1

   The certificate’s common name must match the FQDN of Capsule Server. Ensure to change this when running the command on each Capsule Server that you configure for load balancing. You can also set a wildcard value *. If you set a wildcard value, you must add the -t capsule option when you use the katello-certs-check command.

   2

   Under [alt_names], include the FQDN of the load balancer as DNS.1 and the FQDN of Capsule Server as DNS.2.

4. Create a Certificate Signing Request (CSR) for the SAN certificate.

   # openssl req -new \
   -key /root/capsule_cert/capsule_cert_key.pem \ 

   1

   
   -config SAN_config.cfg \                   

   2

   
   -out /root/capsule_cert/capsule_cert_csr.pem   

   3

   Copy to Clipboard Toggle word wrap

   1

   Capsule Server’s private key, used to sign the certificate

   2

   The certificate request configuration file

   3

   Certificate Signing Request file

5. Send the certificate request to the Certificate Authority:

   When you submit the request, specify the lifespan of the certificate. The method for sending the certificate request varies, so consult the Certificate Authority for the preferred method. In response to the request, you can expect to receive a Certificate Authority bundle and a signed certificate, in separate files.

6. Copy the Certificate Authority bundle and Capsule Server certificate file that you receive from the Certificate Authority, and the Capsule Server private key to your Satellite Server.

7. On Satellite Server, validate the Capsule Server certificate input files:

   # katello-certs-check \
   -c /root/capsule_cert/capsule_cert.pem \      

   1

   
   -k /root/capsule_cert/capsule_cert_key.pem \  

   2

   
   -b /root/capsule_cert/ca_cert_bundle.pem      

   3

   Copy to Clipboard Toggle word wrap

   1

   Capsule Server certificate file, provided by your Certificate Authority

   2

   Capsule Server’s private key that you used to sign the certificate

   3

   Certificate Authority bundle, provided by your Certificate Authority

   If you set the commonName= to a wildcard value *, you must add the -t capsule option to the katello-certs-check command.

   Retain a copy of the example capsule-certs-generate command that is output by the katello-certs-check command for creating the Certificate Archive File for this Capsule Server.

Procedure

1. Append the following option to the capsule-certs-generate command that you obtain from the output of the katello-certs-check command:

   --foreman-proxy-cname loadbalancer.example.com

   Copy to Clipboard Toggle word wrap

2. On Satellite Server, enter the capsule-certs-generate command to generate Capsule certificates. For example:

   # capsule-certs-generate \
   --foreman-proxy-fqdn capsule.example.com \
   --certs-tar /root/capsule_cert/capsule.tar \
   --server-cert /root/capsule_cert/capsule.pem \
   --server-key /root/capsule_cert/capsule.pem \
   --server-ca-cert /root/capsule_cert/ca_cert_bundle.pem \
   --foreman-proxy-cname loadbalancer.example.com

   Copy to Clipboard Toggle word wrap

   Retain a copy of the example satellite-installer command from the output for installing the Capsule Server certificates.

3. Copy the certificate archive file from Satellite Server to Capsule Server:

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

   Copy to Clipboard Toggle word wrap

4. Append the following options to the satellite-installer command that you obtain from the output of the capsule-certs-generate command. Set the --puppet-ca-server option to point to the Capsule Server where you enter the command. You must install Puppet CA on your Capsule Servers, regardless of whether you intend to use it or not. Puppet is configured in its default single-node configuration.

   --certs-cname                              "loadbalancer.example.com" \
   --puppet-dns-alt-names                     "loadbalancer.example.com" \
   --puppet-ca-server                         "capsule.example.com" \
   --foreman-proxy-puppetca                   "true" \
   --puppet-server-ca                         "true" \
   --enable-foreman-proxy-plugin-remote-execution-ssh

   Copy to Clipboard Toggle word wrap

5. On Capsule Server, enter the satellite-installer command, for example:

   # satellite-installer --scenario capsule \
   --foreman-proxy-content-parent-fqdn        "satellite.example.com" \
   --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         "oauth key" \
   --foreman-proxy-oauth-consumer-secret      "oauth secret" \
   --certs-tar-file                           "capsule.example.com-certs.tar" \
   --puppet-server-foreman-url                "https://satellite.example.com" \
   --certs-cname                              "loadbalancer.example.com" \
   --puppet-dns-alt-names                     "loadbalancer.example.com" \
   --puppet-ca-server                         "capsule.example.com" \
   --foreman-proxy-puppetca                   "true" \
   --puppet-server-ca                         "true" \
   --enable-foreman-proxy-plugin-remote-execution-ssh

   Copy to Clipboard Toggle word wrap

Procedure

1. On Capsule Server, create a directory to contain all the source certificate files, accessible to only the root user:

   # mkdir /root/capsule_cert
   # cd /root/capsule_cert

   Copy to Clipboard Toggle word wrap

2. Create a private key with which to sign the Certificate Signing Request (CSR).

   Note that the private key must be unencrypted. If you use a password-protected private key, remove the private key password.

   If you already have a private key for this Capsule Server, skip this step.

   # openssl genrsa -out /root/capsule_cert/capsule.pem 4096

   Copy to Clipboard Toggle word wrap

3. Create the certificate request configuration file with the following content:

   [ req ]
   default_bits       = 4096
   distinguished_name = req_distinguished_name
   req_extensions     = req_ext
   prompt = no
   
   [ req_distinguished_name ]
   countryName=2 Letter Country Code
   stateOrProvinceName=State or Province Full Name
   localityName=Locality Name
   0.organizationName=Organization Name
   organizationalUnitName=Capsule Organization Unit Name
   commonName=capsule.example.com  

   1

   
   emailAddress=Email Address
   
   [ req_ext ]
   #authorityKeyIdentifier=keyid,issuer
   #basicConstraints=CA:FALSE
   keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
   subjectAltName = @alt_names
   
   [alt_names]                  

   2

   
   DNS.1 = loadbalancer.example.com
   DNS.2 = capsule.example.com

   Copy to Clipboard Toggle word wrap

   1

   The certificate’s common name must match the FQDN of Capsule Server. Ensure to change this when running the command on each Capsule Server. You can also set a wildcard value *. If you set a wildcard value, you must add the -t capsule option when you use the katello-certs-check command.

   2

   Under [alt_names], include the FQDN of the load balancer as DNS.1 and the FQDN of Capsule Server as DNS.2.

4. Create a Certificate Signing Request (CSR) for the SAN certificate:

   # openssl req -new \
   -key /root/capsule_cert/capsule.pem \ 

   1

   
   -config SAN_config.cfg \          

   2

   
   -out /root/capsule_cert/capsule.pem   

   3

   Copy to Clipboard Toggle word wrap

   1

   Capsule Server’s private key, used to sign the certificate

   2

   The certificate request configuration file

   3

   Certificate Signing Request file

5. Send the certificate request to the Certificate Authority:

   When you submit the request, specify the lifespan of the certificate. The method for sending the certificate request varies, so consult the Certificate Authority for the preferred method. In response to the request, you can expect to receive a Certificate Authority bundle and a signed certificate, in separate files.

6. Copy the Certificate Authority bundle and Capsule Server certificate file that you receive from the Certificate Authority, and the Capsule Server private key to your Satellite Server to validate them.

7. On Satellite Server, validate the Capsule Server certificate input files:

   # katello-certs-check \
   -c /root/capsule_cert/capsule.pem \      

   1

   
   -k /root/capsule_cert/capsule.pem \      

   2

   
   -b /root/capsule_cert/ca_cert_bundle.pem 

   3

   Copy to Clipboard Toggle word wrap

   1

   Capsule Server certificate file, provided by your Certificate Authority

   2

   Capsule Server’s private key that you used to sign the certificate

   3

   Certificate Authority bundle, provided by your Certificate Authority

   If you set the commonName= to a wildcard value *, you must add the -t capsule option to the katello-certs-check command.

   Retain a copy of the example capsule-certs-generate command that is output by the katello-certs-check command for creating the Certificate Archive File for this Capsule Server.

1. Configuring Capsule Server to Generate and Sign Puppet Certificates
2. Configuring Remaining Capsule Servers for Load Balancing

1. Append the following option to the capsule-certs-generate command that you obtain from the output of the katello-certs-check command:

   --foreman-proxy-cname loadbalancer.example.com

   Copy to Clipboard Toggle word wrap

2. On Satellite Server, enter the capsule-certs-generate command to generate Capsule certificates. For example:

   # capsule-certs-generate \
   --foreman-proxy-fqdn capsule-ca.example.com \
   --certs-tar /root/capsule_cert/capsule-ca.tar \
   --server-cert /root/capsule_cert/capsule-ca.pem \
   --server-key /root/capsule_cert/capsule-ca.pem \
   --server-ca-cert /root/capsule_cert/ca_cert_bundle.pem \
   --foreman-proxy-cname loadbalancer.example.com

   Copy to Clipboard Toggle word wrap

   Retain a copy of the example satellite-installer command from the output for installing the Capsule Server certificates.

3. Copy the certificate archive file from Satellite Server to Capsule Server.

4. Append the following options to the satellite-installer command that you obtain from the output of the capsule-certs-generate command:

   --puppet-dns-alt-names                     "loadbalancer.example.com" \
   --puppet-ca-server                         "capsule-ca.example.com" \
   --foreman-proxy-puppetca                   "true" \
   --puppet-server-ca                         "true" \
   --enable-foreman-proxy-plugin-remote-execution-ssh

   Copy to Clipboard Toggle word wrap

5. On Capsule Server, enter the satellite-installer command, for example:

   satellite-installer --scenario capsule \
   --foreman-proxy-content-parent-fqdn        "satellite.example.com" \
   --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-ca.example.com" \
   --foreman-proxy-oauth-consumer-key         "oauth key" \
   --foreman-proxy-oauth-consumer-secret      "oauth secret" \
   --certs-tar-file                           "certs.tgz" \
   --puppet-server-foreman-url                "https://satellite.example.com" \
   --certs-cname                              "loadbalancer.example.com" \
   --puppet-dns-alt-names                     "loadbalancer.example.com" \
   --puppet-ca-server                         "capsule-ca.example.com" \
   --foreman-proxy-puppetca                   "true" \
   --puppet-server-ca                         "true" \
   --enable-foreman-proxy-plugin-remote-execution-ssh

   Copy to Clipboard Toggle word wrap

6. On Capsule Server, generate Puppet certificates for all other Capsules that you configure for load balancing, except this first system where you configure Puppet certificates signing:

   # puppet cert generate capsule.example.com \
   --dns_alt_names=loadbalancer.example.com

   Copy to Clipboard Toggle word wrap

   This command creates the following files on the Puppet certificate signing Capsule Server instance:

   • /etc/puppetlabs/puppet/ssl/certs/ca.pem
   • /etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem
   • /etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem
   • /etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem

1. Append the following option to the capsule-certs-generate command that you obtain from the output of the katello-certs-check command:

   --foreman-proxy-cname loadbalancer.example.com

   Copy to Clipboard Toggle word wrap

2. On Satellite Server, enter the capsule-certs-generate command to generate Capsule certificates. For example:

   # capsule-certs-generate \
   --foreman-proxy-fqdn capsule.example.com \
   --certs-tar /root/capsule_cert/capsule.tar \
   --server-cert /root/capsule_cert/capsule.pem \
   --server-key /root/capsule_cert/capsule.pem \
   --server-ca-cert /root/capsule_cert/ca_cert_bundle.pem \
   --foreman-proxy-cname loadbalancer.example.com

   Copy to Clipboard Toggle word wrap

   Retain a copy of the example satellite-installer command from the output for installing the Capsule Server certificates.

3. Copy the certificate archive file from Satellite Server to Capsule Server.

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

   Copy to Clipboard Toggle word wrap

4. On Capsule Server, install the puppetserver package:

   # satellite-maintain packages install puppetserver

   Copy to Clipboard Toggle word wrap

5. On Capsule Server, create directories for puppet certificates:

   # mkdir -p /etc/puppetlabs/puppet/ssl/certs/ \
   /etc/puppetlabs/puppet/ssl/private_keys/ \
   /etc/puppetlabs/puppet/ssl/public_keys/

   Copy to Clipboard Toggle word wrap

6. On Capsule Server, copy the Puppet certificates for this Capsule Server from the system where you configure Capsule Server to sign Puppet certificates:

   # scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/certs/ca.pem \
   /etc/puppetlabs/puppet/ssl/certs/ca.pem
   # scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem \
   /etc/puppetlabs/puppet/ssl/certs/capsule.example.com.pem
   # scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem \
   /etc/puppetlabs/puppet/ssl/private_keys/capsule.example.com.pem
   # scp root@capsule-ca.example.com:/etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem \
   /etc/puppetlabs/puppet/ssl/public_keys/capsule.example.com.pem

   Copy to Clipboard Toggle word wrap

7. On Capsule Server, change the directory ownership to user puppet, group puppet and set the SELinux contexts:

   # chown -R puppet:puppet /etc/puppetlabs/puppet/ssl/
   # restorecon -Rv /etc/puppetlabs/puppet/ssl/

   Copy to Clipboard Toggle word wrap

8. Append the following options to the satellite-installer command that you obtain from the output of the capsule-certs-generate command:

   --certs-cname                              "loadbalancer.example.com" \
   --puppet-dns-alt-names                     "loadbalancer.example.com" \
   --puppet-ca-server                         "capsule-ca.example.com" \
   --foreman-proxy-puppetca                   "false" \
   --puppet-server-ca                         "false" \
   --enable-foreman-proxy-plugin-remote-execution-ssh

   Copy to Clipboard Toggle word wrap

9. On Capsule Server, enter the satellite-installer command, for example:

   # satellite-installer --scenario capsule \
   --foreman-proxy-content-parent-fqdn        "satellite.example.com" \
   --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         "oauth key" \
   --foreman-proxy-oauth-consumer-secret      "oauth secret" \
   --certs-tar-file                           "capsule.example.com-certs.tar" \
   --puppet-server-foreman-url                "https://satellite.example.com" \
   --certs-cname                              "loadbalancer.example.com" \
   --puppet-dns-alt-names                     "loadbalancer.example.com" \
   --puppet-ca-server                         "capsule-ca.example.com" \
   --foreman-proxy-puppetca                   "false" \
   --puppet-server-ca                         "false" \
   --enable-foreman-proxy-plugin-remote-execution-ssh

   Copy to Clipboard Toggle word wrap