CORBA 2.6.1 Getting Started Guide for Java

Installing JORB Lite
JORB Lite resides in a self-extracting executable file on your NonStop CORBA compact disc. This installation procedure assumes you have the
Java SDK (version 1.1.2 or newer) installed. To install JORB Lite:
1. From the product CD, run the WORKSTATION\JORBLITE.EXE file. You will be prompted for a directory where you want to place the
files. The default directory is c:\jorblite. If you want to enter a different directory name do so and continue. The resulting
directory
structure is shown at the end of this installation procedure. Note that the installer will update your PATH and CLASSPATH.
2. Unzip the following documentation files in the same directory that they live in: \docs\javapubs\javadocs\javadoc.zip
3. To develop JORB Lite applications you must install a C language preprocessor such as cl.exe from Microsoft's Visual C++ (the
preprocessor is needed by the IDL compiler).
You must ensure that the preprocessor program is accessible from the PATH environment variable, because the idl2java script
executes IDL using the
cl.exe program to preprocess information in the IDL file. If the IDL compiler cannot find the preprocessor, it will
generate the error:
nsdidl: Error: nsdidl.PreprocessorException: failed to execute "cl -E -C filename.idl"
4. If you use Gnu's C preprocessor (cpp) you will need to edit bin\idl2java.bat to change "cl" to "cpp."
5. If you use the Java 2 platform you need to copy
lib\orb.properties to your Java 2 root directory\jre\lib.
6. If you want to use
org.omg.CORBA.ORB.resolve_initial _references ("NameService") you must also modify the
RootNamingContextIORFile setting in the file
jorblite-dir\lib\lite.dbm so that it looks like: NS@name_service_settings
RootNamingContextIORFile jorblite-dir\urls\NameService
7. The file "NameService" must contain the root naming context IOR of the Naming Service running on a remote NonStop system. The
NonStop CORBA subsystem creates this file when it is configured on the system. The file is in the directory: NonStop CORBA
installation dir/urls on the NonStop system. You must copy this file from the NonStop system into the jorblite-dir\urls directory.
You can use the NonStop Distributed Component Console or FTP to copy the file.
Note:
Copy this file to your PC after each NonStop CORBA reconfiguration on the NonStop system.
8. Modify jorblite-dir\lib\lite.dbm so that the host_name entry contains the host-name of your PC (the host from where you run JORB
Lite).
When you unpack JORB Lite, it installs the file env.bat into the etc subdirectory. The installer also sets various environmental variables used by
your JORB Lite setup. You may use the
env.bat file to manually set the variables, which may need to be modified for your installation. Make
sure that the following default environment variables set in this file refer to the correct directories on your PC system:
JORB Lite Environmental Variable Setting
Variable Default Setting Description
JORBLITE_HOME c:\jorblite
Root directory of your JORB Lite installation.
JAVA_HOME c:\jdk 1.3.1
Root directory of your JDK installation. Assumes that you have the 1.3.1 JDK installed.
For example, if you install JORB Lite into a directory other than c:\jorblite, you will have to modify the file etc\env.bat so that the
JORBLITE_HOME environment variables reference the correct JORB Lite root directory.
The JORB Lite Directory Structure
When you install JORB Lite, the installation process creates the following directory structure under your base JORB Lite directory:
The JORB Lite Directory Structure
+--bin
+--docs
| +--javapubs
| +--javadocs
+--etc
+--idl
+--javasamples
| +--bank
| +--calc
| +--event_service
| +--ins
| +--jpathsend
| +--jts_bank
| +--stack
| +--stack-obv
| +--stack-tie
| +--stock
| +--stock-dynamic
+--lib