8 ENVIRONMENT SETTING AND INSTALLATION

8.1 HW AND SW REQUIREMENTS

The following components are needed for running a full installation of DCS:

· Ultra-Sparc (2 CPU) running Solaris 2.6 or later.

Recommended are ULTRA-2 SBus or ULTRA 60/80 for PCI-Bus.

· 1 DMA Interface EDT SCD 60 (SBus) or EDT PCICD 60 (PCI-Bus).

· Instrument Workstation. This can be one of

- HP-Workstation running HP-UX 10.20 or HP-UX 11

- Sun-Workstation running Solaris 2.6 or later

- PC running Red Hat Linux Release 6.1 or later

· VLT SW Package NOCCS for the Ultra-Sparc.

· VLT SW Package CCS (HP-UX 10-20) or CCSLite (HP-UX 11, Solaris, Linux) for the IWS.

For software tests it is possible to run the data-acquisition software (optimized for Sun-Solaris multi-threading) also on HP-UX in simulation mode. In that case only the HP-Workstation is needed. As the simulation of the acquisition process consumes a lot of system resources and CPU-time it is recommended not to run the simulation at high data-rates (< 2 MHz).

8.2 ENVIRONMENT VARIABLES

The following environment variables have to be set if not marked as optional:

$INS_USER Specifies the current user (defaults to SYSTEM, if not set).

$INS_ROOT Root directory of the instrument configuration.

$IR_SPARC SPARC_SBUS(optional) or SPARC_PCI.

$SDMA_HOST Host name of the IRACE - pre-processor workstation

(for simulation, this can also be the HP-workstation).

$SDMA_DEV Default device name of the DMA-driver (optional).

$SDMA_CMD Command port of the DMA pre-processor.

$SDMA_DATA Data port of the DMA pre-processor.

$SDMA_ERR Error port of the DMA pre-processor (optional).

$TCOM_SRV Command port of the IRACE front-end command server.

$IRACQ_PORT Command port for the NOCCS control server (only

needed for NOCCS installations on the Ultra-Sparc).

$RTD_CAMERA RTD-Camera name.

$IRTD_PORT Port number for the RTD-interface.

The port numbers must not exist in /etc/services of $SDMA_HOST.

8.3 IRD PACKAGE INSTALLATION

The procedure to create the IRD Software package consists of the following steps:

(1) Retrieve from the archive and install module irdarch:

a) mkdir IRDROOT; cd IRDROOT

b) cmmCopy irdarch

c) cd irdarch/src; make prepare_installation

(2) Go to installation directory:

cd ../../INSTALL

(3) Retrieve all needed modules from the archive:

./buildFromArchive

(4) Build and install modules:

./buildIRD

(5) Run automatic test procedure:

./buildTestIRD (DISPLAY variable must be set)

Steps 3 to 5 can also be done in one step:

./buildAll

This procedure is only applicable on the instrument workstation. The software on the IRACE workstation (Ultra Sparc) must be installed manually as after retrieving the irace module the DMA interface driver has to be installed before compilation. The driver installation requires root access.

8.4 MANUAL SOFTWARE INSTALLATION

The first step of installation is to get the standard IRACE-DCS base modules:

IRACE-DCS:

cmmCopy irace

cmmCopy iracq

cmmCopy dicIRACE

Optional RTD interface:

cmmCopy rtdb

cmmCopy irtd

8.4.1 SOFTWARE INSTALLATION ON ULTRA-SPARC

The interface device drivers for IRACE are found in the SYSTEM/DRV directory of the irace module. Generally the DMA driver-packages (EDTscd for SBUS-based sparcs, EDTpcd for PCI-based sparcs) have to be installed before compilation on the Ultra-Sparc, as the driver interface defined in sdmaDrv.h will include header files from that package and may also link object files (PCI-version). If the package cannot be installed, one has the possibility to compile also on the Ultra-Sparc for simulation purposes only (by using the MAKE_SIM=T flag when compiling the irace/iracq modules).

