How to customize Apache configuration on OA-managed host

Original Publishing Date:
2020-01-22

Symptoms

Provider wants to add custom directives into Apache server configuration on Linux Shared Hosting server managed by OA.

Resolution

Attention: this article is applicable to legacy Apache web hosting servers only, not to Shared Hosting NG servers.

Apache configuration on OA-managed shared host is loaded from the custom configuration file - /usr/local/pem/etc//httpd.conf.pem, not from the default Apache configuration file /etc/httpd/conf/httpd.conf.

However, the /usr/local/pem/etc/apache/httpd.conf.pem file should not be customized because it is generated by OA and it may be overwritten in case of update of POA package Apache which is installed on the host.

The correct file to put custom Apache directives is /usr/local/pem/etc/apache/httpd.conf.pem.override which overrides settings from the httpd.conf.pem file and the httpd.conf.pem.override file is not touched by OA package upgrades.

After configuration file is updated restart Apache server:

# /etc/init.d/pemhttpd restart