SOAP Toolkit for HP OpenVMS
Installation Guide and Release Notes
February 2007
Version 2.0
Based on Apache Axis Version 1.1
Contents:
Hardware Prerequisites
Software Prerequisites -- Client
Software Prerequisites -- Server
Removing the Previous Version
Downloading the ToolKit
Expanding the ToolKit
Installing the SOAP Kit
After Installing the ToolKit
Installing the Sources and Documentation
Removing the Kit
Known Issues
Release Notes
Support
Before Installing the SOAP Toolkit
----------------------------------
Hardware Prerequisites
----------------------
The SOAP Toolkit for OpenVMS is available on OpenVMS Alpha
and OpenVMS Industry Standard 64 (I64).
Disk Space Requirements
-----------------------
The SOAP Toolkit Version V2.0 self-extractable file for
OpenVMS Alpha and I64 requires approximately
42,000 blocks of disk space. The product installation
requires approximately 100,200 blocks of disk space.
Software Prerequisites - Client
-------------------------------
The following software is required to call web services
with the SOAP Toolkit for OpenVMS:
For OpenVMS Alpha:
- HP OpenVMS Alpha Version 7.3-2 (or higher)
- HP Software Development Kit (SDK) for the Java
Platform Version 1.4.2 (or higher)
For OpenVMS I64:
- HP OpenVMS I64 Version 8.2 (or higher)
- HP Software Development Kit (SDK) for the Java
Platform Version 1.4.2 (or higher)
For both Alpha and I64:
All patches required for SDK for the Java Platform.
Check the SDK
documentation for the version of Java you are
installing to be sure that you
have all prerequisite OpenVMS Alpha patches.
- JAXP-1.1 compliant XML parser such as Xerces or
Crimson must be configured before the SOAP toolkit
will operate. (However, you may install the SOAP toolkit
without an XML parser being configured.)
Note: The Crimson parser is included with the Java SDK
Version 1.4 (or higher). A Xerces
parser is included in the SOAP Toolkit. To use this
parser, add it to your classpath after
installation. For example:
$ define java$classpath disk$:
[axis-1_1.openvms.libjars]
xercesImpl.jar
Software Prerequisites - Server
-------------------------------
The following software is required to deploy web services
with the SOAP Toolkit for OpenVMS:
- All Axis client prerequisites
- A Java Servlet container
When deploying web services with the OpenVMS SOAP Toolkit,
a servlet container is required to host the
Axis Servlet. There are three configuration options for
establishing a Servlet container, as follows:
* Use the built-in Java Servlet container named
SimpleAxisServer. (See Axis documentation.)
Note: SimpleAxisServer is NOT a production weight web
server, but is appropriate for evaluation or
prototyping and testing in a development environment.
* Use Tomcat (CSWS_JAVA) as the servlet container while
using the built-in web server in Tomcat.
* Use Tomcat (CSWS_JAVA) as the servlet container and the
Apache-based Secure Web Server
(CSWS) as your web server.
The SOAP Toolkit for OpenVMS has been tested on Alpha with
the following versions of CSWS and
CSWS_JAVA:
- HP Secure Web Server (CSWS) Version 1.2 (or higher) for
OpenVMS
- CSWS_JAVA Version 2.0 (or higher) for Secure Web Server
for OpenVMS
The SOAP Toolkit for OpenVMS has been tested on I64 only
with the included SimpleAxisServer.
Note: Installing on an ODS-5 enabled disk is required.
Removing the Previous Version
-----------------------------
There are two ways a user can remove the previous versions:
1. Run AXIS$ROOT:[000000]
UNINSTALL_SOAP_TOOLKIT-2_0.COM
to remove the product. For example,
$ @AXIS$ROOT:[000000]UNINSTALL_SOAP_TOOLKIT-2_0.COM
2. PCSI product installation provides an option to
delete the previous version of the kit. It checks for
AXIS$ROOT:[000000]UNINSTALL_SOAP_TOOLKIT-2_0.COM and
prompts for un-installation.
Downloading and Installing the SOAP Toolkit
-------------------------------------------
Downloading the Kit
-------------------
The SOAP Toolkit for OpenVMS can be obtained in three
different ways:
1. OpenVMS Alpha via the e-Biz CDs for OpenVMS Alpha
2. I64 Delta CDs for OpenVMS Integrity
3. OpenVMS website for both OpenVMS Alpha and
Integrity. To download the kit, please submit the
registration form.
Expanding the Kit
-----------------
To expand the SOAP Toolkit for OpenVMS, perform the
following steps:
1. Create a temporary directory on an ODS-5 disk to hold
the installation files that will
be extracted from the SOAP-V0200-I64.EXE or
SOAP-V0200-AXP.EXE file. For example:
$ CREATE/DIRECTORY DISK$:[TEMP]
2. Copy SOAP-V0200-I64.EXE or SOAP-V0200-AXP.EXE to the
temporary directory created in Step 1.
3. Set default to the temporary directory created in
Step 1. For example:
$ SET DEFAULT DISK$:[TEMP]
4. Enter the following command to extract relevant files
from the SOAP kit.
$ RUN SOAP-V0200-I64.EXE (For Integrity)
$ RUN SOAP-V0200-AXP.EXE (For Alpha)
The following provides the procedure for expanding the
self-extractable kit on OpenVMS Alpha and I64 respectively:
RUN SOAP-V0200-AXP.EXE
UnZipSFX 5.41 of 16 April 2000, by Info-ZIP (Zip-
Bugs@lists.wku.edu)
inflating: HP-VMS-SOAP-V0200--1.PCSI$COMPRESSED
inflating: HP-VMS-SOAP-V0200--1.PCSI$COMPRESSED_ESW
$ RUN SOAP-V0200-I64.EXE
UnZipSFX 5.42 of 14 January 2001, by Info-ZIP (Zip-
Bugs@lists.wku.edu).
inflating: HP-VMS-SOAP-V0200--1.PCSI$COMPRESSED
inflating: HP-VMS-SOAP-V0200--1.PCSI$COMPRESSED_ESW
Installing the Kit
------------------
To install the SOAP Toolkit for OpenVMS, enter a command
similar to the following:
$ prod install soap
The following product has been selected:
HP VMS SOAP 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.
HP VMS SOAP V2.0: SOAP Toolkit Version 2.0 for OpenVMS,
based on Apache Axis 1.1
© Copyright 2007 Hewlett-Packard Development Company, L.P.
Hewlett-Packard Company
* This product does not have any configuration options.
Execution phase starting ...
The following product will be installed to destination:
HP VMS SOAP V2.0 DISK$ALPHASYS:[VMS$COMMON.]
Portion done: 0%...10%...20%...30%...40%...50%...90%
AXIS$ROOT has been defined.
The following logical must be added to
SYS$MANAGER:SYLOGICALS.COM so that it will
be defined each time the system is rebooted.
$ define/sys/nolog/trans=concealed AXIS$ROOT DISK$ALPHASYS:
[SYS0.SYSCOMMON.AXIS.]
After finishing the SOAP Toolkit 2.0 installation, we
recommend that you execute
the installation validation tests by running
soap_toolkit-2_0_util.com.
@AXIS$ROOT:[AXIS-1_1.openvms.coms]soap_toolkit-2_0_util.com
For documentation on AXIS and for further instructions
please access
the Apache AXIS website at the following url.
http://ws.apache.org/axis/
...100%
The following product has been installed:
HP VMS SOAP V2.0 Layered Product
$
After Installing the SOAP Toolkit
---------------------------------
After the installation is complete, perform the following
tasks.
1. Run the validation tests.
a. In one OpenVMS terminal session enter the following
command to startup the SimpleAxisServer:
$ @AXIS$ROOT:[AXIS-1_1.openvms.coms]
start_simple_axis_server
Following is a log of a validation test run as viewed from
this terminal session:
$ @AXIS$ROOT:[AXIS-1_1.openvms.coms]
start_simple_axis_server
Enter Port Number[8080]
%DCL-S-SPAWNED, process axis_server spawned
%DCL-S-ATTACHED, terminal now attached to process
axis_server
Dec 10, 2006 11:22:59 AM
org.apache.axis.transport.http.SimpleAxisServer run
INFO: SimpleAxisServer starting up on port 8080.
Dec 10, 2006 11:25:06 AM org.apache.axis.utils.Admin
processWSDD
SEVERE: Administration service requested to quit, quitting.
Dec 10, 2006 11:25:06 AM
org.apache.axis.transport.http.SimpleAxisServer stop
INFO: SimpleAxisServer quitting.
%DCL-S-RETURNED, control returned to process _TNA34:
$
b. In another OpenVMS terminal session enter the following
command to run the validation tests:
$ @AXIS$ROOT:[AXIS-1_1.openvms.coms]
soap_toolkit-2_0_util.com
Following is a log of a validation test run as viewed from
this terminal session:
$ @AXIS$ROOT:[AXIS-1_1.openvms.coms]
soap_toolkit-2_0_util.com
SOAP Toolkit 2.0 (based on Apache AXIS) Utility
-----------------------------------------------
1 - Show current configuration
2 - Run SOAP Toolkit 2.0 Validation Procedure
3 - Copy supplemental jar files to AXIS$ROOT:[AXIS-1_1.LIB]
E. Exit SOAP Toolkit 2.0 Utility
------------------------------------------------
Please choose a task: 2
The SOAP Toolkit 2.0 validation tests will now be run.
Note: The OpenVMS SOAP Toolkit V2.0 kit provides optional
jar files in
AXIS$ROOT:[AXIS-1_1.OPENVMS.LIBJARS]. These files are often
needed to use AXIS but
are not included in the AXIS distribution from the Apache
Group. They are included
in the OpenVMS SOAP Toolkit as a convenience for the user.
This validation procedure will use the optional jar files
to run the installation
verification tests. You have the option of using these jar
files in your SOAP Toolkit
deployment. To use these jar files, choose option 3 from
this utility to copy the files
to AXIS$ROOT:[AXIS-1_1.LIB]
The SOAP Toolkit 2.0 Validation Tests require that the
Simple Axis Server be started in
another process. The Simple Axis Server is a web server
provided in the Axis distribution
to be used for prototyping.
Please execute the command below from a different terminal
window.
@axis$root:[axis-1_1.openvms.coms]start_simple_axis_server
By default the Simple Axis Server will listen on port 8080.
If this port is already in
use you may specify a different port number as an argument
to the command procedure.
For example:
@axis$root:[axis-1_1.openvms.coms]start_simple_axis_server
999
If a different port was specified when calling
start_simple_axis_server.com then provide that port number
below.
Enter the port number on which Simple Axis Server is
listening [8080]:
... Running validation tests...This may take a few
moments...
%DCL-S-SPAWNED, process soap_val_tsts spawned
%DCL-S-ATTACHED, terminal now attached to process
soap_val_tsts
%DCL-S-RETURNED, control returned to process _FTA149:
The results of the validation tests are saved to a log
file. Please compare the tests
results log file against the benchmark log file provided in
the same directory. The benchmark log file shows the
expected results when the validation tests complete
successfully.
The log file produced is:
AXIS$ROOT:[AXIS-1_1.OPENVMS.VALIDATION-TESTS]
validate_soap_toolkit_install.log
The benchmark log file is:
AXIS$ROOT:[AXIS-1_1.OPENVMS.VALIDATION-TESTS]
validate_benchmark.log
To compare the two log files use the command:
$diff /ignore=(spacing,blank,trailing)-
AXIS$ROOT:[AXIS-1_1.OPENVMS.VALIDATION-TESTS]
validate_soap_toolkit_install.log-
AXIS$ROOT:[AXIS-1_1.OPENVMS.VALIDATION-TESTS]
validate_benchmark.log
Choice (R- Return to Menu) (E- Exit): E
2. Check the results of the validation test log
validate_soap_toolkit_install.log by performing a DIFF
against the validate_benchmark.log file supplied in the
validation-tests directory as instructed when running the
validation procedure selection
Run SOAP Toolkit 2.0 Validation Procedure as documented
above in step 1.
Note: If a port number other than the default 8080 was
used, then this will show up in the DIFF of the log and
benchmark files.
Following is a log of a DIFF:
$ diff /ignore=(spacing,blank,trailing)-
_$ AXIS$ROOT:[AXIS-1_1.OPENVMS.VALIDATION-TESTS]
validate_soap_toolkit_install.log -
_$ AXIS$ROOT:[AXIS-1_1.OPENVMS.VALIDATION-TESTS]
validate_benchmark.log
Number of difference sections found: 0
Number of difference records found: 0
DIFFERENCES /IGNORE=(SPACING,TRAILING_SPACES,BLANK_LINES)/
MERGED=1-
AXIS$ROOT:[AXIS-1_1.openvms.validation-tests]
VALIDATE_SOAP_TOOLKIT_INSTALL.LOG;1
AXIS$ROOT:[AXIS-1_1.openvms.validation-tests]
validate_benchmark.log;1
$
Note: If a port number other than the default 8080 was
used, this will show up in the DIFF of the validation run
log and benchmark files.
The following shows the contents of a successful validation
test log:
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
BEGIN - Run Validation Test: Stock
Processing file /axis$root/axis-1_1/samples/stock/
deploy.wsdd
Done processing
Test Command: java "samples.stock.GetInfo" -p 8080 "CSCO"
"name"
CSCO: Cisco Systems
Processing file /axis$root/axis-1_1/samples/stock/
undeploy.wsdd
Done processing
END - Run Validation Test: Stock
------------------------------------------------------------
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
BEGIN - Run Validation Test: Userguide example3
Processing file /axis$root/axis-1_1/samples/userguide/
example3/deploy.wsdd
Done processing
Test Command: java "samples.userguide.example3.Client" -p
8080 "Look what I typed!"
You typed : Look what I typed!
Processing file /axis$root/axis-1_1/samples/userguide/
example3/undeploy.wsdd
Done processing
END - Run Validation Test: Userguide example3
------------------------------------------------------------
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
BEGIN - Run Validation Test: Userguide example4
Processing file /axis$root/axis-1_1/samples/userguide/
example4/deploy.wsdd
Done processing
Test Command: java "samples.userguide.example4.Client" -p
8080
Hi, you've reached the testMethod.
END - Run Validation Test: Userguide example4
------------------------------------------------------------
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
BEGIN - Run Validation Test: Userguide example5
Processing file /axis$root/axis-1_1/samples/userguide/
example5/deploy.wsdd
Done processing
Test Command: java "samples.userguide.example5.Client" -p
8080
Hi, Glen Daniels!
You seem to have ordered the following:
1 of item : mp3jukebox
4 of item : 1600mahBattery
If this had been a real order processing system, we'd
probably have charged you about now.
END - Run Validation Test: Userguide example5
------------------------------------------------------------
Shutting down SimpleAxisServer...
quitting.
$
3. Add the following line to SYS$MANAGER:SYLOGICALS.COM so
that this logical is defined to make AXIS automatically
available each time the system is rebooted.
$ define/sys/nolog/trans=concealed AXIS$ROOT DISK$:
[AXIS.]
where DISK$:[AXIS.] is the location where you installed the
SOAP Toolkit Version 2.0.
Installing the Sources and Documentation
----------------------------------------
The sources and documentation are provided in the form a
backup saveset. Execute the following command to restore
the documentation and sources.
$ set def AXIS$ROOT:[000000]
$ @soap_restore_backups.com
*** THIS PROCEDURE WILL LET YOU RESTORE DOCUMENTATION OR
SOURCE OR BOTH ON TO AXIS$ROOT:[000000 ] ***
1. RESTORE DOCUMENTATION ONLY
2. RESTORE SOURCES ONLY
3. RESTORE DOCUMENTATION AND SOURCES
4. EXIT
TYPE 1 OR 2 OR 3 OR 4 : 1
BACKUP RESTORE OPERATION STARTS.....
DOCUMENTATION IS RESTORED.
$ @soap_restore_backups.com
*** THIS PROCEDURE WILL LET YOU RESTORE DOCUMENTATION OR
SOURCE OR BOTH ON TO AXIS$ROOT:[000000 ] ***
1. RESTORE DOCUMENTATION ONLY
2. RESTORE SOURCES ONLY
3. RESTORE DOCUMENTATION AND SOURCES
4. EXIT
TYPE 1 OR 2 OR 3 OR 4 : 2
BACKUP RESTORE OPERATION STARTS.....
SOURCE IS RESTORED
$ @soap_restore_backups.com
*** THIS PROCEDURE WILL LET YOU RESTORE DOCUMENTATION OR
SOURCE OR BOTH ON TO AXIS$ROOT:[000000 ] ***
1. RESTORE DOCUMENTATION ONLY
2. RESTORE SOURCES ONLY
3. RESTORE DOCUMENTATION AND SOURCES
4. EXIT
TYPE 1 OR 2 OR 3 OR 4 : 3
BACKUP RESTORE OPERATION STARTS.....
DOCUMENTATION AND SOURCES ARE RESTORED
$ @soap_restore_backups.com
*** THIS PROCEDURE WILL LET YOU RESTORE DOCUMENTATION OR
SOURCE OR BOTH ON TO AXIS$ROOT:[000000 ] ***
1. RESTORE DOCUMENTATION ONLY
2. RESTORE SOURCES ONLY
3. RESTORE DOCUMENTATION AND SOURCES
4. EXIT
TYPE 1 OR 2 OR 3 OR 4 : 4
$
Removing the Kit
----------------
To remove the SOAP Toolkit Version 2.0 kit, enter the
following command:
$ prod remove soap
The following information is displayed:
$ prod remove soap
The following product has been selected:
HP VMS SOAP V2.0 Layered Product
Do you want to continue? [YES]
The following product will be removed from destination:
HP VMS SOAP V2.0 DISK$I64SYS:[VMS$COMMON.]
Portion done:
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
The following product has been removed:
HP VMS SOAP V2.0 Layered Product
Known Issues
------------
On OpenVMS V7.3-2, removing the SOAP product will display
the following error messages, but the un-installation is
not affected. You will have to manually delete these files.
$ prod remove soap
The following product has been selected:
HP VMS SOAP V2.0 Layered Product
Do you want to continue? [YES]
The following product will be removed from destination:
HP VMS SOAP V2.0 DISK$ALPHASYS:[VMS$COMMON.]
Portion done: 0%...10%
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
webapps.axis.web-inf.classes.samples.attachments]
EchoAttachmentsService$MemoryOn
lyDataSource.class;1
-SYSTEM-W-BADFILENAME, bad file name syntax
Portion done: 20%...30%...40%...50%...60%
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
test.badWSDL]
Error-OutputInOperationWithUndefinedMessage.wsdl;1
-SYSTEM-W-BADFILENAME, bad file name syntax
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
test.badWSDL]
Error-OutputInOperationWithMissingMessageAttribute.wsdl;1
-SYSTEM-W-BADFILENAME, bad file name syntax
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
test.badWSDL]
Error-InputInOperationWithUndefinedMessage.wsdl;1
-SYSTEM-W-BADFILENAME, bad file name syntax
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
test.badWSDL]
Error-InputInOperationWithMissingMessageAttribute.wsdl;1
-SYSTEM-W-BADFILENAME, bad file name syntax
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
test.badWSDL]
Error-FaultInOperationWithUndefinedMessage.wsdl;1
-SYSTEM-W-BADFILENAME, bad file name syntax
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
test.badWSDL]
Error-FaultInOperationWithUndefinedMessage-MultipleFaults.wsdl;1
-SYSTEM-W-BADFILENAME, bad file name syntax
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
test.badWSDL]
Error-FaultInOperationWithMissingMessageAttribute.wsdl;1
-SYSTEM-W-BADFILENAME, bad file name syntax
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
test.badWSDL]
Error-FaultInOperationWithMissingMessageAttribute-MultipleFaults.ws
dl;1
-SYSTEM-W-BADFILENAME, bad file name syntax
Portion done: 70%...80%...90%
%PCSI-E-FILNOTPUR, error deleting DISK$ALPHASYS:
[SYS0.SYSCOMMON.][AXIS.AXIS-1_1.
samples.attachments]
EchoAttachmentsService$MemoryOnlyDataSource.class;1
-SYSTEM-W-BADFILENAME, bad file name syntax
Portion done: 100%
The following product has been removed:
HP VMS SOAP V2.0 Layered Product
Release Notes
-------------
This section contains notes on the current release of the
SOAP Toolkit for OpenVMS.
There are currently no release notes for the Version 2.0
kit.
Support
-------
Customer Release Versions
See the SOAP Toolkit Software Support page for information.
For technical feedback to the HP SOAP Toolkit for OpenVMS
engineering team, please send mail.