ActivePerl
ActivePerl User Guide
ActiveState

Installing ActivePerl


Welcome, and thanks for downloading ActivePerl. This release corresponds to Perl version 5.6.1.

Please note that ActivePerl 600 series builds are NOT binary-compatible with the older 500 series builds. In particular, do not attempt to use extensions or PPM packages built for the 500 series builds with ActivePerl 600 series builds and vice versa. This build is binary compatible with previous 600 series builds.

Binaries for the following platforms are available:

Installing ActivePerl on Linux (x86)

Linux Prerequisites

Linux Installers

RPM Package for Red Hat 6.2 or later
The Red Hat compatible package is in RPM format. This should be installed as root, using the following command:
    % rpm -i ActivePerl-5.6.1.635-i686-linux.rpm

This will install ActivePerl into /usr/local/ActivePerl-5.6. If you wish to change the default install location, use the --prefix option as follows:

    % rpm -i --prefix /opt/ActivePerl-5.6 ActivePerl-5.6.1.635-i686-linux.rpm

To uninstall Activeperl, run:

    % rpm -e ActivePerl

The RPM package has only been tested with Red Hat 6.2, but is expected to be compatible with other Red Hat 6.2 compatible installations as well.

DPKG Package for Debian 2.2 or later
The Debian-compatible package is in dpkg format. This should be installed as root, using the following command:
    % dpkg -i ActivePerl-5.6.1.635-i686-linux.deb

This will install ActivePerl into /usr/local/ActivePerl-5.6. The dpkg installation package has no mechanism to change the default installation location. Consider installing ActivePerl using the ActivePerl Generic Installer or the RPM package if you need this.

To uninstall ActivePerl, run:

    % dpkg -r ActivePerl

The Debian package has only been tested with Debian 2.2, but is expected to be compatible with other Debian 2.2 compatible installations as well.

Generic AS Package for Linux
The generic installer allows installation as an unprivileged user into a user-specified path. GNU tar is required for extracting the files. See ``Known Issues'' in the ActivePerl Release Notes for details.

Download the distribution to a temporary directory, extract the files, chdir to the ActivePerl directory and then run the script ``install.sh''. The installation script will prompt you for the target installation directory.

    % tar zxf ActivePerl-5.6.1.635-i686-linux.tar.gz
    % cd ActivePerl-5.6.1.635
    % ./install.sh

Linux Configuration

The Red Hat and Debian packages are installed into the /usr/local/ActivePerl-5.6 directory. Add the /usr/local/ActivePerl-5.6/bin directory to your PATH environment variable to conveniently access it. For example, in the C shell:

    % setenv PATH /usr/local/ActivePerl-5.6/bin:$PATH

The ActivePerl Generic installer allows you to install the package anywhere that the user has write permission. Add the bin directory to your PATH environment variable to conveniently access it. For example, in the C shell (assuming you installed into /home/larry/ActivePerl-5.6):

    % setenv PATH /home/larry/ActivePerl-5.6/bin:$PATH

Uninstalling ActivePerl on Linux

Debian Package
If you installed ActivePerl using the DPKG format installer, uninstall as follows:
    dpkg -r ActivePerl

RPM Package
If you installed ActivePerl using the RPM format installer, uninstall as follows:
    rpm -e ActivePerl

AS Package
If you installed ActivePerl using the AS format installer, remove the directory into which ActivePerl was installed. For example:
    /bin/rm -rf /usr/local/ActivePerl-5.6

Installing ActivePerl on Solaris (sparc)

Solaris Prerequisites

Solaris Installers

PKGADD Package
The Solaris package is in pkgadd format. This should be installed as root, using the following commands:
    % gunzip ActivePerl-5.6.1.635-sun4-solaris.gz
    % pkgadd -d ActivePerl-5.6.1.635-sun4-solaris

pkgadd will query you for the installation location, which can be changed from the default of /usr/local/ActivePerl-5.6.

To uninstall ActivePerl, run:

    % pkgrm ASperl

This package has only been tested with Solaris 2.6, but is expected to be compatible with other Solaris 2.6 compatible installations as well, including Solaris 2.7 and Solaris 2.8.

