view release on metacpan or  search on metacpan

lib/App/installguide/win32.pod  view on Meta::CPAN

#!perl -w
# run this document through perl to check its syntax
use Pod::Checker;
podchecker(\*DATA);
__END__

=head1 NAME

App::installguide::win32 - Installation Guide for Perl Software on Win32 System

=head1 INTRODUCTION

These is a general Installation Guide for installing Perl software on
the Microsoft Windows platform.  The emphasis is on web and database applications
in Perl.

This document is motivated by helping people install the
App-Context Framework (comprised of
App-Context, App-Options, App-Repository, and App-Widget).
However, most of the information here is useful regardless of what Perl modules
you are installing.

You should also read through the general Installation Guide (App::installguide) and
understand how the software would be installed on Unix/Linux
before consulting this specialized Win32 guide. 

This guide will predominantly focus on how to get
up and running on a plain vanilla Windows system
for demonstration or development purposes.
The focus here is not on optimized server installation on Windows
servers, although the instructions may still be useful.

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

=head1 PERL

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

  http://www.activestate.com
  http://www.activestate.com/Products/ActivePerl/

Registration is required, but it is free of charge.
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

=head1 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 (PPM, included with
ActiveState Perl).  This installs Windows binary versions of many of the
packages which are on CPAN from ActiveState's website.
Take a look at this web page.

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

NOTE: The following instructions are good for the latest version of PPM (PPM3).
Some syntax changed since PPM2.

You can go into the PPM utility to manage installed binary distributions
and check on which "repositories" of PPM files are currently configured.

  C:\> ppm
  PPM> repository
  PPM> quit
  C:\>

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

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