ALICE TRD fxsproxy README
		=========================

fxsproxy is a tool for the retrieval of all TRD FEE configuration 
information via DIM acknowledge channel, triggered by a DIM command 
including the run number. This command can be launched from everywhere, 
preferably from within the PVSS SOR/EOR scripts.
In case of any problems, please contact: Frederick.Kramer@cern.ch


REQUIREMENTS
------------

The Library libdim is necessary for this package, the dim headers and a dim_dns has to be running.


INSTALLATION
------------

There are two possible ways for the installation:
A: install from rpm
B: install from source


A) 

rpm -U fxsproxy-X.X-X.i386.rpm

Like this, the files will be installed to the directories:
/usr/bin
/etc/rc.d/init.d
/etc/trd


B)

The installation procedure from source makes use of the GNU quasi-standard 
autoreconfigure, which is creating a configure script which then provides 
the actual makefiles.
The standard installation procedure comprises the following steps:
1. unpack & enter the package:
	tar zxfv fxsproxy*.tar.gz
	cd fxsproxy
2. create the makefiles without prefix
	./configure --prefix=
3. compile the code
	make
4. install the fxsproxy (you need to be root for this)
	(su)
	make install
	(exit)

Like this, the files will be installed to the directories:
/bin
/etc/rc.d/init.d
/etc/trd
If you don't give the prefix, the above three directories will be preceeded by /usr/local


INSTALLATION/DE-INSTALLATION OPTIONS
-----------------------------------

A) 
rpm -e fxsproxy


B)
- remove the installed files
	make uninstall
- erase what has been built
	make clean 
- additionally erase anything './configure' has created
	make distclean


OPERATION
---------

Please see the man pages.


RELEASES
--------

1.2  The check for the FEE states is now much faster and the work on this part of the
     code considered done.
     The xsl file has been adjusted to the modified rstate tags and revised to a large
     extend. Although it's structure is still based on poor knowledge in xsl it's now
     displayed quite quickly and shows a useful digest of the data.
1.1  ..
1.0  Running the proxy as a background process is now possible. Since now all primary
     features are in place and stable this is the first version with a 1 in the front.
     Some other new features are:
     a) protection against multiple startup
     b) protection against multiple triggering with the same run number
     c) protection against triggering while still processing the previous command
     d) revised XSL file. Now direct visualisation of the output is quite convenient.
     Anyhow there are some remaining issues:
     a) ask for the FEE states in parallel,
     b) full daemon functionality via /sbin/service not yet in place
     c) GTU/PreTrigger
0.13 All main functionalities are done, except that of the daemon. The dcsFXSPutData 
     section needs to be revised for the next release. Also still missing is the part for 
     GTU and pretrigger.
0.12 --
0.11 --
0.10 --
0.9  The command line server is mostly ready, the main missing functionality is sending
     tags, this will hopefully be solved in the next release.
     The second main open issue is the daemon. This is in principle ready but there are 
     still quite problems with dim.
0.8  --
0.7  --
0.6  first release, many open issues