SOAP Toolkit for HP OpenVMS
Installation Guide and Release Notes
January 2005
Version 2.0 Contents:
» Before Installing the SOAP Toolkit
» Downloading and Installing the SOAP Toolkit
Based on Apache Axis Version 1.1
» Support
Before
Installing the SOAP Toolkit |
|
Hardware
Prerequisites |
The SOAP Toolkit for OpenVMS is available on OpenVMS Alpha and OpenVMS Industry Standard 64.
Disk Space Requirements
The SOAP Toolkit Version 2.0 Java archive (JAR) file requires approximately 30,000 blocks (14.6 MB) of disk space. Expanding the JAR file requires an additional 32,000 blocks (15.7 MB).
The installation procedure allows you to choose to install some or all of the SOAP Toolkit components. The total disk space required is approximately 26,000 blocks (12.7 MB) to 92,000 blocks (45 MB), depending on the installation options you choose.
|
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.2-2 (or higher)
- » HP Software Development Kit (SDK) for the Java™ Platform Version 1.3.1 (or higher)
For OpenVMS Industry Standard 64:
- HP OpenVMS I64 Version 8.2 (or higher)
» HP Software Development Kit (SDK) for the Java™ Platform Version 1.4.2 (or higher) for HP OpenVMS I64
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.
» 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 IA64 only with the included SimpleAxisServer.
Note: Installing on an ODS-5 enabled disk is required.
|
Removing
the Previous Version |
Before you install SOAP Toolkit Version 2.0 for OpenVMS, you must remove the SOAP Toolkit Version 1.1 (or 1.0) for OpenVMS if it was previously installed.
To remove the Version 1.1 kit, invoke the uninstall procedure by entering the following command:
$ @SOAP$ROOT:[000000]UNINSTALL_SOAP-1_1
To remove the Version 1.0 kit, invoke the uninstall procedure by entering the following command:
$ @SOAP$ROOT:[SOAP_Tools-1_0]UNINSTALL_SOAP-1_0
|
Downloading
and Installing the SOAP Toolkit |
|
Downloading
the Kit |
The SOAP Toolkit for OpenVMS kit is included with the OpenVMS I64 and OpenVMS Alpha layered product distributions. A compressed, self-extracting file is also available for download from the SOAP Toolkit for OpenVMS web site.
|
Expanding
the Kit |
To expand the SOAP Toolkit for OpenVMS JAR file, perform the following steps:
- Invoke the appropriate Java setup procedure for the installed version
of Java, if you have not already done so. See SYS$MANAGER:JAVA$*SETUP.COM
(for example, SYS$MANAGER:JAVA$142_SETUP.COM).
- Create a temporary directory on an ODS-5 disk to hold the installation
files that will be extracted from the SOAP-TOOLS-2_0.JAR file. For example:
$ CREATE/DIRECTORY DISK$:[TEMP]
- Copy SOAP-TOOLS-2_0.JAR to the temporary directory created in Step 2.
- Enter the following command:
$ DEFINE/NOLOG DECC$EFS_CASE_PRESERVE ENABLE
- Set default to the temporary directory created in Step 2. For example:
$ SET DEFAULT DISK$:[TEMP]
- Enter the following command to extract relevant files from the SOAP kit.
$ jar -xvf SOAP-TOOLS-2_0.JAR
This command extracts INSTALL_SOAP_TOOLKIT-2_0.COM, UNINSTALL_SOAP_TOOLKIT-2_0.COM, and a number of other files needed to complete the installation.
Following is an example of expanding the SOAP-TOOLS-2_0.JAR file.
$ @SYS$MANAGER:java$131_setup Setting up symbols for foreign command line usage... JAVA$FILENAME_CONTROLS now set to: -1 $ CREATE/DIRECTORY DISK$:[TEMP] $ COPY SOAP-TOOLS-2_0.JAR DISK$:[TEMP] $ SET DEFAULT DISK$:[TEMP] $ jar xvf SOAP-TOOLS-2_0.JAR created: axis-1_1/ created: axis-1_1/documentation/ extracted: axis-1_1/documentation/AXIS-docs-1_1.jar created: axis-1_1/examples/ extracted: axis-1_1/examples/AXIS-samples-1_1.jar created: axis-1_1/kit/ extracted: axis-1_1/kit/AXIS-bin-1_1.jar extracted: axis-1_1/kit/AXIS-webapps-1_1.jar extracted: axis-1_1/kit/doc_descrips-1_1.txt extracted: axis-1_1/kit/install_soap_toolkit-2_0.com extracted: axis-1_1/kit/src_descrips-1_1.txt extracted: axis-1_1/kit/uninstall_soap_toolkit-2_0.com created: axis-1_1/sources/ extracted: axis-1_1/sources/AXIS-src-1_1.jar
|
Installing
the Kit |
Before you begin installing the SOAP Toolkit Version 2.0, be sure you have removed the V1.1 or V1.0 versions of the SOAP Toolkit, if they were previously installed.
The installation command procedure is located in the sub directory [.AXIS-1_1.KIT].
To install the SOAP Toolkit for OpenVMS kit, enter a command similar to the following:
$ @DISK$:[TEMP.AXIS-1_1.KIT]INSTALL_SOAP_TOOLKIT-2_0.COM
Following is an example of an installation log.
SOAP Toolkit 2.0 (based on Apache Axis 1.1) Installation Procedure
--------------------------------------------------------------------
Before installing this kit, please make sure that the following prerequisites
have been met. If they have not been met, the installation procedure may be
unable to complete and may terminate:
For the Alpha Architecture:
1) The installed operating system is OpenVMS Alpha V7.2-2 or later.
2) Software Development Kit (SDK) for the Java Platform Version
1.3.1 (or higher) is installed, including any required OpenVMS
patches.
For the IA64 Architecture:
1) The installed operating system is OpenVMS I64 Evaluation Release
8.1 or later.
2) Software Development Kit (SDK) for the Java Platform Version
1.4.2 (or higher) is installed, including any required OpenVMS
patches.
For either Architecture:
3) An ODS-5 enabled disk is available and mounted.
***********************************************************
Note
Questions, where indicated, accept a response of
"H" to request additional Help and information.
***********************************************************
Please enter the ODS-5 target destination device and directory or logical name
indicating the location where you would like to install SOAP Toolkit 2.0.
This location will become the base directory for SOAP Toolkit 2.0: (H) [ SYS$SYSDEVICE:[AXIS] ] : SYS$SYSDEVICE:[AXIS]
SYS$SYSDEVICE:[AXIS] does not exist.
Would you to create this directory? (Y, N) [Y] : Y
Documentation
------------------
The documentation included with SOAP Toolkit 2.0 consists of documentation
for AXIS itself (User's Guide and API reference) as well as documentation
for other components required to install the product.
Most documentation is in the form of HTML files. Using a web browser, the
documentation can be accessed locally or remotely if served by a locally
installed web server, or accessed locally without a web server by accessing
the files directly.
Installing documentation is optional. Even if you decide to install none of
the documentation, it will still be available to you online.
You can choose to install all of the documentation, or none of it.
-----------------------------------------------------------------
1. [ ] Axis V1.1 Documentation ~ 51646 blocks
-----------------------------------------------------------------
[x] = Selected, [ ] = Not Selected
Enter: 1 through 1 - To toggle a selection
A - To select All documentation
N - To select No documentation
Y - To proceed with the installation
A, N, 1-1, or Y : A
-----------------------------------------------------------------
1. [x] Axis V1.1 Documentation ~ 51646 blocks
-----------------------------------------------------------------
[x] = Selected, [ ] = Not Selected
Enter: 1 through 1 - To toggle a selection
A - To select All documentation
N - To select No documentation
Y - To proceed with the installation
A, N, 1-1, or Y : Y
Sources
------------
The sources included with SOAP Toolkit 2.0 (based on Apache Axis) consist of
source files that will allow you to build AXIS itself, as well as sources for
some of the associated components required to install the product.
AXIS and the associated components are implemented entirely in Java. It is not
necessary to install the sources or to build them. The sources are provided
for those that may wish to build them in order to do development work in this
area.
You can choose to install all of the sources, or none of them.
-----------------------------------------------------------------
1. [ ] Axis V1.1 Sources ~ 11360 blocks
-----------------------------------------------------------------
[x] = Selected, [ ] = Not Selected
Enter: 1 through 1 - To toggle a selection
A - To select All sources
N - To select No sources
Y - To proceed with the installation
A, N, 1-1, or Y : A
-----------------------------------------------------------------
1. [x] Axis V1.1 Sources ~ 11360 blocks
-----------------------------------------------------------------
[x] = Selected, [ ] = Not Selected
Enter: 1 through 1 - To toggle a selection
A - To select All sources
N - To select No sources
Y - To proceed with the installation
A, N, 1-1, or Y : Y
Here is a summary of your current selections:
-----------------------------------------------------------------
Documentation Selection(s):
1. [x] Axis V1.1 Documentation ~ 51646 blocks
Source Selection(s):
1. [x] Axis V1.1 Sources ~ 11360 blocks
-----------------------------------------------------------------
[x] = Selected, [ ] = Not Selected
Are you satisfied with your installation selections?
Enter: N - No, restart selection process
Y - Yes, proceed with the installation
Y or N : Y
Proceeding with installation...
Installing binaries...
This will take a minute or so...
Installing samples...
Installing sources...
Installing documentation...
SOAP Toolkit 2.0 Installation complete.
--------------------------------------------------------------------------
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 SYS$SYSDEVICE:[AXIS.]
--------------------------------------------------------------------------
Press the <Enter> key to continue:
Post Installation Checkout
--------------------------
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/
To access documentation installed with this kit please use the
following url from a browser.
file:///AXIS$ROOT/AXIS-1_1/docs/index.htmL
|
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
Feb 25, 2004 8:06:20 PM org.apache.axis.transport.http.SimpleAxisServer run
INFO: SimpleAxisServer starting up on port 8080.
Feb 25, 2004 8:11:31 PM org.apache.axis.utils.Admin processWSDD
SEVERE: Administration service requested to quit, quitting.
Feb 25, 2004 8:11:31 PM org.apache.axis.transport.http.SimpleAxisServer stop
INFO: SimpleAxisServer quitting.
%DCL-S-RETURNED, control returned to process _FTA153:
$
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 - Run SOAP Toolkit 2.0 Validation Procedure
as documented above in step 1. above.