The "Freeola Customer Forum" forum, which includes Retro Game Reviews, has been archived and is now read-only. You cannot post here or create a new thread or review on this forum.
Please remember for CGI to work you must first request CGI to be enabled with an email to [email protected]
Thank you for your enquiry regarding CGI scripts at Freeola.
Contents: A brief description of CGI
Script settings for CGI at Freeola
Sending your script to Freeola
Setting Permissions for your script on Freeola's servers
A brief description of CGI
CGI stands for Common Gateway Interface
It allows you to run a script on the Freeola internet servers which can perform tasks that are not available in HTML. For example hit counters, guestbooks and random image displays to name but a few.
Freeola's servers currently support any Perl CGI Scripts that do not require SSI (Server Side Includes)to be enabled.
CGI scripts are simply text or ASCII files which are 'compiled on the fly' (a program on the server rather than the browser)by the Perl interpreter. They can be edited or created on any text editor and must be saved with a cgi File Extension.
=
Script settings for CGI at Freeola
To run your script at Freeola there are a few configuration settings for your script which must be changed or added inside the script these are:
PATH TO PERL:
In the VERY first line of your CGI script the path to perl must be defined, the path to perl must read #!/usr/bin/perl NB this must be on the VERY first line or the script will not work.
Some or all of the following settings may be required by your script. If you have downloaded a 3rd party script, there may be comments within the script to tell you where to place them instructions could also be within any text files which accompany the script.
PATH TO SENDMAIL:
For Sending mail from your script: /usr/sbin/sendmail
FULL SERVER PATH TO WEBSPACE ROOT DIRECTORY:
This depends on your Connection User I the last 2 numbers form part of the path eg:
for sr0011223 the path is /freeola/users/3/2/sr0011223 and
for sr0024658 the path is /freeola/users/8/5/sr0024658
FULL URL FOR WEBSPACE:
your web address eg: www.john.spursfans.co.uk
FULL URL TO CGI SCRIPT:
Your web address with /cgi-bin/ added to the end eg: www.john.spursfans.co.uk/cgi-bin/
FULL URL TO TEMPORARY FILE:
This is probably the directory you wish to send information from your script to
Your web address plus a temporary file name eg:
www.john.spursfans.co.uk/tempfile/
E-MAIL ADDRESS:
The e-mail address which you would like your script to send e-mails to (the @ sign in the email address should be preceded by a \). For example [email protected] would be john\@spursfans.co.uk (this is only needed for e-mail addresses written in the script).
Sending your script to Freeola
Once your script has been setup you will need to send it to your website via FTP. It must be placed within your CGI directory 'cgi-shl' otherwise it will not work. The file MUST be transferred in Text or ASCII mode and NOT in Automatic or Binary mode.
Setting Permissions for your script on Freeola's servers
Now that your script is on the server you need to set the 'Permissions' for the script using your FTP software. This is the way that you open access to the script for people accesssing the website. A lot of care is needed for this procedure as setting the wrong permissions can deny access to the script, even making it impossible for you to read alter or delete the script.
In your FTP software there should be a link for 'Set Permissions' or CHMOD (if you cannot find this link you may have to use a different FTP program). There are two ways to change permissions for a file. The first is to enter a number which will identify the permissions for the file. ALL scripts in the cgi-shl directory should be set to CHMOD 755.
The other way of setting permissions is when you are presented with a table with read, write and execute across the top and owner, group and public down the side. The settings should look something like this:
Read Write Execute
Owner On On On
Group On Off On
Public On Off On
In some FTP software programs the On may be exchanged for ticks or crosses and the off for o's.
The HTML file which calls your CGI script should be uploaded to your 'htdocs' directory.
If your script outputs information to or creates a file or a web page the file or page must be stored in a sub-directory of the htdocs directory. Create the sub-directory using your FTP software. Using CHMOD again set permissions for the directory and any file within it to 770:
Read Write Execute
Owner On On On
Group On On On
Public Off Off Off
This information should help you to get most scripts running at Freeola. Freeola support cannot howecer offer individual support for any CGI scripts.
Yours Faithfully,
Freeola Customer Support
Please remember for CGI to work you must first request CGI to be enabled with an email to [email protected]
Thank you for your enquiry regarding CGI scripts at Freeola.
Contents: A brief description of CGI
Script settings for CGI at Freeola
Sending your script to Freeola
Setting Permissions for your script on Freeola's servers
A brief description of CGI
CGI stands for Common Gateway Interface
It allows you to run a script on the Freeola internet servers which can perform tasks that are not available in HTML. For example hit counters, guestbooks and random image displays to name but a few.
Freeola's servers currently support any Perl CGI Scripts that do not require SSI (Server Side Includes)to be enabled.
CGI scripts are simply text or ASCII files which are 'compiled on the fly' (a program on the server rather than the browser)by the Perl interpreter. They can be edited or created on any text editor and must be saved with a cgi File Extension.
=
Script settings for CGI at Freeola
To run your script at Freeola there are a few configuration settings for your script which must be changed or added inside the script these are:
PATH TO PERL:
In the VERY first line of your CGI script the path to perl must be defined, the path to perl must read #!/usr/bin/perl NB this must be on the VERY first line or the script will not work.
Some or all of the following settings may be required by your script. If you have downloaded a 3rd party script, there may be comments within the script to tell you where to place them instructions could also be within any text files which accompany the script.
PATH TO SENDMAIL:
For Sending mail from your script: /usr/sbin/sendmail
FULL SERVER PATH TO WEBSPACE ROOT DIRECTORY:
This depends on your Connection User I the last 2 numbers form part of the path eg:
for sr0011223 the path is /freeola/users/3/2/sr0011223 and
for sr0024658 the path is /freeola/users/8/5/sr0024658
FULL URL FOR WEBSPACE:
your web address eg: www.john.spursfans.co.uk
FULL URL TO CGI SCRIPT:
Your web address with /cgi-bin/ added to the end eg: www.john.spursfans.co.uk/cgi-bin/
FULL URL TO TEMPORARY FILE:
This is probably the directory you wish to send information from your script to
Your web address plus a temporary file name eg:
www.john.spursfans.co.uk/tempfile/
E-MAIL ADDRESS:
The e-mail address which you would like your script to send e-mails to (the @ sign in the email address should be preceded by a \). For example [email protected] would be john\@spursfans.co.uk (this is only needed for e-mail addresses written in the script).
Sending your script to Freeola
Once your script has been setup you will need to send it to your website via FTP. It must be placed within your CGI directory 'cgi-shl' otherwise it will not work. The file MUST be transferred in Text or ASCII mode and NOT in Automatic or Binary mode.
Setting Permissions for your script on Freeola's servers
Now that your script is on the server you need to set the 'Permissions' for the script using your FTP software. This is the way that you open access to the script for people accesssing the website. A lot of care is needed for this procedure as setting the wrong permissions can deny access to the script, even making it impossible for you to read alter or delete the script.
In your FTP software there should be a link for 'Set Permissions' or CHMOD (if you cannot find this link you may have to use a different FTP program). There are two ways to change permissions for a file. The first is to enter a number which will identify the permissions for the file. ALL scripts in the cgi-shl directory should be set to CHMOD 755.
The other way of setting permissions is when you are presented with a table with read, write and execute across the top and owner, group and public down the side. The settings should look something like this:
Read Write Execute
Owner On On On
Group On Off On
Public On Off On
In some FTP software programs the On may be exchanged for ticks or crosses and the off for o's.
The HTML file which calls your CGI script should be uploaded to your 'htdocs' directory.
If your script outputs information to or creates a file or a web page the file or page must be stored in a sub-directory of the htdocs directory. Create the sub-directory using your FTP software. Using CHMOD again set permissions for the directory and any file within it to 770:
Read Write Execute
Owner On On On
Group On On On
Public Off Off Off
This information should help you to get most scripts running at Freeola. Freeola support cannot howecer offer individual support for any CGI scripts.
Yours Faithfully,
Freeola Customer Support