ActivePerl User Guide
|
|
ActivePerl User Guide |
|
Welcome, and thanks for downloading ActivePerl. This release corresponds to Perl version 5.8.1.
Please note that ActivePerl 800 series builds are NOT binary-compatible with the older 600 and 500 series builds. In particular, do not attempt to use extensions or PPM packages built for the 500 and 600 series builds with ActivePerl 800 series builds and vice versa.
Binaries for the following platforms are available:
PERLLIB, PERL5LIB or PERL5OPT, you should unset them before
installing ActivePerl. Otherwise, these variables may cause incompatible
versions of Perl modules to be used during the installation process.
% rpm -i ActivePerl-5.8.4.810-i686-linux.rpm
This will install ActivePerl into /usr/local/ActivePerl-5.8. If you
wish to change the default install location, use the --prefix option
as follows:
% rpm -i --prefix /opt/ActivePerl-5.8 ActivePerl-5.8.4.810-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 -i ActivePerl-5.8.4.810-i686-linux.deb
This will install ActivePerl into /usr/local/ActivePerl-5.8. 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.
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.8.4.810-i686-linux.tar.gz
% cd ActivePerl-5.8.4.810
% ./install.sh
The Red Hat and Debian packages are installed into the /usr/local/ActivePerl-5.8 directory. Add the /usr/local/ActivePerl-5.8/bin directory to your PATH environment variable to conveniently access it. For example, in the C shell:
% setenv PATH /usr/local/ActivePerl-5.8/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.8):
% setenv PATH /home/larry/ActivePerl-5.8/bin:$PATH
dpkg -r ActivePerl
rpm -e ActivePerl
/bin/rm -rf /usr/local/ActivePerl-5.8
PERLLIB, PERL5LIB or PERL5OPT, you should unset them before
installing ActivePerl. Otherwise, these variables may cause incompatible
versions of Perl modules to be used during the installation process.
% gunzip ActivePerl-5.8.4.810-sun4-solaris.pkg.gz
% pkgadd -d ActivePerl-5.8.4.810-sun4-solaris.pkg
pkgadd will query you for the installation location, which can be changed from the default of /usr/local/ActivePerl-5.8.
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.
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.8.4.810-sun4-solaris.tar.gz
% cd ActivePerl-5.8.4.810
% ./install.sh
The Solaris package is installed into the /usr/local/ActivePerl-5.8 directory. Add the /usr/local/ActivePerl-5.8/bin directory to your PATH environment variable to conveniently access it. For example, in the C shell:
% setenv PATH /usr/local/ActivePerl-5.8/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.8):
% setenv PATH /home/larry/ActivePerl-5.8/bin:$PATH
pkgrm -d ASperl
/bin/rm -rf /usr/local/ActivePerl-5.8
PERLLIB,
PERL5LIB or PERL5OPT have been set on your system, you should unset them
before installing ActivePerl. Otherwise, these variables may cause incompatible
versions of Perl modules to be used during the installation process.
When upgrading from ActivePerl version 5.6, additional packages that were installed using PPM must be manually reinstalled for ActivePerl 5.8. Before performing the upgrade, generate a list of modules by running the following command at a command prompt:
dir /b c:\perl\site\lib\ppm-conf\*.ppd > c:\ppm_modules.txt
This will write a list of the modules installed via PPM to the file
ppm_modules.txt. Alter the command as necessary to suit your
installation.
After uninstalling the old version of ActivePerl, manually delete the
c:\perl directory, then install ActivePerl 5.8.x. Use the
version of PPM installed with ActivePerl 5.8 to re-install the modules listed
in ppm_modules.txt.
If you have installed modules using the PPM included with earlier versions of ActivePerl 5.8, use the following steps to upgrade ActivePerl. PPM modules can only be migrated to later ActivePerl builds if you installed ActivePerl using the MSI Installer.
C:\Perl) except the site\lib directory.C:\Perl).If you are using ActivePerl to serve CGI / ASP scripts using IIS or another Web server, stop the Web server before installing ActivePerl.
Do not install over a 500 or 600 series build of ActivePerl. This package must be installed into a separate directory.
msiexec /i msi_file.msi
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 msi_file.msi ADDLOCAL="PERL_FEATURE,PERLIS"
The following features may be specified with the ADDLOCAL switch:
A set of command-line properties can be used to configure the installation. For example:
msiexec /i msi_file.msi TARGETDIR="c:\perl" PERL_PATH="Yes"
The following command-line switches can be used:
msiexec /i msi_file.msi /l log.txt
To enable verbose logging, use the '*v' modifier with the '/l' command line option. For example:
msiexec /i msi_file.msi /l*v log.txt
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.