• Installation prerequisites
• SSL and WebSphere users read the additional installation notes
• Installing the Servlet Engine and ULC Sample Applications
• Enabling the UIEngine for HTTP Tunnelling
• Running the samples
• Feedback

• ULC Java Release 3.0 or above
• A Java Servlet 2.1 compatible Servlet engine
  Examples:
  • Sun Servlet Development Kit 2.1 (JSDK 2.1).
  • Sun Java Web Server.
  • IBM Websphere 3.02.

Note: Currently VisualAge Java 3.02 Java2 edition does not support the Websphere test environment and hence all testing needs to be done outside VA Java. IBM has announced VA Java 3.5 EE to be released on the 31st of August which will support the Websphere test environment along with Java 2. At that time this code will be validated for VA Java 3.5 EE.

Inside VA Java choose the ADD Feature option to add the RevaSoft Ulc Http Servlet Transport.

Note: You will neeed a Servlet Engine 2.1 compatible implementation as a prerequisite. You can import the Sun Servlet 2.1 classes and the JSSE 1.0.2 classes into VA Java in order to run the UIEngine at least inside VA Java. To run ULC applications inside VA Java your best bet would be the Websphere code available in VA Java Enterprise 3.5.

Note: The description below describes the installation using the Sun Servlet Development Kit 2.1 and the ULC Java Dossier example. Any ULC Java application can be installed in a similar manner. To use any other Servlet engine (eg: IBM Websphere 3.02) read the installation instructions that are shipped with the product.

1. Download the Java Servlet Development Kit 2.1 code from the Sun web site and install it on a local directory on your test machine (eg: \JSDK2.1).

2. Create a ULC subdirectory as a subdirectory of your JSDK 2.1 install path
   (Eg: \JSDK2.1\ULC)

3. Create a WEB-INF subdirectory as a subdirectory of the above directory
   (Eg: \JSDK2.1\ULC\WEB-INF)

4. Create a servlets subdirectory as a subdirectory of the above directory
   (Eg: \JSDK2.1\ULC\WEB-INF\servlets).
   Note:This servlets subdirectory will now be referred to as the <install-directory> in this document.

5. From a ULC R3.0 installation extract the contents of the \ULCR30\Java\lib\ulc.jar to the <install-directory>

6. Extract the contents of the supplied ulchttpservlet.jar to the <install-directory>

7. Verify that the file (\JSDK2.1\ULC\ULCTransport.properties) exists and overrides the default http protocol mapping to the following:

   # *** default "http" protocol
   UlcTransport.classForProtocol.http=com.revasoft.ulc.http.UlcHttpTransport
   # *** default "https" protocol
   UlcTransport.classForProtocol.https=com.revasoft.ulc.http.UlcHttpsTransport
   
   # *** default "http" protocol
   UlcTransportServer.classForProtocol.http=com.revasoft.ulc.http.UlcHttpTransportServer
   # *** default "https" protocol
   UlcTransportServer.classForProtocol.https=com.revasoft.ulc.https.UlcHttpTransportServer 
   

8. Add a mapping for the ULC directory by editing the file \JSDK2.1\default.cfg and add the following lines at the bottom of the file.

   		server.webapp.ulcapp.mapping=/ulc
   		server.webapp.ulcapp.docbase=ulc
   

9. Start the Servlet Engine (\JSDK2.1\startserver.bat)

10. Verify that the servlet engine is installed correctly by connecting to it from your Web browser (eg: http://localhost:8080).

11. Ensure all the sample servlets shipped with the Sun JSDK 2.1 run correctly.

12. From a ULC R3.x installation, install the ULC Dossier Sample by copying all files and subdirectories from \ULCR30\Java\Applications\Dossier into the <install-directory>. Any other samples that you would like tested can be installed in a similar manner.
    Note: Only the contents of the directory \ULCR3x\Java\Applications\Dossier should be copied along with its subdirectories.
    Do NOT create a subdirectory <install-directory>/Dossier.

Extract the contents of the supplied ulchttpservlet.jar to the \ULCR30\UIEngine\lib directory.
Verify that the file (\ULCR30\UIEngine\lib\ULCTransport.properties) exists and overrides the default http protocol mapping as described earlier.
Extract the contents of the \JSDK2.1\servlet.jar to the \ULCR3x\UIEngine\lib directory.
Note: As an alternative to extracting the above two jar files to the \ULCR30\UIEngine\lib directory it is also possible to add the two jar files to the classpath of the UIEngine. In this case the ulchttpservlet.jar must be placed on the classpath before the uiengine.jar file since the ULCTransport.properties file supplied with the Http Tunnelling code overrides settings in the default properties file.

  Start the Servlet Engine (\JSDK2.1\startserver.bat)
  From a command prompt change the current directory to the \ULCR30\UIEngine\bin subdirectory.
  Run the Dossier sample by executing the following command:

run -url http://localhost:8080/com.ibm.ulc.examples.Dossier.Dossier

Note: The command for running other samples on other hosts is as follows:

run -url http://<HostName>:<Servlet Engine port>/<fully qualified ULC application startup class name>

Send feedback regarding the HTTP/HTTPS Transport to ulcsupport@revasoft.com.

Further information

• JavaServer Group
• JavaServlet 2.1 API
• Whats new in 2.1
• IBM WebSphere Zone