Revasoft Revasoft Banner
HomeOur ExpertiseOur ServicesOUR ProductsAbout UsCareersContactsupport
Print this page HttpServlet

ULC Http/Https Tunnelling with Servlets

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

Installation prerequisites

    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.

top

SSL and WebSphere users read the additional installation notes

Inside VA Java choose the ADD Feature option to add the RevaSoft Ulc Http Servlet Transport.
Note: You will need 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.

top

Installing the Servlet Engine and ULC Sample Applications

  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.

Enabling the UIEngine for HTTP Tunnelling

  1. Extract the contents of the supplied ulchttpservlet.jar to the \ULCR30\UIEngine\lib directory.
  2. Verify that the file (\ULCR30\UIEngine\lib\ULCTransport.properties) exists and overrides the default http protocol mapping as described earlier.
  3. 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.

top

Running the samples

  1. Start the Servlet Engine (\JSDK2.1\startserver.bat)
  2. From a command prompt change the current directory to the \ULCR30\UIEngine\bin subdirectory.
  3. Run the Dossier sample by executing the following command:
run  -url http://localhost:8080/com.ibm.ulc.examples.Dossier.Dossier

At this point the ULC ORB Monitor should start and the ULC Dossier Sample should start running.

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>

top

Feedback

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

top

Back to Products Print this pageBack to ULC Demo
ULC
Getting Started
Release Notes
Installation
Running the Samples
Concepts
Architecture Overview
Internal Architecture
Using Layout
UI Engine Extensions
Application Controller
Web Integration
Development
Manual Pages
FAQ
Bringing the Advantage of Thin Client Computing to JAVA
The ULC Tour

top of page
Home | Our Expertise | Our Services | Our Products | About Us | Careers | Contact Us | Support
ULC Demo | ULC Tour | ULC R4.0 | Download | FAQ

 © Copyright 2001 Revasoft Private Limited.
 info@revasoft.com