Internet Information Services: Difference between revisions
No edit summary |
No edit summary |
||
| (8 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{Installing Moodle}}[[Internet Information Services]] ('''IIS''') is the web server software bundled with Windows Server, as well as certain client versions of Windows. | {{Installing Moodle}}[[Internet Information Services]] ('''IIS''') is the web server software bundled with Windows Server, as well as certain client versions of Windows. Please note Apache web server has much better community support and there are usually fewer problems when running Moodle on Apache. | ||
==PHP installation== | ==PHP installation== | ||
It is strongly recommended to use only the official Microsoft PHP installer from http://php.iis.net/, it automatically installs all necessary components and | It is strongly recommended to use only the official Microsoft PHP installer from http://php.iis.net/, it automatically installs all necessary components and facilitates easy configuration with PHP manager. Manual installation attempts often fail or may not allow Moodle to function properly. | ||
==Configuration | ==Configuration== | ||
Unfortunately IIS does not natively support unicode characters in so called ''slashargument URL'' which are used in Moodle for file serving. Moodle requires manual configuration of rewrite rules, the PHP installation via ''Microsoft Web Platform Installer'' installs necessary ''URL Rewrite 2.0'' module. Add following rewrite rule to enable support for Moodle file | ===URL rewriting=== | ||
Unfortunately IIS does not natively support unicode characters in so called ''slashargument URL'' which are used in Moodle for file serving. Moodle requires manual configuration of rewrite rules, the PHP installation via ''Microsoft Web Platform Installer'' installs necessary ''URL Rewrite 2.0'' module. | |||
[[File:Rewrite_rule_-_Internet_Information_Services_(IIS)_Manager.png|thumb]] | |||
Add following rewrite rule to enable support for unicode file names in Moodle and to work around internal file length limitation breaking YUI file serving: | |||
* Matches the Pattern - Regular Expressions - <code>^([^\?]+?\.php)(\/.+)$</code> | * Matches the Pattern - Regular Expressions - <code>^([^\?]+?\.php)(\/.+)$</code> | ||
* Action - Rewrite - <code>{R:1}\?file={R:2}</code> | * Action - Rewrite - <code>{R:1}\?file={R:2}</code> | ||
* Append query string - enabled | |||
* Stop processing of subsequent rules - enabled | |||
===CGI timeouts=== | |||
By default IIS is configured to stop execution of any PHP script after 5 minutes of activity, this interferes with long running Moodle scripts such as upgrade or cron. The timeout should be increased to at least one hour. | |||
==Directory permissions== | |||
The default IIS account is ''IIS_IUSRS'', make sure it has appropriate access right to Moodle dirroot (read only) and dataroot (read/write) directories. | |||
==Debugging problems== | |||
By default IIS contains custom error pages that intentionally hide error details on production sites. When diagnosing problems you may want to disable temporarily the IIS Error Pages. | |||
== See also == | == See also == | ||
* [[Installing MSSQL for PHP]] | |||
* [http://www.iis.net The Official Microsoft IIS Site] | * [http://www.iis.net The Official Microsoft IIS Site] | ||
* [http://en.wikipedia.org/wiki/Internet_Information_Services Wikipedia article on IIS] | * [http://en.wikipedia.org/wiki/Internet_Information_Services Wikipedia article on IIS] | ||
Latest revision as of 09:10, 4 September 2012
Internet Information Services (IIS) is the web server software bundled with Windows Server, as well as certain client versions of Windows. Please note Apache web server has much better community support and there are usually fewer problems when running Moodle on Apache.
PHP installation
It is strongly recommended to use only the official Microsoft PHP installer from http://php.iis.net/, it automatically installs all necessary components and facilitates easy configuration with PHP manager. Manual installation attempts often fail or may not allow Moodle to function properly.
Configuration
URL rewriting
Unfortunately IIS does not natively support unicode characters in so called slashargument URL which are used in Moodle for file serving. Moodle requires manual configuration of rewrite rules, the PHP installation via Microsoft Web Platform Installer installs necessary URL Rewrite 2.0 module.
_Manager.png)
Add following rewrite rule to enable support for unicode file names in Moodle and to work around internal file length limitation breaking YUI file serving:
- Matches the Pattern - Regular Expressions -
^([^\?]+?\.php)(\/.+)$ - Action - Rewrite -
{R:1}\?file={R:2} - Append query string - enabled
- Stop processing of subsequent rules - enabled
CGI timeouts
By default IIS is configured to stop execution of any PHP script after 5 minutes of activity, this interferes with long running Moodle scripts such as upgrade or cron. The timeout should be increased to at least one hour.
Directory permissions
The default IIS account is IIS_IUSRS, make sure it has appropriate access right to Moodle dirroot (read only) and dataroot (read/write) directories.
Debugging problems
By default IIS contains custom error pages that intentionally hide error details on production sites. When diagnosing problems you may want to disable temporarily the IIS Error Pages.
