Skip to content
This repository has been archived by the owner on Dec 2, 2020. It is now read-only.

ORPHAS Setup

Jump to bottom
S. V. Paulauskas edited this page Jun 8, 2018 · 5 revisions

Written by : Karl Smith, Sean Burcher, Cory Thornsberry, David Walter, and S. V. Paulauskas

This document will provide step-by-step instructions on how to setup the ORHPAS acquisition software. Written to support Fedora 24.

Install Standard Packages

Step 1 - Install 3rd Party Packages

The standard packages can be installed with the dnf:

su
dnf install gcc-gfortran libX11-devel tcsh environment-modules tftp-server dhcp

Step 2 - Setup the Environment

We now setup a directory to build the orphas packages:

cd /root
mkdir programs
cd programs

Install Analysis

UPAK is the data analysis package provided by Oak Ridge National Laboratory. We'll need it to compile utkscanor.

Step 1 - Obtain the source code

Go to ORNL's DAQ support page and download the UPAK Data Analysis software source

wget ftp://ftp.phy.ornl.gov/pub/upak/Linux/hribf-upak-rh6-gfort-src.tgz
tar xzf hribf-upak-rh6-gfort-src.tgz
cd upak

Step 2 - Compile the software.

We now remove the object and archive files that were compiled elsewhere.

find . -name *.o -exec rm {} \;
find . -name *.a -exec rm {} \;

We can now compile and install the binaries and libraries:

make
cd ..
mv hhirf/ /usr

Install Acquisition

Go to ORNL's DAQ support page and download: Acquisition software source for MVME 5500 with RTEMS. If that link doesn't work then try this additional link.

Step 1 - Prepare the environment

In a terminal download the acq2 tar ball to /root/programs

su
cd ~
mkdir programs
cd programs
mkdir acq2
wget ftp://ftp.phy.ornl.gov/pub/upak/Linux/data-acquisition/acq2-myriad.tgz
tar xzf acq2-myriad.tgz -C acq2
cd acq2

Step 2 - Remove all object and archive files:

