Footy Tipping Software

Interface & Web Front-end 

Installation instructions for Unix:

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.

1. Find out the Unix user name that your web server runs as.

2. Ensure Perl5 (minimum 5.00404) is installed
   (latest version of Perl is available from
    http://www.perl.com ) 

3. Find out where the perl executable is. You can find
   it's location by using the following command:

     which perl

   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-2026.31.tar.gz
   (you'll find it in a sub-directory called FILES under
   the Footy directory on your PC) into a working directory
   on your server and unpack it with the command

        gunzip FTS-2026.31.tar.gz;  tar xvf FTS-2026.31.tar

6. Change directories to the unpacked directory with

	cd FTS-2026.31

7. Become root, or the user name from #1 above.

8. Run

	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:
   1.  The full local path to the html directory on the web server?

      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


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

      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

   3. The full local path to the CGI or Scripts directory on the web server?
      
      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


   4. Directory under html & cgi 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/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/

   5. User name that your web server runs as?
      
      As you found out in step 2 above.
      It is often 'nobody'

   6. The path to the perl executable?
      
      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 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_Unix.txt) has also been placed in your
Footy directory for your future reference.



