Subversion Repositories DevTools

Index

    JATS Installation Process

        Host-specific Installation Operation

    Creating the JATS package for Release (Automated Release)

    Creating the JATS package for Release (Manual Release)

    Notes on directory layout

================================================================================

================================================================================

================================================================================

================================================================================

Notes on directory layout

The current directory structure is given by the picture below:

    /MASS_Dev_Infra/core_devl/:

      |-BIN.linux_i386/:

      |-BIN.solaris10_sparc32/:

      |-BIN.solaris10_x86/:

      |-BIN.sparc/:

      |-BIN.win32/:

      |-BUILD/:

      |-CFG/:

      |   |-PLATFORM/:

      |   |-SH/:

      |   |-TOOLSET/:

      |-TEMPLATES/:

      |-TEST/:

      |   `-version1/:

      |-TOOLS/:

      |   |-DEPLOY/:

      |   |-LIB/:

      |   |   |-Clearcase/:

      |   |   |-DeployUtils/:

      |   |-LOCAL/:

      |-UTILS/:

Details:

/MASS_Dev_Infra/core_devl

    The root of the core_devl view in the ClearCase VOB

    The only files in the directory should be readme's and the build.pl file

BIN.linux_i386

BIN.solaris10_sparc32

BIN.solaris10_x86

BIN.sparc

BIN.win32

    These directories contain machine-specific binaries used by JATS at runtime.

    There is one directory for each machine-type supported by JATS

    The Unix machine directories contain machine-specific binaries and

    a file that will be used to create symbolic links when the package is

    installed.

    The win32 directory contains a great number of Unix-like utilities.

    These are not cygwin.

BUILD

    This directory contains build files used when the package is built.

    Building core_devel is really a process of creating an install image.

    No binaries are compiled by the 'build' process.

CFG

  |-PLATFORM

  |-SH

  |-TOOLSET

  The files in the CFG subdirectory tree are used by JATS in the process of

  creating makefiles.

  CFG/PLATFORM: Contains files for each 'platform' known to JATS

  CFG/TOOLSET:  Contains files for each 'toolset' known to JATS

  CFG/SH:       Unknown. May be complete rubbish and may not be required any

                         more

TEMPLATES

    Example build and makefiles for various aspects of JATS

    There are no build.pl files in the example. They all use the alternate

    file name of build_test.pl

    Could do to be expanded

TEST

    Test builds

    Very under represented

    Would be nice to have a 'test' build that did something simple

    for each platform currently supported. Would provide a nice test of

    the installation of the required compilers.

TOOLS

  |-DEPLOY

  |-LIB

     |-Clearcase

     |-DeployUtils

    The TOOLS directory contains the jats front-end and utilities that can

    be run with the 'jats etool' command.

    The TOOLS/DEPLOY directory contains 'old' deployment utilities that now

    run under JATS. Some useful stuff. Also run with 'jats etool'

    The TOOLS/LIB directory contains (mostly) perl modules that are used

    extensively by JATS.

    TOOLS/LIB/DeployUtils and TOOLS/LIB/Clearcase contain Perl modules used by

    the TOOLS/DEPLOYutilities. Mostly legacy stuff. Still used, but not actively

    maintained.

UTILS

   This directory contains sources for binary utilities used by jats.

   The utilities are (mostly) NOT JATS buildable

   They are built by hand and only need to be built when a new machine

   type is added to JATS.