ActiveState!

ActivePerl Documentation
Table of Contents

(Usage Statistics)
(about this ver)


* Getting Started
    * Welcome To ActivePerl
    * Release Notes
    * Readme
    * ActivePerl Change Log
* Install Notes
    * Linux
    * Solaris
    * Windows
* ActivePerl Components
    * Overview
    * PPM
    * Windows Specifics
       * OLE Browser
       * PerlScript
       * Perl for ISAPI
       * PerlEZ
* ActivePerl FAQ
    * Introduction
    * Availability & Install
    * Using PPM
    * Docs & Support
    * Windows Specifics
       * Perl for ISAPI
       * Windows 9X/NT/2000
       * Quirks
       * Web Server Config
       * Web programming
       * Programming
       * Modules & Samples
       * Embedding & Extending
       * Using OLE with Perl
* Windows Scripting
    * Active Server Pages
    * Windows Script Host
    * Windows Script Components

Core Perl Documentation


* perl
* perlfaq
* perltoc
* perlbook

* perlsyn
* perldata
* perlop
* perlreftut
* perldsc
* perllol

* perllexwarn
* perldebug

* perlrun
* perlfunc
* perlopentut
* perlvar
* perlsub
* perlmod
* perlpod

* perlstyle
* perlmodlib
* perlmodinstall
* perltrap
* perlport
* perlsec

* perlref
* perlre
* perlform
* perllocale
* perlunicode

* perlboot
* perltoot
* perltootc
* perlobj
* perlbot
* perltie

* perlipc
* perlnumber
* perlfork
* perlthrtut

* perldiag
* perlfaq1
* perlfaq2
* perlfaq3
* perlfaq4
* perlfaq5
* perlfaq6
* perlfaq7
* perlfaq8
* perlfaq9

* perlcompile

* perlembed
* perlxstut
* perlxs
* perlguts
* perlcall
* perlfilter
* perldbmfilter
* perlapi
* perlintern
* perlapio
* perltodo
* perlhack

* perlhist
* perldelta
* perl5005delta
* perl5004delta

* perlamiga
* perlcygwin
* perldos
* perlhpux
* perlmachten
* perlos2
* perlos390
* perlvms
* perlwin32

Pragmas


* attributes
* attrs
* autouse
* base
* blib
* bytes
* charnames
* constant
* diagnostics
* fields
* filetest
* integer
* less
* lib
* locale
* lwpcook
* open
* ops
* overload
* perllocal
* re
* sigtrap
* strict
* subs
* utf8
* vars
* warnings

Libraries


* ActivePerl
    * DocTools
        * TOC
            * RDF
* AnyDBM_File
* Archive
    * Tar
* AutoLoader
* AutoSplit
* B
    * Asmdata
    * Assembler
    * Bblock
    * Bytecode
    * C
    * CC
    * Debug
    * Deparse
    * Disassembler
    * Lint
    * Showlex
    * Stackobj
    * Terse
    * Xref
* Benchmark
* Bundle
    * LWP
* ByteLoader
* Carp
    * Heavy
* CGI
    * Apache
    * Carp
    * Cookie
    * Fast
    * Pretty
    * Push
    * Switch
* Class
    * Struct
* Compress
    * Zlib
* Config
* CPAN
    * FirstTime
    * Nox
* Cwd
* Data
    * Dumper
* DB
* Devel
    * DProf
    * Peek
    * SelfStubber
* Digest
    * HMAC
    * HMAC_MD5
    * HMAC_SHA1
    * MD2
    * MD5
    * SHA1
* DirHandle
* Dumpvalue
* DynaLoader
* English
* Env
* Errno
* Exporter
    * Heavy
* ExtUtils
    * Command
    * Embed
    * Install
    * Installed
    * Liblist
    * MakeMaker
    * Manifest
    * Miniperl
    * Mkbootstrap
    * Mksymlists
    * MM_Cygwin
    * MM_OS2
    * MM_Unix
    * MM_VMS
    * MM_Win32
    * Packlist
    * testlib
