Enable HTTP2 Support in Apache: Difference between revisions
Tag: 2017 source edit |
(→Tuning) Tag: 2017 source edit |
||
Line 51: | Line 51: | ||
== Tuning == | == Tuning == | ||
As with all tuning, there can be a lot of factors that relate to how the figures configuration should be looked at. For edge situations or applications, further advice should be sought. The details below can be used as a guide for general purpose web servers. | |||
=== Apache === | === Apache === | ||
Line 66: | Line 68: | ||
</IfModule> | </IfModule> | ||
If your server has 4 cores and 16GB RAM, you can set the StartServers to 4 and the MaxRequestWorkers to around 175 to 200. | If your server has 4 cores and 16GB RAM, you can set the StartServers to 4 and the MaxRequestWorkers to around 175 to 200. Further information can be found regarding the above parameters [https://httpd.apache.org/docs/2.4/mod/mpm_common.html in the apache documentation]. | ||
=== PHP-fpm === | === PHP-fpm === | ||
Again there are a lot of things to consider regarding the settings for the FPM pool. We will look at the basics again but you will need to look at your systems RAM usage and other functions for further fine tuning. The configuration file for php-fpm is heavily commented, the main settings that you would need to set up are: | Again there are a lot of things to consider regarding the settings for the FPM pool. We will look at the basics again but you will need to look at your systems RAM usage and other functions for further fine tuning. You can find the configuration file for the php-fpm in /etc/php/7.3/fpm/pool.d/www.conf. The configuration file for php-fpm is heavily commented, the main settings that you would need to set up are: | ||
pm = dynamic | pm = dynamic | ||
Line 78: | Line 80: | ||
pm.max_spare_servers = 3 | pm.max_spare_servers = 3 | ||
Again this would be a good starting point for a base server (2 cores, 8GB ram) and can be scaled up in a similar way so with 4 cores and 16GB ram you can increase the numbers by a factor of 2. | Again this would be a good starting point for a base server (2 cores, 8GB ram) and can be scaled up in a similar way so with 4 cores and 16GB ram you can increase the numbers by a factor of 2. Further information regarding the php-fpm configuration directives can be found [https://www.php.net/manual/en/install.fpm.configuration.php in the php-fpm documentation]. | ||
[[Category:How To]] | [[Category:How To]] |
Revision as of 12:11, 14 April 2020
To get http2 running on Symbiosis in a production environment reliably, brings about a few configuration changes. I'll attempt to highlight these here.
MPM_event to replace MPM_prefork
The prefork MPM has substantial limitations when working with http2 namely in that each connection can only handle one request at a time. More details can be found on the apache website. Because of this we are going to switch the apache server to using the event MPM. The event MPM is not able to preload the PHP module so we will also need to install php-fpm to parse php on the server.
If you had previously made modifications to the prefork settings to optimise performance then these will need transposing across to the MPM_event configuration as well. If you have not made changes as highlighted below then just disabling the prefork module and enabling the event module as below will be enough.
Setting up
Install the php-fpm, the default php install on a buster machine is currently php7.3:
apt-get install -y php7.3-fpm
We will disable the prefork and php7.3 module. The php7.3 module allows the prefork module to run in prefork but we need to remove it to run php-fpm
a2dismod php7.3 mpm_prefork
We will then install the modules for the event MPM, proxy_fcgi for passing php requests to php-fpm and the http2 module
a2enmod alias mpm_event proxy proxy_fcgi setenvif http2
We can then add the php7.3-fpm config as well.
2enconf php7.3-fpm
At this point the system is configured to run with the new settings but until we have restarted apache they have not taken effect. The php_admin directives that we are set in sympl to enhance security throw errors using the fpm as the multiple fields are not recognised by proxy_fcgi. We need to contain the multiple parameters in quotes so they are all seen as one parameter and passed through to php-fpm as a whole. To do this moving forwards we can adapt the sympl-web-configure templates:
sed -E -i 's/php_admin_value (.*)/SetEnv php_admin_value \"\1\"/' /etc/sympl/apache.d/*.erb
sed -E -i 's/php_admin_flag (.*)/SetEnv php_admin_flag \"\1\"/' /etc/sympl/apache.d/*.erb
if you have hand edited the configuration files and dont want to run sympl-web-configure --force
sed -E -i 's/php_admin_value (.*)/SetEnv php_admin_value \"\1\"/' /etc/apache2/*-available/*.conf
sed -E -i 's/php_admin_flag (.*)/SetEnv php_admin_flag \"\1\"/' /etc/apache2/*-available/*.conf
You can test the new configuration before restarting apache with the apachectl config test:
apachectl -t
You should recieve a message saying 'Syntax OK'. there may be a message about the test not seeing the correct IP address but this can be ignored, as long as there are no errors your configuration will work. You can then create the config with the following command:
sympl-web-configure --verbose
You can test the new configuration using a browser in debug mode or using curl from your server with:
curl -I --http2 http://localhost
and you should recieve somethig like:
HTTP/1.1 101 Switching Protocols Upgrade: h2c Connection: Upgrade HTTP/2 200 date: Sat, 11 Apr 2020 21:55:34 GMT server: Apache content-type: text/html; charset=UTF-8
Tuning
As with all tuning, there can be a lot of factors that relate to how the figures configuration should be looked at. For edge situations or applications, further advice should be sought. The details below can be used as a guide for general purpose web servers.
Apache
Fine tuning of these settings can take you into a lot of detail, going beyond the initial basic configuration which for a base level machine (2 cores, 8GB RAM) is fine and a good starting point. If you have anything more, you will need to make at least the changes suggested here. If you need more tuning then you will need to consider what other services are on the machine, take some metrics as to what resource your current processes are using and factor in all the limits and capabilities of the server and take into consideration changes that are planned. As this guide is helping you get started we will not go into too much detail here. Your /etc/apache2/mods-available/mpm_event.conf would look a little like this:
<IfModule mpm_event_module> StartServers 2 # You should set this to the number of cores you have on your server MinSpareThreads 25 MaxSpareThreads 75 ThreadLimit 64 ThreadsPerChild 25 MaxRequestWorkers 150 # This should be around StartServers * ThreadsPerChild + MaxSpareThreads. Here there are a few more to play with. MaxConnectionsPerChild 0 </IfModule>
If your server has 4 cores and 16GB RAM, you can set the StartServers to 4 and the MaxRequestWorkers to around 175 to 200. Further information can be found regarding the above parameters in the apache documentation.
PHP-fpm
Again there are a lot of things to consider regarding the settings for the FPM pool. We will look at the basics again but you will need to look at your systems RAM usage and other functions for further fine tuning. You can find the configuration file for the php-fpm in /etc/php/7.3/fpm/pool.d/www.conf. The configuration file for php-fpm is heavily commented, the main settings that you would need to set up are:
pm = dynamic pm.max_children = 5 pm.start_servers = 2 pm.min_spare_servers = 1 pm.max_spare_servers = 3
Again this would be a good starting point for a base server (2 cores, 8GB ram) and can be scaled up in a similar way so with 4 cores and 16GB ram you can increase the numbers by a factor of 2. Further information regarding the php-fpm configuration directives can be found in the php-fpm documentation.