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

  • A full Java CORBA 2.4 ORB product,
  • A Java Development Kit,
  • The ant 1.5-beta2 tool to build OpenCCM platform and demonstrations,
  • In order to compile the OpenCCM IDL3 parser, you need to have the javacc tool.

Extra requirements

You may have to provide the following requirements:

  • If you want to have 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 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.4.tar.gz
    2. Untar the archive file:

      $ tar xvf OpenCCM-0.4.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.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.cshOpenCCM environment file for Unix C-shells.
 envi.OpenCCM.shOpenCCM environment file for Unix shells.
 envi_OpenCCM.batOpenCCM environment file for MS-DOS 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.
 ots/OpenCCM external dependencies on Transaction Service.
 velocity/OpenCCM external dependencies on Velocity.
 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.
test/ The OpenCCM test files.
 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 and potentially the Ant tool.

Then configuring OpenCCM requires:

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

    $ cd OpenCCM-0.4
  2. To start the Ant tool a first time, just do (on Unix or Windows systems):

    $ ant

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

  3. 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;
    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 or Windows systems):

$ ant

Generating OpenCCM documentation

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

$ ant 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.
doc/ All generated documentation.
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:

$ ant 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).
idl/ All OpenCCM's OMG IDL files.
lib/ All OpenCCM's libraries.
templates/ All generator's template files.

Last modified at 2003-03-28 08:22 PM - Copyright © 1999-2003, ObjectWeb Consortium