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.