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.

Linux Red Hat 7.3 has been added among the supported platforms, but it is not yet an accepted platform by Paranal. In addition, there is still development to do to have a fully working system (workstation and lcu(s)).

Other imprtant changes for APR2003 are: the compiler version is now gcc 3.2.1 and GNU make has been ported from 3.75 to 3.79.

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 printed 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 both HP and SUN 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 around 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 COPYING, 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

LCU:

· Motorola MVME 167 CPU board - any version

· Motorola MVME 2604 CPU board - any version

· VMIVME-3111 Analog I/O board - version ID 0x0d

· ACROMAG AVME948X Digital I/O board - any version

· ESO Time Reference Board - ESO internal version

· VME4SA-X1 4-channel DC Servo Amplifier - any version

· VME4ST 4-channel STP Servo Amplifier - any version

· MACCON - MAC4- INC motion controller incremental encoder - version 4.1A or 4.2

· MACCON - MAC4- SSI motion controller SSI encoder - version 4.1A or 4.2

· MACCON - MAC4- STP motion controller STP encoder - version 2.0A or 2.1

· VMIVME-5576 Reflective Memory Board

· ESD ISER8 - 8 port RS232 serial interface

· NAT NET01 - Ethernet board

· BI016 - transputer interface

· Heidenhain IK320 Encoder, firmware: "246 118 06"

1.2.2 Software

UNIX Operating System:

SUN: Solaris 2.8

HP: HP-UX B.11.00

Linux: redHat 7.3

Graphical Libraries: X11R6 and Motif2.1.

VxWorks:

· TORNADO 2 (VxWorks 5.4) on both HP and SunOS

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

· 02SEP patch level 1.3

1.3 CONTENTS

The VLT Common Software is distributed as:

· one CD 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 (in case of an internal release, the Installation Manuals and Release Notes only will be distributed, on paper copies)

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

1.3.1 Software

1. PUBLIC DOMAIN SOFTWARE

a. GNU C-compiler (3.2.1)

b. GNU binutils (2.12)

c. GNU Make (3.79)

d. GNU awk (3.1.0)

e. GNU gdb (5.2)

f. GNU flex (2.5.4)

g. GNU bison (1.35)

h. GNU gzip (1.2.4a)

i. GNU texinfo (4.2)

j. GNU emacs (21.2)

k. GNU sed (3.02)

l. GNU diffutils (2.8.1)

m. GNU rcs (5.7)

n. GNU cvs (1.10)

o. GNU ddd (3.3.1)

p. GNU zip (2.3)

q. GNU unzip (5.32)

r. GNU tar (1.13)

s. GNU M4 (1.4)

t. GNU autoconf (2.53)

u. Tcl 8.3.5

v. Tk 8.3.5

w. [incr Tcl] 3.2.1

x. [incr Tk] 3.2.1

y. tclX 8.3.5

z. TkX 8.3.5

aa. BLT 2.4z

ab. msqltcl 1.99

ac. img 1.2.4

ad. Tktable 2.8

ae. snack 2.2

af. tclCheck 1.1.13

ag. expect 5.3.8

ah. rman 3.0.9

ai. groff 1.17

aj. tkman 2.1

ak. tkinspect 5.1.6

al. Sybtcl (HP-UX only)

am. pgplot

an. perl 5.6.1

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)

software module handling utilities (mod)

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)

workpage time account (wp) (FOR ESO INSTALLATION ONLY)

b. Queue Server Emulator (qsemu)

c. Central Common Software:

CCS/Ccs

CCS/alrm

CCS/book

CCS/cai

CCS/ccs

CCS/ccsei

CCS/cmd

CCS/db

CCS/dbl

CCS/dblcb

CCS/eccs

CCS/envs

CCS/err

CCS/errch

CCS/evh

CCS/evhEt

CCS/evt

CCS/fftw

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)

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)

SLX/file handling tool - user interface (fht)

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, lccdev, lcctoo)

g. CCD Control Software

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

i. FIERA CCD Detector ontrol Software

j. IRD Infrared Detector Control Software - NEW -

k. TCS (Telescope Control Software)

TCS/Star Catalogue interface (catif)

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

TPOINT Telescope pointing model

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

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

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

o. instrument templates

VxWorks:

p. LCU Common Software

LCC library (lcc)

LCC engineering interface (lccei)

Command Interpreter templates (citmp)

Command Interpreter tools (too)

q. LCU QServer (lqs)

r. 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)

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)

s. 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)

t. an example of an LCU application (lexamples/cuapp)

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

5: INS

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

· as paper copy only on motivated request
To people who have already received the previous versions, only new or changed documents are shipped as well as instructions on how to merge the new set into the existing one.

· as a tar compressed file DOC.tar.Z 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/APR2003/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 must be regenerated.

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