Footy Tipping Software

Interface & Web Front-end 

Installation instructions for Windows:

PLEASE PLEASE PLEASE print this page for further reference.

If you are using the web hosting service provided by us then these instructions
are not for you. You should follow the instructions sent by us when your 
website is set up.

Skip steps 1 & 2 if you already have a web server with Perl installed. 

1. Install web server software:

   * On Windows 2000, IIS 5.0 or later (included in Windows 2000 Install).
   * on Windows NT 4.0, IIS 4.0 or later.

2. Install ActivePerl (we currently recommend 5.6.1 or above) from ActiveState
   (www.activestate.com). It's free.
   Allow the installation to alter your autoexec.bat, and to
   register .pl with your web server (ie take all the defaults)

3. Check to make sure that you have a Scripts folder or equivalent set up and that 
   it is enabled to run scripts and executables.

   To add a Scripts folder, In Internet Information Services Manager right click on the 
   website you are going to run the Web Front End in, click on Add Application. Set the 
   Alias to Scripts, and set the folder to c:\inetpub\Scripts (for a default install into 
   the default web server). Remember this path as you will be asked for it during the 
   installation process. Make sure that you allow Scripts AND Executables to be able to 
   run.

4. Make sure that the .pl extension is mapped to the perl.exe executable. 

   Please note: The scripts are not designed to work with PerlIS (or any other ISAPI based 
   perl) nor FastCGI or equivalents.

   IIS 6 and below:
   ----------------
   4.1 Right click on the Scripts folder you created in step 3 above, choose Properties.
   
   4.2 On the Virtual Directory tab, click on Configure (if there isn't a Configure button, 
       click on Create, then click on Configure when it appears). 
      
   4.3 You should see the .pl extension listed on the Mappings tab. If it isn't, click add. 
       In the path box, type the following:

         c:\perl\bin\perl.exe "%s" %s

       If you haven't installed perl in the default location, then you will have to 
       amend this for your installation.

       For the extension, enter .pl

   4.4 Click OK, then OK, and again.

   4.5 For IIS 6, you may also need to set up a Web Service Exception. Click on Web 
       Service Extensions in the tree on the left. Check to make sure that there is an 
       extension for Perl CGI (or something similar). If there isn't one, add one, call 
       it PerlCGI, add the perl executable WITH EXACTLY THE SAME PATH AND PARAMETERS 
       AS IS IN THE EXTENSION MAPPING.

   IIS 7 and above:
   ----------------
   4.1 Make sure that the CGI components are installed for IIS. Installing this is 
       different on different operating systems, please check your server documentation 
       or the interwebs for more information.

   4.2 In the Internet Information Services Manager (which can be found in administrative 
       tools), find the scripts folder that you are going to install the Web Front End into.
       This is the same folder you set up in step 3. Click on it.
   
   4.3 In the centre pane, double click on the icon called Handler Mappings. Check if 
       *.pl is in the list, and if it is, make sure it's enabled. If it isn't, add it 
       by clicking on Add Script Map in the Actions pane on the right hand side. In 
       Request Path, put *.pl, and add the following text to Executable:

         C:\Perl\bin\perl.exe "%s" %s

   4.4 Click OK. Make sure you click Yes when asked if you want to enable the mapping.

5. Copy the FTS distribution file called FTS-2026.31.zip
   (you'll find it in a sub-directory called FILES under
   the Footy directory on your PC) into a working directory (eg. C:\temp)
   on your server and unpack it by right clicking on the file and choosing
   extract all, or if you are using WinZip then ENSURE you tell it to
   "Use Folder Names".

6. Double click on install.pl in the FTS-2026.31 folder,
   (which will be created when you unzip the files)
   and then answer the questions. The install program
   will suggest likely answers and ask you to confirm or not.
   If the suggestion is correct, type "Y" and press 'Enter'.
   If you need to change it, type "n" and type in the answer
   you want before pressing 'Enter'. PLEASE NOTE that answers  
   2 & 4 require leading forward-slashes ("/") 
   
   You will be asked:
   
   1.  The full local path to the html directory on the web server?

      This is often 'c:\inetpub\wwwroot'

      This is the _full_local_path_ to the html directory on your 
      web server. Another example is:

         d:\inetpub\virtual-server-name\


   2. Directory for scripts on your web server, as seen from a web browser?

      This is often '/Scripts'.

      It is the scripts directory as it would be seen from a 
      web browser, here is an some example:

        If your URL looks like:

            http://www.xyz.com.au/scripts/script.cgi

        then answer the question with:

            /scripts


   3. The full local path to the CGI or Scripts directory on the web server?
      
      This is often 'c:\inetpub\Scripts'

      This is the _full_local_path_ to the scripts directory on your 
      web server. Another example is:

         d:\inetpub\virtual-web-server\Scripts



   4. Directory under html & script directories for your competition (eg /tipping)? 

     This is the directory that the perl scripts and html files will be 
      copied into.

      This will end up being the name of the directory appended to 
      the answer in questions 1, 2 and 3. So if you put '/tipping' 
      in here, you would end up with something like this:

         URL for the comp:

            http://www.xyz.com.au/tipping/index.htm

         URL for the competitors page:

            http://www.xyz.com.au/Scripts/tipping/tippers.pl

         directory created for the html:
  
            c:\inetpub\wwwroot\tipping\

         directory created for the scripts:

            c:\inetpub\Scripts\tipping\

7. Go to www.(YourWebAddressHere)/(YourDirectory)/index.htm 
   on your web server, you should see the main page for your
   FTS web site. 

   We suggest you click on the link and visit the Administration
   page. Either 'bookmark' or note the address of the
   Administration page, as there is no other link to it
   from the web pages. You will only require the Admin page
   if there are problems with automatic uploading of files
   using the Web Interface that has been installed on your PC.

   You can check to see if the file system permissions are set correctly
   for the software to work correctly by clicking on the "Check Script 
   Permissions" link on this page.

8. Set the file system permissions for the folders that the scripts and 
   other files are installed in.
   
   These permissions are to be set for the IUSR_<machinename> account, 
   which is the default anonymous web user. On IIS 7 and above, this may 
   be just IUSR.
   
   DO NOT JUST ALLOW THE "Everyone" GROUP "Full Control", IT WILL NOT 
   WORK!

   c:\inetpub\scripts\tipping       Read
                                    Read/Execute

   c:\inetpub\scripts\tipping\data  Read
                                    Write

   c:\inetpub\scripts\tipping\style Read
                                    Write

   c:\inetpub\wwwroot\tipping       Read
   (and all it's sub folders)       Write

   You may need to turn off inherited permissions from parent folders for 
   the data and style directories.

   You can check the permissions are correct by clicking on the "Check Script 
   Permissions" link on the admin page, as noted above.

9. You will then need to run the Web Interface (webfooty.exe)
   on your PC to create the data file (upload.dat) for
   uploading to the Web. See the Web Interface help file for
   further details.

If you have problems with getting the scripts working after 
following these instructions, please refer to our Web Font
End Frequently Asked Questions Page at:

  http://www.footy.com.au/fts/faq_webfooty.htm

These installation instructions set up the scripts on a 
standard web server. If your web server works differently, 
or you want the directories to be layed out in a specific way, 
please contact us for advice. Please note though, that we
cannot guarantee that the scripts will work in all 
environments.

This file (ReadMe_Windows.txt) has also been placed in your
Footy directory for your future reference.
