1 OVERVIEW

1.1 GENERAL

Starting with APR2003, the Operating System HP10.20 will not be supported any longer. RTAP and the so-called "full CCS" type of the VLTROOT have been dropped. CCSLite and NOCCS only are the possible "flavours" for building the VLTROOT.

For JAN2006, Scientific Linux 4.0 is now an official platfom.

Other important changes for JAN2006 are: the compiler version is now gcc 3.3.4. Tcltk is now 8.4.11. .

The VLT Common Software currently includes:

· VLT development utilities

· Central Common Software (CCS)

· Instrumentation Common Software (INS)

· Telescope Control Software (simulation)

· Sequencer

· WS-LCU communication software (Qserver)

· LCU Common Software (LCC)

· Drivers

· Motor Control

· LCU contributions

· CCD Control Software (formerly disstributed as a separate tape)

· FIERA Control Software

· Infrared Detector Control Software (IRD)

· VLTI basic modules (simulation)

· BOSS Base Observation Software

· OSB Supplementary modules for BOSS

· installation and installation verification procedures

· instrument template

· simple examples

and all the relevant documentation in both pdf and PostScript file format.

The present version of the VLT Common Software replaces entirely any previous ESO distribution of VLT Software. No support will be given to previous versions.

The distribution kit contains all the sources needed to regenerate the software on HP, SUN and Linux systems. Distributing the sources also provides developers with:

· examples of applications (e.g., test programs)

· skeletons for the development of similar modules (e.g., drivers)

For a complete description of each module mentioned, please refer to the appropriate user manual.

The major differences with the previous version as well as currently known problems and work arounds are summarized in the RELEASE NOTES, that are published together with the documentation and also available on the WEB.

Even if you are interested in one part only of the VLT Software, please read ALL of the following sections.

1.1.1 Copyright

The VLT Common Software is distributed outside ESO for the development of applications related to the VLT Project and ruled by the "General Conditions of ESO Contracts". Any other use is not allowed without prior authorization from ESO.

The rights of Third Parties (Free Software Foundation, VxWorks, etc.), whose software is for convenience copied on the VLT Common Software tape, are ruled by their copyright notice included in their software.

The file COPYRIGHT, included in the distribution kit, contains the full copyright notice.

1.2 SUPPORTED CONFIGURATION

1.2.1 Hardware

WS

· HP J/B series

· SUN UltraSparc

· Dell Optiplex GX, Poweredge

See the tested configurations in the documents [8] and [10].

LCU:

Please refer to the list of LCU in the section 4.3.5.1 of the document [11].

1.2.2 Software

UNIX Operating System:

SUN: Solaris 5.8

HP: HP-UX B.11.00

Linux: Scientific Linux 4.0

Graphical Libraries: X11R6 and Motif2.1.

VxWorks:

· TORNADO 2.0 - VxWorks 5.4 on HP.

· TORNADO 2.2 - VxWorks 5.5 on both Linux and SUN.

MIDAS (only if INS/pco installation is done):

· 05SEP patch level 1.2

1.3 CONTENTS

The VLT Common Software is distributed as:

· one CD (also available on the web) containing:

a. the software. (For convenience, the CD also contains some public domain software used in the generation of the VLT Software)

b. the documentation kit

· an additional CD containing VxWorks (5.4 or 5.5) is distributed on request

· binaries are available on the web.

1.3.1 Software

1. PUBLIC DOMAIN SOFTWARE

a. GNU C-compiler (3.3.4)

b. GNU binutils (2.15)

c. GNU Make (3.80)

d. GNU awk (3.1.4)

e. GNU gdb (6.0)

f. GNU flex (2.5.4a)

g. GNU bison (1.875)

h. GNU gzip (1.2.4a)

i. GNU texinfo (4.8)

j. GNU emacs (21.4a)

k. GNU sed (4.0.9)

l. GNU diffutils (2.8.1)

m. GNU rcs (5.7)

n. GNU cvs (1.11.5)

o. GNU ddd (3.3.9)

p. GNU zip (2.3)

q. GNU unzip (5.32)

r. GNU tar (1.14)

s. GNU M4 (1.4.3)

t. GNU autoconf (2.59)

u. GNU deroff (2.0)

v. GNU grep (2.5)

w. GNU gnuplot (4.0.0)

x. GNU gsl (1.6)

y. GNU groff 1.19.1

z. GNU perl 5.8.6

aa. Tcl 8.4.11

ab. Tk 8.4.11

ac. [incr Tcl] 2005-03-30

ad. [incr Tk] 2005-03-30

ae. widgets 2005-04-11

af. tclX 2005-04-26

ag. TkX 2005-04-26

ah. BLT 2.4z

ai. msql2

aj. tkimg 1.3

ak. Tktable 2.9

al. snack 2.2.9

am. tclCheck 1.1.13

an. expect 5.43

ao. rman 3.1

ap. tkman 2.2

aq. tkinspect 5.1.6p10

ar. Sybtcl (HP-UX only)

as. pgplot

at. TclPro (procheck) 1.5.0

au. msqltcl (1.99)

av. tcllib (1.7)

2. VLT SOFTWARE
(the version number of each module is listed in <VLTSW>/INSTALL/buildFromArchive)

UNIX:

a. VLT Utilities

installation scripts: (vltsw)

Kit/VLT Makefile and Man-page browser (vlt)

document development support toolkit (doc)

utilities to check files for potential compatibility problems (compat)

code and document templates (templates)

standard environment (pecsvltsw)

compatibility checker (compat)

emacs customization kit (emacs)

code management module (cmm)

tool for automatic test (tat)

b. Queue Server Emulator (qsemu)