* Fatal
* Fcntl
* File
    * Basename
    * CheckTree
    * Compare
    * Copy
    * CounterFile
    * DosGlob
    * Find
    * Glob
    * Listing
    * Path
    * Spec
        * Functions
        * Mac
        * OS2
        * Unix
        * VMS
        * Win32
    * stat
* FileCache
* FileHandle
* FindBin
* Font
    * AFM
* Getopt
    * Long
    * Std
* HTML
    * AsSubs
    * Element
    * Entities
    * Filter
    * Form
    * FormatPS
    * Formatter
    * FormatText
    * HeadParser
    * LinkExtor
    * Parse
    * Parser
    * TokeParser
    * TreeBuilder
* HTTP
    * Cookies
    * Daemon
    * Date
    * Headers
        * Util
    * Message
    * Negotiate
    * Request
        * Common
    * Response
    * Status
* I18N
    * Collate
* IO
    * Dir
    * File
    * Handle
    * Pipe
    * Poll
    * Seekable
    * Select
    * Socket
        * INET
        * UNIX
* IPC
    * Msg
    * Open2
    * Open3
    * Semaphore
    * SysV
* LWP
    * Debug
    * MediaTypes
    * MemberMixin
    * Protocol
    * RobotUA
    * Simple
    * UserAgent
* Math
    * BigFloat
    * BigInt
    * Complex
    * Trig
* MD5
* MIME
    * Base64
    * QuotedPrint
* NDBM_File
* Net
    * Cmd
    * Config
    * Domain
    * DummyInetd
    * FTP
    * hostent
    * libnetFAQ
    * netent
    * Netrc
    * NNTP
    * PH
    * Ping
    * POP3
    * protoent
    * servent
    * SMTP
    * SNPP
    * Time
* O
* ODBM_File
* Opcode
* Pod
    * Checker
    * Find
    * Html
    * InputObjects
    * Man
    * Parser
    * ParseUtils
    * Plainer
    * Select
    * Text
        * Color
        * Termcap
    * Usage
* POSIX
* PPM
    * SOAPClient
    * SOAPServer
* Safe
* SDBM_File
* Search
    * Dict
* SelectSaver
* SelfLoader
* SHA
* Shell
* SOAP
    * Defs
    * Envelope
    * EnvelopeMaker
    * GenericHashSerializer
    * GenericInputStream
    * GenericScalarSerializer
    * Lite
    * OutputStream
    * Packager
    * Parser
    * Transport
        * HTTP
            * Apache
            * CGI
            * Client
            * Server
        * LOCAL
        * MAILTO
        * POP3
        * TCP
    * TypeMapper
* Socket
* Symbol
* Sys
    * Hostname
    * Syslog
* Term
    * ANSIColor
    * Cap
    * Complete
    * ReadLine
* Test
    * Harness
* Text
    * Abbrev
    * ParseWords
    * Soundex
    * Tabs
    * Wrap
* Thread
    * Queue
    * Semaphore
    * Signal
    * Specific
* Tie
    * Array
    * Handle
    * Hash
    * RefHash
    * Scalar
    * SubstrHash
* Time
    * gmtime
    * Local
    * localtime
    * tm
* UDDI
    * Lite
* UNIVERSAL
* URI
    * data
    * Escape
    * file
    * Heuristic
    * ldap
    * URL
    * WithBase
* User
    * grent
    * pwent
* Win32
    * AuthenticateUser
    * ChangeNotify
    * Clipboard
    * Console
    * Event
    * EventLog
    * File
    * FileSecurity
    * Internet
    * IPC
    * Mutex
    * NetAdmin
    * NetResource
    * ODBC
    * OLE
        * Const
        * Enum
        * NEWS
        * NLS
        * TPJ
        * Variant
    * PerfLib
    * Pipe
    * Process
    * Registry
    * Semaphore
    * Service
    * Sound
    * TieRegistry
* Win32API
    * File
    * Net
    * Registry
* WWW
    * RobotRules
        * AnyDBM_File
* XML
    * Element
    * Parser
        * Expat
    * PPD
    * PPMConfig
    * ValidatingElement
* XSLoader

 Install Notes

Contents


Requirements

Hardware

  • recommended 35MB hard disk space for typical install

Operating System

Windows 2000

  • no extra requirements

