 |
|
|
|
|
CSWS_PERL Version 2.0 requires that the following software is
installed before you install CSWS_PERL:
CSWS_PERL Version 1.1 requires that the following software is
installed before you install CSWS_PERL:
|
|
|
|
|
|
To expand the CSWS_PERL for OpenVMS Alpha self-extracting file, enter one
of the following commands, depending on the file you downloaded:
$ RUN CPQ-AXPVMS-CSWS_PERL-V0200--1.PCSI-DCX-AXPEXE
$ RUN CPQ-AXPVMS-CSWS_PERL-V0101--1.PCSI-DCX-AXPEXE
The system displays information about the
file compression version, and help information
about the command syntax.
At the Decompress into (file specification): prompt,
press return. The system expands the file and names the decompressed file
CPQ-AXPVMS-CSWS_PERL-V0200--1.PCSI or
CPQ-AXPVMS-CSWS_PERL-V0101--1.PCSI. Do not rename this file.
|
|
|
|
|
|
Before you begin the installation of CSWS_PERL, do the following:
- Install prerequisite software
Install the Secure Web Server and Perl for OpenVMS, if they are not already installed.
- Add logical definitions for Perl
You must define the logical PERL_ROOT before you install or remove
the CSWS_PERL kit. The CSWS_PERL kit installs several files that
extend the capabilities of Perl. The PERL_ROOT logical must be available
to CSWS_PERL in order to add and remove those files.
If you are running multiple
versions of Perl, make sure that the Secure Web Server for OpenVMS can only
"see" the version of Perl that has been modified to work
with the Secure Web Server.
You can do this by adding
the logical definitions to LOGIN.COM for the account
running the Secure Web Server. Note that if the logicals are
defined this way, they must be JOB logicals so that they can be
passed to any subprocesses.
For example, to define PERL_ROOT and PERLSHR, enter the following commands:
$ DEFINE/JOB/TRANSLATION=CONCEALED -
_$ PERL_ROOT DKB100:[PERL5_006_01.]
$ DEFINE/JOB PERLSHR PERL_ROOT:[000000]PERLSHR.EXE
- Shut down the Secure Web Server
Be sure that the Secure Web Server is shut down before you begin
the installation of CSWS_PERL. Enter the following command:
$ @SYS$STARTUP:APACHE$SHUTDOWN
|
|
|
|
|
|
To install the CSWS_PERL for Secure Web Server for OpenVMS Alpha kit, enter the following command.
$ PRODUCT INSTALL CSWS_PERL/DESTINATION=DISK1:[WEB_SERVER]
Note: You must install the CSWS_PERL kit into the same
device and directory where you installed the Secure Web Server for OpenVMS.
To see where the Secure Web Server is installed, enter the following command:
$ SHOW LOGICAL APACHE$ROOT
"APACHE$ROOT" = "DISK1:[WEB_SERVER.APACHE.SPECIFIC.hostname.]
= "APACHE$COMMON:"
1 "APACHE$COMMON" = "DISK1:[WEB_SERVER.APACHE.]
As the installation procedure progresses, the system displays
the following information.
$ PRODUCT INSTALL CSWS_PERL/DESTINATION=DISK1:[WEB_SERVER]
The following product has been selected:
CPQ AXPVMS CSWS_PERL V2.0 Layered Product
Do you want to continue? [YES]
Configuration phase starting ...
You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.
CPQ AXPVMS CSWS_PERL V2.0
Compaq Computer Corporation & The Apache Software Foundation.
* This product does not have any configuration options.
Execution phase starting ...
The following product will be installed to destination:
CPQ AXPVMS CSWS_PERL V2.0 DISK1:[WEB_SERVER]
Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
The following product has been installed:
CPQ AXPVMS CSWS_PERL V2.0 Layered Product
CPQ AXPVMS CSWS_PERL V2.0
Post-installation tasks are required for Mod_Perl for OpenVMS.
The release notes give detailed directions. This information
is a brief checklist.
This installation modifies APACHE$ROOT:[CONF]HTTPD.CONF to
enable Mod_Perl. Check HTTPD.CONF for accuracy. The line
"Include /apache$root/conf/mod_perl.conf" should be the only
difference. Also study the Mod_Perl configuration file
(APACHE$ROOT:[CONF]MOD_PERL.CONF) for options required for your
site. The Modperl::Registry module is enabled by default and
the location "/perl" is defined to access it.
The Apache server must be shutdown and restarted to make these
changes to the HTTPD.CONF file take place. Test that Mod_Perl
is working by accessing the sample script from a browser:
http://<your web server host>/perl/perl_rules.pl
Thank you for using the Secure Web Server based on Apache.
|
|
|
|
|
|
This section contains notes on the current release of CSWS_PERL.
- Apache Perl modules require changes in mod_perl 2.0
Many Apache Perl modules that currently run under mod_perl 1.0 will
require changes to run under mod_perl 2.0. Basic functionality has
changed, and there are also changes to file locations.
See the Apache Perl website for
detailed information on porting Apache Perl modules to mod_perl 2.0 at
http://perl.apache.org/docs/2.0/user/porting/porting.html.
- Problem corrected: CSWS_PERL logical names exceeding 255 characters
CSWS_PERL uses logical names to contain environment variables used by Perl scripts.
Previously, if the equivalence string for any logical name exceeded 255 characters, CSWS_PERL
terminated with the following error in APACHE$ROOT:[LOGS]ERROR_LOG:
Fatal VMS error (status=340) at ROOT$:[PERL5_005_03]VMS.C;2
This error was most likely to occur if your browser transmits an HTTP_ACCEPT string
that exceeds 255 characters.
This error has been corrected in Perl V5.5-3A2 and higher for OpenVMS. If you have an earlier
version of Perl, download and install the latest version of Perl,
then reinstall
CSWS_PERL to correct this problem.
- File protections of Perl scripts
When you create a Perl script, make sure it is world readable and world
executable.
For example:
$ SET FILE/PROTECTION=W:RE MYSCRIPT.PL
- Tracking versions of CSWS_PERL and Perl
The CSWS_PERL and
Perl kits are tightly connected. Future versions of Perl
or CSWS_PERL may not interact correctly across version numbers.
CSWS_PERL Version 2.0
works with Perl for OpenVMS Version 5.6.1 ECO 3.
CSWS_PERL Version 1.1
works with Perl for OpenVMS Version 5.6.1.
- Shareable image mismatch
If you are pointing at the
wrong version of Perl, an ident mismatch occurs and
the following error appears in the log file.
Syntax error on line 207 of /apache$root/conf/httpd.conf:
Can't locate API module structure `perl_module' in file
/apache$root/mod_perl.exe:
%LIB-E-ACTIMAGE, error activating image !AS
To correct this problem, see the Add logical definitions for Perl section in
Before Beginning the
Installation.
» Return to the Secure Web Server for OpenVMS home page
|
|
|
