P5EEx-Blue-0.01

P5EEx::Blue::installguide::win32


NAME

P5EEx::Blue::installguide::win32 - P5EE Installation Guide for Win32


INTRODUCTION

This is the Installation Guide to the P5EE (Perl 5 Enterprise Environment) for the Microsoft Windows platform. You can find out more background to the project on the web.

  ../../../../../../p5ee
  http://p5ee.perl.org

You should also consult the general P5EEx::Blue::installguide before consulting this specialized guide.

This will describe how to get up and running (for demonstration or development purposes) from a plain vanilla Windows system.

These instructions assume that your PC is connected to the Internet.


PERL

The official Perl for the Windows platform is available from ActiveState.

  http://www.activestate.com
  http://www.activestate.com/Products/Download/Get.plex?id=ActivePerl

Registration is required, but it is free. Follow the download and installation directions and you should end up with perl installed in the following directories under C:\Perl.

  C:\Perl            # install directory for Perl
  C:\Perl\bin        # programs directory (home of perl.exe)
  C:\Perl\eg         # example code
  C:\Perl\html       # html doc for the installed perl modules
  C:\Perl\lib        # standard perl modules
  C:\Perl\site\lib   # extram perl modules installed at this site


OTHER PERL MODULES

After you install the base Perl distribution, you need to install a number of other Perl modules, which would normally be downloaded from CPAN. Because you are installing on a Windows platform, however, you will use ActiveState's Perl Package Manager (included with ActiveState Perl). This installs Windows binary versions of many of the packages which are on CPAN from ActiveState's website.

  http://aspn.activestate.com/ASPN/Modules

Not all of the Perl modules you may want (i.e. mod_perl) are available from ActiveState, so you should know about a second repository for PPM files.

  http://theoryx5.uwinnipeg.ca/ppmpackages/
  http://theoryx5.uwinnipeg.ca/

To add this repository to the list for the ppm shell utility to search, do the following.

  C:\> ppm
  PPM> set repository theoryx5 http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer
  PPM> set save
  PPM> quit
  C:\>

The ``set save'' command saves the theoryx5 repository to your PPM configuration file, so that future PPM sessions will search this repository, as well as ActiveState's, for requested packages.

The following commands are not necessary because these packages come installed with ActiveState Perl, but they are shown in case you wish to get the latest versions.

  C:\> ppm
  PPM> install Data-Dumper             # Data::Dumper
  PPM> install Storable                # Storable
  PPM> install MIME-Base64             # MIME::Base64
  PPM> install Compress-Zlib           # Compress::Zlib
  PPM> install SOAP-Lite               # SOAP::Lite
  PPM> quit
  C:\>

The following commands are to install package which are necessary in order for any of P5EE to run.

  C:\> ppm
  PPM> install TimeDate                # Date::Parse and Date::Format
  PPM> install Class-Data-Inheritable  # Class::Data::Inheritable
  PPM> install Devel-StackTrace        # Devel::StackTrace
  PPM> install Exception-Class         # Exception::Class
  PPM> quit
  C:\>

The following commands are to install packages which are important to have for debugging, so go ahead and install them too.

  C:\> ppm
  PPM> install Class-MethodMaker       # Class::MethodMaker
  PPM> install Hook-LexWrap            # Hook::LexWrap
  PPM> install IO-stringy              # IO::stringy
  PPM> install Aspect                  # Aspect
  PPM> quit
  C:\>

The following commands are to install packages which used to be required by earlier versions of P5EE. They are shown just in case a dependence on them were restored in the future.

  C:\> ppm
  PPM> install Error                   # Error
  PPM> quit
  C:\>


APACHE


MOD_PERL

The following is derived from

  http://perl.apache.org/win32_binaries.html

After installing Perl and Apache, you can then install mod_perl via the PPM utility.

  C:\> ppm
  PPM> install mod_perl
  PPM> quit
  C:\>

The mod_perl PPM package also includes the necessary Apache DLL mod_perl.so; a post-installation script should be run which will offer to copy this file to your Apache modules directory (eg, C:\Apache\modules).

Note that the mod_perl package available from this site will always use the latest mod_perl sources compiled against the latest official Apache release; depending on changes made in Apache, you may or may not be able to use an earlier Apache binary. However, in the Apache Win32 world it is particularly a good idea to use the latest version, for bug and security fixes.