Project

General

Profile

Using Synoptic for monitoring » History » Version 48

Sarah Lockwitz, 04/30/2015 03:33 PM

1 1 Flor de maria Blaszczyk
{{toc}}
2 1 Flor de maria Blaszczyk
3 42 Jason St.john
*Synoptic plots are interactive:* 
4 42 Jason St.john
Zoom in by selecting a box around the area you're interested in.
5 42 Jason St.john
Zoom out by right-clicking on the plot.
6 42 Jason St.john
7 42 Jason St.john
8 1 Flor de maria Blaszczyk
h1. 1) How to start the Synoptic slow-control monitoring
9 39 Jason St.john
10 44 Flor de maria Blaszczyk
1) Open a console.
11 44 Flor de maria Blaszczyk
12 44 Flor de maria Blaszczyk
   @setup ftbf@
13 44 Flor de maria Blaszczyk
14 44 Flor de maria Blaszczyk
2) Go to /home/nfs/ftbf_user/acnet.
15 44 Flor de maria Blaszczyk
16 44 Flor de maria Blaszczyk
   @cd /home/nfs/ftbf_user/acnet@
17 44 Flor de maria Blaszczyk
18 45 Flor de maria Blaszczyk
3) Run the *LArIATViewer.sh* script. This will get automatically a kerberos ticket with settings permissions and open the main menu.
19 44 Flor de maria Blaszczyk
20 44 Flor de maria Blaszczyk
   @./LArIATViewer.sh@
