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_styleX_X_X.css||Base style sheet|
|ssi_admin_styleX_X_X.css||Style sheet for Admin Module|
* 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 (http://filezilla-project.org/download.php)
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.