Automated Windows Installer

DWsurvey has a Windows installer as a downloadable option. This isn't just for Windows servers but it designed for you to download to your Windows client and then either install to a local location (if, for instance, you were downloading directly to a Windows server) or it can install DWsurvey to any other server remotely. This means that the Windows installer can be used to install DWmail to any webserver supporting any other operating system remotely from a Windows system.

You can download the automated installer from our Member's Download area to your Windows machine. This is a .EXE executable file.

Before running the installer you will need the following information available to you:

Once you have downloaded this file to your computer, run the executable file called dwsurvey.exe. If you are using Windows Vista and have User Account Control (UAC) enabled you will be asked to authenticate with an Administrator's account.

The first screen you see above is simply a welcome screen. Click on the NEXT> button.

Screen 2 is the DWsurvey license agreement. You cannot install the software until you accept the license agreement. Select the I accept the agreement box and click on the NEXT> button.

There are now two choices. The first is to install DWsurvey on a remote server, this does so via the FTP protocol. The other option is to install to your current machine. If the computer you are actually installing to is actually the server you'll be serving your surveys from then select the second option or you have access to it through a shared network drive.

Make your choice and press NEXT>. We will be talking from here onwards about the first option, to Install to a remote machine.

Here is where you need to enter your FTP connection details. Any field values should be set appropriately for your own installation as explained below

The installer uses FTP to upload the application to your server. The FTP login group of fields are details of your FTP connection to allow the installer to connect to the server. Enter in FTP server address the name of the server (the FTP host), for example ftp.domain.com, or else the IP address of the server if you have that information. Enter the FTP username and FTP password for your account on this host.

The Install location on FTP server is an important group as this determines where DWsurvey will be installed. By default the installer will install DWsurvey to a directory called dwsurvey in the default folder the FTP connects to, the FTP root. You can change firstly the name of the installation folder by clicking on the Change button.

You can also change the folder you wish to create the dwsurvey installation folder in. For example if your FTP server connects you to a root folder but all of your web pages have to be in a sub-folder from that called httpdocs you can enter httpdocs in the Create install folder in field or click on the Browse button.

This will pop-up a box which will connect to your server and list the available folders, you can then select the folder you wish to install to and click OK. In this example we are going to select httpdocs

Once you have entered your information click on the NEXT> button

The installer will now make a connection and run some checks on your server as to what it needs to upload.

The installer will next ask you for a the URL that corresponds with the install location. Note you do not need to add the install folder (default dwsurvey) to this location. By default this would simply be the domain name to your server (and any sub directories you selected as the install location).

For instance, if you entered the following on the FTP Settings page:

FTP Server Address: domain.com
Package Install Folder: httpdocs/

and also suppose there is a file example.html with FTP URL:

ftp://domain.com/httpdocs/example.html

You should enter as the Install location URL the full URL value you would type into a web browser address bar in order to view the file example.txt, and then remove the name example.txt from the end. The result might be something like:

http://domain.com/

Click on the NEXT> button to continue.

The installer will now test the capabilities of your server for the easiest transfer method.

A summary screen will be displayed before any files are uploaded.

Check you have entered the correct server settings, then click the Install button on the installer to start the file transfer, or click <Back to modify settings on previous pages.

This screenshot shows a remote transfer taking place. Once completed, the installer wizard will automatically advance to the final page. You can abort the installation at any time by clicking the Cancel button.

This page is reached once the installation has completed. If you wish to read the DWsurvey readme file, check the View Readme checkbox to view the file.

Before you can proceed to actually using DWsurvey you will need to configure it's database settings. Make sure the Run Configuration Tool checkbox is ticked and click on the Finish button. If you choose not to run the configuration tool at this time, then you can run it by relauching the installer, and choosing the Configure option on the Start page.

When you click on Finish two things will happen, the configuration tool will appear and the DWsurvey guided setup will automatically run in your browser. You MUST run the configuration tool first to enter your database details.

Only one file needs configuring and that is config.inc.php from the includes directory. To configure this file, double-click on the name of the file. A simple text editor will open, you can make necessary modifications, then click OK to close the editor. To commit the changes to the server click the Apply button.

As soon as you press the Apply button, the installer will copy the configuration to the server and launch the database initalization page in your default web browser. You can now follow the install notes for that from the database option on the help>install menu.

The Configuration Tool can be run at any time by launching the dwsurvey.exe that was used initially to install the application, and selecting the Configure option.