ObjectWeb logo
Valid HTML 4.01!Valid CSS!
[Advanced search]
 [Become a member of the ObjectWeb Consortium! Membership is free for individuals.]

OpenCCM:   
Download  Documentation  Mailing Lists  Partners  License  History 
Developers' Corner:   
How to Contribute  Workplan  CVS Repository  Bug Tracking  ObjectWeb Forge Site  User Mailing List  Team Mailing List 
About OpenCCM:   
Team  Contacts 
ObjectWeb Resources:   
FAQ  Mailing Lists  CVS Repositories  Search  ObjectWeb Forge  Mirror Sites 

 Table of Contents 

 Availability 

Requirements

To work correctly, OpenCCM has the following mandatory requirements:

  • A full Java CORBA 2.4 ORB product, and
  • A Java Development Kit.

Extra requirements

You may have to provide the following requirements:

  • If you want to regenerate the OpenCCM IDL/PSDL/CIDL parser, you need to install the JavaCC tool, but this is not a mandatory requirement.
  • If you want to generate the detailed OpenCCM APIs, you need to have the doxygen tool.
  • If you are using the OpenORB product and if you want to use the OpenCCM's transactions facilities, you need to have OpenORB OTS libraries according to your OpenORB version number.
  • If you want to use IDLscript deployment scripts for OpenCCM demonstrations, you need to have an IDLscript interpreter (you can have a look to CorbaScript or Java IDLscript).

Currently supported ORBs

ORB NameURL for downloading
Borland Enterprise Server 5.0.2 for Java http://www.borland.com/besappserver/index.html
ORBacus 4.1.x for Java http://www.iona.com/products/orbacus_home.htm
The Communauty OpenORB 1.2.1 and 1.3 http://openorb.sourceforge.net

Currently fully supported configurations

ORB Name and ReleaseOperating systemJava Compiler
Borland Enterprise Server 5.0.2 for JavaLinuxSUN JDK 1.3.1
Borland Enterprise Server 5.0.2 for JavaWindowsSUN JDK 1.3.1
ORBacus 4.1 for JavaLinuxSUN JDK 1.3.1
ORBacus 4.1 for JavaLinuxSUN J2SDK 1.4.0
ORBacus 4.1 for JavaWindowsSUN JDK 1.3.1
ORBacus 4.1 for JavaWindowsSUN J2SDK 1.4.0
ORBacus 4.1 for JavaSolarisSUN JDK 1.3.1
OpenORB 1.2.1LinuxSUN JDK 1.3.1
OpenORB 1.2.1LinuxSUN J2SDK 1.4.0
OpenORB 1.2.1WindowsSUN JDK 1.3.1
OpenORB 1.2.1WindowsSUN J2SDK 1.4.0
OpenORB 1.2.1SolarisSUN JDK 1.3.1
OpenORB 1.3.0LinuxSUN J2SDK 1.4.0
OpenORB 1.3.0WindowsSUN JDK 1.3.1
OpenORB 1.3.0WindowsSUN J2SDK 1.4.0
OpenORB 1.3.0SolarisSUN JDK 1.3.1

 Distribution 

Extracting the contents of the OpenCCM archive

  • On a Unix like system:

    Execute the following commands in a shell window to extract the contents of the OpenCCM archive:

    1. Uncompress the archive file:

      $ gunzip OpenCCM-0.5.tar.gz
    2. Untar the archive file:

      $ tar xvf OpenCCM-0.5.tar
  • On a Microsoft Windows system, you can use a tool such as WinZip to extract the contents of the OpenCCM archive.

The contents of the OpenCCM archive

The OpenCCM archive contains the following directories and files:

DirectoryFileDescription
 build.batWindows script for compilation process.
 build.shUnix script for compilation process.
 build.xmlMain rules for compiling and installing OpenCCM.
config/ The configuration directory.
 build.propertiesTemplate file for the common variables to set for compilation and installation.
 common.xmlOpenCCM general variables.
 envi_OpenCCM.batOpenCCM environment file for MS-DOS shells.
 envi.OpenCCM.cshOpenCCM environment file for Unix C-shells.
 envi.OpenCCM.shOpenCCM environment file for Unix shells.
 jvm.batWindows environment file for starting a Java Virtual Machine.
 jvm.shUnix environment file for starting a Java Virtual Machine.
 xml_dtd.propertiesXML DTD variables used for compilation and installation.
 BES-5.0.2/BES-5.0.2 configuration dependencies.
 JacORB-1.4/JacORB-1.4 configuration dependencies.
 OpenORB-1.2.1/OpenORB-1.2.1 configuration dependencies.
 OpenORB-1.3.0/OpenORB-1.3.0 configuration dependencies.
 ORBacus-4.1.0/ORBacus-4.1.0 configuration dependencies.
