|
OpenCCM
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
|
CORBA Module Install Guide
This module requires the following modules to work properly :
The CORBA module and all dependencies can be checked out by using the alias openccm-corba.
Requirements
To work correctly, the OpenCCM CORBA module has the following mandatory requirements :
Extra Requirements
You may have to provide the following extra requirements:
-
If you are using the OpenORB
product and if you want to use the OpenCCM transactions facilities,
you need to have OpenORB OTS libraries according to your OpenORB version number.
-
If you are an Apple MacOS X user and did not install a Java Development Kit,
the provided Java Framework from MacOS X updates should be sufficient.
Make sure to have the latest JavaVM update.
Supported CORBA Products
Currently, OpenCCM is supported on the following CORBA products :
If you want to use the CosTrading Service (mainly for
deployment purpose), you need to have a CosTrading Service
implementation. The table below shows currently fully
supported configuration of CosTrading Services.
ORB name | Trading Service Product |
Borland Enterprise Server 5.2 for Java | None |
JacORB 2.1, and 2.2 | JacORB Trading Service 2.1, and 2.2 |
ORBacus 4.1.x for Java | ORBacus Trader 2.0 |
The Community OpenORB 1.2.1, 1.3.0, 1.3.1 and 1.4.0-BETA1 | The Community OpenORB CosTrading Service 1.3.0, 1.3.1 and 1.4.0-BETA1 |
Warning: For The Community OpenORB 1.4.0-BETA1, it is required
to download at least all the following packages and uncompress them
in a same directory.
OpenORB module name | Comments |
OpenORB | Required |
tools | Required |
NamingService | Required |
TransactionService | Only required if the CosTransactions Service will be used |
TradingService | Only required if the CosTrading Service will be used |
PersistentStateService | Only required if the CosTrading Service will be used |
EvaluatorUtility | Only required if the CosTrading Service will be used |
Contents Structure
The CORBA module contains the following directories and files :
Directory | File | Description |
| build.xml | ANT main script for compilation process. |
config/ | | Contains specific configuration sets for each supported ORB. |
| BES-5.2/ | BES-5.2 configuration dependencies. |
| JacORB-2.1/ | JacORB-2.1 configuration dependencies. |
| JacORB-2.2/ | JacORB-2.2 configuration dependencies. |
| OpenORB-1.2.1/ | OpenORB-1.2.1 configuration dependencies. |
| OpenORB-1.3.0/ | OpenORB-1.3.0 configuration dependencies. |
| OpenORB-1.3.1/ | OpenORB-1.3.1 configuration dependencies. |
| OpenORB-1.4.0/ | OpenORB-1.4.0 configuration dependencies. |
| ORBacus-4.1/ | ORBacus-4.1 configuration dependencies. |
| export.xml | ANT file providing settings to be re-used by other modules. |
externals/ | ots/ | A CosTransactions Service implementation. |
src/ | | The source code directory. |
| ant/ | ANT files used for the compilation of the module's parts. |
| dtd/ | DTD file for the description of a CosTrading service type. |
| idl/ | IDL definitions from the CORBA specification. |
| java/ | Java source code, mainly the OpenCCM CORBA and IDL2Java wrapper packages. |
| unix/ | Unix scripts. |
| windows/ | Windows scripts. |
| xml/ | XML files to be used with the Launcher and the Trading Service. |
test/ | | All OpenCCM CORBA module test files. |
| sample1.idl | The OMG IDL2.0 file used to test idl2java command without prefix. |
| sample2.idl | The OMG IDL2.0 file used to test idl2java command with prefix. |
| trader/ | Trading service definition sample. |
web/ | | Source files for this documentation. |
Configuration Instructions
To configure and compile OpenCCM Corba module, you must have already installed :
-
A CORBA
product supported by OpenCCM.
-
A Ant tool version > or equals to 1.6.0.
Then configuring OpenCCM CORBA module requires:
-
To check if the JAVA_HOME shell variable is correctly set
to the JDK you will use.
-
To start the Ant tool
a first time, just do
$ ant
As result, the build.properties file is generated
in the OpenCCM CORBA module root directory.
-
To edit the generated build.properties file
and set the following variables:
Variable | Description | Mandatory |
ORB.name |
The name of the ORB product used to compile and execute OpenCCM.
Select one ORB name in the proposed list.
|
Yes
|
ORB.home.dir |
The directory where the used ORB product is installed.
|
Yes
|
NS.home.dir |
The directory where the used CosNaming Service is installed.
Default value is ORB.home.dir .
Must be set when the used CosNaming Service is installed
in a directory different that the ORB one.
|
No
|
trader.home.dir |
The directory where the used CosTrading Service is installed.
Default value is ORB.home.dir .
Must be set when the used CosTrading Service is installed
in a directory different that the ORB one.
|
No
|
OTS.home.dir |
The directory where the used CosTransaction Service is installed.
If not set then OpenCCM will not be able to use the CosTransaction Service.
|
No
|
Warning: On Windows systems, directories must be
separated by '/' instead of '\', e.g. write
c:/dev/OpenCCM instead of
c:\dev\OpenCCM .
Else a lot of errors will appear at compilation and
execution times.
Warning: Don't put some space characters at the end of lines
of the previously configurated properties,
else some Ant build errors would raise.
Compilation Instructions
This module provides a build.xml file to be used by your ANT
tool (which should be in your PATH environment setting).
A quick help message can be displayed with ANT project help :
$ ant -p
Buildfile: build.xml
Build file for compiling the OpenCCM CORBA Module.
Main targets:
build Builds the whole module
doc Builds the documentation in <build directory>/doc
Default target: build
Thus, the full build can be achieved by simply running ANT without
any argument.
Results of Compilation
The compilation of the CORBA module feeds the build directory with the following directories and files:
Directory | File | Description |
ant/ | | Pathes and libraries settings for following modules build and runtime. |
bin/ | | All generated commands. |
class/ | | All compiled Java classes. |
externals/ | | Libraries used during the compilation. |
idl/ | | All OMG IDL files. |
jar/ | | Archived Java packages. |
java/ | | Java files generated from DTDs or OMG IDL files. |
lib/ | | Final libraries. |
xml/ | | XML files for the Launcher and the Trading Service. |
See the user's guide for usage instructions.
| |