How To Install IIPImage on Windows 2008/IIS7 – 2008R2/IIS7.5
It is now finally possible to install IIPImage on IIS7 and IIS7.5! Many thanks indeed to Ricardo Valdiviezo for getting this to work and for sending us the following detailed and illustrated tutorial.
- First, if it is not already installed, install IIS 7/7.5.
- Install the FastCGI extension
- Download the IIPImage Windows package and unzip it into a folder (e.g. “C:\IIPServer”)
- Create a folder called
images
into the folder which was created in step 3 - Create a new folder called
logs
into the folder which was created in step 3 - Rename the file
iipsrv.fcgi
toiipsrv.exe
- Now you should be able to see the following folders and files into the folder which was created in the step 3:
- Open your Internet Information Service Manager and click on the server icon, then open the FastCGI Settings:
- Give permissions to new folders and files
- Add a new Application and configure it.
- You need to configure a “Handler Mappings” for the new extension “.fcgi” or any other do you want. This can be configured at Server level, Site level, directory or virtual directory level. In this example we configure it as virtual directory.
- Create a Virtual Directory (fcgi-bin)
- Create an empty file iipsrv.fgci inside this new directory. (You may name this something else if you wish)
- Create a Handler Mapping:
- In the Actions pane click Add Module Mapping
- In Request path enter
*.fcgi
- In Module select
FastCGIModule
- On Executable (optional)” enter the full path of the exe file, e.g.
c:\iipServer\iipsrv.exe
(This is NOT in fact optional for IIPImage) - Click Request Restrictions then on Access tab, select
Execute
- Click
OK
,OK
and accept the Warning message that will appear.
- Copy the client samples into the website (It can be copied at any location, not necessarily in a virtual directory)
- To test with
IIPZoom 0.2
, adjust the following javascript vars:
Installation
Configure FastCGI
This is a variable based on the authentication scheme selected for the website. For AppPoolIdentity you need assign the following permissions to the various directories you have created and to the dlls and .exe files:
C:\IIPServer
For dlls and exe files give execute permissions for IIS_IUSRS user:
C:\IIPServer\Images
Only read permission is required for your images directory:
C:\IIPServer\Logs
Write permission must be allowed for the IIS_IUSRS user for logging:
Application Configuration
10.1 Click on Add Application in the Actions pane.
10.2 Enter the full path of the file “iipsrv.exe” (e.g. c:\iipServer\iipsrv.exe
)
10.3 Leave Arguments empty.
10.4 In FastCGI Properties add various FCGI parameters.
For example:
- Instance MaxRequest : 200 - Standard Error Mode: ReturnStdErrIn500 - Activity TimeOut: 30 - Idle Timeout: 300 - Queue Length: 1000
And so on. You can change these values at any time and tailor them to your needs.
10.5 Now configure the IIPImage server parameters. For IIS7/7.5, unlike IIS6, there is no fcgiext.ini
file, so you will need to enter these parameters as Environment variables individually. See the server documentation for a full list of available parameters.
Site configuration
//This is the path to your empty file created in step 13 var server = "/fcgi-bin/iipsrv.fcgi"; //This is the full path to your source TIFF image var image = "/IIPServer/images/flower2T.tif";
Optionally, on IIS 7/7.5 you can configure the “Application Request Routing Cache” in order to improve its performance.