9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

Community | Code | Docs | Downloads | more Welcome, Guest | Sign In | Store |

Cart

ActiveState Docs
ActivePerl 5.14 Documentation
Table of Contents
Search

INSTALLING ACTIVE PERL 5.14.2.1402

General Installation Notes Installing ActivePerl on Windows (x86) Windows Prerequisites Upgrading from ActivePerl 5.6, 5.8, 5.10, or 5.12 Windows Installers Windows Configuration Uninstalling ActivePerl on Windows Installing ActivePerl on Mac OS X (x86) OS X Prerequisites OS X Installer OS X Configuration Uninstalling ActivePerl on OS X Installing ActivePerl on Linux (x86) Linux Prerequisites Linux Installers Linux Configuration Uninstalling ActivePerl on Linux Installing ActivePerl on Solaris (sparc, x86) Solaris Prerequisites Business Edition License Solaris Installers Solaris Configuration Uninstalling ActivePerl on Solaris Installing ActivePerl on AIX (rs6000) AIX Prerequisites AIX Installers AIX Configuration Uninstalling ActivePerl on AIX Installing ActivePerl on HP-UX (PA-RISC) HP-UX Prerequisites HP-UX Installers HP-UX Configuration Uninstalling ActivePerl on HP-UX

General Installation Notes

Welcome, and thank you for choosing ActivePerl. Version Numbers:The first three numbers of an ActivePerl release correspond to the core Perl version. The fourth number is the ActivePerl build number, which may be followed by a fifth number that specifies a modified build for ActivePerl Enterprise. For example, this release of ActivePerl is 5.14.2.1402, which corresponds to Perl 5.14.2. Binary Incompatibility: ActivePerl 1400 series builds (Perl 5.14) are not binary-compatible with the older 1200 (Perl 5.12), 1000 (Perl 5.10), 800 (Perl 5.8) and 600 (Perl 5.6) series builds. In particular, do not attempt to use extensions or PPM packages built for an older series builds with ActivePerl 1400 series builds and vice versa. Side-by-Side x64 and x86 Installation: On 64 bit operating systems which support 32 bit compatibility, both x86 and x64 versions of ActivePerl can be installed on the same system as long as they are installed in separate directories. The Windows MSI installer will suggest the following default directories to keep them separate: Windows x64: C \ e l 4 :Pr6 Windows x86: C \ e l :Pr Other installers will not suggest a platform-specific default install directory. You must specify a
docs.activestate.com/activeperl/5.14/install.html# 1/9

9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

unique installation directory manually.

Installing ActivePerl on Windows (x86)

Windows Prerequisites
Hardware: 200 MB hard disk space for typical install Perl for ISAPI: requires an ISAPI-compatible web server, such as IIS PerlScript: requires an ActiveX scripting host such as Internet Explorer or Windows Scripting Host Perl Environment Variables: if Perl environment variables such as P R L B P R 5 I or ELI, ELLB P R 5 P have been set on your system, you should unset them before installing ActivePerl. ELOT Otherwise, these variables may cause incompatible versions of Perl modules to be used during the installation process. System Account: (MSI Installer only) Do not launch the installation package from a directory for which the "System" account does not have read permission. If you do, the Windows Installer Service will not be able to access the MSI file in order to perform the installation. You may get an error message to this effect, or it may fail mysteriously. Administrative Privileges: On Windows 2000/XP/2003/Vista systems ActivePerl installations must be performed by a privileged user only. If you install ActivePerl without full administrator privileges, the following problems occur: Environment variables are set only for the current user PerlScript file associations are not created The PerlScript feature will be unavailable Registry entries are created under HKEY_CURRENT_USER and not under HKEY_LOCAL_MACHINE IIS script mappings are not set ActivePerl applications will not write messages to the event log ActivePerl only appears in the Add/Remove Programs list for the current user Internet Explorer: Ensure that you have at least IE 6. If necessary, get an update from: http://windowsupdate.microsoft.com Windows 2000 (MSI Installer only) Microsoft Windows Installer 2.0 or greater, available from: http://downloads.ActiveState.com/contrib/Microsoft/MSI2.0/NT/InstMsiW.exe Windows Vista / Windows XP / Windows 2003 Server: no additional requirements

