Install docs update?

[nigel_currie]

I had to do a server move a while back and came across a timeout issue that took way too long to resolve.

The server we moved to was Apache running fcgid. The CiviCRM installer consistently timed out after 31s. The suggested php.ini changes were made - still timed out.

Finally after a heck of a lot of back and forth between me and the hosting folk, we found that the fcgi timeouts needed to be extended in TWO files - /etc/apache2/mods-enabled/fcgid.conf and /etc/apache2/sites-enabled/<SITE DOMAIN>.conf. The hosting people just bumped everything up to 900s, which is overkill, ending up with this:

Code: [Select]

<IfModule mod_fcgid.c>
  AddHandler fcgid-script .fcgi
  IPCConnectTimeout 900
  IPCCommTimeout 900
  FcgidConnectTimeout 900
  FcgidIOTimeout 900
  BusyTimeout 900
</IfModule>

Would have saved a lot of time had that been in the installation troubleshooting docs.

I run Zend server locally on windows when developing and ran into installation timeouts there too. Again, took some time to figure out that timeouts needed bumped up in <zend install dir>/Zend/ZendServer/etc/ZendEnablerConf.xml as so:

Code: [Select]

<Timeouts connectionTimeout="90" requestTimeout="900" />

There will be a lot of people out there running either of these configurations, so adding this info to the installation docs (after the suggested php.ini settings) - a good idea?