How to configure DEIMOS manually

Procedure and Components

De Clarke, UCO/Lick, Jan 2002

Various levels of failure or nonstandard elements might prevent you from using the semi-automated DEIMOS configuration tools. In these cases, you will have to use manual (i.e. command-line) workarounds.

These are circumstances under which workaround procedures would be required:

observer brings "foreign" elements such as gratings or filters which have no barcode labels
labels on slitmasks are damaged or missing
the slit mask internal barcode scanner fails
the hand held bargun scanner fails
the dremel daemon dies or won't start

See Troubleshooting Guide for tips on diagnosing and fixing some of these problem. If nothing in the troubleshooting guide helps, then you must use manual procedures.

There are two tasks to accomplish. First, we must modify the database table which holds dynamic instrument configuration information, and from that table generate a new configuration file for the dispatcher daemons. Second, we must acquire and install the mask design information for the installed masks.

First Fallback GUI and Dispatcher Configuration:

From your main menu run "Tkremel Configure".
For each stage that you could not configure automatically, from the Elements menu to the right of each ordinal slot for which autoconfiguration didn't work, pick the element you know you installed in that slot.
Hit the Commit button.

Second Fallback GUI and Dispatcher Configuration: Use this if the main menu item "Tkremel Configure" doesn't exist or doesn't work, i.e. you can't even get tkremel to come up.

cd config
./confget
use your favourite text editor to edit the file deimot.cfg
./confput

Fallback Mask Data Acquisition and Installation:

You have a web page which shows the observer's desired configuratino for the night. For masks, the data on this page are in the form

		MASK NAME	BAR CODE	ORDINAL SLOT

grab this text (via the usual select mechanism) and paste it into a file which you edit with your usual text editor. Modify the data so that the ordinal slots represent the actual ordinal slots you installed the masks into. If you installed any masks without barcodes, just skip those positions when you edit the file. You have now done what the auto-mask-scan would do when it scans the cassette full of masks.

Now, feed this new text file (which you just created) to the manual workaround tool for mask design data:

MakeMaskData your_filename_here

This should generate the mask design data and install the files in the appropriate places (what the second phase of the auto-mask-scan code would do).

Manual Verification of Configuration

You can now manually verify the configuration process. You will need a window (xterm) on polo and one on keamano.

ON KEAMANO:

cd /local/kroot/data/deimot/dyna and look for the files mapRON.cfg and slidermap.cfg. These files should be of very recent date, and if you inspect the contents they should reflect the current instrument configuration.
cd /local/kroot/data/deiccd/dyna and look for files with names like *.fits and *.reg. There should be a .fits file and a .reg file for each slitmask cassette slot containing a mask that had a valid barcode label.

If all the above is true, restart the dispatchers manually with

deimos restart dispatcher2.1
deimos restart dispatcher2.2

and you are done with keamano.

ON POLO: Go to the same directories and look for the same files. They should be of very recent date and should match the files on keamano.

If the files look OK, restart the GUI.

You're done.

de@ucolick.org
De Clarke