Sawtooth Software: The Survey Software of Choice

Certain permissions need to be set for SSI Web to work properly on your web server. Perl needs to be installed on the server and the Perl scripts (ciwweb.pl and admin.pl) need permission to execute. 

Unix file permissions can be set through an FTP program such as FileZilla (see above). In FileZilla right-click the file or folder and then select "File permissions". In the table below, all the files and folders necessary for SSI Web to run are explained. The Unix permissions that need to be set are also shown. "STUDYNAME" is used to represent the name of your study.

File / Directory Description Unix Permissions* 
   login.html Login page. Entry point for respondents. 644    r w _ |r _ _ | r _ _
   admin.html Admin Module login page. Entry point for study administrators. 644    r w _ |r _ _ | r _ _
admin Folder or directory. 703    r w x | _ _ _ | _ w x
   STUDYNAME_qst.cgi Main web questionnaire file. 644    r w _ |r _ _ | r _ _
   STUDYNAME_path.cgi Contains server path information. 644    r w _ |r _ _ | r _ _
   STUDYNAME_config.cgi
    (see security section below)
Contains Admin Module passwords. 644    r w _ |r _ _ | r _ _
   ** STUDYNAME_CBC[exerciseID]_[designID].cgi Design file for CBC/Web studies. 644    r w _ |r _ _ | r _ _
   *** STUDYNAME_MXD[exerciseID]_[designID].cgi Design file for MaxDiff/Web studies. 644    r w _ |r _ _ | r _ _
   db_setup Folder containing database setup files. 707    r w x | _ _ _ | r w x
   STUDYNAME_questionnaire.cgi Main web questionnaire file used for setup. 644    r w _ |r _ _ | r _ _
   STUDYNAME_layout.cgi Contains all data fields. Used to set up data base data tables. 644    r w _ |r _ _ | r _ _
   STUDYNAME_pwds.cgi Respondent password file used to set up the database password table. 644    r w _ |r _ _ | r _ _
cgi-bin Folder or directory that contains all of the Perl files. 701    x x x | _ _ _ | _ _ x
   ciwweb.pl   755    r w x | r _ x | r _ x
   admin.pl   755    r w x | r _ x | r _ x
   ciwlibXXX.pl   644    r w _ |r _ _ | r _ _
   authlibXXX.pl   644    r w _ |r _ _ | r _ _
   pverlibXXX.pl   644    r w _ |r _ _ | r _ _
   grdlibXXX.pl   644    r w _ |r _ _ | r _ _
   enterlibXXX.pl   644    r w _ |r _ _ | r _ _
   acalibXXX.pl   644    r w _ |r _ _ | r _ _
   cbclibXXX.pl   644    r w _ |r _ _ | r _ _
   cvalibXXX.pl   644    r w _ |r _ _ | r _ _
   maxdifflibXXX.pl   644    r w _ |r _ _ | r _ _
   acbclibXXX.pl   644    r w _ |r _ _ | r _ _
graphics Folder or directory that contains all the graphics in your study. 707    r w x | _ _ _ | r w x
   system Folder containing supporting files. 707    r w x | _ _ _ | r w x
   ssi_javascriptX_X_X.js SSI Web Javascript library 644    r w _ |r _ _ | r _ _
   ssi_styleX_X_X.css Base style sheet 644    r w _ |r _ _ | r _ _
   ssi_admin_styleX_X_X.css Style sheet for Admin Module 644    r w _ |r _ _ | r _ _
   jquery-X.X.X.min.js Javascript library 644    r w _ |r _ _ | r _ _

* Unix Permission Notation - The notation consists of three sets of the letters r, w, and x. The letter "r" stands for "read", "w" for "Write" and "x" for "Execute." The first set of letters is for the Unix group "Owner", the second for "Group", and the third for "Other." So the full permissions of r w x | r w x | r w x or 777 give "read", "write", and "execute" permissions to "Owner", "Group", and "Other." 

** Only for CBC/Web studies 

*** Only for MaxDiff/Web studies

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). Then make sure to log into the Admin Module and click "Apply Changes" so that your changes will be applied to the database.

If you are getting errors see the Common Mistakes section below.