== User's Troubleshooting Guide ==
Most of these issues appear to have been resolved, but we will leave these notes up for a while in case the problems re-surface! Please be sure to inform the instrument team of any technical issues you encounter during your run, either by emailing lisa(at)saao.ac.za, or by means of the SAAO's online fault forum.
'''Starting a Hartmann sequence does not always work, it just takes one frame and then exits'''* The Control GUI should grey out and shuttle through If the set of Hartmann exposures - if it does not grey out within a few seconds, it is not working* Kill the GUI and restart it* Click ''Run'' to start the Hartmann sequence again* Usually restarting the GUI does the trick, slit runs anything but horizontally across the most extreme case required a couple rear-of GUI restarts before the sequence would run properly* This problem went away for more than a week, but it has subsequently reappeared so we will continue trouble-shooting '''Attempts to do multiple exposures (e.g. for flats) lead to alternating black (empty) framesslit image, something's broken in the GUI!'''camera needs relocating* Abort Fiddling with the exposure and kill USB cable can disrupt the SpUpNIC Control GUI* Clicking the "reset exposure controls" button on the advanced tab physical position of the Exposure/CCD info pane does not clear the problemcamera, so open which is on a terminal and type "restart_services" spring-loaded kinematic mount* Restart the GUI Go out and proceed with single exposures * We'll sort this out ASAP! '''If grip the SpUpNIC control GUI won't open, it's likely that the detector subrear-system is unhappy'''* Try resetting the PCI card: go to the back of the SpUpNIC PC -slit camera assembly and press the small white switch near the bottom right corner of the machine, then try again to launch the GUI* If the PCI card reset doesn't help, try the black reset button on the grey power supply for the SDSU controller (bottom left of the instrument if viewed from the south side)* If that too doesn't help, try powergently jiggle it -cycling the grey power supply for the SDSU controller (the normal on/off switch on the power supply) '''If the Quick-look GUI won't open, camera will pop back into its settings.json file is likely corrupt'''required position* Open up a terminal on Verify with the SpUpNIC PC and navigate to the /home//ccd/.spup directory* Move the qlsettings.json file to a new file name (mv qlsettings.json qlsettings.json.x) so slit illumination that it's out of the way but can still be used for diagnostic purposes* Try to launch slit runs horizontally across the Quick-look GUI image again, a new qlsettings.json file will be created since there isn't one present
'''If the rear-of-slit camera window does not produce any images (though the exposures seem to count down), it probably needs a reset'''
* If you still don't see anything, go out and gently unplug the black USB cable that goes in to the back of the camera (look for the red LED on the small camera that pokes out of the south side of the instrument's lower box) and plug it back in again
* Start the exposures again and check with the slit illumination
'''If the slit runs anything but horizontally across the rear-of-slit image, the camera needs relocating
* Fiddling with the USB cable can disrupt the physical position of the camera, which is on a spring-loaded kinematic mount
* Go out and grip the rear-of-slit camera assembly and gently jiggle it - the camera will pop back into its required position
* Verify with the slit illumination that the slit runs horizontally across the image again
= Technician's Guide =