KLOE Offline Code Distribution


DESCRIPTION

This page explains briefly how to access the KLOE Offline Software at a remote institution.

The KLOE software is now distributed by three ways: backup on tape media, anonymous ftp, AFS (Andrew File System).
About 600MB of disk space are needed for the full distribution.

BACKUP TAPE

In order to get a backup tape of the KLOE software, you should send e-mail to flavia@hpcalc.lnf.infn.it. The tape media currently supported are: Exabyte tapes 8500, DAT, DLT2000. The version of the code running on VAX/DEC-AlphaVMS has been frozen and will no longer be supported. This code is available for distribution only via backup tapes.

OpenVMS Systems

0. Mount the EXABYTE 8mm/DAT/DLT2000 distribution tape on a drive.
   Let's assume that the drive name is MKA0.

   $ ALLOCATE MKA0 TAPE
   $ MOUNT/FOREIGN TAPE KLOESW

1. Create a directory [.KLOE]. This directory can also be the login
   area for the account KLOE_OFFLINE.

2. Create the system logical KLOE$COMMANDS to point to the above
   directory. This logical can be a process logical defined
   in the users LOGIN.COM.

3. Execute the following commands:

        $ SET DEF KLOE$COMMANDS
        $ SET DEF [-]
        $ BACKUP TAPE:PACK.BCK/SELECT=[KLOE...] [.KLOE...]
        $ BACKUP TAPE:OFFLINE.BCK/SELECT=[KLOE.OFFLINE...] [.KLOE.OFFLINE...]
        $ BACKUP TAPE:KLOEDB.BCK/SELECT=[KLOEDB...] [.KLOE.KLOEDB...]
        $ DISMOUNT TAPE

4. Configure the database as follow:

	$ DEFINE DISK$MF :[KLOE.]/TRANSLATION=CONCEAL

   Put the command above either in the system wide login (SYLOGIN.COM)
   or in your LOGIN.COM

5. At this point execute the command:

        $ @KLOE$COMMANDS:SETUP

   You can put the above command in your LOGIN.COM

6. To use the KLOE OFFLINE (to have all logicals and symbols defined) execute:

            $ SETUP OFFLINE

Unix Systems


a) At your site create an account kloe with home directory
   on the disk where you want the software to be installed

b) Create the directory ~kloe/off and cd to it (% cd ~kloe/off).

c) Mount the EXABYTE 8mm/DAT/DLT2000 distribution tape on a drive.
   Let's assume that the drive name is /dev/rmt/0m

   % tar -xvf /dev/rmt/0m

d) Execute the following:

	% cd ~kloe
	csh -x install.csh >& install.log

   The above commands will install the software in the off
   directory and delete the tar files.
   (If something goes wrong send the file ~kloe/install.log to
    flavia@hpkloe01.lnf.infn.it).

e) To accomodate the KLOE database at your side you have to
   customize one configuration file: ~kloe/off/kloedb/hepdb.names.
   Edit this file changing all occurences of the string /kloe/soft
   with what you get executing the command: % echo ~kloe.

   At this point you are done and the kloe software is installed at
   your side.

   The following commands should be executed at each login session.
   you might want to consider sourcing the following scripts
   respectively in each KLOE user's .cshrc and .login:

           % source group_cshrc

           and

           % source group_login

f) At this point you can execute the command :

           % setup offline

   and use the KLOE software.

ANONYMOUS FTP

The distribution via anonymous ftp is only available for UNIX system. Only two flavors of the UNIX operating system are currently supported: HP-UX and Digital Unix (v3.2d). Some effort is being made to support the software also for IBM/AIX and Windows NT.

        a) At your site create an account kloe with home directory
           on the disk where you want the software to be installed

        b) Via anonymous ftp (ftp@hpkloe01.lnf.infn.it) get the following
           files:

                /dist/offline/install.csh
                /dist/offline/group_cshrc
                /dist/offline/group_login

           and put them in ~kloe.

        c) Create the directory ~kloe/off.

        d) Get via anonymous ftp all tar files that you find in the
           KLOE distribution directory for the UNIX flavor of interest
           under /dist/offline/HP-UX or /dist/offline/OSF1 and put them
           in the ~kloe/off directory.

        e) Execute the following:

                % cd ~kloe
                % csh -x install.csh >& install.log

           The above commands will install the software in the off
           directory and delete the tar files.
           (If something goes wrong send the file ~kloe/install.log to
            flavia@hpkloe01.lnf.infn.it).

        f) To accomodate the KLOE database at your side you have to
           customize one configuration file: ~kloe/off/kloedb/hepdb.names.
           Edit this file changing all occurences of the string /kloe/soft
           with what you get executing the command: % echo ~kloe.

        At this point you are done and the kloe software is installed at
        your side.

        The following commands should be executed at each login session.
        you might want to consider sourcing the following scripts
        respectively in each KLOE user's .cshrc and .login:

                % source group_cshrc

                and

                % source group_login

        g) At this point you can execute the command :

                % setup offline

           and use the KLOE software.

ANDREW FILE SYSTEM

The KLOE software is also distributed using the AFS method in read only mode. The AFS server is located at CASPUR but it will soon be moved to LNF. Weekly (on wednesdays), the KLOE software disk in Frascati is mirrored on the AFS server disk, and this mirror copy is then available to outside institution.


a) Install AFS at your site (have the system manager do it).

b) Once AFS is installed you will find the KLOE Offline Software under
   the directory /afs/infn.it/project/kloe/off.

c) Put in your .cshrc the following line at the end of the file:

	% source /afs/infn.it/project/kloe/off/afs_group_cshrc

   and in your .login the following:

	% source /afs/infn.it/project/kloe/off/afs_group_login

d) Then logout and log back in (or just source your .cshrc and .login
   files), and you are ready to use the software:

	% setup offline


Last updated Jul 25, 1996

Suggestions ? Please contact flavia@hpkloe01.lnf.infn.it