User Tools

Site Tools


s800_daq_tools

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
s800_daq_tools [2016/02/29 11:49]
pereira [Mesytec CFD GUI]
s800_daq_tools [2016/02/29 13:13]
pereira [Troubleshooting]
Line 2: Line 2:
  
   * [[#Running the S800 DAQ]]   * [[#Running the S800 DAQ]]
-    * [[#Run Control Window]] +    * [[#Readout GUI]]
-    * [[#EventBuilder Window]]+
     * [[#Mesytec CFD GUI]]     * [[#Mesytec CFD GUI]]
     * [[#Delay Window]]     * [[#Delay Window]]
     * [[#Trigger GUI]]     * [[#Trigger GUI]]
     * [[#Scaler Display]]     * [[#Scaler Display]]
-    * [[#Troubleshooting]] +  * [[#Troubleshooting]]
-  * [[#S800 DAQ status tool]] +
-    * [[#Readout GUI tab]] +
-    * [[#Eventbuilder tab]] +
-    * [[#Controls tab]]+
   * [[#How to run combined S800 + GRETINA]]   * [[#How to run combined S800 + GRETINA]]
  
Line 23: Line 18:
  
 ==== Readout GUI ==== ==== Readout GUI ====
-The S800 Readout GUI is invoked by either clicking the icon **S800 DAQ** in the desktop of [[Software#u6pc5 (data U6)|u6pc5]] or by navigating in a Linux terminal to the directory **/user/s800/converged_daq** and typing ''godaq''. The Readout GUI window will appear. +The S800 Readout GUI is invoked by either clicking the icon **S800 DAQ** in the desktop of [[Software#u6pc5 (data U6)|u6pc5]] or by navigating in a Linux terminal to the directory **/user/s800/converged_daq** and typing ''godaq''. The Readout GUI window will appear. **IMPORTANT NOTE:** When running Readout GUI, make sure that the environment variables needed by the system are properly defined. This can be done from a Linux terminal by typing: ''. /usr/opt/nscldaq/xxxx/daqsetup.bash'', where ''xxxx'' is the nscldaq version (xxx = 11.0-020, on Feb 2016).
- +
-**IMPORTANT NOTE:** When running Readout GUI, make sure that the environment variables needed by the system are properly defined. This can be done from a Linux terminal by typing: ''. /usr/opt/nscldaq/xxxx/daqsetup.bash'', where ''xxxx'' is the nscldaq version (xxx = 11.0-020, on Feb 2016).+
  
 Before beginning taking data is necessary to initialize the system. This is done by clicking ''Start'' in the ReadoutGUI. After initializing the contollers, the ReadoutGUI window will show the ''Begin'' button active. In addition, three additional buttons should appear at the end of the window. They can be used to start the GUI associated with the [[#Mesytec CFD GUI|MCFD]], [[#Delay Window|Delay XLM]], and [[#Trigger GUI|Trigger ULM]] modules. Make sure that the system is fully initializing before opening those GUIs. Before beginning taking data is necessary to initialize the system. This is done by clicking ''Start'' in the ReadoutGUI. After initializing the contollers, the ReadoutGUI window will show the ''Begin'' button active. In addition, three additional buttons should appear at the end of the window. They can be used to start the GUI associated with the [[#Mesytec CFD GUI|MCFD]], [[#Delay Window|Delay XLM]], and [[#Trigger GUI|Trigger ULM]] modules. Make sure that the system is fully initializing before opening those GUIs.
Line 94: Line 87:
  
  
-==== Troubleshooting ====+===== Troubleshooting ===== 
 +There are several common reasons why the S800 DAQ may fails to start. The list below describes what to do to fix these problems.    
 + 
 +==== CCUSB and/or VMUSB claimed by existing programs ==== 
 +One of the most common reasons why the S800 DAQ fails to start is because the CCUSB and/or VMUSB are claimed by existing programs. This is shown by the error messages displayed by the system. If you find yourself in this situation try the following: 
 +      - Log on to S800 spdaq (spdaq19 as of October 2015) 
 +      - Type ''ps aux | grep Readout'' 
 +      - Use ''kill -9 PID'', where PID identifies any CCUSBReadout or VMUSBReadout processes that show up 
 +      - Use ''kill -9 PID'', where PID identifies any tclsh ReadoutShell process that might show up 
 +      - Try ''godaq'' to see if this works now 
 +      - If this didn't help try rebooting the S800 DAQ manually (see below) 
 +==== Manual rebooting ====
 In the rare case that the RunControl GUI gets "frozen", it is possible to reboot the whole system manually. This operation requires to turn off the VME and CAMAC crates, and the spdaq computer, all them located in the rack seating near the FP box in the S3 vault. Then, the system must be turned back on in the following order. First, CAMAC crate, second VME crate, and third spdaq. In the rare case that the RunControl GUI gets "frozen", it is possible to reboot the whole system manually. This operation requires to turn off the VME and CAMAC crates, and the spdaq computer, all them located in the rack seating near the FP box in the S3 vault. Then, the system must be turned back on in the following order. First, CAMAC crate, second VME crate, and third spdaq.
-===== S800 DAQ status tool ===== 
-In order to remotely monitor the status of the S800 DAQ, a tool has been created which can show statistics and current information about the present running instances of the Readout GUI and eventbuilder programs. This is accessed by the following: 
  
-1. On spdaq48 do: 
  
-**/user/s800/operations/daq/usb/s800status/comms** 
  
-which will open the status GUI.+===== How to run combined S800 + GRETINA ===== 
 +OBSOLETE. Documentation is currently under development.
  
-There are tabs for connections to the Readout GUI, the eventbuilder and a controls tab. 
- 
- 
-==== Readout GUI tab ==== 
-The communications port to the Readout GUI is tcp:7999 and it runs by default on spdaq48. These options are selected by default in the server and port drop down boxes, but other values can be entered here by hand. Clicking "Get Status" will connect to this server/port combination and attempt to fill in the Run Info section with the returned information. The status will also be updated. 
- 
-{{:wiki:comms.png?500|S800 Status GUI}} 
- 
- 
-==== Eventbuilder tab ==== 
-The communications port to the eventbuilder is tcp:8100 and it runs by default on spdaq48. These options can be changed in a manner identical to the Readout GUI tab. Information about the current statistics (input/output buffers, etc) will be updated, as will the connections information. In this scroll box any connection to which the eventbuilder must write data is listed in the form: remote host:local port. 
- 
-{{:wiki:evbuild.png?500|Eventbuilder tab}} 
- 
-This is the only information available to the tcp protocol, but the pid of the processes responsible for these connections can be investigated by using the following commands: 
- 
-1. For each remote host, log in as each user which may be connected to the DAQ (ie e11007, s800). Unfortunately, root access is required to see this information for every user, so seperate logins must be made for each possible user. 
- 
-2. Do **lsof -i | grep port** (where port is replaced by the local port information obtained from the status gui. This will look similar to: 
- 
-<code> 
-netcat.tc 2498 e11007   10u  IPv4  11103      0t0  TCP spdaq44.nscl.msu.edu:58207->spdaq48.nscl.msu.edu:9002 (ESTABLISHED) 
-</code> 
- 
-where the second column shows the PID of the connecting process. In this case the pid is 2498.  
- 
-3. Do **ps -aux | grep PID**. This will look similar to: 
- 
- 
-<code> 
-e11007    2498  0.0  0.0  12052  2252 ?        Sl   12:31   0:20 /usr/bin/tclsh /soft/intel/lucid/daq/10.1/TclLibs/s800/../../bin/netcat.tcl spdaq48 9002 
-</code> 
- 
-which gives the program name associated with the PID that is connecting to the eventbuilder.  
- 
-If the eventbuilder is hanging, which is evidenced by non-increasing statistics and no data/triggers, then it is possible that one of these processes has crashed in a manner that holds open the tcp connection to the eventbuilder. The process can be killed, which will return the DAQ to a normal running mode. 
- 
- 
-==== Controls tab ==== 
-This tab allows forced control of the Readout GUI, and is for advanced users only. In the event that the run must be stopped, or the DAQ software exited without access to the Readout GUI itself these buttons may be used to perform these actions. The run MUST be ended before using the Force Exit button, or it is likely that the USB crate controllers will become stuck in DAQ mode and the crates will have to be reset. 
- 
-{{:wiki:controls.png?500|Controls tab}} 
- 
- 
- 
-===== How to run combined S800 + GRETINA ===== 
  
 In order to run the combined S800 + Gretina daq, the following steps need to be taken: In order to run the combined S800 + Gretina daq, the following steps need to be taken:
s800_daq_tools.txt · Last modified: 2023/10/19 17:25 by swartzj