Consortium    Solutions    Middleware    Forge    MyObjectWeb 
ObjectWeb Consortium
Print

Advanced search




ECM

Project Links
· Home
· Download
· Quick Start
· Documentation
· Mailing List
· Partners
· License
· History
· Related projects

Developers' Corner
· How to Contribute
· Workplan
· Resources

About
· Team
· Contacts

Installation documentation

  1. Availability
  2. Distribution
  3. Compilation
  4. Installation

Availability

Requirements

To work correctly, the ECM-RI has the following mandatory requirements:

Note that OpenCCM's generation framework is used by the generation tools of the ECM-RI. The OpenCCM's launcher framework is used by the command line scripts of the ECM-RI. The Jakarta Ant tool is used by the build process of the ECM-RI.


Supported CORBA products

The ECM-RI is supporting the following CORBA products:

ORB nameURL for downloading
ORBacus 4.1.x for Javahttp://www.iona.com/products/orbacus_home.htm
The Community OpenORB 1.3.1 and 1.4.0http://openorb.sourceforge.net

Important Note: there's no relationship between the ORB used to compile OpenCCM and the ORB used by the ECM-RI. As a consequence:

  • You can compile the ECM-RI with different ORBs while keeping the same OpenCCM compiled version
  • You can use a OpenCCM version compiled with an ORB which is not supported by the ECM-RI


Fully supported configurations

The ECM-RI is tested on the following configurations (the list only describes the main configurations):

JDKORBOpenCCMJakarta AntOS
SUN JDK 1.4.0ORBacus 4.1.0OpenCCM 0.8Ant 1.6.0Unix / Linux / Windows XP
SUN JDK 1.4.0OpenORB 1.3.1 and 1.4.0OpenCCM 0.8Ant 1.6.0Unix / Linux / Windows XP

Distribution

Extracting the content of the ECM-RI archive

On a Linux system, execute the following commands to uncompress the archive file:

    $ tar xzvf ECM-0.2.0.tgz
or
    $ unzip ECM-0.2.0.zip


The content of the ECM-RI archive

The ECM-RI archive contains the following directories and files:

DirectoryFileDescription
build/ 
components/ Various components provided by the ECM-RI.
 demos/ECM-RI demonstrations
 runtime/ECM-RI runtime implementation
 services/ECM-RI services
 tools/ECM-RI tools
doc/ HTML documentation of the platform.
externals/ Wrappers of the various components required by the ECM.
 Ant-1.6.0/
 OpenCCM-0.8/
 SUN-JDK-1.4.0/
main/ The "main" of the distribution.
 make.configConfiguration file to edit (linux).
 make_config.batConfiguration file to edit (windows).
 make.shBuild process script (linux).
 make.batBuild process script (windows).
README A text readme file.

NOTE: the required components in the externals directory are not included, you have to provide them.

Compilation

To compile the ECM-RI, you have first to edit the configuration file with your environment specific information. On a Unix/Linux system, edit the make.config file. On a Windows system, edit the make_config.bat file. The configuration defines a set of variables which are later used by the build scripts. Its content is the following:

VariableDescriptionExample (linux/windows)Mandatory
sun_jdk_1_4_0_dirInstallation directory of the SUN JDK./usr/java/jdk1.4.0
c:\java\jdk1.4.0
Yes
ant_1_6_0Installation directory of Ant/usr/java/ant-1.6beta
c:\java\ant-1.6beta
Yes
openccm_0_8_0Installation directory of OpenCCM./usr/OpenCCM-0.8/openccm/ORBacus-4.1
c:\OpenCCM-0.8\openccm\ORBacus-4.1
Yes
orbacus_4_1_0_dirInstallation directory of ORBacus 4.1.0./usr/corba/ORBacus-4.1.0
c:\corba\ORBacus-4.1.0
Yes if you want to build the ECM-RI for ORBacus 4.1.0.
openorb_1_3_1_dirInstallation directory of OpenORB 1.3.1./usr/corba/OpenORB-1.3.1
c:\corba\OpenORB-1.3.1
Yes if you want to build the ECM-RI for OpenORB 1.3.1.
openorb_1_4_0_dirInstallation directory of OpenORB 1.4.0./usr/corba/OpenORB-1.4.0
c:\corba\OpenORB-1.4.0
Yes if you want to build the ECM-RI for OpenORB 1.4.0.

NOTE: Some variables have a fixed value which shall not be edited. These variables are not described in the previous table.


Then, you can call the build script:

  • On Linux system, just do:
    $ ./make.sh --build
    Select ORB: 1) OpenORB 1.3.1 2) OpenORB 1.4.0 2) ORBacus 4.1.0
    ...
  • On Windows system, just do:
    > make.bat /build
    Select ORB: 1) OpenORB 1.3.1 2) OpenORB 1.4.0 2) ORBacus 4.1.0
    ...

This will compile the ECM-RI for the selected ORB product.

Installation

To install the ECM-RI in the filesystem:

  • On Linux system, just do:
    $ ./make.sh --install
    Select ORB: 1) OpenORB 1.3.1 2) OpenORB 1.4.0 2) ORBacus 4.1.0
    ...
  • On Windows system, just do:
    > make.bat /install
    Select ORB: 1) OpenORB 1.3.1 2) OpenORB 1.4.0 2) ORBacus 4.1.0
    ...

This will install the ECM-RI for the selected ORB product.

NOTE: The configuration file defines an additional variable which can be set for the installation process.

VariableDescriptionExample (linux/windows)Mandatory
default_install_dirDefault installation directory for the ECM-RI./usr/ECM-0.2.0
c:\ECM-0.2.0
No

If don't set the "default_install_dir" variable, then the installation prompts you for the installation directory. You may install the compiled ECM-RI at various location in a filesystem by executing the command multiple times with different directories. If the "default_install_dir" variable is set, then the ECM-RI is installed in the $default_install_dir/$ORB_NAME (linux) or %default_install_dir%\%ORB_NAME% (windows) directory where ORB_NAME is the name of the selected ORB product as specified in the configuration file.

The content of the installation directory is the following:

DirectoryDescription
bin/ECM-RI command line scripts
dtd/ECM-RI DTDs (used for component packaging)
launcher/ECM-RI launcher files (used by command line scripts)
lib/ECM-RI libraries (used by command line scripts)
templates/ECM-RI generation templates (used by generation tools)
zips/ECM-RI software components (for demos and services)


Once the ECM-RI is installed, you may suppress the ECM-RI source directory.


Copyright © 1999-2004, ObjectWeb Consortium | contact | webmaster | Last modified at 2004-04-15 09:05 PM