Upgrading from ActivePerl 5.6.x, 5.8.x, 5.10.x, or 5.12.x

Upgrading from earlier ActivePerl versions requires that you delete the old version of ActivePerl, and then install the 5.14.x version. This means that any additional packages that were installed using PPM must be manually reinstalled after the ActivePerl 5.14.x installation, so creating a list of these packages is an important first step. You can use ppm profile to help save and restore your locally installed PPM packages. For example, to save a profile before you upgrade, you can type: pmpoiesv C\rfl.m p rfl ae :poiexl Once you have saved this profile, you can proceed with the new install. Once done, you can use the profile you saved to reinstall the same set of PPM packages in your new installation by typing: pmpoiersoeC\rfl.m p rfl etr :poiexl

Windows Installers
If you are using ActivePerl to serve CGI / ASP scripts using IIS or another Web server, stop the Web server before installing ActivePerl. MSI Installer Package To install the MSI package double-click on the MSI file in Windows Explorer. Do not install over a 500, 600, 800, 1000, or 1200 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: mixc/ mifl.s see i s_iemi
docs.activestate.com/activeperl/5.14/install.html# 2/9

9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

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: mixc/ mifl.s ADOA=PR_ETR,ELS see i s_iemi DLCL"ELFAUEPRI" 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) A set of command-line properties can be used to configure the installation. For example: mixc/ mifl.s TREDR":"PR_AH"e" see i s_iemi AGTI=c\ ELPT=Ys TARGETDIR: Used to specify the absolute path where ActivePerl will be installed. If not specified, ActivePerl will be installed in a default location on the same drive as the Windows operating system. If this option is used, a value is required. Note: Ensure that the NT 'SYSTEM' user account that actually runs the MSI installer has full access to the target directory. Also, don't select a directory with spaces in its name. Perl will likely work, but many scripts will not. PERL_EXT: If set to 'No', the installer will not create the default '.pl' file extension association with p r . el PL_IISMAP: If is set to 'No', the installer will not create a global IIS script mapping for '.pl' and Perl. PLEX_IISMAP: If set to 'No', the installer will not create a global IIS script mapping for '.plex' and PerlIS. PLX_IISMAP: If set to 'No', the installer will not create a global IIS script mapping for '.plx' and PerlIS. PERL_PATH: If set to 'No', the Perl/bin directory will not be added to the system PATH environment variable. CREATE_SAMPLE_DIR: If set to 'No', the PerlEx sample virtual directory in IIS is not created. 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: mixc/ mifl.s / lgtt see i s_iemi l o.x To enable verbose logging, use the * modifier with the / command line option. v l For example: mixc/ mifl.s /* lgtt see i s_iemi lv o.x 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 installer file and follow the prompts.

