Installation & execution

Installation

Afecs-1.3 package contains all the source code (the package is completely self-contained), and the jar file containing all Afecs-1.3 classes. To install Afecs-1.3 download Afecs-1.3.tar.gz file from CODA ftp site. After unpacking it you will get Afecs-1.3 distribution with the Afecs-1.3 being the top level directory Simply include Afecs-1.3/afecs-1.3.jar, along with provided jar files from the Afecs-1.3/lib and you are ready to run the application. Afecs-1.3/bin directory contains Linux csh scripts, as well as windows batch files to run the application. In order to run the Afecs platform and run-control user interface through the provided executables you must set AFECS_HOME environmental variable pointing to the Afecs-1.3 directory (not forget to set COOL_HOME environmental variable).

To compile the project locally, change the directory to Afecs-1.3, and type "ant". N.B. This application requires Sun's Java Runtime Environment (JRE) Release 1.6 or later.

Execution

To run Afecs platform the following env variables must be set (provided Linux examples).

setenv EXPID experiment_name

setenv AFECS_HOME /daqfs/home/gurjyan/Devel/Afecs-1.3

setenv COOL_HOME /daqfs/home/gurjyan/Devel/Afecs-1.3/usrdb

COOL_HOME must have certain directory structure, include sub-directory "config" and setup.xml file. However if the provided COOL_HOME directory does not have a required structure Afecs will create structure and provide default setup.xml file. After directory structure is created you have to modify the setup.xml file accordingly for your needs.

config - directory containing cool configuration files

setup.xml - xml file containing platform start-up details.

setup.xml contains platform configuration details, including TCP/UDP communication ports. Below is an example of a setup.xml file.

<afecs>

<!--...... This section is for platform settings ......-->

<!--...................................................-->

<description>Afecs Test Platform</description>

<platformHost>ankaa.jlab.org</platformHost>

<!--<tcpPort>7777</tcpPort>-->

<!--<udpPort>8888</udpPort>-->

<!--...... This section is for rc domain settings ......-->

<!--....................................................-->

<rcDescription>Afecs Test Platform RC Domain</rcDescription>

<!--<rcUdpPort>7878</rcUdpPort>-->

<!--...... this section is for coda2 db settings ......-->

<!--...................................................-->

<dbUrl>jdbc:msql://alcor.jlab.org:8101/vardansTest</dbUrl>

<dbDriver>com.imaginary.sql.msql.MsqlDriver</dbDriver>

</afecs>

setup.xml can be used to specify network specific communication ports

(when skipped the default values are used: TCP-45000, UDP-45000, RC_UDP-45200).