View source for Trouble Shooting Guide

This is a trouble shooting guide for tohbans monitoring EOVSA remotely using MobaXterm and VNC Viewer.

<font size="5">'''<General checklist for solar observation>'''</font>

1. Check [http://ovsa.njit.edu/EOVSA/ant_status.php Antenna Status Page] to see if any antenna is under work.

2. In Schedule window, click "Today", "File", choose "Save" (overwrite if prompted), and "Go".

<span style="color: red">'''Since Feb. 2017, the schedule setup is slightly different.''' Do the following:</span>

<span style="color: red">2.1. Load 'solar.scd' and hit Today. Save it (overwrite if prompted).</span>

<span style="color: red">2.2. Open 'solar_plus3c84_Feb2017.scd' in Texteditor (in ~/Dropbox/PythonCode/Current folder).</span>

<span style="color: red">2.3. Update the sunrise and the sunset time according to the solar.scd file that you just updated.</span>

<span style="color: red">2.4. Update the PHASECAL (and refcal, which is 1-hr PHASECAL, if necessary) times by '''subtracting''' 4 minutes from each scan (to account for the day-to-day sidereal time shift of each calibrator source). Shift the times of previous and next lines (usually ACQUIRE and SUN) accordingly.</span>

<span style="color: red">2.5. Save the updated 'solar_plus3c84_Feb2017.scd'. Don't forget to update the DATE as well.</span>

<span style="color: red">2.6. Load the updated 'solar_plus3c84_Feb2017.scd' and hit Go.</span>

3. '''Antenna Tracking''' - are all antenna tracking (in white color)?

4. '''Frequency Tuning''' - LO1A Sweep Status = "Sweeping", FSeqFile = FSEQ-FILE on the schedule, ErrorMsg = "No error"

5. '''Phase Tracking''' - "ON"

6. '''Power and Attenuation''' - Are all dBm on both H- and V- Channels within the second and third numbers shown in "AGC" on the schedule window? You can also see '''SaveList''' hpol and vpol to check this.

7. '''Temps''' - no fluctuation?

8. '''CryoRX''' - this is for antenna 14 control system. If it is down (Eg: FEMA Outlets & Receiver Voltage/Current values are zero and status is OFF), then issue the command 'ctlgo' in the terminal.

9. Make sure that [http://ovsa.njit.edu/EOVSA/status.php EOVSA Observing Status Page] is being updated and that the data is being recorded. You can check if the data is recorded by typing "ls /data1/IDB |tail" in DPP terminal too.

10. STOW antennas at the end of the observation, if needed (see [http://www.ovsa.njit.edu/wiki/index.php/Trouble_Shooting_Guide#Antenna_does_not_stow_.28Ant_10.29 possible problem with Ant 10])

11. Checking the PHASECAL plots [http://ovsa.njit.edu/phasecal/ PHASECAL plot page], if you notice any unusual noisy data on ants 9, 10, 11 or 13, generally it means the antenna did not stow properly on a previous occasion, so you should issue the commands (for example with ant 13): 
step 1: stop ant13

step 2: stow ant13 (wait for it to completely stow--repeat steps 1 and 2 if it seems like it is not stowing after 5 minutes or so)

step 3: track ant13

<span style="color: red"> New! </span> 12. After the day's observation is over, take a look at the results of all PHASECAL by going to [http://ovsa.njit.edu/phasecal/ PHASECAL plot page]. Note any scan that didn't go well '''without''' the effect of WINDSCRAM (if it was under WINDSCRAM then the data points would appear in red). Record your comments on them in tohban log at [http://ovsa.njit.edu/dev/data-browsing/index.php EOVSA tohban log page]. Log other activities during your duty.

<span style="color: red"> New! </span> 13. Do the reference gain calibration analysis by following the procedures explained in [http://www.ovsa.njit.edu/wiki/index.php/Reference_Gain_Calibration Reference Gain Calibration] '''by 1 pm on the next day'''.

<!--<span style="color: red"> New! </span> 14. Run the following commands to produce daily spectrogram which will be uploaded to RHESSI browser.

<pre>
import read_idb as ri
from util import Time
#To produce the spectrogram for 2017-08-14 on 2017-08-15
out = ri.allday_udb(t=Time('2017-08-14'),gain_corr=True,savfig=True)
</pre>-->

== Schedule window ==

=== I accidentally closed the schedule ===

1. Click "Schedule" (on the left task bar) '''just once'''.

2. Click "Today".

=== “Error: Could not write stateframe to SQL” ===

1. hit STOP on the schedule

2. type $scan-stop in Raw Command window (to stop the data recording)

3. close the schedule (exit out of it)

4. restart the program (by clicking on the icon at the left)

5. hit GO to start the observation again

== Stateframe ==

=== Stateframe is frozen ===

1. Close the old one using command 'kill -2 #', where # is the number followed by My PID on the right corner of the StateFrame, in the terminal of sched@helios. If you have accidentally closed the StateFrame without noting the PID, you can get it by typing '''ps -elf | grep sf_display''' in sched@helios, and looking at the number indicated in the '''fourth column from the left''' on the line that ends with "python /common/python/current/sf_display.py".

2. Open a new Stateframe from the menu on the left ('sf_display')

3. Check the log box of the new stateframe

=== “ACC down?” ===

1. Open pdudigital.solar.pvt on web browser

2. Go to “Actions”

3. Go to “Loads” (on the left)

4. Click item 14 (ACC)

5. Hit “Cycle” and “Ok” when prompted

After rebooting, if Stateframe hangs up & does not respond, open a new Stateframe and give "kill ##" (## = “My PID” on the upper right corner of frozen Stateframe) command to sched@helios.solar.pvt server.

=== ACC Restart ===

After the above procedure, or any time the ACC reboots, it loads from its own disk and this appears to cause glitches in the recorded data due to some synchronization problem.  For some reason not understood, the glitches go away when the ACC is loaded from the win computer.  To do this, 
* Start LabVIEW on the win computer if it is not already open, and click on EOVSA-LabVIEW 2015.lvproj (this may already be open).  
* In the new Project Explorer window, under Targets, expand the acc item and right click on acc, then choose Connect from the drop down menu.
* After connecting, click on ACC Master.vi and start it (by selecting the white arrow at the top of the window)
* After it starts successfully, right click on acc in the Project Explorer and choose Disconnect.
* Now you can close the ACC Master.vi window

Note: Rebooting the ACC kills the dppxmp program, so you need to rmlock on the DPP to allow it to run again.  It also kills the sf_display, see above.

=== CryoRX tab - Status are OFF, all values are zeroes (Checklist #7 is false)===

What you should be seeing is that FEMA Outlets and Receiver Voltages/Currents are all zeroes, and Status are all OFF (except for Noise Diode, and RFSwitch when using low frequency receiver). This means that the control system for receiver has died. You would still see that antennas are tracking fine and data is recorded, and it doesn't mean that these data are "wrong" or "unusable". They have to be ON and non-zeroes whenever you want to change receiver setting or modify attenuation setting, which sometimes happens during the observation.

<del>To reboot, execute "starburstControl start" in antctl@feanta server (ssh connect from helios, if disconnected).</del>

<12/18/2016> To reboot, just type "ctlgo" in a terminal window on helios in VNC Viewer (you may have to stop the schedule). If for any reason you want to stop the control system, type "ctlstop".

=== Antenna(s) down ===

<span style="color: red">'''Don’t forget to check the [http://ovsa.njit.edu/EOVSA/ant_status.php Antenna Status page] before considering to “fix” any of the antennas!!'''</span>

Symptoms: Not tracking, showing ‘AT STOW’ or other unwanted coordinates, both AZ and EL permits ON or only EL permit ON, or Axis Lock is ON

Please be noted that the old antennas don't have power controller so $pcycle command won't work on them.

1. Ant 9, 10, 11, 13 could be in this state early in the schedule because they just can't move to commanded position (out of declination limit). In this case, you just have to wait a while (~few hours?)

2. In cold morning, large spike in the current may cause large position error in AT STOW state. 

3. Proceed if neither #1 nor #2 is the case. If only AZ permit is ON (the first column), try "reboot 1 ant2" for rebooting ant2, for example.

4. If both AZ and EL permit is ON (the second column) or only EL permit is ON, then give command "$pcycle ant2" for resetting antenna 2. This switches OFF the power to antenna for 15 seconds and switches ON. In Communication tab, Ant 2 line will go red. Wait till it becomes white. If it does not become white, then try "sync ant2". If cRIO does not respond to this, it may be in “safe mode”, in which case you can type "$pcycle crio ant2" (if on ants 1-8 or 12) and it will cycle the power on the cRIO. <span style="color: green">Note that cRIO takes at least 2 minutes to reboot and come back online.</span> If this sequence does not work, you may try $pcycle again, <span style="color: green">but keep in mind that this command in general should only be used when needed (i.e. discouraged if it can be avoided), to save wear and tear on the components.</span>

5. Give "tracktable [the current tracktable ***.radec] ant2" and "track ant2" to initiate the tracking. If this does not work, look for temperature to raise (if temperature is low).

=== Ant14's cRIO's "Ant" value (last column) is showing negative value ===

What you may see is that ant14's cRIO's "Ant" value (the very last column) showing negative value (not necessarily the extremely large value like you see for some antennas that are down, but some random number with negative sign). When you observe this, go to "ant14.solar.pvt" on web browser and see if it says in red "Slot1 - Maths error" on the left side. It is believed to occur when the controller is interpolating coordinates for the last-entered track table, and the calculation blows up (i.e. pcal_tab.radec file would have had a day change in it when it was not supposed to).

<span style="color: red">This should not happen beyond 12/18/2016, but if you observe it beyond this date, '''report to Dr. Gary''', and proceed to do the followings:</span>

1. In "ant14.solar.pvt", go to "Log-in" and log-in (if you need ID/PW, ask Dr. Gary or Natsuha.)

2. Click "Parameters", then select "#10 - Status And Trips".

3. Choose "#1 - 10.00".

4. Enter "1070" to "Update values", and hit "change".

5. Go to "Parameters" again, and choose "#38 - User Trip".

6. Enter "100" to "Update values", and hit "change".

This is supposed to reset the controller. Watch for cRIO's Ant value changes to positive values. <span style="color: red">Take note on the time you did this procedure, and report it to Dr. Gary.</span>

=== BRIGHTSCRAM ===

Find out which antenna is experiencing this by looking at [http://ovsa.njit.edu/fits/images/ FITS image files]. BRIGHTSCRAM should appear as data-gap like features on the dynamics spectra. <span style="color: green">If more than two antennas are having BRIGHTSCRAM, then ALL antennas show BRIGHTSCRAM.</span>

Wait for a while (~10 min) to see if it automatically goes away. After it goes away, give "tracktable [the current tracktable ***.radec] ant#" and "track ant#" to initiate the tracking.

=== Frequency Tuning's Sweep Status is “stopped” or "Queue overflow" ===

1. Try "Stop" and "Go" the schedule.

2. If #1 does not work, try "lo1a-reboot" in Raw command window

3. If #2 does not work, try the following raw commands:

<pre>
fseq-off
fseq-init
fseq-file [the current frequency receiver setting ***.fsq] (should be in the right side of the schedule window, like solarhi.fsq)
fseq-on
</pre>

=== Temperature is fluctuating too much ===

Try rebooting the temperature controller by typing "tec$bc ant2" for ant2, for example (tec => Thermo-Electric Controller).

=== nd-on is on (Attenuation) ===

Send "nd-off ant#" raw command to turn off the local noise diode. 
 
[[File:2016-04-13_hpol.png|thumb|upright=2.0|'''Figure 1:''' Example of the oscillation from unbalanced attenuation for ant 12 (orange).]]

[[File:2016-04-15_hpol.png|thumb|upright=2.0|'''Figure 2:''' Example of the oscillation from unbalanced attenuation for ant 2 (red) and 5 (cyan).]]

=== hpol/vpol plot (Savelist) is showing unusual oscillating behavior ===

What you should see is the dBm values of the antenna fluctuating very violently like in '''Figure 1''' and '''2'''. Notice that the amplitude of the fluctuation is ~3 dB, which was one FEMATTN step (at this date). This happens when hattn/vattn settings of the antenna get changed somehow and two polarizations get very unbalanced. The result is that the automatic gain control is not being able to find a happy level for both at the same time, and went into an oscillation. To calm it down, first issue the commands:

<pre>femauto-off ant#
hattn 0 0 ant#
vattn 0 0 ant#</pre>

which turns off the automatic gain control. '''If the antenna is on the Sun, temporarily move it off the Sun using''' 
<pre>
radecoff 0 10 ant#
</pre>
With the antenna off the Sun, set the hattn and vattn settings until both power levels are around 3 dB, i.e.:
<pre>
hattn 0 12 ant#
vattn 0 11 ant#
</pre>
where the choice of attenuations (12 and 11 in this example) are those that set the power level close to 3 dB. Finally, turn the gain control back on, with

<pre>
femauto-on ant#
</pre>

'''If you issued the radecoff command, be sure to remove it with'''
<pre>
radecoff 0 0 ant#
</pre>

<span style="color: green">If the fluctuation is within one FEMATTN step (2 dB as of 12/12/16, check [http://www.ovsa.njit.edu/wiki/index.php/Schedule_Commands#FEMATTN_level_.5Bantennalist.5D Schedule Command - FEMATTN level]), the cause might be just interference. In this case, leave it for a while and see if the oscillation goes away.</span>

=== Antenna does not stow (Ant 10) ===

This mostly seems to happen on Ant 10 (as of ~July 2017). The symptom is that Ant 10 keeps staying at "TO STOW" status while all other (old) antennas are AT STOW already at the end of the observation. You might have tried the command "stow ant10", but it did not change the status. If this continues for more than a minute or so, it is likely that the antenna is running into a limit, and cannot be stowed properly with just "stow ant10" command (you also cannot trust if it does go to STOW by itself much later). To properly stow the antenna, '''issue "stop ant10" first''', then do "stow ant10". You may need to do this multiple times. If you don't properly stow the antenna this way, it may not start tracking automatically next morning, and you will miss the data from this antenna.

=== Antenna tab is blank and an attempt to switch to it causes the Stateframe to freeze ===

This occurred around early June of 2017. The cause turned out to be a change in numpy behavior. Dr. Gary updated the numpy at some point and a subtle difference caused it. This means that we should think about software upgrade as one of the causes of malfunctions of our system sometimes.

=== Antenna shows (Lo or Hi) Hard limit and does not track ===

If a hard limit of any antenna on some axis is ON, follow this procedure into the Raw Command window of the schedule (with no typos).

1. Make sure that other antennas are tracking a source and that no source changes are coming up within the next minute or so.

2. Put antenna in velocity mode with

<pre>
runmode 2 ant#  (e.g for antenna 6, use "runmode 2 ant6")   
</pre>

Be sure to specify the antenna, otherwise ALL antennas will move. 

3. Drive the antenna OFF the limit in velocity mode.  
<pre>
<axis>velocity <speed> ant# (e.g "azimuthvelocity 5000 ant6" for which antenna 6 begins to move in azimuth, to drive off the Lo limit)  
</pre>
If the limit is on the azimuth axis, set <axis>velocity as "azimuthvelocity".  If the limit is on the elevation axis, set <axis>velocity as "elevationvelocity".
To drive off a low limit, use a positive velocity 5000.  To drive off a high limit, use a negative velocity -5000. Units are 1/10000th of a deg/s, so 5000 means 0.5 deg/s.
  
4. After the limit is off, set the velocity back to zero.

Wait for up to ~10-30 s, until the Hard Limit indicator goes OFF (on the antenna tab). 
<pre>
<axis>velocity 0 <ant> (e.g "azimuthvelocity 0 ant6" for which antenna 6 stops moving) 
</pre>

5. Bring antenna to track.
<pre>
track ant# (e.g "track ant6" for which antenna 6 resumes normal slew to target and starts tracking)
</pre>

If the Lo Hard Limit indicator does not go OFF after 30 s, go ahead with commands 4 and 5 (although tracking will not work) and let Dr. Gary know about it.

== Data recording (DPP) ==

=== Data recording has stopped (ls /data1/IDB |tail does not return the most recent file) ===

You need to delete dpplock.txt file. Follow these steps:

1. Enter "top" into user@dpp.solar.pvt command line (if user@dpp.solar.pvt is not there, open a new terminal/terminal tab in VNC viewer & type “ssh -X user@dpp.solar.pvt).

2. Look for "dppxmp” under “command” column. <span style="color: red">'''If it is there, do NOT delete dpplock.txt.'''</span> If it’s not there, then quit top by hitting “q” and proceed.

3. Type “rmlock" on DPP terminal. Check if the data recording has recovered by sending "ls /data1/IDB |tail".

== Network ==

=== Cannot open VNC Viewer, or VNC Viewer's response is too slow ===

Open the “local” raw command window and Stateframe window by following these steps:

1. Type "cd /common/python/current" in helios.solar.pvt terminal of MobaXterm

2. Type "./sched_commands.py" for raw command window

3. Type "./sf_display.py" for Stateframe window (add “ &” in the end if you want to keep typing the command in the same helios window) -- note that this Stateframe window may take a while (~5 min or more) to load.

== Others ==

[[File:FLM20151005.png|thumb|upright=2.0|'''Figure 3:''' Geosynchronous satellite signals seen in flare monitor.]]

=== Strong interference in flare monitor ===

Twice per year (for 1-2 weeks centered around Mar. 5 and Oct. 5), the Sun enters in geosynchronous satellite belt. In this case, we see strong signals on flare monitor, like in '''Figure 3''' (blue line). These are radio signals from man-made satellites, which will not harm the system and cannot be avoided, so don't be alarmed.

=== The “streak” in the lowest frequency of the dynamic spectrum ===

If you are seeing this at the beginning or at the end of the day, this is the Sun! See '''Figure 4''' and '''Figure 5''' for sample images. When the baseline is foreshortened (as in near sunrise or sunset), the response is quite strong to the solar disk.  As the Sun rises, the intensity goes down because the baselines start to get longer.  You will actually see the reverse trend in the afternoon, although often the RFI is stronger so the color scale is more blue than in the morning.

[[File:XSP20151202160136.png|thumb|upright=2.0|'''Figure 4:''' The solar signal at the beginning of 2015-12-02 observation period. Notice that the low frequency intensity is decreasing as the Sun rises.]]

[[File:XSP20151202213507.png|thumb|upright=2.0|'''Figure 5:''' The solar signal at the end of 2015-12-02 observation period. Notice the reverse effect compared to '''Figure 4'''.]]