Web Scripts Installation Guide

This setup guide will help you through installing the Web Scripts on your web server if you are using the Web edition of our program.

A basic knowlege of administering your server is required to complete these steps. If you aren't familiar with web servers, please find someone to help through this guide.

If you have problems with this installation, please contact Footy Tipping Software for support. Please note though, that if the problem is with the web server, and not with the scripts, this support may be billed.

NOTE: 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.

There are two sections to this guide:

Installation on a Windows web server

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

  1. Install web server software. IIS is available for free for instalionl on your Windows Server, and is included on your installation media. Please refer to your OS documentation for help.
  2. Install ActivePerl (we currently recommend 5.6.1 or above) from ActiveState (www.activestate.com). It's free. Allow the installation 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:

    1. Right click on the Scripts folder you created in step 3 above, choose Properties.
    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).
    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:

      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. Click OK, then OK, and again.
    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:

    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.

    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 above. Click on it.
    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:

    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-2017.23.zip 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".

    You'll find the FTS distribution file in either the data file directory of your competition or in the common user area of your computer. For instance, on Windows Vista, 7 and 8 look in either C:\Users\<username>\AppData\Roaming\Footy Tipping Software\Footy Tipping, C:\ProgramData\Footy Tipping Software\Footy Tipping or if you have installed to another drive (like a network drive), they will be in the same folder as the program.
  6. Double click on install.pl in the FTS-2017.23 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:

    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\

    This is often /Scripts.

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

    If your URL looks like:

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

    then answer the question with:

    /scripts

    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

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


    File/directory

    Owner

    <scripts>\tipping\

    Read & Execute 
    List Folder Contents
    Read

    <scripts>\tipping\data\ Read
    Write
    <scripts>\tipping\style\ Read
    Write
    <html>\tipping\ Read
    Write
    <html>\tipping\reports

    Read
    Write

    <html>\tipping\images

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

    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.

  9. You will then need to run Footy Tipping Software to synchonise your competition to the web. See the help on the Web Competition Connection tab in the options for more help.

Installation on a Unix/Linux web server

  1. Find out the Unix user name that your web server runs as.
  2. Ensure Perl5 (minimum 5.9.5) is installed - the latest version of Perl (5.16.2 as at 25.02.13) is available from http://www.perl.org
  3. Find out where the perl executable is. You can find it's location by using the following command:

    It is often /usr/bin/perl but can vary depending on version of Unix you use.

  4. Ensure a web server is installed.
  5. Copy the FTS distribution file called FTS-2017.23.tar.gz into a working directory on your server and unpack it with the command

    You'll find the FTS distribution file in either the data file directory of your competition or in the common user area of your computer. For instance, on Windows Vista, 7 and 8 look in either C:\Users\<username>\AppData\Roaming\Footy Tipping Software\Footy Tipping, C:\ProgramData\Footy Tipping Software\Footy Tipping or if you have installed to another drive (like a network drive), they will be in the same folder as the program.

  6. Change directories to the unpacked directory with:

    cd FTS-2017.23
  7. Become root, or the user name from #1 above.
  8. Run the install script:

    perl install.pl

    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 require leading forward-slashes (/)

    You will be asked:

    This is often /usr/local/apache/htdocs.

    This is the full local path to the html directory on your web server. Some other examples are:

    /home/httpd/html
    /usr/local/apache/htdocs/username/WWW

     

    This is often /cgi-bin. It is the cgi directory as it would be seen from a web browser, here are some examples:

    If your URL looks like:

    http://www.xyz.com.au/cgi-bin/script.cgi

    then answer the question with:

    /cgi-bin

    or if your URL looks like this:

    http://www.xyz.com.au/~username/cgi-bin/script.cgi

    then answer with:

    /~username/cgi-bin

     

    This is often /usr/local/apache/cgi-bin

    This is the full local path to the cgi directory on your web server. Some other examples are:

    /home/httpd/cgi-bin
    /usr/local/apache/htdocs/username/cgi-bin

     

    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 tippers page:

    http://www.xyz.com.au/cgi-bin/tipping/tippers.cgi

    directory created for the html:

    /usr/local/apache/htdocs/tipping/

    directory created for the scripts:

    /usr/local/apache/cgi-bin/tipping/

    As you found out in step 1 above. It is often nobody or www-data.

    As you found out in step 3 above. This is generally /usr/bin/perl.

  9. Go to (YourWebServerAddressHere)/(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.

  10. You will then need to run Footy Tipping Software to synchonise your competition to the web. See the help on the Web Competition Connection tab in the options for more help.

If you have problems with getting the scripts working after following these instructions, please refer to our Web 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 (WebScriptsInstallGuide.htm) has also been placed in your Footy data directory for your future reference, and is part of the help file. It is also available on the Footy Tipping software website.