CSWS_PERL
for Compaq Secure Web Server for OpenVMS Alpha

Installation Guide and Release Notes

CSWS_PERL Version 1.1
CPQ-AXPVMS-CSWS_PERL-V0101--1.PCSI

Contents:

Software prerequisites
Documentation
Before you begin the installation
Installing CSWS_PERL for OpenVMS
Post-installation task
Removing CSWS_PERL for OpenVMS
Release notes

CSWS_PERL V1.1 runs with Version 1.2 of the Compaq Secure Web Server for OpenVMS Alpha.

CSWS_PERL V1.1 is based on Mod_Perl V1.25, which is an upgraded version from previous CSWS_PERL versions.

Software Prerequisites

The CSWS_PERL for OpenVMS kit requires that the following software is installed before you install CSWS_PERL:

• OpenVMS Alpha Version 7.2-1 or higher
• Compaq Secure Web Server V1.2 for OpenVMS Alpha
• Perl V5.6.1

Documentation

For more information about MOD_PERL, see The Apache/Perl Integration Project.

See the Perl for OpenVMS Alpha Installation Guide and Release Notes for information about running Perl.

Before You Begin the Installation

Before you begin the installation of CSWS_PERL, do the following:

• 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 Compaq Secure Web Server can only see the version of Perl (V5.6.1) that has been modified to work with the Compaq Secure Web Server for OpenVMS Alpha. You can do this by adding the logical definitions to LOGIN.COM for the account running the Compaq 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.

  To define PERL_ROOT and PERLSHR, enter the following commands:

      $ DEFINE/JOB PERL_ROOT DKB100:[PERL5_006_01.]/TRANS=CONC
      $ DEFINE/JOB PERLSHR PERL_ROOT:[000000]PERLSHR.EXE
  

Installing CSWS_PERL for OpenVMS

To install the CSWS_PERL for Compaq Secure Web Server for OpenVMS Alpha kit, enter the following command.

Note: You must install the CSWS_PERL kit into the same device and directory where you installed Compaq Secure Web Server for OpenVMS.

For example:

$ SHOW LOGICAL APACHE$ROOT
  "APACHE$ROOT" = "DISK1:[WEB_SERVER.APACHE.SPECIFIC.hostname.]
        = "APACHE$COMMON:"
1   "APACHE$COMMON" = "DISK1:[WEB_SERVER.APACHE.]

$ PRODUCT INSTALL CSWS_PERL/DESTINATION=DISK1:[WEB_SERVER]

For a description of the features you can request with the PRODUCT INSTALL command when starting an installation such as running the IVP, purging files, and configuring the installation, see the POLYCENTER Software Installation Utility User's Guide.

As the installation procedure progresses, the system displays the following information.

        The following product has been selected:
            CPQ AXPVMS CSWS_PERL V1.1             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 V1.1

            Compaq Computer Corporation.

        * This product does not have any configuration options.

        Execution phase starting ...

        The following product will be installed to destination:
            CPQ AXPVMS CSWS_PERL V1.1          DISK1:[WEB_SERVER.]

        Portion done: 0%..20%..30%..40%..80%..100%

        The following product has been installed:
            CPQ AXPVMS CSWS_PERL V1.1             Layered Product

        CPQ AXPVMS CSWS_PERL V1.1

            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 APACHE::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 Compaq Secure Web Server for OpenVMS.

Post-Installation Task

• Review MOD_PERL.CONF

  Review the APACHE$COMMON:[CONF]MOD_PERL.CONF configuration file to be sure it enables all of the features required for your site.

Removing CSWS_PERL for Compaq Secure Web Server for OpenVMS

You can remove the CSWS_PERL kit by using the POLYCENTER Software Installation utility. The Compaq Secure Web Server must be shut down before you remove CSWS_PERL.

To remove CSWS_PERL, enter the following commands:

    $ SET DEF APACHE$ROOT:[000000]
    $ @SYS$STARTUP:APACHE$SHUTDOWN
    $ PRODUCT REMOVE CSWS_PERL

The PRODUCT REMOVE command removes all files created by this installation. It also attempts to remove the directories defined by this installation. The removal also deletes the reference to the MOD_PERL.CONF configuration file from the the HTTPD.CONF file.

Release Notes

This section contains notes on the current release of CSWS_PERL.

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

• Order of installing optional modules

  Previous CSWS_PERL kits required that you install CSWS_PERL before installing the MOD_JSERV kit, if you were installing both kits on the same system. This restriction has been removed. You can install CSWS_PERL before or after CSWS_JAVA (which contains MOD_JSERV), or you can install one without the other.

  However, you must install and configure Compaq Secure Web Server for OpenVMS and Perl for OpenVMS before you install CSWS_PERL.

• 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. This release of CSWS_PERL (V1.1) works with Perl V5.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
  

---