Step 3.2: Configuring IIS 8 Web Server on Windows Server 2012

Before configuring IIS on Windows Server 2012, verify that your IIS installation includes the CGI service.

To install IIS on Windows Server 2012:

• In Windows Server Manager, click Manage, and select Add Roles and Features.
• In the Add Roles and Features Wizard, click Server Roles, and select the Web Server (IIS) check box. Click Next.

  

• On the Role Services page, ensure that you add the CGI module, which is located in the Application Development section. Click Next, and then click Install.

  

To configure MTWeb as the default website in IIS:

1. Open the IIS Manager from Windows Start > Administrative Tools > IIS Manager.
2. In the IIS Manager Connections pane, expand the server name, expand Sites, and then click Default Web Site.

   

3. Go to the Actions pane on the right, and under Edit Site, click Basic Settings…
   1. Click the … button next to Physical path field, and select the WebRoot folder.

      

      For the default MassTransit installation, the path is:

      C:\Program Files (x86)\Acronis\MassTransit Server\MTWeb\WebRoot

   2. Click OK twice.
4. In the Default Web Site Home pane, double-click the Handler Mappings icon.
   1. Check if there is a PHP handler mapping in the Enabled list of the Handler Mappings pane. If it exists, select it and click Remove in the Actions pane.
   2. In the Actions pane, click Add Module Mapping…
   3. In the Request path field, enter: *.php.
   4. In the Module field, select: FastCgiModule.
   5. In the Executable (optional) field, select the path to the php-cgi.exe file. For example, C:\php\php-cgi.exe.
   6. In the Name field, enter: PHP.

      

   7. Click OK.
   8. If the following dialog appears, click Yes.

      

      Note: You must repeat steps 4.a through 4.h for each extension that you want to associate with PHP scripts. Extensions such as .php3 may be required for legacy applications, but are not necessary for MassTransit.

5. In the IIS Manager Connections pane, click Default Web Site. Then double-click MIME Types in the Home pane.
   1. Check if there is a .dmg extension in the MIME Types list. If the extension exists, go to step 6. Otherwise, continue with this step.
   2. In the Actions pane, click Add...
   3. In the File name extension field, enter: .dmg.
   4. In the MIME type field, enter: x-application/applediskimage.

      

   5. Click OK.
6. In the IIS Manager Connections pane, click Default Web Site. Then double-click MIME Types in the Home pane.
   1. Check if there is a .json extension in the MIME Types list. If the extension exists, go to step 7. Otherwise, continue with this step.
   2. In the Actions pane, click Add...
   3. In the File name extension field, enter: .json.
   4. In the MIME type field, enter: application/json.

      

   5. Click OK.
7. In the IIS Manager Connections pane, click Default Web Site. Then double-click Default Document in the Home pane.
   1. Check if there is index.php in the list of the Default Document pane. If it exists, go to step 8. Otherwise continue with this step.
   2. In the Actions pane, click Add…
   3. In the Name field, enter: index.php.
   4. Click OK.

      

   5. Move the index.php to the top by clicking Move Up in the Actions pane.
8. Open the Command Prompt as an administrator.
   1. Navigate to the inetsrv folder, by entering the following command:

      cd C:\Windows\system32\inetsrv

      Note: Modify this path according to your actual Windows installation folder.

   2. To set the maximum allowed content length for the transferred files, enter the command below.

      appcmd set config /section:requestfiltering /requestlimits.maxallowedcontentlength:value

      If you are using the preconfigured php.ini file, set the value to 2147483647.

      If you are configuring this setting after upgrading MTWeb, replace this value with the same value (in bytes) that was set for the upload_max_filesize .For more information on this topic, refer to Step 2: Upgrading and Configuring PHP.

      Note: It is recommended to set this value to 2147483647 bytes (2GB). This is also the highest value that can be set for upload_max_filesize.

   3. To set the maximum allowed time for an HTTP transfer, enter the commands bellow. Replace value with a value greater than the maximum time in seconds that an HTTP transfer takes.

      appcmd set config /section:system.webServer/fastCgi /[fullPath='c:\php\php-cgi.exe'].ActivityTimeout:value

      appcmd set config /section:system.webServer/fastCgi /[fullPath='c:\php\php-cgi.exe'].RequestTimeout:value

      Note: It is recommended to set these values to 3600 (1 hour). This is also the highest value that can be set for ActivityTimeout. 

9. Restart IIS so that the changes made to PHP and IIS settings are properly loaded. To do so, go to the IIS Manager Connections pane, and click Default Web Site. Then, in the Actions pane, navigate to the Manage Web Site section, and click Restart.
10. Restart the machine. This is required to ensure that all new settings for IIS and MassTransit are properly loaded, and to remove any cached versions of the old website that may be in the memory.