Symptoms

How to generate custom HTTPD config.

Resolution

Default configuration Apache templates are included into the hsphere-update package and installed in the following locations:

    /hsphere/pkg/scripts/templates/hs-31/apache/httpd.conf.tmpl.default   
    /hsphere/pkg/scripts/templates/hs-31/apache/httpd2.conf.tmpl.default   
    /hsphere/pkg/scripts/templates/hs-31apache/lsrv.conf.tmpl.default   

To customize them, perform:

1. Create custom configuration template if required. Otherwise, skip this step.
   1.1 Download H-Sphere updater:

   # wget http://download.hsphere.parallels.com/shiv/HS/releases/U36.0/U36.0P3/U36.0P3
   

   1.2 Run the update script:

   # sh ./U36.0P3
   

   1.3 Execute the hspackages wrapper with the ctemplates=httpd option for Apache 1.3 and/or ctemplates=httpd2 option for Apache 2.2:

   hspackages ctemplates=httpd [OPTIONS]
   

   Custom templates will be placed into the following locations:

   /hsphere/local/config/httpd/lsrv.conf.tmpl.custom
   /hsphere/local/config/httpd/httpd.conf.tmpl.custom
   /hsphere/local/config/httpd2/lsrv.conf.tmpl.custom
   /hsphere/local/config/httpd2/httpd.conf.tmpl.custom
   

2. Edit the .custom files according to your needs:

   /hsphere/local/config/httpd/lsrv.conf.tmpl.custom   
   /hsphere/local/config/httpd/httpd.conf.tmpl.custom   
   

3. To immediately apply changes, run the conf file generating script which is as a rule executed in the postinstall section of the package:

   /hsphere/shared/scripts/apache-restart