Generic AS Package for Solaris
The Generic Installer allows installation as an unprivileged user, and into a user-specified path. GNU tar is required for extracting the files. See ``Known Issues'' in the ActivePerl Release Notes for details.

Download the distribution to a temporary directory, extract the files, chdir to the ActivePerl directory and then run the script ``install.sh''. The installation script will prompt you for the target installation directory.

    % tar zxf ActivePerl-5.6.1.635-sun4-solaris.tar.gz
    % cd ActivePerl-5.6.1.635
    % ./install.sh

Solaris Configuration

The Solaris package is installed into the /usr/local/ActivePerl-5.6 directory. Add the /usr/local/ActivePerl-5.6/bin directory to your PATH environment variable to conveniently access it. For example, in the C shell:

    % setenv PATH /usr/local/ActivePerl-5.6/bin:$PATH

The ActivePerl Generic installer allows you to install the package anywhere that the user has write permission. Add the bin directory to your PATH environment variable to conveniently access it. For example, in the C shell (assuming you installed into /home/larry/ActivePerl-5.6):

    % setenv PATH /home/larry/ActivePerl-5.6/bin:$PATH

Uninstalling ActivePerl on Solaris

PKGADD Package
If you installed ActivePerl using the PKGADD format installer, uninstall as follows:
    pkgrm -d ASperl

AS Package
If you installed ActivePerl using the AS format installer, remove the directory into which ActivePerl was installed. For example:
    /bin/rm -rf /usr/local/ActivePerl-5.6

Installing ActivePerl on Windows (x86)

Windows Prerequisites

Windows Installers

MSI Installer Package
To install the MSI package double-click on the MSI file in Windows Explorer.

Do not install over a 500 series build of ActivePerl. This package must be installed into a separate directory.

MSI Package Installation from the Command Line
You can install ActivePerl from the command line using the 'msiexec' program. For example:
    msiexec /i E<lt>msi_fileE<gt>

The ADDLOCAL command line property is used to specify which features should be installed. (If ADDLOCAL is not specified, all features are installed.) For example:

    msiexec /i E<lt>msi_fileE<gt> ADDLOCAL="PERL_FEATURE,PERLIS"

The following features may be specified with the ADDLOCAL switch:

  • PERL_FEATURE (the Perl core)

  • PPM (the Programmer's Package Manager)

  • PERLIS (the Perl for ISAPI interpreter)

  • PERLSE (the Perl ActiveX Scripting Engine)

  • EXAMPLES (some simple examples)

  • DOCUMENTATION (the ActivePerl documentation)

A set of command-line properties can be used to configure the installation. For example:

    msiexec /i E<ly>msi_fileE<gt> TARGETDIR="c:\perl" PERL_PATH="Yes"
  • TARGETDIR: Used to specify the absolute path where ActivePerl will be installed. 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. If this option is used, a value is required.

  • PL_IISMAP: If this option is set to 'Yes', the installer will create a global IIS script mapping for '.pl' and Perl. By default, the installation does not create the script mapping.

  • PLX_IISMAP: If this option is set to 'Yes', the installer will create a global IIS script mapping for '.plx' and PerlIS. By default, the installation does not create the script mapping.

  • PERL_PATH: If this option is set to 'Yes', the Perl/bin directory will be added to the system PATH environment variable. By default, the directory is not added to the path.

The following command-line switches can be used:

Silent Mode
To run in silent mode, specify the '/q' command line option. The installer will run with no UI.

Logging
To log the installation process, specify the '/l' command line option and the name of the log file. For example:
    msiexec /i E<lt>msi_fileE<gt> /l E<lt>log_fileE<gt>

To enable verbose logging, use the '*v' modifier with the '/l' command line option. For example:

    msiexec /i E<lt>msi_fileE<gt> /l*v E<lt>log_fileE<gt>

AS Installer Package
The AS package is a generic installation package that can be used on systems where the MSI package is not supported. The AS package provides no uninstall functionality. To install using the AS package, double-click the the installer file and follow the prompts.

Windows Configuration

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 interpeter 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.

Uninstalling ActivePerl on Windows

MSI Package
If you installed ActivePerl using the MSI installer, uninstall using the Windows Add / Remove Programs applet.

AS Package
If you installed ActivePerl using the AS installer, uninstall by deleting the directory in which ActivePerl was installed.