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

Table of contents

  1. Availability
    1. Requirements
    2. Extra Requirements
    3. Currently fully supported configurations
  2. Distribution
    1. Extracting the contents of the OpenCCM archive
    2. The contents of the OpenCCM archive
  3. Configuration Instructions
  4. Compilation Instructions
    1. Compiling OpenCCM
    2. Generating OpenCCM documentation
    3. Compilation result
  5. Installation Instructions
    1. Installing OpenCCM
    2. Installation result

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.

WinZip is a registered trademark of WinZip Computing, Inc.

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.

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