http://ift.wiki.uib.no/index.php?action=history&feed=atom&title=FeeServerFeeServer - Revision history2026-05-24T04:18:41ZRevision history for this page on the wikiMediaWiki 1.44.2http://ift.wiki.uib.no/index.php?title=FeeServer&diff=137&oldid=prevDfe002: New page: Category:DCS back to: Detector Control System == Overview == ... (to be filled) == FeeServer Download == Curren...2009-02-20T10:46:12Z<p>New page: <a href="/index.php?title=Category:DCS&action=edit&redlink=1" class="new" title="Category:DCS (page does not exist)">Category:DCS</a> back to:<a href="/Detector_Control_System_(DCS)_for_ALICE_Front-end_electronics" title="Detector Control System (DCS) for ALICE Front-end electronics"> Detector Control System</a> == Overview == ... (to be filled) == FeeServer Download == Curren...</p>
<p><b>New page</b></p><div>[[Category:DCS]]<br />
back to:[[Detector Control System (DCS) for ALICE Front-end electronics | Detector Control System]]<br />
<br />
<br />
<br />
== Overview ==<br />
<br />
... (to be filled)<br />
<br />
<br />
== FeeServer Download ==<br />
Current releases of the FeeServer with RCU-like ControlEngine (fits for '''TPC''' and '''PHOS''') are available from the [[DCS Download#FeeServer | Download page]].<br />
<br />
<br />
<br />
Versions of the FeeServer core software can be downloaded from the [https://www.ztt.fh-worms.de/download/alice ZTT web pages]. This package only contains the FeeSever core, the needed [http://www.cern.ch/dim DIM framework] libraries and a dummy CE (something like a echo server), the real CE depends on the detector and requires the appropriated hardware).<br />
<br />
<br />
== Compilation ==<br />
After unpacking the compressed archive (tar xzvf <filename> ) change to the directory. The package must be configured by running the ''./configure'' script, after configuration for the desired platform type ''make''. The script has several options:<br />
<br />
* '''--host <host environment>''' : selection of the cross compiler<br />
* '''--disable-rcu''' : RCU related functionality (in this wiki you will only find RCU-like FeeServers, so there is only the option to turn it off)<br />
* '''--enable-tpc''' : TPC related functionality (so far there is none, all is included in the RCU target)<br />
* '''--enable-phos''' : PHOS related functionality<br />
* '''--enable-mastermode''': Enable special features (e.g. shell command execution, FeeServer update)<br />
* '''--enable-rcudummy''' : Enable a dummy implementation of the RCU CE. This will skip all the hardware accesses. <br />
<br />
Try '''--help''' to get a comprehensive help or '''--help=short''' to get information on the package specific options.<br />
<br />
If you want to build the FeeServer for the armlinux on the DCS board you need a [[DCS FAQ#What is a cross compiler? | Cross Compiler]]. Currently arm-uclibc-gcc 3.3.1 is used. To configure the package for the cross compiler run the configure script like:<br />
<br />
./configure --host arm<br />
make<br />
<br />
Be sure that the path of the cross compiler is added to the '''PATH''' environment variable ([[DCS FAQ#How do I install a cross compiler and use it? |more help]]). <br />
<br />
<br />
If you plan to compile the FeeServer core package please have a look into the README file which comes along with the package.<br />
<br />
== Preparation ==<br />
To run the FeeServer on the DCS board copy it to the board wherever you want to have it. The second, strongly recommended, possibility is to mount a network disk on the board. The FeeServer package supports automatic copying to whatever folder through the standard ''make install'' command. The location can be specified by the '''--prefix''' option to the ''configure'' script.<br />
<br />
A few more variables have to be set:<br />
<br />
* '''DIM_DNS_NODE'''(mandatory) denotes the host where a ''Name Server'' for the DIM framework (''dns - DIM Name Server'') is running.<br />
* '''FEE_SERVER_NAME'''(mandatory) for the name of the FeeServer (as it will pop up in the DIM system )<br />
* '''FEE_LOG_LEVEL'''(optional) default logging level of the FeeServer<br />
* '''FEESERVER_FEC_MONITOR'''(optional) specifies the valid FECs <br> its a string of '0' and '1', missing entries are set to 0, e.g. '01001' puts FEC 2 and 5 into the configuration<br />
<br />
<br />
'''!!! IMPORTANT !!! NOTE:'''<br />
<br />
Since version 0.7.0:<br />
The environment variable for the FeeServer name has changed to<br />
FEE_SERVER_NAME. (prior versions: DIM_SERVER_NAME)<br />
<br />
== Running the FeeServer ==<br />
<br />
To execute FeeServer properly please follow these steps:<br />
* make sure that the dns for DIM is running on the machine you specified<br />
* !!! NEW !!! since version 0.7.0:<br> finally run ''sh startFeeServer.sh'' <br> This script starts the FeeServer and takes care of various features.<br />
<br />
The starting script also accepts an optional parameter: You can also set the FeeServer name by passing it to the starting script. The starting script automatically restarts the FeeServer, if it exits with an unknown error/exit value.<br />
<br />
For debugging purpose it is convenient to start the FeeServer directly like ''./feeserver''. In that case, the restart and update features will not work.<br />
<br />
== Important Notes ==<br />
<br />
* for full functionality start the FeeServer only with the startFeeServer.sh script.<br />
* interface of FeeServer and CE changed in version 0.7.0 <br />
* The service name scheme for CE service has changed:<br>old style: ''servername/servicename'' -> new style: ''servername_servicename''<br> (These changes for ACK-, MSG- and Command-channel will follow.)<br />
* never turn on '''mastermode''' unless you are shure that your network is behind a firewall to avoid abuse.<br />
<br />
See also the README and ChangeLog - files of the FeeServer package.<br />
<br />
<br />
<br />
== ControlEngine guidelines ==<br />
<br />
Following some notes, which should be taken account of when developing a ControlEngine. <br />
* We included a demo function for initializing an "Item" in our dummy CE. When writing an own CE, it is best copying and using this function in order to get a proper initialized "Item".<br />
* Don't use static created "Items", especially don't use static allocated memory for the "Item" names. This would case the clean up to hang and a proper exit would be no longer possible.<br />
* Please obey the DCS naming and numbering convention, when naming an "Item". more under: http://alicedcs.web.cern.ch/AliceDCS/<br />
* Provide the "Items" with a default deadband. (Else the deadband will be 0, and the update rate would get to high -> to much traffic). <br />
* After the CE has been initialized, let this thread sleep for approx. 2-5 seconds (this gives the FeeServer time start the serving functionality inside the DIM framework).<br />
* In "cleanUpCE()", the CE don't need to clean and/or free "Items" and its members. (In fact it must not do it, this would crash the FeeServer during its cleanup.)<br />
* Don't call the createLogMessage() function during initializing the CE. (after the above mentioned sleep is fine). This service is only available after the DIM serving functionality has been started. <br />
* Be careful with sending log messages, especially in rapidly repeated checks/functions, this can pile up your log file extremely. Even consider carefully the specified log level; MSG_ALARM should be only for events, that could damage or destroy the system/hardware.<br />
* If, while testing, certain log messages of the CE don't appear, check the set log levels in FeeServer and InterComLayer. They may have filtered these messages. To set the default log level of the FeeServer, you can also use the environment variable FEE_LOG_LEVEL before starting the FeeServer.<br />
<br />
== ControlEngine implementations == <br />
* [[RCU ControlEngine | The ControlEngine for the RCU]]</div>Dfe002