21 44 Flor de maria Blaszczyk
22 44 Flor de maria Blaszczyk
23 44 Flor de maria Blaszczyk
Back up option: ACNET page *D99* launches Synoptic for Lariat.
24 1 Flor de maria Blaszczyk
25 43 Jason St.john
Detailed instructions (starting with launching ACNET): 
26 43 Jason St.john
If the Synoptic viewer is not opened already or if it has crashed, please follow the "steps 1 to 6 here":http://cdcvs.fnal.gov/redmine/projects/lardbt/wiki/How_to_use_the_online_monitoring#From-the-FTBF-MCenter-Control-Room-computers-any-desktop-computer
27 32 Flor de maria Blaszczyk
28 1 Flor de maria Blaszczyk
29 1 Flor de maria Blaszczyk
h1. 2) The displays main menu
30 8 Flor de maria Blaszczyk
31 1 Flor de maria Blaszczyk
!MainMenu.png!
32 1 Flor de maria Blaszczyk
33 42 Jason St.john
This is the main menu. All displays/controls a shifter or expert needs can be accessed through this menu. Click on the menu to open the display / control panel you would like to look at. See the "For shifters" section for a full description of each display.
34 1 Flor de maria Blaszczyk
35 1 Flor de maria Blaszczyk
*Note: All the displays have a button that allows you to go back to the main menu, generally at the bottom right corner of the display.*
36 1 Flor de maria Blaszczyk
37 1 Flor de maria Blaszczyk
h1. 3) For shifters
38 1 Flor de maria Blaszczyk
39 5 Flor de maria Blaszczyk
Unless you need to change the settings on one of the power supplies / tertiary beam magnet, these are the displays you will need to look at.
40 1 Flor de maria Blaszczyk
41 1 Flor de maria Blaszczyk
h2. Beam related information
42 2 Flor de maria Blaszczyk
43 1 Flor de maria Blaszczyk
h3. MCenter Supercycle
44 2 Flor de maria Blaszczyk
45 11 Flor de maria Blaszczyk
!MCenterSupercycle.png!
46 1 Flor de maria Blaszczyk
47 11 Flor de maria Blaszczyk
On this display you can see at which stage of the beam cycle you are. The plots evolve continuously, wait for the spill (circled) to appear before stopping / starting a run (on the screenshot above you can see 2 spills). The full cycle is 1mn.
48 22 Flor de maria Blaszczyk
49 1 Flor de maria Blaszczyk
h3. MCenter info
50 2 Flor de maria Blaszczyk
51 20 Flor de maria Blaszczyk
You can access the tertiary beam magnets and chiller controls from this display. You can also access the last 24h data for the magnets (temperatures and current).
52 2 Flor de maria Blaszczyk
53 8 Flor de maria Blaszczyk
!MCenterInfo.png!
54 1 Flor de maria Blaszczyk
55 3 Flor de maria Blaszczyk
*Beam related information*
56 1 Flor de maria Blaszczyk
* MC6CV indicates the opening a vertical collimator in the secondary beamline(see "Switchyard Layout":https://cdcvs.fnal.gov/redmine/attachments/download/23879/Switchyard-Current.pdf ). When the beam profiles do not look “good” (off-centered or too wide), MCR can change this value to improve the beam profile.
57 1 Flor de maria Blaszczyk
* MCENRG states the energy of the secondary beam at the LArIAT target.
58 22 Flor de maria Blaszczyk
59 22 Flor de maria Blaszczyk
*Tertiary magnets*
60 1 Flor de maria Blaszczyk
* MC7AT1 states the temperature of the coil of magnet 1. Alarm above 175º F.
61 1 Flor de maria Blaszczyk
* MC7AT2 states the temperature of the coil of magnet 2. Alarm above 175º F.
62 23 Flor de maria Blaszczyk
* +MC7AN+ is the current of the magnets . +Remember to report this number when starting a run+.
63 22 Flor de maria Blaszczyk
* MC7ANB is a probe inserted in our magnets to measure the polarity of the field. The actual value stated is not important as only the sign matters. +Double check that the polarity is the right one (positive or negative)+ required for the run and +remember to report its value in the elog when starting a run+.
64 1 Flor de maria Blaszczyk
65 1 Flor de maria Blaszczyk
*Scintillator counters*
66 1 Flor de maria Blaszczyk
* MC7SC1  states the number of counts for the scintillator counter before the LArIAT target.  Intensity of the secondary beam. 1E5 or more is pretty good.
67 22 Flor de maria Blaszczyk
* MC7SC2  states the number of counts for the scintillator counters after the last magnet.
68 22 Flor de maria Blaszczyk
* MC7SC3  states the number of counts for the scintillator counters after the Wire Chamber 4.
69 3 Flor de maria Blaszczyk
* MC7SC5 states the number of counts for the coincidence of SC1, 2, 3.
70 18 Flor de maria Blaszczyk
* MC7SC6 used to be the "trigger": coincidence between wire chambers, TOF, halo and/or other beam elements -> obsolete?
71 3 Flor de maria Blaszczyk
72 1 Flor de maria Blaszczyk
h3. Beam profiles
73 1 Flor de maria Blaszczyk
74 10 Flor de maria Blaszczyk
_Not available through Synoptic_ 
75 24 Flor de maria Blaszczyk
To get these for now you have to use ACNET. See "How to display the wire chambers positioned before the LArIAT target":https://redmine.fnal.gov/redmine/projects/lariat-online/wiki/Using_ACNET_for_monitoring#How-to-display-the-wire-chambers-positioned-before-the-LArIAT-target-along-the-secondary-beam-line .
76 4 Flor de maria Blaszczyk
77 1 Flor de maria Blaszczyk
h3. Beam-line detectors: Upstream and Downstream TOF, Halo and Punch-through, Aerogel Cerenkov
78 3 Flor de maria Blaszczyk
79 10 Flor de maria Blaszczyk
!AGPMTsMonitor.png!
80 3 Flor de maria Blaszczyk
81 8 Flor de maria Blaszczyk
Because most of the PMTs for these systems are powered by the Zener voltage divider (aka COW) in the control room, controls and current monitoring are only available for the halo PMTs. These displays are similar, above is the one for the Aerogel Cerenkov.
82 8 Flor de maria Blaszczyk
83 28 Flor de maria Blaszczyk
_Note: If you cannot do settings on a page, it simply means no setting is possible. Pages where settings are possible are listed as "controls" in the main menu. Otherwise they are called "monitor"._ 
84 3 Flor de maria Blaszczyk
85 46 Sarah Lockwitz
h2. TPC
86 1 Flor de maria Blaszczyk
87 1 Flor de maria Blaszczyk
h3. High-voltage summary
88 3 Flor de maria Blaszczyk
89 1 Flor de maria Blaszczyk
This display shows the cathode, bias, cryo-PMTs, and SiPMs voltages for the last 24h. You might need to scroll down since all the plots don't fit in the screen.
90 46 Sarah Lockwitz
91 48 Sarah Lockwitz
[[Shifter Drift HV]]
92 48 Sarah Lockwitz
* *Shifter monitoring drift HV*
93 48 Sarah Lockwitz
* *Shifter changing drift HV*
94 46 Sarah Lockwitz
* *What to do if the HV is off and is supposed to be on*
95 12 Flor de maria Blaszczyk
96 3 Flor de maria Blaszczyk
h3. Cryogenic system
97 9 Flor de maria Blaszczyk
98 3 Flor de maria Blaszczyk
The cryogenic system control is fully automated, these plots are for the shifter general interest.
99 1 Flor de maria Blaszczyk
100 1 Flor de maria Blaszczyk
_Note: Not all of the devices of the cryogenic system are shown, only a selection relevant for the LArIAT shifter._ 
101 1 Flor de maria Blaszczyk
102 21 Flor de maria Blaszczyk
* *Overview* 
103 21 Flor de maria Blaszczyk
Shows an overall view of the current readings on different parts of the cryogenic system. For historical plots, see the individual displays.
104 21 Flor de maria Blaszczyk
105 21 Flor de maria Blaszczyk
* *Cryostat info*
106 3 Flor de maria Blaszczyk
The plots in this display show the temperatures inside the cryostat, the pressures in different parts of the cryostat (the vacuum jacket and between the helico-flex seals in particular), and the liquid Argon level inside the inner cryostat for the last 24h.
107 3 Flor de maria Blaszczyk
108 47 Sarah Lockwitz
* *LAr and N dewars*
109 47 Sarah Lockwitz
These plots show the evolution over the last 24h of the pressure and level of the outer LAr and N dewars.
110 3 Flor de maria Blaszczyk
111 21 Flor de maria Blaszczyk
* *Filter and gas analyser*
112 5 Flor de maria Blaszczyk
For the gas analyser, you have to check the current configuration of the gas sampler. Please check the e-log for more information (?) .
113 1 Flor de maria Blaszczyk
114 1 Flor de maria Blaszczyk
h1. 4) For experts: Synoptic power supplies controls
115 1 Flor de maria Blaszczyk
116 12 Flor de maria Blaszczyk
Before you do anything... some useful information:
117 1 Flor de maria Blaszczyk
118 12 Flor de maria Blaszczyk
* *Settings are disabled by default.* This means you can zoom in / out on the plots or click on the links but cannot change any setting.
119 1 Flor de maria Blaszczyk
120 25 Flor de maria Blaszczyk
* *Closing a window restarts the plots, but the settings are NOT changed.* This means that if you close a window (on purpose or by mistake) or if the display crashes (it can happen from time to time) the power supply remains in whichever state it was before the closure. If it was on, it remains on at whatever voltage it was set. 
121 1 Flor de maria Blaszczyk
122 12 Flor de maria Blaszczyk
* *To power off a supply, please set the voltage to 0 first and then turn it off. Do not forget to turn it off!*
123 1 Flor de maria Blaszczyk
124 12 Flor de maria Blaszczyk
!BiasControls.png! !GlassmanControls.png! !CryoPMTControls.png!
125 12 Flor de maria Blaszczyk
126 15 Flor de maria Blaszczyk
1) To enable settings, click on the button on the bottom right hand corner and select for how long you wish to enable the settings (Disable, 10mn, 1h or 8h). Do not forget to disable the settings once you are done! 
127 16 Flor de maria Blaszczyk
128 15 Flor de maria Blaszczyk
_There are pop-up confirmation windows that will prevent you from changing anything by mistake but it is still better to disable the settings once you have finished._ 
129 1 Flor de maria Blaszczyk
130 1 Flor de maria Blaszczyk
2) To turn on / off an power supply, click on the on / off button. A window will pop-up for confirmation. When the supply is on, the light should be green.
131 1 Flor de maria Blaszczyk
132 6 Flor de maria Blaszczyk
3) Turn on the regulate function when available (the light will turn green). This is to have an output voltage that matches the set voltage, otherwise there is a small offset. 
133 1 Flor de maria Blaszczyk
134 16 Flor de maria Blaszczyk
_In some cases this feature has been disabled because it was causing more trouble than help. You might have to play with the value you enter to get on the readout the value you want if you see a disagreement._
135 1 Flor de maria Blaszczyk
136 1 Flor de maria Blaszczyk
4) Click on the button in the green frame "Set voltage" (in volts) next to the power supply you would like to set a voltage to. A window will pop up, enter the value including the "-" sign and validate. If you enter a positive value and the supply is negative only, nothing will happen. You will have to re-enter a value.
137 1 Flor de maria Blaszczyk
138 1 Flor de maria Blaszczyk
5) The selected supply readout voltage should indicate the new output voltage. Please wait until the reading stabilizes before changing to another value. This might take a few seconds.
139 1 Flor de maria Blaszczyk
140 12 Flor de maria Blaszczyk
6) Some controls (Glassman PS and Cryo-PMTs) might include additional features such as slow ramp options. 
141 1 Flor de maria Blaszczyk
142 12 Flor de maria Blaszczyk
Current can be readout in the bottom left hand side of the display. The top plot shows the voltage as a function of time, the bottom plot is the current as a function of time. To access the history plots, click on the "Last 24h" button.
143 1 Flor de maria Blaszczyk
144 1 Flor de maria Blaszczyk
h1. 5) For experts: Controlling the power supplies with ACNET
145 1 Flor de maria Blaszczyk
146 1 Flor de maria Blaszczyk
*Please use this method ONLY if the Synoptic displays are not working even after restarting the Synoptic Viewer* (and contact F. Blaszczyk to report the issue). Once ACNET settings permissions are enabled, it is very easy to make mistakes: there is no confirmation window so you could cause a power supply to turn off or trip if you are not familiar with ACNET.
147 1 Flor de maria Blaszczyk
148 1 Flor de maria Blaszczyk
[[Using ACNET to power up the power supplies]]
149 1 Flor de maria Blaszczyk
150 1 Flor de maria Blaszczyk
h1. Troubleshooting
151 1 Flor de maria Blaszczyk
152 14 Flor de maria Blaszczyk
If Synoptic crashes or hangs up, do not panic! Only the application is affected, not the devices themselves. You only need to close the application and restart it. The non-historical plots will be reset.
153 1 Flor de maria Blaszczyk
154 30 Flor de maria Blaszczyk
*The most common reasons why the Synoptic viewer does not start, crashes or gives you random errors are:*
155 27 Flor de maria Blaszczyk
156 30 Flor de maria Blaszczyk
* You are not opening Synoptic correctly, i.e. you forgot to get a Kerberos ticket or you didn't open Synoptic through the ACNET console when working on a control room desktop computer. Please read the instructions carefully before reporting an issue. 
157 1 Flor de maria Blaszczyk
158 30 Flor de maria Blaszczyk
* You don't have the right Java environment. Make sure you have the "Sun / Oracle Java Runtime Environment (JRE)":http://www.oracle.com/technetwork/java/javase/downloads/index.html installed and up-to-date. OpenJRE / IcedTea does not seem to work well with Synoptic (unless you're lucky).
159 13 Flor de maria Blaszczyk
160 30 Flor de maria Blaszczyk
* Your Java security parameters are not configured correctly. Because of some recent changes on the Java platform, you might have to do some tweaks to the Java security parameters. If you get an error that says that the application cannot be launched because it is from an unknown source / signature, please do the following:
161 30 Flor de maria Blaszczyk
162 1 Flor de maria Blaszczyk
1) Open the Java control panel. How to access it varies according to the OS (Google is your friend). You might have to launch it with admin privileges.
163 1 Flor de maria Blaszczyk
164 1 Flor de maria Blaszczyk
2) Select the security tab.
165 1 Flor de maria Blaszczyk
166 1 Flor de maria Blaszczyk
3) Drop the security to medium level.
167 1 Flor de maria Blaszczyk
*Note: This might not be possible in recent java versions. If you only have the high and very high options, choose high.
168 1 Flor de maria Blaszczyk
169 1 Flor de maria Blaszczyk
4) Add the following links to the exceptions list:
170 1 Flor de maria Blaszczyk
http://synoptic.fnal.gov
171 1 Flor de maria Blaszczyk
http://www-bd.fnal.gov
172 1 Flor de maria Blaszczyk
173 31 Flor de maria Blaszczyk
5) Validate. You might have to restart the computer for these changes to take effect. _Note: Make sure you type "http" and not "https". The latter will not work._
174 1 Flor de maria Blaszczyk
175 30 Flor de maria Blaszczyk
176 30 Flor de maria Blaszczyk
*The most common reasons why you cannot do settings are:*
177 30 Flor de maria Blaszczyk
178 30 Flor de maria Blaszczyk
* You forgot to enable the settings or you went past the time the settings were enabled.
179 30 Flor de maria Blaszczyk
180 30 Flor de maria Blaszczyk
* There are no possible settings on the display (monitor only plots).
181 30 Flor de maria Blaszczyk
182 35 Flor de maria Blaszczyk
* You are not including the "-" sign in front of the value you are trying to set. All the negative VME power supplies require you to include the sign, while the Glassman does not.
183 34 Flor de maria Blaszczyk
184 36 Flor de maria Blaszczyk
* You are trying to set a value larger than the allowed limit. For security reasons or physical reasons (maximum PS voltage), some settings have been restricted to a particular range.
185 36 Flor de maria Blaszczyk
186 30 Flor de maria Blaszczyk
* Your Kerberos account has not been granted setting permissions. There is only a few people who have settings permissions on their individual accounts. If you really need to do settings, all desktop computers in the control room can do settings, provided you started Synoptic correctly.
187 30 Flor de maria Blaszczyk
188 30 Flor de maria Blaszczyk
* You are off-site. Even if you follow the procedure, and even if you're connected using the Fermilab VPN, you will not be able to enable settings. 
189 30 Flor de maria Blaszczyk
190 37 Flor de maria Blaszczyk
* We (as in LArIAT users) do not have settings permissions for that particular device. This shouldn't happen since all the devices used on Synoptic are LArIAT devices so we should have permissions for all of them. If it does happen, the device might be a recent one so we haven't been granted permissions yet. Please let Flor Blaszczyk and Charlie Briegel know. If you are doing settings on ACNET, make sure it is one of our devices and refrain from trying to change other devices (unless you are 100% sure you should). 
191 33 Flor de maria Blaszczyk
192 30 Flor de maria Blaszczyk
*Common web-viewer issues:*
193 30 Flor de maria Blaszczyk
194 30 Flor de maria Blaszczyk
* "I know the device is on, why does it show as if it were off?" Because of Fermilab firewalls or your respective institution firewalls, it might take couple minutes for the displays to show up. If you see little "stars" instead of values with a unit in the readout sections of the displays and that nothing shows on the time plots, it means you're not getting any information from the devices. Only way to go around or speed things up: use the Fermilab VPN.
195 1 Flor de maria Blaszczyk
196 1 Flor de maria Blaszczyk
h1. Contact
197 1 Flor de maria Blaszczyk
198 1 Flor de maria Blaszczyk
*LArIAT contact*: Flor de Maria Blaszczyk (Boston University), fblaszcz@bu.edu
199 1 Flor de maria Blaszczyk
Office phone #: 617-358-0989
200 1 Flor de maria Blaszczyk
Cell-phone # (also on the Control Room white board): 225-280-0536
201 1 Flor de maria Blaszczyk
Skype: flor.de.maria.blaszczyk
202 1 Flor de maria Blaszczyk
203 1 Flor de maria Blaszczyk
_Need a new display? Don't understand something? Please let me know! All suggestions and comments are welcome._
204 1 Flor de maria Blaszczyk
205 7 Flor de maria Blaszczyk
*Synoptic support*: synoptic-support@fnal.gov
206 19 Flor de maria Blaszczyk
207 19 Flor de maria Blaszczyk
*ACNET controls*: Charlie Briegel, briegel@fnal.gov
208 19 Flor de maria Blaszczyk
209 19 Flor de maria Blaszczyk
*Emergencies*: If no matter what you do, you cannot restart the OM, please contact *Linden Carmichael* (carmichael@fnal.gov) x5036 or 630-728-7059 (cell) or *Denise Finstrom* x4688