Product Documentation

PDK 7.2 Documentation

Perl Dev Kit Installation Guide

Installing the PDK on Windows

ActiveState's Perl Dev Kit (PDK) includes a graphical installation that makes it easy to install. You can install the Perl Dev Kit on Microsoft Windows Vista, Windows Server 2003, Windows XP, or Windows 2000 operating systems.

In-depth knowledge of Perl is not required for installing and running the Perl Dev Kit. However, some knowledge of Perl is recommended if you intend to modify Perl programs to work with the Perl Dev Kit.

Windows Software Requirements

ActivePerl build 638 or later.
Note: If you are uninstalling an older version of ActivePerl before installing a later version of ActivePerl, it is recommended that you reboot your computer in between uninstalling the old version and installing the new one.
PerlNET requires an installation of the Microsoft .NET Framework 2.0.

Windows Operating System Requirements

Windows Vista, Windows XP, Windows Server 2003

No additional requirements

Windows 2000

Windows Installer 2.0 Redistributable for Windows 2000

Windows Installation

Installation of the Perl Dev Kit requires that you have administrator privileges (as applicable) on the computer. Before installing the Perl Dev Kit, ensure that the installation directory does not contain a previous version of the Perl Dev Kit. Multiple versions of the PDK can be installed on a system, providing none of the versions is the same, and they are installed in different locations.

To install the Perl Dev Kit:

Double-click the installation file (with the .MSI extension) to run the installer program.
Follow the instructions on the screen. You are prompted to agree to the terms of the license agreement and select the components of the Perl Dev Kit that you wish to install. When the installation is complete, you have the option of viewing the Perl Dev Kit Release Notes.
Note: Services created with the PerlSvc component cannot be run until the machine is rebooted.

Installing the PDK on Mac OS X

Perl Dev Kit for OS X is distributed as a .dmg image containing a package installer.

Mac OS X Software Requirements

Mac OS X 10.4 "Tiger" or later

ActivePerl build 816 or later.

Mac OS X Installation

Installation of the Perl Dev Kit requires that you have administrator privileges on the computer. Before installing the Perl Dev Kit, ensure that the installation directory (by default /usr/local/PDK) does not contain a previous version of the Perl Dev Kit.

To install the Perl Dev Kit:

Double-click the downloaded .dmg file to open it (Note: this is done automatically if you downloaded using Safari).
Double-click the Perl Dev Kit package icon.
Step through the Perl Dev Kit installer. You will be prompted to read and accept the ActiveState Perl Dev Kit License Agreement, choose a drive to install to, and finally to install the software. If you are not logged in as an Administrator, you will be prompted for an Administrator username and password.
Eject the mounted Perl Dev Kit disk image.

The Perl Dev Kit tools are installed under /usr/local/PDK. You may wish to add PDK to your path environment variables. This can be done with the commands:

  export PATH=/usr/local/PDK/bin:$PATH
  export MANPATH=/usr/local/PDK/share/man:$MANPATH

The tools can also be launched from from the ActiveState Perl Dev Kit folder under Applications in the Finder. Drag the icons into the Dock to create shortcuts.

Installing the PDK on AIX/HP-UX/Linux/Solaris

Install the PDK on AIX, HP-UX, Linux or Solaris by downloading the appropriate installation (.tar.gz) file, unzipping it, and running the installation script. The installer prompts you to select an installation directory and a compatible version of Perl.

AIX/HP-UX/Linux/Solaris Software Requirements

Web browser to view documentation
ActivePerl build 628 or later on AIX, Linux and Solaris.
ActivePerl build 627 or later on HP-UX. ActivePerl for HP-UX can be obtained from HP.

Note: ActivePerl and PerlApp on HP-UX have a known incompatibility with extension libraries that link with libcl.sl. For example, some versions of the Oracle client libraries are known to link with libcl.sl. If the DBD::Oracle extension links with such an Oracle client library, that extension is not compatible with ActivePerl and PerlApp.

Note that the tar command on Solaris has a bug that prevents files with long path names from being extracted from the package correctly. GNU tar may therefore be required to extract the package into the filesystem correctly. A precompiled version of GNU tar for the sparc platform is available from Sun .

AIX/HP-UX/Linux/Solaris Operating System Requirements

AIX-5.1+ on rs6000
HP-UX 11.00+ on PA_RISC
HP-UX 11.22+ on Itanium
Linux on x86: needs libc-2.3+
Linux on x64: needs libc-2.3+
Solaris 2.8+ on Sparc
Solaris 10+ on x86

AIX/HP-UX/Linux/Solaris Installation

The Perl Dev Kit can be installed in the location of your choice. However, ensure that the installation directory does not contain a previous version of the Perl Dev Kit. You do not need root privileges, but you must have write access to the chosen location.

Multiple versions of the PDK can be installed on a system, providing they are installed in different locations.

Unzip the downloaded installation file using the gunzip and tar commands. For example:
```
  gunzip -c PDK-7.2.0-linux.tar.gz | tar xvf -
```
Make the extracted directory the current directory, and run the contained install.sh script to start the PDK installer:
```
  cd PDK-7.2.0-linux
  sh install.sh
```
Choose an installation directory. Press 'Enter' to install the Perl Dev Kit in the default location (/opt/pdk) or specify a different top-level directory.
Specify the Perl version to use with the PDK. The installer prompts you to select the version that is first in your system's PATH. Press 'Enter' to accept this version, or specify a different version.
If you have more than one Perl version that is compatible with the PDK, the installer displays them in a numbered list. For example:
```
    Select Perl to use with the PDK
```
```
     1. /usr/bin/perl (default)
     2. /usr/local/ActivePerl-5.10/bin/perl
     3. None of these
```
Then enter the number indicating the desired version (in the example above, '1' or '2'), or enter the number indicating 'None of these' to specify a different version. Press 'Enter' to complete the installation.
Add the Perl Dev Kit's installation directory to your path. For example, if you accepted the default directory, enter the following command:
```
    PATH=/opt/pdk/bin:$PATH
```

Use the following command to find and display the Perl Dev Kit documentation:

  perldoc pdk

The complete Perl Dev Kit documentation is installed with the Windows version of Perl Dev Kit. It is also available in HTML format on ASPN, the ActiveState Programmer Network.

Uninstalling the PDK

Windows

Select Start|Programs|ActiveState Perl Dev Kit 7.2|Uninstall Perl Dev Kit.

Mac OS X

Run the following command:

  sudo "/Library/Receipts/Perl Dev Kit.pkg/Contents/Resources/uninstall"

AIX/HP-UX/Linux/Solaris

Delete the directory containing the Perl Dev Kit installation.