demo/ OpenCCM demonstrations directory.
 common/Common build files and execution scripts for all demonstrations.
 demo1/This illustrates a simple clients / server application.
 demo2/This illustrates a simple producer / consumers application.
 demo3/This illustrates a simple clients / server-producer / consumers application.
 dinner/This illustrates the philosopher's dinner.
 hello/This illustrates the classical Hello World application.
doc/ The OpenCCM documentation directory.
externals/ OpenCCM external dependencies.
 jidlscript.jarThe Java IDLscript library.
 ant/Ant compilation tool from Apache/Jakarta
 cpp/Windows C/C++ preprocessor from MinGW(1.0.1-20010726).
 ots/OpenCCM external dependencies on Transaction Service.
 velocity/OpenCCM external dependencies on Velocity.
 winprocess/Common applications to manage processes under Windows: exec , kill , ps.
 xml_dtd/OpenCCM external dependencies on XML DTD.
src/ The OpenCCM source code directory.
 cpp/The OpenCCM C++ source code directory.
 doxygen/The OpenCCM doxygen config directory.
 dtd/The OpenCCM XML DTD files directory.
 idl/The OpenCCM OMG IDL files directory.
 java/The OpenCCM Java source code directory.
 unix/The OpenCCM Unix scripts directory.
 windows/The OpenCCM Windows scripts directory.
 winprocess/Utilities source code to manage processes under Windows (Visual Studio project).
test/ The OpenCCM test files.
sample.idl3The sample file used in the OpenCCM's User Guide.
 idl/The OpenCCM IDL test files.
 psdl/The OpenCCM PSDL test files.
 various/Various OpenCCM test files.
web/ The OpenCCM Web pages.

 Configuration Instructions 

To configure and compile OpenCCM, you must have already installed an OpenCCM supported ORB product.

Then configuring OpenCCM requires:

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

  2. To go into the OpenCCM root directory, just do (on Unix or Windows systems):

    $ cd OpenCCM-0.5
  3. To start the Ant tool a first time, just do on Unix systems:

    $ build.sh

    or on Windows systems:

    $ build.bat

    As result, the build.properties file is generated in the OpenCCM root directory.

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

    Variable nameDescription
    ORB.nameThe name of your favorite ORB product;
    OpenCCM.root.dirThe root directory where the OpenCCM platform package is installed;
    install.dirThe directory where the OpenCCM platform will be installed;
    ORB.home.dirThe directory where the used ORB is installed;
    cpp.compilerThe path to an installed C/C++ preprocessor;
    on Unix, use /usr/bin/cpp or set to the Unix C/C++ preprocessor path
    on Windows, uncomment these two lines corresponding to the MinGW(1.0.1-20010726) C/C++ preprocessor:
        cpp.compiler=${OpenCCM.root.dir}/externals/cpp/cpp.exe
        cpp.compiler.add=${OpenCCM.root.dir}/externals/cpp/cpp0.exe
    javacc.dirThe directory where JavaCC.zip is installed. Only required for compiling the OpenCCM's OMG IDL / PSDL / CIDL Parser.jj file and/or for generating the parser documentation.

 Compilation Instructions 

Compiling OpenCCM

After configurating OpenCCM, just do on Unix systems:

$ build.sh

or on Windows systems:

$ build.bat

Generating OpenCCM documentation

To generate OpenCCM APIs documentation you must have already installed the Doxygen tool. Then, just do:

$ build.sh doc

or

$ build.bat doc

Compilation Result

After compilation, a directory is created according to the name of the used ORB product. It contains the following directories and files:

DirectoryFileDescription
bin/ All generated binaries.
classes/ All compiled Java classes.
config/ All configuration files.
doc/ All generated documentation.
dtd/ All XML DTD files.
generated/ All generated Java source files.
idl/ All OpenCCM OMG IDL files.
lib/ All generated libraries.
templates/ All generator's template files.

 Installation Instructions 

Installing OpenCCM

Execute the following command to install OpenCCM:

$ build.sh install

or

$ build.bat install

Installation Results

After installation, the following directories and files are created in the configured install.dir directory:

DirectoryFileDescription
bin/ All OpenCCM's binaries and scripts.
See User's Guide for more information.
 envi_OpenCCM.batThe environment file for using OpenCCM from Windows shells.
 envi.OpenCCM.shThe environment file for using OpenCCM from Unix shells (sh, bash, etc).
 envi.OpenCCM.cshThe environment file for using OpenCCM from Unix C-shells (csh, tcsh, etc).
config/ All OpenCCM's configuration files.
dtd/ All OpenCCM's XML DTD files.
idl/ All OpenCCM's OMG IDL files.
lib/ All OpenCCM's libraries.
templates/ All generator's template files.

Last modified at 2003-07-16 08:09 PM - Copyright © 1999-2003, ObjectWeb Consortium