Windows Configuration
If you run Perl at the command prompt, the script will be executed by the first P r . x it encounters elee in the list of paths in the PATH environment variable. To ensure the script is executed by the Perl interpreter of your choice, specify the complete path to the P r . x you want to use. (Typing p r elee el vat 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. fyePrSrp=elee% % tp elcitpr.x 1 *
docs.activestate.com/activeperl/5.14/install.html# 3/9

9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

asc.lPrSrp so p=elcit

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. Manual Uninstall If you must uninstall ActivePerl manually, delete the Perl directory, including all sub-directories, and the following registry entries: 1. HKEY_LOCAL_MACHINE/Software/ActiveState/ActivePerl 2. HKEY_LOCAL_MACHINE/Software/ActiveState/PerlScript 3. HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Uninstall/ActivePerl

Installing ActivePerl on Mac OS X (x86)

OS X Prerequisites
Hardware: 200 MB hard disk space for typical install Operating System: OS X 10.5 or later

OS X Installer
Installing the OS X Package ActivePerl is distributed on Mac OS X as a disk image (. m file). The disk image contains an dg installer package (. k bundle) that installs ActivePerl. pg Download the ActivePerl disk image (A t v P r - v r i n - p a f r > d g c i e e l < e s o > < l t o m . m ). If the browser does not automatically mount the disk image and open the mounted folder in Finder, double-click A t v P r - v r i n - p a f r > d gto do so. cieel<eso><ltom.m Double-click the ActivePerl installer package (ActivePerl-<version>.pkg) to start the installation. Follow the Installer prompts. The installer will ask for administrative authentication if the current user does not have administrative priviledges. After installation is complete, you may eject the ActivePerl disk image and move ActivePerl-version.dmg to the Trash. OS X includes a non-interactive command line interface to Apple's Installer. To install the ActivePerl Apple installer from the command line: $sd isalr-k /sr/uenm>AtvPr-vrin.k -agt/ uo ntle pg Ues<srae/cieel<eso>pg tre More information on the command line interface to Installer can be found in its m npage. a

OS X Configuration
The Apple Installer package installs ActivePerl in /usr/local/ActivePerl-5.14. To run the perl interpreter and PPM package manager (without having to enter the full path), add /usr/local/ActivePerl-5.14/bin to your PATH environment variable. For example: $epr PT=urlclAtvPr-.4bn$AH xot AH/s/oa/cieel51/i:PT $epr PT=urlclAtvPr-.4st/i:PT xot AH/s/oa/cieel51/iebn$AH To permanently add the directory to your PATH, add it to the . r f l or . a h p o i efile in the poie bs_rfl user's home directory. For example: PT=urlclAtvPr-.4bn$AH AH/s/oa/cieel51/i:PT PT=urlclAtvPr-.4st/i:PT AH/s/oa/cieel51/iebn$AH epr PT xot AH

docs.activestate.com/activeperl/5.14/install.html#

4/9

9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

Alternatively, symbolic links to the binaries can be created in any bin directory currently in the PATH. For example: PT=Ues<srae/i:PT AH/sr/uenm>bn$AH $l - /s/oa/cieel51/i/el/sr/uenm>bnpr n s urlclAtvPr-.4bnpr Ues<srae/i/el $l - /s/oa/cieel51/i/p /sr/uenm>bnpm n s urlclAtvPr-.4bnpm Ues<srae/i/p

Uninstalling ActivePerl on OS X
To uninstall ActivePerl, run the uninstall script: $sd /s/oa/cieel51/i/puisal uo urlclAtvPr-.4bna-nntl Removing ActivePerl will also remove perl modules manually installed using PPM. If neccessary, remove any symbolic links created during configuration. For example: $r /sr/uenm>bnpr m Ues<srae/i/el

Linux Prerequisites
Hardware: 200 MB hard disk space for typical install Operating System: Red Hat 6.2 or later, Debian 2.2 or later Online Help: Web browser

Installing ActivePerl on Linux (x86)

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: %rm- AtvPr-.4210-66lnxrm p i cieel51..42i8-iu.p This will install ActivePerl into /opt/ActivePerl-5.14. To uninstall ActivePerl, run: %rm- AtvPr p e cieel 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. Note: Previous versions of ActivePerl were installed in / s / o a . Upgrading using r mwill urlcl p not remove modules and documentation subsequently added using PPM or the CPAN shell, nor will it move them to the new location in / p . These modules must be reinstalled after the ot upgrade. The old ActivePerl directory in / s / o a can be removed. urlcl Gzipped Tarball 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 i s a l s . The installation script will prompt you for the ntl.h target installation directory. %trzfAtvPr-.4210-66lnxtrg a x cieel51..42i8-iu.a.z %c AtvPr-.4210 d cieel51..42 %.isals /ntl.h If you share the system with other people, or if you do not have root access, it is recommended that you install ActivePerl in your own user directory. For example: /oe<srae/cieel51 hm/uenm>AtvPr-.4
docs.activestate.com/activeperl/5.14/install.html# 5/9

9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

We suggest adding the following line to your .bash_profile file: PT=PT:hm/uenm>bn AH$AH/oe<srae/i Also, we suggest that you create symbolic links to the binaries: l - /oe<srae/cieel51/i/el/oe<srae/i/el n s hm/uenm>AtvPr-.4bnpr hm/uenm>bnpr l - /oe<srae/cieel51/i/p /oe<srae/i/p n s hm/uenm>AtvPr-.4bnpm hm/uenm>bnpm This will allow you to call ActivePerl with a command like: pr -e"el Wrd; el l Hlo ol!"

Linux Configuration
The Red Hat and Debian packages are installed into the /opt/ActivePerl-5.14 directory. Add the /opt/ActivePerl-5.14/bin directory to your PATH environment variable to conveniently access it. For example, in the C shell: %stn PT /p/cieel51/i:PT eev AH otAtvPr-.4bn$AH The 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/<username>/ActivePerl-5.14): %stn PT /oe<srae/cieel51/i:PT eev AH hm/uenm>AtvPr-.4bn$AH

