HP OpenVMS Systems

CSWS_JSERV installation guide and release notes

April 2, 2001

CSWS_JSERV V1.0
CPQ-AXPVMS-CSWS_JSERV-V0100--1.PCSI-DCX-AXPEXE

On this page you'll find information about:

» software prerequisites
» documentation
» downloading the kit
» expanding the kit
» installing CSWS_JSERV
» post-installation tasks
» release notes
» MOD_JSERV and JServ Servlet Engine release notes

CSWS_JSERV runs with Version 1.1, Version 1.0-1 and Version 1.0 of the Compaq Secure Web Server for OpenVMS Alpha.

software prerequisites

CSWS_JSERV for the Compaq Secure Web Server for OpenVMS Alpha requires the following software:

• OpenVMS Alpha Version 7.1 or later
• » Compaq Secure Web Server V1.1 for OpenVMS Alpha or
  Compaq Secure Web Server Version 1.0-1 for OpenVMS Alpha or
  Compaq Secure Web Server Version 1.0 for OpenVMS Alpha
• »  Compaq Java Development Kit Version 1.1.8-5 (or later) for OpenVMS Alpha
• » all patches required for Compaq Java Development Kit Version 1.1.8-5 (or later) for OpenVMS Alpha

For the Compaq Secure Web Server to use CSWS_JSERV, you must install the CSWS_JSERV kit on the same system on which you installed the web server.

documentation

For more information on Apache JServ and Apache JSSI, see the Java Apache Project website. General information about Apache is available from the Apache Software Foundation.

You can also access the CSWS_JSERV for the Compaq Secure Web Server class="udrline"Release Notes.

downloading the kit

Download CSWS_JSERV for the Compaq Secure Web Server self-extracting file.

»  CSWS_JSERV for Compaq Secure Web Server for OpenVMS Alpha

Make sure the file type of the saved file is .PCSI-DCX-AXPEXE.

expanding the kit

To expand the CSWS_JSERV self-extracting file, enter the following command:

$ RUN CPQ-AXPVMS-CSWS_JSERV-V0100--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_JSERV-V0100--1.PCSI. Do not rename this file.

installing CSWS_JSERV

To install the CSWS_JSERV kit, enter the following command where DISK$DKA0 is the name of the disk where you installed the Compaq Secure Web Server for OpenVMS.

$ PRODUCT INSTALL CSWS_JSERV/DEST=DISK$DKA0:[000000]

Note: Be sure to install CSWS_JSERV into the same disk and directory where you installed the Compaq Secure Web Server for OpenVMS.

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_JSERV V1.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_JSERV V1.0: JServ/JSSI modules for
Compaq Secure Web Server for OpenVMS Alpha

    COPYRIGHT (c) 1995-1999 The Apache Group.  All rights reserved.

* This product does not have any configuration options.

Execution phase starting ...

The following product will be installed to destination:
    CPQ AXPVMS CSWS_JSERV V1.0         DISK$DKA0:[000000]

Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%

The following product has been installed:
    CPQ AXPVMS CSWS_JSERV V1.0         Layered Product

CPQ AXPVMS CSWS_JSERV V1.0: JServ/JSSI modules for
Compaq Secure Web Server for OpenVMS Alpha

    Post installation tasks required for Jserv for OpenVMS Alpha
	Post installation tasks required for Jserv for OpenVMS Alpha

	        Please review apache$root:[jserv]configure_vms.com

	        This command procedure will configure the following:

	        Change ownership from SYSTEM (PCSI default) to Apache$www.

	        File: mod_jserv.conf
	                Add mod_jserv.so to mod_jserv.conf
	                Enable ApJServManual (Auto start it
                                 not supported on OpenVMS)
	                Define "JSERV_CONF" to "/apache$root/conf"
	                Define "JSERV_LOG" to "logs"
	                Copy mod_jserv.conf to apache$common:[conf]

	        File: JSERV.PROPERTIES
	                Define JSERV_CONF to "/apache$root/conf"
	                Define JSERV_LOG to "/apache$root/logs"

        If you are satisfied with the defaults, execute configure_vms.com once.

post-installation tasks

1. After the installation is complete, enter the following commands:

   $ SET DEFAULT APACHE$ROOT:[JSERV]
   $ @CONFIGURE_VMS.COM
   

   After you run CONFIGURE_VMS.COM, perform a shutdown and then a startup of the Compaq Secure Web Server. This will start one JServ process. (A restart will not start the JServ process.)

2. This kit includes the jar file needed for JSSI support. To enable this support, uncomment the following line from MOD_JSERV.CONF and restart the server:

   #ApJServAction .jhtml /servlets/org.apache.servlet.ssi.SSI
   

   Note: JHTML files must be in STREAM_LF format. See the Release Notes for information about how to convert your files to STREAM_LF.

3. See the MOD_JSERV and JServ Servlet Engine release notes for instructions on how to run the Hello.java example program.

release notes

This section contains notes on the current release of CSWS_JSERV.

• JHTML files must be in STREAM_LF format. If the file is in a different format, the JSSI processor will fail.

  To convert your file to STREAM_LF, enter the following:

  $ CONVERT/FDL=STREAM_LF.FDL infile.JHTML outfile.JHTML
  

  The FDL file should contain the following lines:

  $ TYPE STREAM_LF.FDL
  
  FILE
     ALLOCATION              4
     BEST_TRY_CONTIGUOUS     yes
     EXTENSION               0
     ORGANIZATION            sequential
  
  RECORD
     BLOCK_SPAN              yes
     FORMAT                  stream_LF
     SIZE                    0
  

• If you are installing Compaq Java Development Kit Version 1.1.8-3 for OpenVMS Alpha on a system that has a previous version of the JDK installed, be sure that you delete or move the previous version of the JDK11*_CLASSES.ZIP file from the SYS$COMMON:[JAVA.LIB] directory before you begin the installation. Otherwise, problems may occur when you start the JServ process.

• The names of the examples in the EXAMPLE directory are case-sensitive. Although the .CLASS files appear in uppercase in the EXAMPLE directory, the URL must specify "Hello" and "IsItWorking" for the examples to work.

• The JSERV.LOG file remains empty until sufficient data causes the buffer to be flushed. If the server is shut down, the log file is empty. To avoid this situation, modify the logical JAVA$FILE_OPEN_MODE to 2 in the file START_JSERV_MANUAL.COM (located in APACHE$COMMON:[000000]). Note: Setting this logical to 2 might negatively affect system performance. Compaq recommends that you modify this logical only for diagnostic purposes and not for production use.

» return to the Compaq Secure Web Server for OpenVMS home page