Subversion Repositories DevTools

JATS Installation Process
-------------------------

1) Place the JATS package in a suitable directory

2) Perform the host-specific installation operation
        SOLARIS: run the script PostInstall.sh
        WINDOWS: do nothing

3) Tailor the JATS startup script
        SOLARIS: tailor TOOLS/jats.sh
        LINUX:   tailor TOOLS/jats.sh
        WINDOWS: tailor TOOLS/jats.bat

   The JATS startup script may be copied to a directory within the users
   PATH and the various values within the script may be alterred to suite
   the users environment.

   The JATS startup script may be modified in-situ and the users PATH
   extended to include the TOOLS directory.

   The JATS startup script is designed to need no changes from JATS
   release to JATS release. Its sole purpose is to startup another
   JATS script that is contained within the release.


JATS Requirements
-----------------

1) Perl 5.6.1 or better
2) Compilers and tools as required by the targets being built

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

Host-specific Installation Operation
-----------------------------------

SOLARIS and LINUX (Done by PostInstall.sh)
    1) Make the scripts in TOOLS executable
    2) Make the binaries in BIN.xxx executable as required
    3) Untar the links.tar file in BIN.xxx as required

WINDOWS
    Nothing

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

Creating the JATS package for Release (Automated Release)
-------------------------------------

1) Create a New automated version in Release Manager
   Use: HOME > TECHNOLOGY GROUP > Build Environment TOOLS
   The package is 'core_devl'

2) Make changes to the JATS files
   Clearcase config Spec:
        element /MASS_Dev_Infra/... .../mass_dev/LATEST
        element /MASS_Dev_Infra/... /main/LATEST
        load    /MASS_Dev_Infra/core_devl

3) Update the ChangeLog.txt file
   Leave the 'VERSION' as current.
   Update the Release Date.

4) Label ALL files in the core_devl view with the CORE_DEVL.XXXX.CR.WIP label

5) Use Release Manager to Release and build the package
   The Build Deamons should build and install the package

6) On "auperaunx26", locate the released package and run the PostInstall script.
        cd core_devl/XX.XX.XX.cr
       ./PostInstall.sh

7)Update the softlink to the latest version of JATS
   On "auperaunx26", in the directory /devl/dpkg_archive/core_devl

        rm jats2_current
        ln -s dpkg_archive/core_devl/XX.XX.XX.cr jats2_current

8) Email the last release note entry to all

Creating the JATS package for Release (Manual Release)
------------------------------------------------------

1) Make changes to the JATS files
   Clearcase config Spec:
        element /MASS_Dev_Infra/... .../mass_dev/LATEST
        element /MASS_Dev_Infra/... /main/LATEST
        load    /MASS_Dev_Infra/core_devl

2) Update the ChangeLog.txt file

3) Label ALL files in the core_devl view with the JATS_XX.XX.XX.cr label

4) Use the jats command:
        jats release JATS_XX.XX.XX.cr
   to release the package.

5) On "auperaunx26", locate the released package and run the PostInstall script.
        cd core_devl/XX.XX.XX.cr
       ./PostInstall.sh

6)Update the softlink to the latest version of JATS
   On "auperaunx26", in the directory /devl/dpkg_archive/core_devl

        rm jats2_current
        ln -s dpkg_archive/core_devl/XX.XX.XX.cr jats2_current

7) Maintain the Release Manager Entry
        
8) Email the last release note entry to all