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:

   Copy to Clipboard Toggle word wrap

   [Service]
   LimitNOFILE=65536

2. Apply the changes to the unit.

   Copy to Clipboard Toggle word wrap

   # systemctl daemon-reload

3. Restart Katello services.

   Copy to Clipboard Toggle word wrap

   # 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:

   Copy to Clipboard Toggle word wrap

   [Service]
   LimitNOFILE=65536

2. Apply the changes to the unit.

   Copy to Clipboard Toggle word wrap

   # 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:

   Copy to Clipboard Toggle word wrap

   qpidd - nofile 65536

2. Restart the qpidd service.

   Copy to Clipboard Toggle word wrap

   # service qpidd restart

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

   Copy to Clipboard Toggle word wrap

   work_mem = 4MB
   shared_buffers = 256MB

2. Restart postgresql services.

   Copy to Clipboard Toggle word wrap

   # 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:

   Copy to Clipboard Toggle word wrap

   <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:

   Copy to Clipboard Toggle word wrap

    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:

   Copy to Clipboard Toggle word wrap

    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.

   Copy to Clipboard Toggle word wrap

   max_connections = 500

6. Restart postgresql services.

   Copy to Clipboard Toggle word wrap

   # service postgresql restart

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

   Copy to Clipboard Toggle word wrap

   (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.

   Copy to Clipboard Toggle word wrap

   [Service]
   LimitNOFILE=maximum_number_of_files

   1. Apply the changes to the unit.

      Copy to Clipboard Toggle word wrap

      # systemctl daemon-reload

   2. Restart the Satellite services.

      Copy to Clipboard Toggle word wrap

      # katello-service restart

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

   Copy to Clipboard Toggle word wrap

   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.

      Copy to Clipboard Toggle word wrap

      # service qdrouterd restart