=== User's troubleshooting guide===
* '''Acquisition doesnCamera won't startswitch on:''' 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 display times out when trying to a time in the near futureswitch on, and try again. Sometimes, it appears that the GPS trigger signal is not being sent (despite the software reporting that it is). The current acquisition should be stopped and restarted (because when the acquisition is started, the time the POP signal you will start is recorded and will apear in need to restart the fits headers - so stopping and starting the acquisition will ensure that the correct POP time is used). Note that the index willl be incremented when doing thisservices. To avoid do 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 * Open a terminal. The data This is spooled to a directory under /data/spool/, based on available from the date, top menu of the sequence number and thin client in the time warm room. If the acquisition started. In this directory web browser is the data filefull screen, data.fitspush 'F11', and file containing other acquisition parameters, infoyou should then see the top menu bar.txt. The latter may be used to update Once the FITS header. The procedure is as follows:** Open a terminal and window appears, ssh to the instrument, by running the command
ssh shoc74in@shoc74in.suth.saao.ac.za
or
ssh shoc40in@shoc40in.suth.saao.ac.za
When prompted for the password, use the password for the 74in or 40in user.
** Rescue your data using In the data rescue utilityterminal, as described in the section Rescuing Data.** Run the command to restart the webserver: type
restart_services
This You will prompt you again be prompted for the password of . The various services comprising the userinstrument will then restart. This lasts a few seconds a few seconds.** Return to the web browser, and take reload the page, then tryh to star the cameraa again.** It may be necessary to restart the services a few seconds times before you can start the camera.* '''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 completea 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). The web server current acquisition should be accessible againstopped and restarted (because when the acquisition is started, the time the POP signal will start is recorded and will apear in the fits headers - so stopping and starting the acquisition 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:** Rescue your data using the data rescue utility, as described in the section Rescuing Data.** Run the command to restart the webserver, as described above in the subsection "Camera won't switch on".
** 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.
**''' IMPORTANT:'''