c. Central Common Software:

CCS/Ccs

CCS/alrm

CCS/cai

CCS/ccs

CCS/ccsMon

CCS/ccsei

CCS/cmd

CCS/db

CCS/dblpp

CCS/dblcb

CCS/eccs

CCS/envs

CCS/err

CCS/errch

CCS/evh

CCS/evhEt

CCS/evt

CCS/fnd

CCS/his

CCS/log

CCS/msg

CCS/ntp

CCS/plot

CCS/samp

CCS/scan

CCS/tims

CCS/vcc

CCS/vccmake

PANEL/fedit

PANEL/panel

PANEL/ptlib

PANEL/uif

d. HOS (High-level Operaton Software)

sequencer (seq)

brooker for observing blocks (bob)

access configuration and control (acc)

template server (tplsrv)

Audio software (audio) - NEW -

e. INS Common Software - File handling

SLX/miscellaneous utilities (misc)

SLX/setup file handling (slx)

SLX/setup file handling - C++ version (oslx)

SLX/setup file handling - tcl interface (slxtcl)

INS/data transfer module. (dxf)

INS/ins system tools (ist)

INS/protocol converter. (pco)

INS/common templates (insc)

INS/VLT OnLine Archive interface (volac)

f. ICB INS Common Base ICS (auto, ctoo, egen, ic0, ic0dev, ic0dig, ic0lcu, ic0mot, ic0sen, icb, icbpan, lccdev, lcctoo, uvisen)

g. CCD Control Software

h. OSB (boss, bossvlti, ibac, ixac, osb)

i. FIERA CCD Detector ontrol Software

j. IRD Infrared Detector Control Software

k. TCS (Telescope Control Software)

TCS/Star Catalogue interface (catif)

TCS simulation kit (agws, catif, m2com, msw, prs, tcs, tcssim, tcs mon, tif, trkws)

TPOINT Telescope pointing model

l. Real-Time Display (DMD/rtd) and catalog lirary (DMD/cat)

m. DICB FITS keyword Dictionaries (dicDPR, dicOBS, dicPAF, dicTPL)

n. an example of a WS application (examples/wsapp)

o. instrument templates

p. VLTI basic modules (simulation)

VxWorks:

q. LCU Common Software

LCC library (lcc3)

Command Interpreter tools (too)

r. LCU QServer (lqs)

s. Drivers

driver log utility (lculog)

driver common utilities (lcudrv)

empty driver skeleton (xxx)

MACCON driver (mcon)

Analog I/O driver (aio)

ACROMAG Digital I/O driver (acro)

Servo Amplifier driver (ampl)

NET01 Ethernet I/F Board driver (net01)

Time Board driver (tim)

Heidenhein IK320 Encoder driver (ikon)

Serial I/F driver (iser)

Reflective Memory (rmn)

Can driver (canio)

MEN analog/digital I/O (mendrv)

LCU configuration tool (lcuboot)

LCU status monitoring tool (lcustat, lcuwd)

driver engineering interface basic tool (inducer)

acro engineering interface (acrox)

aio engineering interface (aiox)

ikon engineering interface (ikonx)

Time Board engineering interface (timx)

canio engineering interface (caniox)

t. Motion Control

Motion Controller wrapper (mcm)

Motion Controller SDL (mac4)

Motor Control Module API (mot)

Motor Command Interface (motci)

Motor Engineering Interface (motei)

SDL Common Interface (sdl)

Servo Amplifier SDL (vme4sa)

u. an example of an LCU application (examples/lcuapp)

1.3.2 Documentation

The documentation is organized in the following volumes

1a&b: CCS - workstation part

2a: LCU Common Software and Motor Library

2b: LCU Drivers

3: HOS & TCS

4: CCD

5a: INS specifications

5b: INS templates

5c: INS manuals

Documents are provided for external releases only in the following formats:

· as a tar compressed file DOC.tar.gz in the VLTSW CD that contains all the documents in ps format (most of them are also in pdf format)

· on the web:
http://www.eso.org/projects/vlt/sw-dev/wwwdoc/JAN2006/dockit.html

1.4 BACKWARD COMPATIBILITY

The software included in the present delivery is backward compatible with the previous version that have been already declared as baseline. For what is concerning software that appear for the first time with this release, please refere to the appropriate User Manual to see whether is released as a baseline version (i.e., backward compatible in future versions) or still in a preliminary form (i.e., it may change in future versions)

In any case, after the installation of the current release, any existing software/application using the VLTSW must be regenerated. INTROOTs (if any) should be regenerated from scratch.

The "Release notes" point out the differences between the current version and the previous one. In addition the "compat" utility is provided to help in locating the lines of code to be changed (see 2.10 for more), if any.

1.5 DEFAULT SHELL

Starting with the MAR2001 release, the default shell is bash. We changed to bash from tcsh for different technical reasons, the main ones being that with CDE the login scripts are written in sh and tcsh is not supported any longer on HP11.

We re-wrote also the standard environment, now called PECS (see section 2.6 and 5) in order to use bash. The general organisation of the environment, the installation procedure and setting the environment for a user have changed. The implications of this are:

· a new account is needed (called pecsmgr) that is the owner of some core PECS files;

· the users vltmgr and vlt must have the default shell set to /bin/bash;

· vx will remain to /bin/csh

· any other user must be defined with default shell /bin/bash

· the syntax in the bash shell is different (see 5 ).

1.6 PROBLEM REPORTING/CHANGE REQUEST

Please use the procedure explained in [6].

Quadralay Corporation http://www.webworks.com Voice: (512) 719-3399 Fax: (512) 719-3606 sales@webworks.com