Installation documentation
-
Availability
-
Distribution
-
Compilation
-
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:
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):
JDK | ORB | OpenCCM | Jakarta Ant | OS |
SUN JDK 1.4.0 | ORBacus 4.1.0 | OpenCCM 0.8 | Ant 1.6.0 | Unix / Linux / Windows XP |
SUN JDK 1.4.0 | OpenORB 1.3.1 and 1.4.0 | OpenCCM 0.8 | Ant 1.6.0 | Unix / 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:
Directory | File | Description |
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.config | Configuration file to edit (linux). |
| make_config.bat | Configuration file to edit (windows). |
| make.sh | Build process script (linux). |
| make.bat | Build 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:
Variable | Description | Example (linux/windows) | Mandatory |
sun_jdk_1_4_0_dir | Installation directory of the SUN JDK. | /usr/java/jdk1.4.0
c:\java\jdk1.4.0 | Yes |
ant_1_6_0 | Installation directory of Ant | /usr/java/ant-1.6beta
c:\java\ant-1.6beta | Yes |
openccm_0_8_0 | Installation directory of OpenCCM. | /usr/OpenCCM-0.8/openccm/ORBacus-4.1
c:\OpenCCM-0.8\openccm\ORBacus-4.1 | Yes |
orbacus_4_1_0_dir | Installation 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_dir | Installation 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_dir | Installation 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.
Variable | Description | Example (linux/windows) | Mandatory |
default_install_dir | Default 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:
Directory | Description |
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.
|