Some entries have to be added to /etc/system:

For IPC facilities:

set msgsys:msginfo_msgmap=1024

set msgsys:msginfo_msgmax=8192

set msgsys:msginfo_msgmnb=65535

set msgsys:msginfo_msgmni=512

set msgsys:msginfo_msgseg=4096

set msgsys:msginfo_msgssz=64

set msgsys:msginfo_msgtql=1024

set semsys:seminfo_semmap=2048

set semsys:seminfo_semmni=500

set semsys:seminfo_semmns=8192

set semsys:seminfo_semmsl=500

set semsys:seminfo_semopm=50

set semsys:seminfo_semvmx=32767

set shmsys:shminfo_shmmax=32000000

set shmsys:shminfo_shmmni=256

set shmsys:shminfo_shmseg=64

set shmsys:ism_off = 1

For faster scheduling:

set hires_tick = 1

Driver Installation for SBus:

To remove a previously installed driver type:

su

<enter password>

pkgrm EDTscd; rm -rf /opt/EDTscd

cd irace/SYSTEM/DRV; su

<enter password>

cp EDTscdx.xx.tar /usr/spool/pkg/

<x.xx> is the version of the driver (currently EDTscd2.55.tar)

cd /usr/spool/pkg; tar xvf EDTscdx.xx.tar; rm EDTscdx.xx.tar

pkgadd EDTscd

You will be asked to select the source for the TXT signal:

-> enter <1> (RXT looped...). In newer driver versions

(2.80 and later) you have to do the following instead:

cd /opt/EDTscd

./scdrequest

enter <1> (RXT looped...)

Now you have to check the permissions of the parallel port device referenced by

/dev/bpp0 (type `ls -lL /dev/bpp0'; this is a link to `/devices/sbus...').

The device must be given read/write permissions for all users.

Driver Installation for PCI-Bus:

To remove a previously installed driver type:

su

<enter password>

pkgrm EDTpcd; rm -rf /opt/EDTpcd; rm -f /usr/lib/libedt.so

cd irace/SYSTEM/DRV; su

<enter password>

cp EDTpcdx.xx.tar /usr/spool/pkg/

<x.xx> is the version of the driver (currently EDTpcd2.304.tar)

cd /usr/spool/pkg; tar xvf EDTpcdx.xx.tar; rm EDTpcdx.xx.tar

pkgadd EDTpcd

cd /opt/EDTpcd

./pcdrequest

enter <1> (RXT looped...)

ln -s /opt/EDTpcd/libedt.so /usr/lib/libedt.so

Software Installation (SBus and PCI-Bus):

If a version of irace is already installed in $INTROOT:

cd $INTROOT/bin; su

<enter password>

./sdmaChMod <user-name> and/or

./chmod a-s <your application processes>

./chown <user-name> <your application processes>

Compilation:

cd irace/src; make

cd iracq/src; make man all install

cd rtdb/src; make man all install

cd irtd/src; make man all install

cd $INTROOT/bin; su

<enter password>

./sdmaChMod su (to enable real-time facilities) and/or

chown root <your applications>

chmod a+s <your applications>

8.4.2 SOFTWARE INSTALLATION ON IWS

The following steps have to be done to install the software on the instrument workstation:

cd irace/src; make (or `make MAKE_POSIX=T' to compile also the posix-wrapper for the Solaris data-acquisition simulation)

cd iracq/src; make man all install

cd dicIRACE/src; make all install

cd rtdb/src; make man all install

cd irtd/src; make man all install

cd $VLTDATA/ENVIRONMENTS/$RTAPENV/dbl

add `iracqBranch.db' to `DATABASE.db' (-> Database)

make db

vccEnvStop -e $RTAPENV

vccEnvInit -e $RTAPENV

vccEnvStart -e $RTAPENV

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