Uninstalling ActivePerl on Linux

Debian Package If you installed ActivePerl using the dpkg format installer, uninstall as follows: dk - AtvPr pg r cieel RPM Package If you installed ActivePerl using the RPM format installer, uninstall as follows: rm- AtvPr p e cieel AS Package If you installed ActivePerl using the AS format installer, remove the directory into which ActivePerl was installed. For example: /i/m-f/p/cieel51 bnr r otAtvPr-.4

Installing ActivePerl on Solaris (sparc, x86)

Solaris Prerequisites
Hardware: 200 MB hard disk space for typical install Operating System: Solaris 2.6 or later for sparc, Solaris 10 or later for x86 Online Help: Web browser

Business Edition License

Access to the Solaris PPM repository requires an ActivePerl Business Edition license. To install this license: Download the license installer from the My Account page on the ActiveState website. Change the permissions on the downloaded file to allow execution (e.g. `c m d + f l n m `) ho x ieae Run the installer (e.g. `. f l n m `). /ieae

Solaris Installers
PKGADD Package The Solaris package is in pkgadd format. This should be installed as root, using the following commands: %gni AtvPr-.4210-u4slrspgg uzp cieel51..42sn-oai.k.z
docs.activestate.com/activeperl/5.14/install.html# 6/9

9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

%pgd - AtvPr-.4210-u4slrspg kad d cieel51..42sn-oai.k This will install ActivePerl into /opt/ActivePerl-5.14. To uninstall ActivePerl, run: %pgmApr kr Sel 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 7 and Solaris 8. Gzipped Tarball 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, c d rto the ActivePerl hi directory and then run the script i s a l s . The installation script will prompt you for the ntl.h target installation directory. %trzfAtvPr-.4210-u4slrstrg a x cieel51..42sn-oai.a.z %c AtvPr-.4210 d cieel51..42 %.isals /ntl.h If GNU tar is installed as 'gtar', substitute that executable name in the first command above.

Solaris Configuration
The Solaris package is installed into the /opt/ActivePerl-5.14 directory. Add the /opt/ActivePerl-5.14/bin directory to your PATH environment variable to conveniently access it. For example, in the C shell: %stn PT /p/cieel51/i:PT eev AH otAtvPr-.4bn$AH The 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/<username>/ActivePerl-5.14): %stn PT /oe<srae/cieel51/i:PT eev AH hm/uenm>AtvPr-.4bn$AH

Uninstalling ActivePerl on Solaris

PKGADD Package If you installed ActivePerl using the PKGADD format installer, uninstall as follows: pgm- Apr kr d Sel Gzipped Tarball Package If you installed ActivePerl using the AS format installer, remove the directory into which ActivePerl was installed. For example: /i/m-f/p/cieel51 bnr r otAtvPr-.4

