• Create Files to Upload to Server
• Installing Perl
• Configuring IIS
  • Using IIS 6.0 (Windows Server 2003)
  • Using IIS 5.0 (Windows 2000 Server)
  • Using IIS 4.0 (Windows NT 4.0 Server)
• Uploading Files and Folders
• Security

• Alternate Configuration - Common cgi-bin for all Studies
• Trouble Shooting - Common Mistakes

Prepare for Web Upload assembles the files required to run the web survey. It places these files in a "Web Upload" folder inside the study folder. These files are later uploaded to the web server.

Active State provides a free version of their ActivePerl interpreter at http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl. Both ActivePerl 5.8.4 and 5.6.1 are supported. We recommend the "MSI" version.

When installing ActivePerl, we recommend accepting all of the defaults.

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

Make sure the following options are checked:

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.

For example, if the SSI Web study were called "stu1", a folder could be created in the wwwroot folder named "stu1".

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/mystudy/stu1logn.htm.

Next, enter the path to the folder where the study is located. This is the study root folder that was created in a previous step.

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

After finishing the Virtual Directory Creaton 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" says "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.

Permissions must be set on the files so that they can be viewed on the Internet. To do this, right-click 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.

** Only for MaxDiff/Web studies

The default configuration has a cgi-bin folder for each study. Some ISPs do not allow this. For configurations other than the default, see the Alternate Configuration section.

The contents of the Web Upload folder are usually uploaded to the web server via FTP (File Transfer Protocol). FTP is a method which transfers (uploads) files from your local PC to the web server on the Internet. To FTP your files, you need an FTP program. We recommend WS_FTP (http://www.ipswitch.com)

When uploading files to the web server it is essential that you upload in binary mode. Binary mode ensures that the file is not changed in any way during the upload process. The size (number of bytes) of all files should be the same on the web server as they are on your local PC.

At this point, if you have uploaded the files and folders and set permissions correctly, your survey should be working. Go to STUDYNAMElogn.htm on your web site and test your survey making sure the study behaves as expected and that it is saving data. Remember to log into the Administrative Module through STUDYNAMEadmn.htm to see your results and download your data.

If you are getting errors see Trouble Shooting - Common Mistakes

1. Upload all of the SSI Web Perl files (*.pl) to the location where they have permission to execute (the "common cgi-bin").
2. In the authoring interface of SSI Web, go to File | Settings | Advanced Settings. Modify the default paths to account for the new location of the Perl scripts. The following list describes the Server Directory Paths that need to be modified:
   • Administrative Directory: Path from the Perl scripts to the admin directory.
   • CGI Scripts Directory: Path from STUDYNAMElogn.htm to the Perl scripts.
   • Data Directory: Path from the Perl scripts to the data directory.
   • Relative Path from CGI Scripts to Graphics: Path from the Perl scripts to the graphics directory.
   • Relative Path from logn.htm to Graphics: Path from STUDYNAMElogn.htm to the graphics directory.

These changes are stored in the STUDYNAMEpath.cgi, STUDYNAMElogn.htm, and STUDYNAMEadmn.htm files. The notation "../" means go up one directory.

For example, given the directory structure:

	
\cgi-bin
	ciwweb.pl
	admin.pl
	(etc.)
\htdocs
	\study1
		\admin
		\data
		\graphics
		STUDYNAMElogn.htm
		STUDYNAMEadmn.htm

the alternate paths are:
• Administrative Directory:   ../htdocs/study1/admin/
• CGI Scripts Directory:   ../../cgi-bin/
• Data Directory:   ../htdocs/study1/data/
• Relative Path from CGI Scripts to Graphics:   ../htdocs/study1/graphics/
• Relative Path from logn.htm to Graphics:   graphics/


3. Remove STUDYNAMEpath.cgi from the admin directory. Upload the STUDYNAMEpath.cgi, with the modified path information, to the "common cgi-bin" directory next to the Perl scripts.