12/04/13 at 10:37am
This Codex is Read Only, there is No reason or requirement to Login to view any and all posts.
YaBB Support Codex
› Setup Perl
Setup Perl (Read 4465 times)
Please read the following web page to get additional information on how to setup Microsoft IIS server to run Perl scripts properly:
Setup Perl on Apache
Installing Perl (for Perl users)
Obviously if you are going to run Perl scripts on your computer you will need to install Perl. You can obtain a Windows version of Perl free of charge from ActiveState.
Install Perl on your computer according to the instructions given by the implementation you downloaded.
1. Running Perl Scripts in a CGI directory
You can configure Apache to treat any file in a particular directory as a CGI script. Typically, web hosts call such a directory the cgi-bin directory.
To configure Apache to treat a particular directory as your script directory, search for the following line in your "httpd.conf" file.
For those who have forgotten where the "httpd.conf" file can be found, try looking for it in the "conf" directory of your Apache folder. If you used the default directories supplied by the Apache installer, it would be "c:\Program Files\Apache Group\Apache\conf\httpd.conf".
ScriptAlias /cgi-bin/ "C:/Program Files/Apache Group/Apache/cgi-bin/"
If it has been commented out, that is, if there is a hash mark ("#") before the line, remove the hash character to enable it. If it has not been commented out, it means that your Apache is already configured to run CGI scripts in that directory. You can change the directory to another directory if you wish.
2. Running CGI scripts anywhere in your domain
If you don't want to be restricted to running CGI scripts within the ScriptAlias directory in your domain, and want CGI scripts to run anywhere in your domain, add the following line to your "httpd.conf" file.
AddHandler cgi-script .cgi
You can add it yourself manually, but since the default httpd.conf file that is supplied by Apache already comes with that line commented out, the simplest thing would be to search for that string in your existing file, and remove the preceding comment character, that is, remove the "#".
If you want the .pl extension recognised as a CGI script as well, simply append the extension to the list, as follows:
AddHandler cgi-script .cgi .pl
Next, search for the line that says "<Directory /> in the file. It should look something like this:
Add "+ExecCGI" to the options list. The line now looks like this:
Options FollowSymLinks +ExecCGI
3. Making a CGI Script Your Default Page
If you want to make your CGI script execute as the default page for a directory, you have to add another line to the Apache configuration file (httpd.conf). Simply search for the line in the file that begins with a "DirectoryIndex" and add "index.cgi" to the list of files on that line. For example, if the line used to be:
change it to
DirectoryIndex index.cgi index.html
The next time you access "http://localhost/" or "http://localhost/directory/" without any filename specified, Apache will run "index.cgi" if available or deliver "index.html" if it cannot find "index.cgi". If you have both "index.cgi" and "index.html" in the directory, "index.cgi" is used since it's listed first.
You are not limited to the above two files. For example, I have set up Apache on my computer with the following line:
DirectoryIndex index.php index.cgi index.shtml index.html
If you have also installed PHP support and enabled server side includes in Apache, the directive will instruct Apache to look first for an index.php file, or failing that an index.cgi file, or if that could not be found, an index.shtml file, and finally an index.html file if all else fails.
That's it. Your Apache server now supports the execution of CGI scripts. You will have to restart the server before the new configuration comes into effect. The work's not ended however - read on.
Modifying Your CGI Script
As it stands, if your CGI script is a Windows executable, it would be executed by Apache correctly. However, if it's a script that relies on an interpreter such as Perl or Python, you will have to modify the first line of the script.
Your Perl script will typically contain an initial line of
or some such thing. This tells a Unix-based kernel to look for an interpreter at the path "/usr/bin/perl" and invoke it to interpret the instructions in the file.
Since the script now runs on Windows, and it is unlikely that you installed your Perl interpreter in a /usr/bin directory, you will need to change that first line to point to the real location of your Perl interpreter.
For example, on my Windows box, I have to change the first line of my Perl scripts to:
Of course if you are using other scripting languages, you will have to set that initial line to point to whatever interpreter you are using.
It's Worth It
In my opinion, it's actually worth your while to install Apache, Perl, PHP and MySQL on your own computer. Testing your scripts offline allows you to work out the most obvious bugs and problems in a setting where you don't have to worry about bringing down the real web server or incurring ISP and telephone charges. It also allows you to work more efficiently, since you can simply edit your scripts on your computer to instantly fix problems while testing, without having to re-upload them before testing again. Of course, you will still have to test it when you actually put the script on your site.
compliments of thesitewizard - Christopher Heng
Top of this page
Forum Jump »
» 10 most recent Posts
» 10 most recent Topics
Frequently Asked Questions FAQ's
YaBB 3 Development
Windows Installation ««
Upgrading to YaBB 2.X
Setting up YaBB Forum
Understanding the Admin Center
Managing Your Forum
Languages Addition and Translating
Guardian, Spam & Censor Settings
Backing up and Restoring
User Requested Template Modifications
Past YaBB Forum Software
YaBB 1.x (No longer Supported)
Installation, Setup, Errors and Structure
YaBB Support Codex
» Powered by
YaBB Next Edition
YaBB Forum Software
© 2000-2011. All Rights Reserved.