Sawtooth Software: The Survey Software of Choice

SSI Web survey authors install SSI Web on their local PC. When they are finished creating a survey, they click Field | Web Server Management.... From this dialog they can enter Database and FTP settings. From there SSI Web will upload and set up the study on the web server.

It is also possible to manually upload your survey files by going to Field | Prepare for Manual Upload.

Prepare for Manual Upload assembles the files required to run the web survey. It places these files in a "Web Upload" folder inside the study folder (your study folder can be viewed via Windows Explorer by clicking the "yellow folder" icon). These files are later uploaded to the web server by using FTP software.

The files and folders created in the Web Upload folder now must be set up and configured on your web server. The following table describes the contents of the Web Upload folder.

File / Directory Description
   login.html Login page. Entry point for respondents.
   admin.html Admin Module login page. Entry point for study administrators.
admin Folder or directory.
   STUDYNAME_qst.cgi Main web questionnaire file.
   STUDYNAME_path.cgi Contains server path information.
   STUDYNAME_config.cgi  (see security section below) Contains Admin Module passwords.
   * STUDYNAME_CBC[exerciseID]_[designID].cgi Design file for CBC/Web studies.
   ** STUDYNAME_MXD[exerciseID]_[designID].cgi Desgin file for MaxDiff/Web studies.
   db_setup Folder containing database setup files.
   STUDYNAME_questionnaire.cgi Main web questionnaire file used for setup.
   STUDYNAME_pwds.cgi Respondent password file used to set up the database password table.
cgi-bin Folder or directory that contains all of the Perl files.  
graphics Folder or directory that contains all the graphics in your study.
   system Folder containing supporting files.
   ssi_javascriptX_X_X.js SSI Web Javascript library
   ssi_styleX_X_X.css Base style sheet
   ssi_admin_styleX_X_X.css Style sheet for Admin Module
   jquery-X.X.X.min.js Javascript library

* Only for CBC/Web studies
** 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 theAlternate 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 FileZilla (

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.

Set Up Database

After the files have been uploaded it is critical that you now log into the Admin Module through admin.html. SSI Web will create the necessary database tables the first time you log into the Admin Module. Your survey should now be working. Go to login.html on your web site and test your survey making sure the study behaves as expected and that it is saving data. Remember to return to the Admin Module through admin.html to see your results and download your data. If you need to make changes re-upload the study files (usually just the contents of the db_setup folder) and make sure to log into the Admin Module and click Apply Changes so that your changes will be applied to the database.