9 August 2011

       Installing dSurvey (WAMP version)

dSurvey is distributed in a .ZIP file

 For installing under a WAMP server: a name like dsvyWAMP_26June2011.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.
 Or, you can see docs\readme_mysql.txt for hints on setting up 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 .zip 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


    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 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

             For notes on using the PEAR email package (useful if your SMTP server requires
             authentication), see /dsurvey/docs/pear_email.txt


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.


