Appendix A. Large Deployment Considerations

1. On Red Hat Enterprise Linux 7, create the /etc/systemd/system/httpd.service.d/limits.conf file and insert the following text:

   [Service]
   LimitNOFILE=65536

2. Apply the changes to the unit.

   # systemctl daemon-reload

3. Restart Katello services.

   # katello-service restart

Increasing the Maximum Number of File Descriptors for qpid Using Red Hat Enterprise Linux 7

1. Create the /etc/systemd/system/qpidd.service.d/limits.conf file and insert the following text:

   [Service]
   LimitNOFILE=65536

2. Apply the changes to the unit.

   # systemctl daemon-reload
   # systemctl restart qpidd.service

Increasing the Maximum Number of File Descriptors for qpid Using Red Hat Enterprise Linux 6

1. Edit the /etc/security/limits.conf file and insert the following text:

   qpidd - nofile 65536

2. Restart the qpidd service.

   # service qpidd restart

1. On Red Hat Enterprise Linux 7, create the /var/lib/pgsql/data/postgresql.conf file and insert the following text:

   work_mem = 4MB
   shared_buffers = 256MB

2. Restart postgresql services.

   # service postgresql restart

1. Adjust the maximum passenger pool size to 1.5 times the physical CPU cores available to the Satellite Server.

   For example, if you have a Satellite Server with 16 cores, then the maximum passenger pool size is 24. This number is referenced as an example and you should use the number applicable to your environment.

2. Edit the /etc/httpd/conf.d/passenger.conf file, updating the IfModule stanza to match the following text:

   <IfModule mod_passenger.c>
     PassengerRoot /usr/share/gems/gems/passenger-4.0.18/lib/phusion_passenger/locations.ini
     PassengerRuby /usr/bin/ruby
     PassengerMaxPoolSize 24
     PassengerMaxRequestQueueSize 200
     PassengerStatThrottleRate 120
   </IfModule>

3. Edit the Foreman Passenger application configuration file /etc/httpd/conf.d/05-foreman-ssl.conf, updating the stanza starting with PassengerAppRoot to match the following text:

    PassengerAppRoot /usr/share/foreman
    PassengerRuby /usr/bin/tfm-ruby
    PassengerMinInstances 6
    PassengerStartTimeout 90
    PassengerMaxPreloaderIdleTime 0
    PassengerMaxRequests 10000
    PassengerPreStart https://example.com

4. Edit the Puppet Passenger application configuration file /etc/httpd/conf.d/25-puppet.conf, adding the following text to the end of the virtual host definition:

    PassengerMinInstances 6
    PassengerStartTimeout 90
    PassengerMaxPreloaderIdleTime 0
    PassengerMaxRequests 10000
    PassengerPreStart https://example.com:8140

5. Change the maximum connections in the /var/lib/pgsql/data/postgresql.conf file.

   max_connections = 500

6. Restart postgresql services.

   # service postgresql restart

1. Calculate the required maximum number of open files, using the following equation.

   (3 x number of content hosts) + 100

   For example, with 1020 content hosts, the new maximum should be set to 3160 ((3 x 1020) + 100).

2. On Red Hat Enterprise Linux 7, create the file /etc/systemd/system/qdrouterd.service.d/limits.conf and add the following text.

   [Service]
   LimitNOFILE=maximum_number_of_files

   1. Apply the changes to the unit.

      # systemctl daemon-reload

   2. Restart the Satellite services.

      # katello-service restart

3. On Red Hat Enterprise Linux 6, edit the file /etc/security/limits.conf and add the following line.

   qdrouterd   -   nofile  maximum_number_of_files

   Add the new line before the # End of file line because anything past that is ignored.

   1. Restart the qdrouterd service.

      # service qdrouterd restart