ActivePerl 5.8

1. Download

   Download the latest version of ActivePerl from http://www.activestate.com/store/activeperl/download (if it asks you to register, you can just leave the form blank and hit "Continue").
   
   Get the Windows (x86) MSI version. My file was named: ActivePerl-5.8.8.822-MSWin32-x86-280952.msi

2. Install

   On the "Setup" screen (where you choose what features to install -- should be about the 2nd or 3rd screen in. I tend to miss it every time and have to go back) change the install location (hit the little "browse" button). I highly recommend that you install perl to a directory like:
   c:\usr\
   
   

   In someone else's words (very good advice)

   If you will be using Perl CGI programs and want to maintain some level of portability between both Linux machines and Windows machines, you will want to install Perl to the same location on your Windows machine that it is on most Linux machines. For example, on a standard Linux machine, Perl is located at /usr/bin/perl and so every Perl program that I write begins with #!/usr/bin/perl. So, when I install Perl on a Windows machine, instead of installing it in the default location (which is E:\perl for ActivePerl) I install it in E:\usr so that the Perl executable is located at /usr/bin/perl. This allows me to write code on my Windows machine, then move it (without making any changes) to a Linux machine and have it run there. And vice versa.

   
   [Check] Add Perl to the PATH environment variable
   [Check] Create Perl file extension association
   The rest should be grayed out and read-only, but if not, leave them unchecked
   

3. Activating CGI

   Using Notepad (or other text editor) open E:\Apache2_2\conf\httpd.conf (also should be start-menu shortcut called "Edit Apache HTTP httpd.conf File") and search for Options Indexes FollowSymLinks (about line 190) when you find it add ExecCGI to the end so it looks like Options Indexes FollowSymLinks ExecCGI

4. [OPTIONAL] Enabling CGI in any directory

   If you want to use CGI outside the E:/Apache2_2/cgi-bin/ ScriptAliased directory, you will need to uncomment the following line: #AddHandler cgi-script .cgi becomes AddHandler cgi-script .cgi (remove the #) I also added .pl behind .cgi so 'perl' extension is also treated as cgi files.
   
   If you will be creating your own cgi-bin, you will want to comment out: ScriptAlias /cgi-bin/ "E:/Apache2/cgi-bin/" so it becomes #ScriptAlias /cgi-bin/ "E:/Apache2/cgi-bin/"

5. Finding your location to perl

   If you do not know where your perl.exe installed to, go to Start -> Search and type in a search for perl.exe This location is the path to perl you put on the top of all your cgi scripts. If you listened to my advice in the "Install" step, the path should be close to: E:/usr/bin/perl.exe
   
   

   Some notes

   For the perl path E:/usr/bin/perl.exe all of these are/were valid. I prefer the last one because of the Linux <<>> Windows portability. #!E:/usr/bin/perl.exe #!E:/usr/bin/perl #!/usr/bin/perl.exe #!/usr/bin/perl

6. Testing CGI

   If you if you uncommented (removed the # symbol) the line AddHandler cgi-script .cgi in step #4, then create a file in your document_root called hello.cgi and put these three lines in it (if you did not comment/disable it, put the CGI file in E:/Apache2_2/cgi-bin/):
   

   #!/usr/bin/perl
   print "Content-type:text/html\n\n";
   print "hello world";

7. Restart Apache if it is already running. Now go to http://localhost/cgi-bin/hello.cgi (or wherever you put the file) and run the script.
8. If you get a hello world in your browser, CGI is running. If you get a 500 error, go to the last entry in E:/Apache2_2/logs/error.log (or the Review Error Log in the start menu) to see exactly what caused this error.