Installing MPIA Software


The MPIA Software Distribution

MPIA Software is distributed on DAT tapes in standard Unix tar format. The tar archives include:

1. ukirtAppl.tar - contains the EPICS application directory and the VxWorks sources to control and operate the Mirror Control Unit including the Hexapod and the 8 axis motion controller (Bottom-end controller)
2. astromed_v1.9.tar - contains the AstroCam source and application directory including all OCCAM sources and the main astromed user interface program aui. This archive also contains the configuration files for the AstroCam CCD camera
3. ukirt.tar - contains a backup of the ukirt Solaris account used at MPIA as login account to operate the entire MPIA-UKIRT-Project system
4. T3.tar - contains a backup of all necessary TCL/TK software to run astroCam.tcl and all other TCL/TK programs
The ukirtAppl tree

To install the ukirtAppl archive give cd /EPICS; tar xf ukirtAppl.tar or in case the archive is on DAT give cd /EPICS; tar xf /dev/rmt/0. The graphical tree below shows the resulting ukirtAppl directory tree.

The ukirtAppl directory tree was created with the applSetup command. EPICS database records are in the db subdirectory, EPICS display lists are in the dl subdirectory, EPICS sequencer programs are in the snc subdirectory and the primary vxWorks/EPICS startup sequence startup.keahua can be found in the startup directory. All executable application programs and all loadable databases can be found in the May96/bin/mv167 and May96/data subdirectories.

The ukirtAppl directory conaints a symbolic link to the startup script:
startup.keahua -> May96/bin/mv167/keahua

This link is important because it is referenced in the vxWorks boot ROM.

The astromed_v1.9 tree

To install the astromed_v1.9 archive give cd /somewhere; tar xf astromed_v1.9.tar or in case the archive is on DAT give cd /somewhere; tar xf /dev/rmt/0. The graphical tree below shows the resulting astromed_v1.9 directory tree.

The next step is to create a symbolic link /ASTROMED which points to /somewhere/astromed_v1.9

Important directories within the /ASTROMED directory tree are aui and 42gci. The latter one contains the 3rd vxWorks boot script 42gciInstall.sh. The primary vxWorks boot script /EPICS/ukirtAppl/startup.keahua calls a second vxWorks shell script named /vw/STARTUP.keahua and this script then calls /ASTROMED/42gci/42gciInstall.sh

Please note that the output of some commands within /vw/STARTUP.keahua are redirected to ukirt's home directory. Check /vw/STARTUP.keahua and change or remove these redirections according to your setup.

ukirt's home directory

To install the ukirt home directory archive give cd /somewhere; tar xf ukirt.tar or in case the archive is on DAT give cd /somewhere; tar xf /dev/rmt/0m. The graphical tree below shows ukirt's home directory. Create a symbolic in such a manner that /UKIRT points to ukirt's home directory (see also Chapter 2). Check the .rhosts file in the ukirt directory and compare/modify it according to the backup you have made earlier. Other files to change are .cshrc and .vxworks.login.

One important shell environment variable is WROOT which is also used within the astroCam.tcl program.

Extracting the TCL/TK stuff - T3.tar

Unpack the T3.tar archive with the command: cd /somewhere; tar xf T3.tar or in case the archive is on DAT give cd /somewhere; tar xf /dev/rmt/0m. You have to set the shell environment variables TCL_LIBRARY and TK_LIBRARY to /somewhere/T3/lib/tcl and /somewhere/T3/lib/tk respectively.

The TIX_LIBRARY variable has also to be modified inside the astroCam.tcl program, e.g. set TIX_LIBRARY /somewhere/T3/lib/tix.


Last Modified: 03:52pm MET DST, June 05, 1996