PSS Module Install Guide

The Persistency State Service module handles generators and wrappers for implementations of the OMG's CosPersistency spec.

This module requires the OpenCCM Platform to work properly since it is an add-on to it.

The PSS module and all dependencies can be checked out by using the alias openccm-pss.

• Extra Requirements
• Contents Structure
• Configuration Instructions
• Compilation Instructions
• Compilation Results

Extra Requirements

You may have to provide the following extra requirements:

• A Kodo JDO implementation (version 3.0.3).

Contents Structure

The PSS module contains the following directories and files :

Configuration Instructions

To configure and compile the OpenCCM provided PSS software, you must have already installed :

• A CORBA product supported by OpenCCM.
• A Ant tool version > or equals to 1.6.0.

Using the PSS material consists in tuning the build properties while compiling the production chain :

1. Start the Ant tool a first time, just do

   $ ant

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

2. Edit the generated build.properties file and set the following variables:

   Variable	Description	Mandatory
   pss.needed	This property must be set to true to build the PSS material	Yes
   pf.name	The name of the persistence framework used to compile and execute OpenCCM PSS. Select one persistence framework name in the proposed list.	Yes
   jdbc.driver.jar	The full path to the JDBC driver Jar file used to access your database.	Yes
   jdo.impl.name	The name of your JDO vendor used by the OpenCCM Persistent State Service. At this time, only Kodo JDO is supported. Select one JDO vendor name in the proposed list.	Yes, if you use a JDO persistence framework
   jdo.impl.version	The version of the JDO product used by the OpenCCM Persistent State Service.	Yes, if you use a JDO persistence framework
   jdo.impl.home.dir	The directory where the used JDO implementation is installed.	Yes, if you use a JDO persistence framework

   Warning: On Windows systems, directories must be separated by '/' instead of '\', e.g. write c:/dev/OpenCCM instead of c:\dev\OpenCCM.

   Warning: Don't put some space characters at the end of lines of the previously configurated properties, else some Ant build errors would raise.

Build Instructions

This module provides a build.xml file to be used by your ANT tool (which should be in your PATH environment setting).

Thus, the full build can be achieved by simply running ANT without any argument :

  $ ant
      

Compilation Results

After compilation, a build directory is created. It contains the following directories and files :