=== User's troubleshooting guide===
* '''Acquisition doesn't start:''' Check on the GPS tab that the trigger signal has been activated. If it has, but the camera is still not taking images, try stopping, resetting the GPS trigger to a time in the near future, and try again. Sometimes, it appears that the GPS trigger signal is not being sent (despite the software reporting that it is). If The current acquisition should be stopped and restarted (because when the camera acquisition is patiently awaiting started, the time the POP signal, restarting will start is recorded and will apear in the GPS fits headers - so stopping and not touching starting the camera settings should trigger successfullyacquisition will ensure that the correct POP time is used). Note that the index willl be incremented when doing this. To avoid this, you can rewind the increment by 1, in the advanced tab. Make sure you have no data that will be overwritten.
*''' Acquisition doesn't finish:''' Sometimes it appears that the camera does not ever leave the acquiring state (despite all images in the kinetic series having been obtained). It may in this case be neccessary to restart the server, manually edit the FITS files to include the filter and timing informations, and to then copy them to their final destination. The server may be restarted running the command "restart_services" from a terminal. The data is spooled to a directory under /data/spool/, based on the date, the sequence number and the time the acquisition started. In this directory is the data file, data.fits, and file containing other acquisition parameters, info.txt. The latter may be used to update the FITS header. The procedure is as follows:
** Open a terminal and ssh to the instrument, running the command ssh shoc74in@shoc74in.suth.saao.ac.za. When prompted for the password, use the password for the 74in user.
** Rescue your data:*** Find your data in using the spool directory. It's stored in a directory named /data/spool/<CCYYMMDD><index>.<HHMMSS> (where index is the indexrescue utility, CCYYMMDD is as described in the date and HHMMSS is the time the acquisition started)section Rescuing Data. For example, /data/spool/201503250002.141026/ .*** There will be files named data.fits and info.txt*** The info.txt file contains filter information, GPS POP start date and time, POP frequency, and TCS pointing information (if available).*** Update the header of the FITS file. THIS NEEDS TO BE UPDATED WITH WHAT THE HEADER KEYWORDS SHOULD BE, AND PREFERABLY, HOW THEY ARE ADDED TO THE DATA.FITS HEADER. IT IS NOT INTUITIVE TO LOOK AT THE NAMES AND VALUES IN INFO.TXT AND FIGURE OUT HOW TO GET THOSE PROPERLY INTO DATA.FITS.*** Copy the fits file to the hard disk: cp /data/spool/<above directory>data.fits /data/<telescope>/<instrument>/<CCYY>/<MMDD>/<instrument>_<YYMMDD>.<index>.fits. THE USER DOESN"T KNOW WHICH INSTRUMENT THEY ARE USING. CAN HIT TAB TO AUTOCOMPLETE FOR THE INSTRUMENT SECTIONS, BUT THAT MIGHT NOT ALWAYS WORK. ALSO, PERMISSION DENIED FOR THIS USER. *** NB: make sure there is no file of the same name that you'd overwrite!
** Run the command to restart the webserver: restart_services . This will take a few seconds to complete. The web server should be accessible again.
** Return to the web browser, ''refresh the page,'' turn the camera back on, and continue with your observing. If the camera is non-responsive, run the restart_services command again.