find . -name *.o -exec rm {} \;
find . -name *.a -exec rm {} \;
rm -f bin/* lib/* etc/acq_priority

Step 3 - Build required vme libraries

cd vmelib
make clean
make install
cd ..
cd vmexxlib
make clean
make install
cd ..

Step 4 - Build required acq libraries

cd acqlib

Edit Makefile to Swap f77 for gfortran. Look for line called FORT.

#FORT = /usr/bin/f77
FORT = /usr/bin/gfortran

Compile

make clean
make install
cd ..

Step 5 - Build required ipc library

cd ipclib
make clean
make install
cd ..

Step 6 - Build pacor library

cd Dacq/pacor/lib

Edit Makefile swapping f77 for gfortran. Look for line called FORT.

#FORT = /usr/bin/f77
FORT = /usr/bin/gfortran

compile

make
cd ..

Step 7 - Build pacor objects

Edit Makefile swapping f77 for gfortran. Look for line called FORT.

#FORT = /usr/bin/f77
FORT = /usr/bin/gfortran

Compile

make install
cd ..

Step 8 - Build the Dacq binaries

./makeall

make acq_priority

cp acq_priority ../bin
cp acq_priority ../etc
cd ..

Step 9 - Build pacman

cd pacman
make install
cd ..

Step 10 - Build scadlib

cd scad/lib

Edit Makefile swapping f77 for gfortran. Look for line called FORT.

#FORTRAN = /usr/bin/f77
FORTRAN = /usr/bin/gfortran

Compile

make clean
make
cd ..

Step 11 - Build scad

Edit Makefile swapping f77 for gfortran. Look for line called FORT.

#FORTRAN = /usr/bin/f77
FORTRAN = /usr/bin/gfortran

Compile

make clean
make install
cd ..

Step 12 - Build scop/lib

cd scop/lib

Edit Makefile swapping f77 for gfortran. Look for line called FORT.

#FORT = /usr/bin/f77
FORT = /usr/bin/gfortran

Compile

make
cd ..

Step 13 - Build scop

Edit Makefile swapping f77 for gfortran. Look for line called FORT.

#FORT = /usr/bin/f77
FORT = /usr/bin/gfortran

Compile

make clean
make install
cd ..

Step 14 - Build tape/scatlib

cd tape/scatlib

Edit Makefile swapping f77 for gfortran. Look for line called FORT.

#FORT = /usr/bin/f77
FORT = /usr/bin/gfortran

Compile

make 
cd ..

Step 15 - Build tape

Edit Makefile swapping f77 for gfortran. Look for line called FORT.

#FORT = /usr/bin/f77
FORT = /usr/bin/gfortran

Compile

make clean
make install
cd ..

Step 16 - Build udptoipc

cd udptoipc

Compile

make clean
make install
cd ..

Step 17 - Build vmereset

cd vmereset

Compile

make clean
make install
cd ..

Step 18 - Build vmeterm

cd vmeterm

Compile

make
cp vmeterm ../bin/
cd ..

Step 19 - Install scripts to bin folder

cp scripts/* bin/
ln -s m_setup bin/modu_setup

Note: It appears that modu_setup has been replaced with m_setup. The link resolves this without having to make modifications to files.

Step 20 - Install acq2 (and do some tftp stuff)

mkdir /usr/acq2
cp -r bin/ lib/ etc/ doc/ /usr/acq2/
cd /usr/acq2/etc
chmod +s acq_priority

Step 21 - Make module file

cd $MODULESHOME/modulefiles

Create a module file

vi orphas

Put the following text in the module file

#%Module1.0
##
## modules orphas
##
## modulefiles/orphas
##
proc ModulesHelp {} {
   global version modroot
   puts stderr "orphas - Oak Ridge Acquisition"
}
module-whatis "Oak Ridge Acquisition"

set acq2topdir  /usr/acq2
set upaktopdir  /usr/hhirf

prepend-path PATH   	$upaktopdir
prepend-path LD_LIBRARY_PATH	$upaktopdir
prepend-path LIBRARY_PATH   	$upaktopdir

prepend-path PATH   	$acq2topdir/bin
prepend-path LD_LIBRARY_PATH	$acq2topdir/lib
prepend-path LIBRARY_PATH   	$acq2topdir/lib

Step 22 - Quit super user

exit

Step 23 - Add module to .bash-profile

cd ~
vi .bash-profile

Add line:

module load orhpas

Note: Module files can be easily loaded and unloaded using module load and module unload. In addition, one can see what is loaded using module list and which additional modules are available with module avail.

Step 24 - Configure tftp Server

Copy the ralf file to the tftpboot folder and create a symbolic link:

su
cd ~/programs/acq2/rtems/vmeacq/o-optimize
cp vmeacq.ralf /var/lib/tftpboot/
cd /var/lib/tftpboot
ln -s vmeacq.ralf vmeacp.bin

Step 26 - Modify the firewall to permit tftp traffic:

firewall-cmd --add-service tftp
firewall-cmd --permanent --add-service tftp
Enable the tftp service at boot:

systemctl enable tftp.socket
systemctl daemon-reload

Step 27 - Install xinetd

Set location of file for tftp (eg /home/tftpboot) in /etc/xinetd.d/tftp

File should look like:

Service tftp
{
    socket_type   	 = dgram
    protocol   	 = udp
    wait   		 = yes
    user   		 = nobody
    server   		 = /usr/sbin/in.tftpd
    server_args   	 = -s -vvv -p /home/tftpboot
#    server_args   	 = -s -vvv -p /var/lib/tftpboot
    disable   		 = no
#    server_args   	 = -p -s /home/tftpboot -v -u tftpd
#    disable   		 = yes
    per_source   	 = 11
    cps   		 = 100 2
    flags   		 = IPv4
}

Run

xinetd

Step 28 - Configure dhcp Server

Edit /etc/dhcp/dhcpd.conf to add addresses for the MVME. A preconfigured file is available with many MVMEs listed. To manually add an MVME add the following lines, replacing XX, YY, and the MAC addresses AA:BB:CC:DD:EE:FF and 00:11:22:33:44:55 to the correct values for the MVME you would like to communicate with:

ddns-update-style none;
subnet 192.168.13.0 netmask 255.255.255.0 {
	option routers 192.168.13.1;
}
host vmeXX {
	hardware ethernet AA:BB:CC:DD:EE:FF;
	fixed-address 192.168.13.YY;
	filename "vmeacq.bin";
}
host vmeXXb {
	hardware ethernet 00:11:22:33:44:55;
	fixed-address 192.168.13.YY;
	filename "vmeacq.bin";
}

For example, for vme54 you would have:

ddns-update-style none;
subnet 192.168.13.0 netmask 255.255.255.0 {
	option routers 192.168.13.1;
}
host vme54 {
	hardware ethernet 00:01:AF:2D:89:3C;
	fixed-address 192.168.13.5;
	filename "vmeacq.bin";
}
host vme54b {
	hardware ethernet 00:01:AF:2D:89:3D;
	fixed-address 192.168.13.5;
	filename "vmeacq.bin";
}

Step 29 - Install dhcp as service starting at boot.

systemctl enable dhcpd
systemctl daemon-reload

Step 30 - Prepare to Acquire

Ensure that the MVME being used is listed in /etc /hosts, the following line should be present, where XX and YY and replaced with the correct values:

192.168.13.YY vmeXX.phys.ornl.gov vmeXX

For example the entry for vme54 would read:

192.168.13.5 vme54.phys.ornl.gov vme54

Note: vme60 and beyond are not currently registered in acq2/ipclib/ipckeys.h. Using any of these MVMEs will result in the following message when starting pacman:

Servername is: vme60
Processor vme60:  Nonexistent ACQ Resource set

To resolve this ipckeys.h needs to be extended to add the additional resource, this may fail if the memory addresses overlap. The acq2 package will then need to be recompiled and installed. We suggest instead using vme54 for all standalone systems. Simply swap the name in /etc/hosts to vme54 for any vme module. For example vme60 which has IP addres 192.168.13.12 would read:

192.168.13.5 vme54.phys.ornl.gov vme54 #Actually vme60
192.168.13.12 vme60.phys.ornl.gov vme60 #Actually vme60

(both lines are needed)

Step 31 - Configure the environment.

As the daq user make an experiment folder and set the following environment variables:

mkdir exp
cd exp
export VME=vme54
export EXPT=test

Note: As discussed above we use vme54 for all standalone systems. Be sure that the /etc/hosts is configured correctly.

Step 32 - Start pacman

pacman

Load the pac file (These files usually end in .pac, but no extension is needed when typing the command.):

pacor pacfile l Be happy!

Auxiliary Items To communicate with the MVME5500 over serial port, the following parameters should be set using minicom Run minicom in setup mode minicom -s Set the port to Com1 (probably ttyS0) Set Baud rate to 9600, IRQ to 8, no parity and no hardware or software flow control To setup ssh server, run: systemctl start sshd.service systemctl enable sshd.service

Analytics

Pixie Acquisition and Analysis Software Suite

Clone this wiki locally