Projection Tool (root)

POSC Specifications
Version 2.2

Projection Tool

This is the root directory for the Projection Toolkit. It can be found on the first CD of the Epicentre Version 2.2 Release in the directory 'Files/SourceCode/proj_tool' from the root of the CD. If you received this release on tape, it will probably have a tar file with this same path. To install the Projection Toolkit there are two basic options:

If a complete installation from this distribution directory/CD needs to be performed, run 'Install.sh' (from this directory!) with the required destination directory as the first parameter (e.g. Install.sh /home/proj_tool). This will copy all files to the destination and extract the tar files to their proper location.
If this directory is already in place (for example, because you received it on tape and extracted it to your hard disk already), and only the tar files need to be expanded, run 'Install.sh' without arguments (from this directory!) This assumes you're not on the CD and already copied the projection tool tree (Files/SourceCode/proj_tool) to a directory on your hard disk. It will then extract the tar files. You can manually remove the tar files after the install if you wish.

In either case, follow the instructions of the 'Install.sh' script to finish the installation.
Please direct inquiries and bug reports to the help desk at POSC ( help@posc.org ).

What's new since Version 2.1

Documentation generated is now HTML instead of frame maker.
Duplications have been added to the projection Tool
Structure has changed to manage projection of multiple models more easily (all in models directory, with subdirectory for each model that contains all model-related information).
Informix is now a supported database the projection tool can generate DDL for (in addition to Oracle and Sybase). Note that the Projection Tool itself can only run on an Oracle database at this time.
As a result of some of the above changes, some minor changes have been made to the meta data model. (see SampleImplementation/MetaModel/main.html from the root of the distribution CD).

Requirements

Disk space (rough estimates):
- On the distribution media: 3MB
- After installing using bin/Install.sh : 10MB (a little less than 3MB extra if installing using the second method described above, because of the compressed tar files)
- After building the exectutables: 55MB
- After fully regenerating the projection, i.e. after running bin/doEpic.2.2 : 117MB
Oracle 7.x (tested with 7.3 only). About 50MB tablespace required for full Epicentre Version 2.2 projection.
Unix computer (tested on Sun Ultra Enterprise 2 running Solaris 2.5.1 only, but should be easy to port). Main difficulties usually come from linking the correct Oracle libraries. Check the Oracle demo's to find out how to do this.
GNU C compiler (gcc)
GNU make (gmake)
GNU awk (gawk) (only required for generating informix DDL)

Other info

The HTML version of the readme files in the projection tool tree can be fully browsed using an HTML browser. At the bottom of each README.htm file is a list of files and directories below the 'current' directory. Each directory name can be clicked to go the the readme file of that directory.
The following files are contained in this directory:

File	Description
Configure.sh	Configuration utility. This utility configures the Projection Toolkit after a successful installation. It requires the installer to provide some information before this script can be run to configure the installation.
Distribute.sh	Distribution script script for projection toolkit.
Install.sh	Installation script for projection toolkit.
README	The ASCII version of this file.
README.htm	The HTML version of this file.
bin	This directory will contain all binaries (programs and utilities) and scripts for the projection tool. It also contains the .ini files used by most of the programs. The binaries are not distributed here, but will be generated when 'make' is issued in the src directory. They are described in short below.
bin.lst	File containing a list of all files in the tar file containing the files from the 'bin' directory used by the 'Install.sh' and 'Distribute.sh' scripts.
include	This is the general include file directory used by C-programs (pt.h) and make (proc.mk).
include.lst	File containing a list of all files in the tar file containing the files from the 'include' directory used by the 'Install.sh' and 'Distribute.sh' scripts.
lib	This directory is used to store the binary C libraries linked in by various C-programs. The actual libraries are not provided in binary format, but must be compiled after installing.
models	This directory contains the models for the Projection Tool. It serves as a root in which one directory per model can be created. This release will only contain the epic.2.2 model, but you can create your own here. This works together with the PT_MODEL environment variable and/or the bin/ProjTool.ini file.
models.lst	File containing a list of all files in the tar file containing the files from the 'models' directory used by the 'Install.sh' and 'Distribute.sh' scripts.
pt_meta_ddl	This directory contains the DDL for the meta data that the Projection Tool uses when setting up the meta data tables. Only oracle is currently supported.
pt_meta_ddl.lst	File containing a list of all files in the tar file containing the files from the 'pt_meta_ddl' directory used by the 'Install.sh' and 'Distribute.sh' scripts.
readme.lst	File containing a list of all readme files that are distributed in uncompressed form. This file is used by the 'Install.sh' and 'Distribute.sh' scripts.
src	This directory is the top of the directories that contain the source code for the various C-programs.
src.lst	File containing a list of all files in the tar file containing the files from the 'src' directory used by the 'Install.sh' and 'Distribute.sh' scripts.
tardirs.lst	File containing a list of all directories that are in a tar file.

Move one directory up.