May 2017

       Installing wSurvey (WAMP version)

  wSurvey is distributed in a .ZIP file -- typically with a name like wsurvey__25may2017.zip

 wSurvey is designed for useg under a WAMP server. So we assume you have wamp up and running.
 However, it also runs under other flavors, such LAMP!

 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, see wsurvey/install/ or help on setting up mySql.

To install wSurvey, you must unzip this .ZIP file, and make sure you maintain
the file structure captured in the .ZIP file. PAY ATTENTION TO STEP 3 IN THE INSTRUCTIONS BELOW!

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

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

Instructions

1) Under D:\WAMP\WWW, create a wsurvey directory.
2) Copy the wSurvey distribution .zip file to D:\WAMP\WWW\wsurvey
3) unZip this distribution file --
    CAUTION! 
       Make sure it unzips directly into D:\WAMP\WWW\wsurvey\
       and NOT into something like D:\WAMP\WWW\wsurvey\wsurvey__27May2017\ --
       Note that placing into such a subdirectory is the default of the zip extract that 
       comes with windows, so don't just accept such a default!

4) Several wSurvey applications use mysql.
   Thus, we recommend creating the following user in mysql
                username: wsurveyAdmin
                password: admin

   If you are not proficient at mysql, plese read the instructions in
   install/readme_mysql.txt

5)  Optional. To enable the Email features of wSurvey (such as the wsEmail 
    application), you  need to use swiftMailer (http://swiftmailer.org/),
    or install the PEAR package.

      Since PHP native email does not support authentication, and since
      almost all SMTP servers require authentication, wSurvey uses functions
      in either swiftEmailer or in the PEAR libraries.

    As of December 2015, wSurvey comes with a small version of swiftEmailer
    installed (under publicLib/swift -- see the README file for details).

           We recommend using Swift Mailers instead of Pear!

    However, if you want you can use Pear (it has somewhat richer
    status reporting) -- you will have to download the wsurvey_other zip file, and look in the pearStuff directory
    (installing PEAR is a bit tedious: for complete instructions see  pear_install.txt).


That is it!  You are now ready to use wSurvey, including the several applications built for it.

A note on security:
        wSurvey is NOT highly secure software.
        If you want to limit access, you should use your web server's
        security protocols.

A note on storing large records in mysql

    mysql uses a few parameters to limit the size of records transferred, hence the size
    of records stored.
    In particular, the max_allowed_packet parameter (usually in the my.ini
    somewhere under the mysql directory) may be not large (i.e.; about 1M).
    This can cause problems. For example, wsEmail will not be able to download
    emails with large attachments, if these attachments are larger than
    If this could be an issue, you should change this max_allowed_packet
    parameter.


A note on installing under Windows 10
   On the off chance you can't get WAMP to install under Windows 10, and you ended up looking here:
   the problem might be due to the IIS server being automatically run.
   
   You can disable this by:
     a) Open a command prompt (you might have to open it as an administrator) , and run  services.msc
     b) scroll down to the World Wide Publishing Service Properties (local computer) row
     c) In the Startup type box, select disabled
     d) Hit apply
     
  To immediately kill IIS, from a command prompt that you open as an administrator, enter:
      iisreset /stop


Daniel Hellerstein
danielh@crosslink.net

Note: wSurvey is distributed under the GPL license (see GPL.TXT). 
     That means it is free to use.
     It also means the authors/distributors/etc of wSurvey (and related applications) are
     NOT responsible for any consequences from the use of this software.