• Ops Modes
  • You want Xguide and NO MAGIQ
  • You want MAGIQ and NO Xguide
  • You want both MAGIQ and Xguide
  • You want to acquire/guide with Xguide and eavesdrop with MAGIQ
  • You want to acquire/guide with MAGIQ

• Camera
  • General Camera Problems

• Servers
  • Null Error upon Connect Attempt
  • Reconnect
  • Restart MagiqServer

• Images
  • Images out of sync

Ops Modes

You want Xguide and NO MAGIQ

Procedure

1. Make sure MAGIQ is not running
2. If you are not sure, kill it again:
   1. From DCSGUI stop MAGIQ server
3. Make sure MAGIQ is not running as another user on kN-magiq-server:
   1. use ps 'axlw or pgreg 'lf java
   2. and kill the process if necessary
4. Start or Restart Xguide

You want MAGIQ and NO Xguide

Procedure

1. Quit Xguide if running, wait until all processes terminate.
2. Make sure there is no other instance of Xguide or aut-tasks:
   1. use ps on kNserver
3. Restart MAGIQ server via DCSGUI
4. If MAGIQ GUI is running, wait until it reconnects, otherwise restart GUI.

You want both MAGIQ and Xguide

Procedure

1. (Re)-start Xguide
2. Make sure Xguide is running at this point and NULL camera is selected.
3. If MAGIQ server is running, press "Reconnect" in MAGIQGui, otherwise, start MAGIQ server via DCS GUI
4. Make sure MAGIQ is running at this point.

You want to acquire/guide with Xguide and eavesdrop with MAGIQ

Procedure

1. MAGIQ GUI: Stop exposure
2. MAGIQ GUI: Select 'Eavesdrop'
3. Xguide: Select desired camera, start exposure and display
4. Verify images on Xguide, MAGIQ GUI, ObserverUI
5. If no images, press 'Reset' on MAGIQ GUI

You want to acquire/guide with MAGIQ

Procedure

1. Xguide: Select 'NULL' camera
2. MAGIQ GUI: Select desired camera, press 'Connect'
3. MAGIQ GUI: Start exposure

Camera

General Camera Problems

Symptom

Unsure, but you know it's not working

Problem

Software is not functioning properly

Solution

Reset and restart successive software layers (stop guiding!)

1. Reselect camera from MagiqGui Camera pull-down
2. Reset camera from MagiqGui (see "Images out of sync")
3. Restart low-level servers (see "Reconnect")
4. Restart MagiqServer (see "Restart MagiqServer")
5. If the problem persists, call support as additional steps involve hardware
6. Check cables, fibers, AAA.
7. Hardware reset camera
8. Power cycle camera and camera controller

Servers

Null Error upon Connect Attempt

Symptom

Attempt to connect to nirspecm guider results in failure with "reason: null" in the error code

Problem

Some part of the MAGIQ software (possibly the mech_server) is not communicating properly.

Solution

Restart the MAGIQ software via these steps:

1. log on to k2-magiq-server as k2obs
2. run "magiq stop CameraServer k2-magiq-camserver1"
3. verify servers were stopped by typing "magiq status" and seeing no processes
4. run "magiq start CameraServer k2-magiq-camserver1"
5. verify "magiq status" returns 3 tasks:
   1. rpcKey_server ... mech_rpc_srv
   2. rpcKey_server ... magiq_mtrctrl
   3. cam_rpc_svc
6. From DCSGUI: DCS -> MAGIQ -> Start Server
7. Wait 10+ seconds
8. From DCSGUI: DCS -> MAGIQ -> OA Gui
9. OA Gui should start with status bar saying "connecting" then it should change to "connected"
10. Connect to nirspecm camera (choose nirspecm from pull-down and click "Connect")
11. Expose to verify performance

Reconnect

Symptom

Need to restart the low-level camera- and mech-servers

Problem

Unknown

Solution

Be sure to stop guiding

1. Click on "Reconnect" in the "Camera and Guider Control" portion of the MagiqGui.
2. Reselect camera from MagiqGui Camera pull-down
3. Begin exposing

Restart MagiqServer

Symptom

Need to restart the high-level MagiqServer

Problem

Unknown

Solution

Be sure to stop guiding

1. Select "Start Server" from "DCS" -> "MAGIQ" menu
2. Reselect camera from MagiqGui Camera pull-down
3. Begin exposing

Images

Images out of sync

Symptom

Image looks scrambled along vertical or horizontal lines

Problem

The MAGIQ camera is out of sync

Solution

Reset the camera from the MagiqGui (may be done while exposing)

1. Click the "Reset" button located in the bottom center of the "Camera and Guider Control" portion of the MagiqGui (shown below).