Web Server Setup for Microsoft IIS Servers

Web Server Setup for Microsoft IIS Servers

Installing Perl

SSI Web uses scripts written in the Perl language to run web-based surveys. A Perl interpreter must be installed on your web server in order for surveys to work correctly.

Active State provides a free version of their ActivePerl interpreter at http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl.

When installing ActivePerl, a set of options is displayed (shown below).

The main Perl option and the Perl ISAPI option are required as shown. PerlScript, PPM 3.0, and Examples are not required, but will not harm the ability to run SSI Web studies.

When asked, Perl should be added to the PATH environment variable, a Perl file extension association should be made, and the IIS script mapping for Perl and Perl ISAPI should be created.

Although instructions have been provided for ActivePerl, SSI Web can utilize any available Perl interpreter. Please consult your System Administrator to make sure a Perl interpreter is available.

Preparing SSI Web Studies

Once an SSI Web study has been written, it must be prepared for uploading. This is done in SSI Web by clicking Field | Prepare for Web Upload.

Inside the study's folder, a new folder called Web Upload contains the files that should be copied to the web server.

Inside the "Web Upload" folder are several files and folders (for this example, the four-letter studyname is stu1):

·	stu1admn.htm (administrative login page)

·	stu1logn.htm (survey login page)

·	admin (study-related file folder)

stu1path.cgi (file path information)

stu1qst.cgi (questionnaire file)

stu1pidx.cgi (password index)

stu1pacc.cgi (password file)

stu1p001.cgi (password file)

stu1_CBC1_<designID>.cgi

stu1ctxt.cgi (CBC conditional relationships design file; only present in some CBC studies)

·	cgi-bin (SSI Web script engines)

acalib522.pl

admin.pl

authlib522.pl

cbclib522.pl

ciwlib522.pl

ciwweb.pl

enterlib522.pl

grdlib522.pl

pverlib522.pl

·	data (respondent data)

·	graphics (image file folder)

ssilogo.gif (SSI Web logo)

NOTE: You might want to configure a different directory structure from what we've shown here. To do so, you must modify the path settings in SSI Web by clicking File | Study Settings... and clicking the Advanced Settings... button. You should also place your STUDYNAMEpath.cgi file in the cgi-bin folder.

Using IIS 6.0 (Windows Server 2003)

To begin, SSI Web studies must be placed in their own folders on the web server.

The main folder for web pages under IIS is C:\Inetpub\wwwroot (although this is the default location, your system administrator may change it).

If the SSI Web study were called stu1, a folder should be created in the wwwroot folder called stu1.

Copy the files from the Web Upload folder to the stu1 folder on the web server (contact your System Administrator to find out how to copy the files).

Open the Internet Information Services (IIS) Manager, located in the Administrative Tools folder of the Control Panel.

A new virtual directory must be created by right-clicking Default Web Site and selecting New | Virtual Directory....

Using the Virtual Directory Creation Wizard, select an alias for the folder. The alias is used in the web URL, i.e. http://www.myserver.com/alias/stu1logn.htm.

Next, enter the folder where the study is located.

Make sure only the Read, Run scripts, and Execute options are checked.

After finishing the Virtual Directory Creation Wizard, the alias appears in the list of items under Default Web Site. Right-click the alias and select Properties.

To verify that SSI Web scripts will run correctly, check that Execute permissions lists Scripts and Executables, and click Configuration....

Scroll down through the extensions, and verify that your Perl interpreter is registered to handle .pl extensions. If it is not present, check with your System Administrator about adding the extension.

Click OK at the configuration window and OK at the virtual directory properties to return to the main IIS manager window.

Permissions must be set on the files so that they can be viewed on the Internet. To do this, right click on the virtual directory, and select Permissions.

Find the entry for Internet Guest Account, and if not already checked, put a check for the Modify flag. All the flags below it should also become checked. Click OK to close the permissions window.

To complete the configuration, click Web Service Extensions from the tree view. If not already allowed, right click All Unknown CGI Extensions and select Allow. This should also be done for other items referring to CGI, such as Perl CGI Extension (this may vary with your Perl interpreter).

Configuration of the web server is now complete and ready for testing. Be aware with the many different Perl interpreters and server configurations, these instructions may vary slightly. Consult your System Administrator for assistance.

Using IIS 5.0 (Windows 2000 Servers)

To begin, SSI Web studies must be placed in their own folders on the web server.

The main folder for web pages under IIS is C:\Inetpub\wwwroot (although this is the default location, your system administrator may change it).

If the SSI Web study were called stu1, a folder should be created in the wwwroot folder called stu1.

Copy the files from the Web Upload folder to the stu1 folder on the web server (contact your System Administrator to find out how to copy the files).

Open Internet Information Services, located in the Administrative Tools folder of the Control Panel.

A new virtual directory must be created by right-clicking Default Web Site and selecting New | Virtual Directory.

Using the Virtual Directory Creation Wizard, select an alias for the folder. The alias is used in the web URL, i.e. http://www.myserver.com/alias/stu1logn.htm.

Next, enter the folder where the study is located.

Make sure only the Read, Run scripts, and Execute options are checked.

After finishing the Virtual Directory Creation Wizard, the alias used appears in the list of items under Default Web Site. Right-click the alias and select Properties.

To verify that SSI Web scripts will run correctly, check that Execute permissions indicates Scripts and Executables, and click Configuration....

Click OK at the configuration window and OK at the virtual directory properties to return to the main IIS manager window.

Permissions must be set on the files so that they can be viewed on the Internet. To do this, right-click the stu1 folder in Windows Explorer (not IIS), and select Properties.

On the Security tab, find the entry for Everyone, and if not already checked, put a check for the Modify flag. All the flags below it should also become checked. Click OK to close the properties window.

Using IIS 4.0 (Windows NT 4.0 Server)

To begin, SSI Web studies must be placed in their own folders on the web server.

The main folder for web pages under IIS is C:\Inetpub\wwwroot (although this is the default location, your system administrator may change it).

If the SSI Web study were called stu1, a folder should be created in the wwwroot folder called stu1.

Copy the files from the Web Upload folder to the stu1 folder on the web server (contact your System Administrator to find out how to copy the files).

Open the Internet Service Manager, located under Start | Programs | Windows NT 4.0 Option Pack | Microsoft Internet Information Server.

A new virtual directory must be created by right-clicking Default Web Site and selecting New | Virtual Directory.

Using the Virtual Directory Creation Wizard, select an alias for the folder. The alias is used in the web URL, i.e. http://www.myserver.com/alias/stu1logn.htm.

Next, enter the folder where the study is located.

Make sure only the Allow Read Access, Allow Script Access, and Allow Execute Access options are checked.

After finishing the Virtual Directory Creation Wizard, the alias used appears in the list of items under Default Web Site. Right-click the alias and select Properties.

To verify that SSI Web scripts will run correctly, check that Permissions is set to Execute (including script), and click Configuration....

Click OK at the configuration window and OK at the virtual directory properties to return to the main IIS manager window.

Permissions must be set on the files so that they can be viewed on the Internet. To do this, right-click the stu1 folder in Windows Explorer (not IIS), and select Properties.

On the Security tab, click Permissions.

Find the entry for Everyone, and if not already set, set the permission to Full Control. Click OK to close the permissions window.