Catalyst+IIS 7.0 on MS Windows 2008/Vista

This article describes deployment of Catalyst application on a Microsoft Windows 2008 or Vista + IIS 7.0 (Internet Information Service).

VERY IMPORTANT: you need at least Catalyst::Runtime 5.80005 to run Catalyst applications as FastCGI on Windows 2008.

First you need Perl + Catalyst framework

See Catalyst+Apache+FastCGI on MS Windows

Let us assume we have our perl installed in c:\strawberry\.

Install your Catalyst application

See Catalyst+Apache+FastCGI on MS Windows

Let us assume we have our application in c:\inetpub\WebApp\.

Install IIS server role with FastCGI support

On Windows 2008 installing IIS means adding appropriate server role. To do this go to Control Panel > Administrative Tools > Server Manager:

window title:Server Manager, right click 'Roles' - choose 'Add Roles'

window title:Add Roles Wizard, check 'Web Server (IIS)' - click 'Next'

It is very important to select CGI Role Service to install (this includes also FastCGI support):

window title:Add Roles Wizard - check 'CGI' - click 'Next'

After installation you should see something like this - "Web Server (IIS)" is important for us:

window title:Server Manager, see 'Roles Summary'

Now go to Control Panel > Administrative Tools > Internet Information Services (IIS) Manager and choose Add Web Site like this:

window title:Internet Information Services (IIS) Manager

Fill in appropriate site name, document root and IP+port:

windows title:Add Web Site, fill 'Site name' = e.g. 'My Catalyst App', fill 'Physical path' = c:\inetpub\WebApp\root, set 'Port' = e.g. 4000 - click OK

Click on our newly created site in left column and then on Handler Mappings icon:

window title:Internet Information Services (IIS) Manager, click on 'Handler Mappings' icon

Click on Add module mapping in right column:

window title:Internet Information Services (IIS) Manager

Fill required info like in the following example.

window title:Add Module Mapping, fill 'Request path'=*, fill 'Module'=FastCgiModule, fill 'Executable (optional)', fill 'Name'=CatFastCGI - click OK

Important: executable is set to

c:\strawberry\perl\bin\perl.exe|c:\inetpub\WebApp\script\webapp_fastcgi.pl -e

In the next dialogue confirm YES:

windows title:Add Module Mapping

Now you can see the new handler "CatFastCGI" in the list like this:

window title:Internet Information Services (IIS) Manager

Click on our "My Catalyst App" site in left column and then on Restart:

window title:Internet Information Services (IIS) Manager

Test your application

At this point your Catalyst application should be available at http://localhost:4000.

My tags:
 
Popular tags:
 
Powered by Catalyst
Powered by MojoMojo Hosted by Shadowcat - Managed by Nordaaker