Microsoft IIS
Prev Chapter 4. Windows Notes Next

Microsoft IIS

This section contains notes and hints specific to IIS (Microsoft Internet Information Server).

General considerations for all installations of ruby-web with IIS

  • First, read the Manual Installation Instructions. Do not skip this step as it provides crucial information for installing ruby-web on Windows.
  • The ruby-web CGI is named ruby-web.exe
  • The IIS user (usually IUSR_MACHINENAME) needs permission to read various files and directories, including c:/ruby/bin, c:/ruby/lib, docroot, and the session tmp directory.
  • When defining the executable, the 'check that file exists' box may also be checked. For a small performance penalty, the IIS (or PWS) will check that the script file exists and sort out authentication before firing up ruby-web.

Windows NT/200x/XP and IIS 4 or newer

You need to start the Microsoft Management Console (may appear as 'Internet Services Manager', either in your Windows NT 4.0 Option Pack branch or the Control Panel=>Administrative Tools under Windows 2000/XP). Then right click on your Web server node (this will most probably appear as 'Default Web Server'), and select 'Properties'.

If you want to install ruby-web as a CGI, do the following:

  • Under 'Home Directory', 'Virtual Directory', or 'Directory', do the following:
  • Change the Execute Permissions to 'Scripts only'
  • Click on the 'Configuration' button, and choose the Application Mappings tab. Click Add and set the Executable path to the ruby-web.exe file. An example value is: C:\ruby\bin\ruby-web.exe Supply .rb or .rhtml as the extension. Leave 'Method exclusions' blank, and check the 'Script engine' checkbox. Now, click OK a few times.
  • Set up the appropriate security. (This is done in Internet Service Manager), and if your NT Server uses NTFS file system, add execute rights for I_USR_ to the c:\ruby\bin and read rights for I_USR_ to the c:\ruby\lib directories.

In order to use index.rhtml as a default content page, do the following: From within the Documents tab, choose Add. Type in index.rhtml and click OK. Adjust the order by choosing Move Up or Move Down. This is similar to setting DirectoryIndex with Apache.

Prev Up Next
Manual Installation Steps Home Apache 1.3.x on Microsoft Windows