Sawtooth Software: The Survey Software of Choice

Microsoft IIS Server Setup for SSI Web (version 3.0 or earlier)

NOTE: If you have version 3.1 or 3.2 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".

  1. 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".

  2. 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)

    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)

  3. You will need to edit the paths in two Perl files, ciwweb.pl and admin.pl. Each path needs to have "cgi-bin/" added to the front.

    For example: my($Path_cgilib) = "cgi-lib.pl"; needs to be changed to my($Path_cgilib) = "cgi-bin/cgi-lib.pl";.

    Do not modify these files in any other way this includes not entering any carriage returns.

  4. You now need to modify the study specific paths in SSI Web. Open your study in SSI Web and go to File, Settings, Advanced. Modify the three paths as shown in the example.

    1. Administrative Directory: This is the path to the admin directory relative to the working directory of the Perl files (the virtual root).
    2. CGI Scripts Directory: This is the path from the stu1logn.htm and stu1admn.htm files to the actual location of the ciwweb.pl and admin.pl files.
    3. Data Directory: This is the path to the data directory relative to the working directory of the Perl files (the virtual root).
    4. Relative Path from CGI Scripts to Graphics: This is the path to the graphics directory relative to the actual location of the Perl files (cgi-bin).
    5. Relative Path from logn.htm to Graphics: This is the path to the graphics directory relative the stu1logn.htm file.

    This path information is stored in the file stu1path.cgi.

  5. 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."

  6. In the Properties dialog box of the Virtual Directory (accessible 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).

  7. 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).