Microsoft IIS Server Setup for SSI Web (version 3.1 or 3.2 or 3.5)
NOTE: If you have version 3.0 or earlier please use this version.
Make sure Perl is installed on your web server. If you need Perl you can get a free copy from Active State. (SSI Web does not currently support Perl ISAPI) When you install Perl make sure that the options are set to run Perl scripts (default).
In this example we will setup a study named "stu1".
Create a folder on your web server for your study. This folder should be created under \Inetpub\wwwroot\. In our example we will call the folder "stu1".
Inside the "stu1" folder set up your study folders and files. The study specific files (those containing the study name as a prefix) can be found in your creation folder on your local computer.
- stu1logn.htm -- Login page (1st page of survey)
- stu1admn.htm -- Administrator login page
- stu1path.cgi -- File path information
- stu1pidx.cgi -- Password index
- stu1p001.cgi -- Password file
- stu1qst.cgi -- Questionnaire file
- stu1pacc.cgi -- Password file
- stu1dsgn.cgi -- CBC design file (for CBC studies only)
- stu1ctxt.cgi -- CBC design file (for CBC studies with conditional relationships only)
The Perl files (*.pl and lite.pm) can be found on your local computer where you installed SSI Web inside the "Server" folder. (C:\Program Files\Sawtooth Software\SSI Web\Server)
NOTE: You might want to setup a different directory structure than is shown here. To do so you will need to modify the path settings in SSI Web (File, Settings, Advanced - Press F1 on this screen for additional help). You might also need to place your STUDYNAMEpath.cgi file in the cgi-bin.
A Virtual Directory now needs to be setup in IIS using the "Internet Information Services" dialog box. This new Virtual Directory needs to point to the "stu1" folder created in step #1.
To do this right click on the Web Site icon (the one with the hand holding the world) and click on New, Virtual Directory. Use the wizard that displays to create a Virtual Directory. You will need to associate the Virtual Directory with your actual study directory that we created in step #1. You will also want to enable "Read" and "Execute".
In the Properties dialog box of the Virtual Directory (accessable by right clicking the Virtual Directory) make sure that your settings are correct.
The settings might be different depending on your server setup. The Perl scripts need permission to execute and read, write, and delete files.
Your unique setup might also have problems finding the stu1path.cgi and ssilogo.gif files. If so try placing these files in the root of the Virtual Directory (virtual root).
You might still have problems with setting the correct permissions. The Perl scripts need permission to read, write, and delete files from the admin and data directories. You might consider changing the permissions at the folder and file level (NTFS).
Go to Windows Explorer and navigate to the folder whose permissions you need to change. Right click on the folder and go to Properties. Click on the Security tab. Give the "Everyone" group permission to read, write, and delete files. You might consider giving the folder Full Control.
The settings might be different depending on your server setup. Your unique setup might also have problems finding the stu1path.cgi and ssilogo.gif files. If so try placing these files in the root of the Virtual Directory (virtual root).
NOTE: Please consult your server administrator on security issues and following these steps with your particular server.
If you are using Windows 2003 Server then you might need to allow "All Unknown CGI Extensions".
To do this go to Web Service Extensions, click on All Unknown CGI Extensions, and then click on Allow.