4 March 2011

       Installing dSurvey

dSurvey is distributed in a .ZIP file
 
 For installing under the SREhttp/2 webserver (for OS/2 or ECS): a name like dsvySRE_5March2011.zip
 For installing under a WAMP server: a name like dsvyWAMP_5March2011.zip

 Note: for more information on  WAMP (Windows/Apache/MySql/PHP), see http://www.wampserver.com/ 
 In the remainder of this documentation, we assume you understand how to work with mysql.

To install dSurvey, you must unzip this .ZIP file, and make sure you maintain the
file structure captured in the .ZIP file.

dSurvey will be installed on a web server.  In particular, in a "web accessible"
subdirectory of the web server.

For simplicity sake, let's assume that the "root" directory for the web server is
D:\www. Thus, an http request for /dsurvey/docs/helpme.htm would point to D:\www\dsurvey\docs\helpme.htm
Obviously, if this "root" directory is not D:\WWW, the appropriate substiutions should
be made in the following instructions.

Instructions

1) Under D:\WWW, create a DSURVEY directory.
2) Copy the dSurvey distribution file to D:\WWW\DSURVEY
3) UnZip this distribution file

  The following directories will be created (under D:\WWW\DSURVEY)

        ADMINS   : html files used to administer dSurvey (and php scripts)
        CLIENT   : html files (and php scripts) used by survey participants
         DATA    : a root directory:  used to store session-specific temporary data files 
          DOCS   : contains documentation files (such as these installation notes)
         IMAGES  : graphics files used by dSurvey
     INSTRUMENTS : a root directory:  used to store module files, and parameter files, for survey instruments
          LIB    : contains javascript libraries
          PINFO  : a root directory:  used to store session specific "client accessible" files
        SESSIONS : a root directory: used to store sesson specific parameter files, and session specific submitted data
         TOOLS   : contains useful utilities

      SREHTTP2  : used for server-side scripts for the SREhttp/2 web server (this is NOT used if you run WAMP)

     Note: the "root" directories will have subdirectories added to them as instruments are added, or as new sessions are generated.

    The only directory that the typical survey designer will change is INSTRUMENTS. 
    See the READ.ME in the INSTRUMENTS directory for   further details.

                  

4) Copy web server specific scripts to the web-servers "script" directory

   * For the SREhttp/2 web server
        
        i) Create a DSURVEY directory in the ADDON directory of SREhttp/2. 
                      For example, D:\SRE2003\SREHTTP2\ADDON\DSURVEY
        ii) Copy the contents of the SREHTTP2 directory to this ADDON\DSURVEY directory.
        iii) Optional. To enable the Email feature of dSurvey, you will need to set some
             parameters in the D:\SRE2003\SREHTTP2\ADDON\DSURVEY\SMTPPARAMS.TXT file -- the file
             contains a description of these parameters.
                The easiest way to do this is with  /dsurvey/tools/emailTest.htm 

   * For the WAMP server
       i) You will need to create a user in mysql
                username: dsurveyAdmin
                password: admin
          For example, you can use mysqladmin -u dsurveyAdmin -padmin

        ii) Optional. To enable the Email feature of dSurvey, you will need to set some
             parameters in the dsurveySMTP mysql database.
             The easiest way to do this is with  /dsurvey/tools/emailTest.htm 
         

That is it!  You are now ready to use dSurvey. You can start by pointing your browser to:
         dsurvey/admin.htm

A note on security:
        dSurvey is NOT a highly secure software.  If you want to limit access, you should use your 
        web server's security protocols. /dsurvey/READ.ME contains details on what directories 
        should be accessible by whom.


