Consortium    Solutions    Middleware    Forge    MyObjectWeb 
ObjectWeb Consortium
Print

Advanced - Powered by Google






OpenCCM

Project Links
· Home
· Download
· Documentation
· Mailing Lists
· Wiki
· Partners
· License
· History
· Related projects

Developers' Corner
· How to Contribute
· Workplan
· Resources
· CVS Repository
· Bug Tracking
· ObjectWeb Forge Site
· User Mailing List
· Team Mailing List

About
· Team
· Contacts

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 :

ORB nameURL for downloading
Borland Enterprise Server 5.2 for Java http://www.borland.com/besappserver/index.html
JacORB 2.1, and 2.2 http://www.jacorb.org
ORBacus 4.1.x for Java http://www.iona.com/products/orbacus_home.htm
The Community OpenORB 1.2.1, 1.3.0, 1.3.1 and 1.4.0-BETA1 http://openorb.sourceforge.net

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 nameTrading Service Product
Borland Enterprise Server 5.2 for JavaNone
JacORB 2.1, and 2.2JacORB Trading Service 2.1, and 2.2
ORBacus 4.1.x for JavaORBacus Trader 2.0
The Community OpenORB 1.2.1, 1.3.0, 1.3.1 and 1.4.0-BETA1The 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 nameComments
OpenORBRequired
toolsRequired
NamingServiceRequired
TransactionServiceOnly required if the CosTransactions Service will be used
TradingServiceOnly required if the CosTrading Service will be used
PersistentStateServiceOnly required if the CosTrading Service will be used
EvaluatorUtilityOnly required if the CosTrading Service will be used

Contents Structure

The CORBA module contains the following directories and files :

DirectoryFileDescription
 build.xmlANT 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.xmlANT 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.idlThe OMG IDL2.0 file used to test idl2java command without prefix.
 sample2.idlThe 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 :

  1. A CORBA product supported by OpenCCM.
  2. A Ant tool version > or equals to 1.6.0.

Then configuring OpenCCM CORBA module requires:

  1. To check if the JAVA_HOME shell variable is correctly set to the JDK you will use.

  2. 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.

  3. To edit the generated build.properties file and set the following variables:

    VariableDescriptionMandatory
    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:

DirectoryFileDescription
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.


Copyright © 1999-2005, ObjectWeb Consortium | contact | webmaster | Last modified at 2005-07-07 02:04 PM