Windows NT

Windows Me

  • no extra requirements

Windows 98

Windows 95

Perl for ISAPI

  • ISAPI compatible Web server such as IIS 4.0+ or PWS 4.0+

PerlScript

  • ActiveX scripting host such as IE 4.0+, or Windows Scripting Host

Installing ActivePerl

Run the ActivePerl-5.6.0.6xx.msi installation package to start the installation wizard, which will guide you through the setup, and give you options on what and where to install stuff.

What happens during install?

Perl is installed by default in C:\Perl. The drive "C" will be the same drive that the operating system is installed on.

If you run Perl at the command prompt, the script will be executed by the first Perl.exe it encounters in the list of paths in the PATH environment variable. To ensure the script is executed by the Perl build you want it to be executed by, you can specify the complete path to the Perl.exe you want to use. (typing perl -v at the command prompt will tell you which version of Perl is currently first in your PATH)

Installing ActivePerl will change your Path environment variable and may change registry settings, such as file associations, which may affect your Web server. If you want to use a previously installed copy of Perl, you will need to modify these settings.


Running Perl scripts on your Web server

ActivePerl, PerlScript and Perl for ISAPI are all useful additions to your Web server. However, they do have specific requirements, (see above) and may require some additional configuration to work properly. For more information on compatibility, installation, configuration and other useful information, have a look at the Web server section of the ActivePerl FAQ included with the ActivePerl package.


Installing ActivePerl from the Command Line

Introduction

You can install ActivePerl from the command line using the 'msiexec' program. For example:

    c:\> misexec /i <msi_file>

Selecting ActivePerl Features

You can also control which ActivePerl features are installed using the 'ADDLOCAL' command line property. This property may be set to a comma (,) delimited list of features to be installed locally. For instance:

    c:\> msiexec /i <msi_file> ADDLOCAL="Perl,PerlIS"
ActivePerl has the following features:
  • Perl - The Perl core
  • PerlIS - The Perl ISAMI interpreter
  • PerlSE - The Perl ActiveX Scripting Engine
  • Examples - Some simple examples
  • Docs - ActivePerl documentation
By default all features of ActivePerl are installed on Windows 2000.

Configuring ActivePerl

Command line properties may be specified to configure ActivePerl installation options. For example:

    c:\> msiexec /i <msi_file> TARGETDIR="c:\perl" PERL_PATH="Yes"
The ActivePerl MSI installer recognizes the following command line properties:
  • TARGETDIR - Using this property you can specify absolute path to where ActivePerl will be installed. This property is optional. If not specified, ActivePerl will be installed in a default location determined by the Windows Installer Service, usually the root of the drive with the most available space. The value of this option is required and should be the absolute path to the directory in which ActivePerl will be installed.
  • PL_IISMAP - Setting this property to 'Yes' causes the installer to create a global IIS script mapping for '.pl' and Perl. This property is optional. The default is to not create the script mapping.
  • PLX_IISMAP - Setting this property to 'Yes' causes the installer to create a global IIS script mapping for '.plx' and PerlIS. This property is optional. The default is to not create the script mapping.
  • PERL_PATH - Setting this property to 'Yes' causes the Perl/bin directory to be added to the system PATH environment variable. This property is optional. The default is to not add the Perl/bin directory to the path.

Running ActivePerl Installer in Silent Mode

To run ActivePerl installer in silent mode you need to specify the '/q' command line option. This causes the installer to run with no UI. For example:

    c:\> msiexec /i <msi_file> /q

Turning on Logging During ActivePerl Installation

To turn on logging during ActivePerl installation you need to specify the '/l' command line option. This option requires you to provide the name of the log file as an argument. For instance:

    c:\> msiexec /i <msi_file> /l <log_file>
You can turn on verbose logging by using the '*v' modifier with the '/l' command line option. For instance:
    c:\> msiexec /i <msi_file> /l*v <log_file>

Known Issues

Windows 95, Windows 98 and Windows Me

After installation, Windows must be rebooted for the PATH environment variable settings to take effect. The PATH settings are also not removed after uninstallation.

Further Information

See the ActivePerl Readme for more information.

 

 Install Notes