Installing ActivePerl on AIX (rs6000)

AIX Prerequisites
Hardware: 200 MB hard disk space for typical install Operating System: AIX 5.3 or later

AIX Installers
Gzipped Tarball for AIX ActivePerl is distributed on AIX as a gzipped tarball containing an installer. 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 run the script i s a l s . ntl.h

docs.activestate.com/activeperl/5.14/install.html#

7/9

9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

$trzfAtvPr-.4210-i-.-sq.a.z a x cieel51..42ax53<e>trg $c AtvPr-.4210 d cieel51..42 $.isals /ntl.h If GNU tar is installed as 'gtar', substitute that executable name in the first command above. The installation script will prompt you for a target installation directory. If you share the system with other people, or if you do not have root access, you may install ActivePerl in your own user directory. For example: /oe<srae/cieel51 hm/uenm>AtvPr-.4

AIX Configuration
We suggest adding the bin directory of the ActivePerl installation to your .profile file. For example: PT=PT:hm/uenm>AtvPr-.4bn AH$AH/oe<srae/cieel51/i Alternatively, create symbolic links to the binaries in a directory already in your path. For example: $l - /oe<srae/cieel51/i/el/oe<srae/i/el n s hm/uenm>AtvPr-.4bnpr hm/uenm>bnpr $l - /oe<srae/cieel51/i/p /oe<srae/i/p n s hm/uenm>AtvPr-.4bnpm hm/uenm>bnpm

Uninstalling ActivePerl on AIX

To uninstall ActivePerl, remove the directory ActivePerl was installed in. For example: $r -f/p/cieel51 m r otAtvPr-.4 If neccessary, remove any symbolic links created during configuration. For example: $r /sr/uenm>bnpr m Ues<srae/i/el

Installing ActivePerl on HP-UX (PA-RISC)

HP-UX Prerequisites
Hardware: 200 MB hard disk space for typical install Operating System: HP-UX 11.00 or HP-UX 11i

HP-UX Installers
Gzipped Tarball for HP-UX ActivePerl is distributed on HP-UX as a gzipped tarball containing an installer. 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 run the script i s a l s . ntl.h $trzfAtvPr-.4210-ARS-sq.a.z a x cieel51..42P-IC<e>trg $c AtvPr-.4210 d cieel51..42 $.isals /ntl.h If GNU tar is installed as 'gtar', substitute that executable name in the first command above. The installation script will prompt you for a target installation directory. If you share the system with other people, or if you do not have root access, you may install ActivePerl in your own user directory. For example: /oe<srae/cieel51 hm/uenm>AtvPr-.4

HP-UX Configuration
We suggest adding the bin directory of the ActivePerl installation to your .profile file. For example: PT=PT:hm/uenm>AtvPr-.4bn AH$AH/oe<srae/cieel51/i Alternatively, create symbolic links to the binaries in a directory already in your path. For example:
docs.activestate.com/activeperl/5.14/install.html# 8/9

9/24/12

ActivePerl 5.14.2.1402 -- Installation Guide

$l - /oe<srae/cieel51/i/el/oe<srae/i/el n s hm/uenm>AtvPr-.4bnpr hm/uenm>bnpr $l - /oe<srae/cieel51/i/p /oe<srae/i/p n s hm/uenm>AtvPr-.4bnpm hm/uenm>bnpm

Uninstalling ActivePerl on HP-UX

To uninstall ActivePerl, remove the directory ActivePerl was installed in. For example: $r -f/p/cieel51 m r otAtvPr-.4 If neccessary, remove any symbolic links created during configuration.

2012 ActiveState Software Inc. All rights reserved. ActiveState, Komodo, ActivePerl, ActivePython, ActiveTcl, and Stackato are trademarks or registered trademarks of ActiveState. All other marks are property of their respective owners.

docs.activestate.com/activeperl/5.14/install.html#

9/9