Appendix I -- Ezra system management





This information is for the older EZRA SPARCstation



***NOTICE*** Like everything in UNIX, file and directory names are case sensitive. Hence ``/h/scman/sc10/Ezconfig'' is not the same as ``/h/scman/sc10/ezconfig''.



Ezra Configuration

Some basic parameters of the system are listed in Table A.1.

Table A.1:   Ezra Parameters 

 
  System name			: 
  Network address		:
  Floppy device name		:  /dev/fd0
  Internal Drive device name	:  /dev/sd1a (not connected)
  External Drive device name	:  /dev/sd1a; /dev/sd1g; /dev/sd1h
  CD-ROM device name		:  /dev/sr0
  Exabyte device name		:  /dev/nrst0
  Internal Disk capacity	:
  External Disk capacity	:
  Exabyte drive capacity	:
  Cass Cage PC name             :
  Cass Cage PC address          :

Setting the System Clock

The time of ezra's system clock is recorded in the log files and FITS headers, so it is useful to synchronize it to the observatory UT clock (although the UT directly from the telescope computer is also saved in the FITS headers). Use the Unix date command for this. Use the su command to become root, then enter

root# date 9602011020

to set the system clock to 1996 Feb 1, 10:20 UT, for example.

SC-10 Software Installation

Here we describe how to copy an SC-10 source code update from a floppy to Ezra's hard disk, then recompile it.

  1. Log in as ``scuser''. Run OpenWindows and open a command tool.

  2. Set the user to scman by typing

    scuser> su scman

    and entering the password.

  3. Change to the directory /h/scman. The subdirectory sc10 holds all the SC-10 related source code in a series of subdirectories.

  4. Save the source code already on disk until the new code has been successfully compiled and run. To do this move the current sc10 directory to a new name. For example

    scman> mv sc10 sc10.Nov92

    renames the existing sc10 directory with code from November 1992 to
    sc10.Nov92.

    If this reports an error, the file and directory ownerships may not be set correctly. The sc10 directory and all its subdirectories must have their owners set as scman, and you must be user scman to manipulate them. You can inspect file and directory ownership using the command ls -l. If the ownerships seem wrong, consult the system manager.

  5. Put the floppy disk with the new source code into the disk drive.

  6. Mount the floppy and its UNIX file system by typing

    scman> fdunix

    If the mount command returns a ``read-only file system'' error, the floppy might be write protected. Move the write-protect tab to the write-enable position. If you still get errors, try nudging the floppy more firmly into the drive (ezra's floppy drive is somewhat finicky at times).

  7. Look at the floppy disk file system by typing

    scman> cd /fdunix

    scman> ls

    You should see a directory lost+found, indicating you are really looking at the floppy directories. Change directory again to get to the SC-10 source code subdirectory. An ls now will show several more subdirectories such as Acq and Disp.

  8. Copy the files onto the hard disk by executing

    scman> cp -r * /h/scman/sc10

    The -r stands for recursive, so the subdirectories and all their contents will be copied.

  9. Change directory back to /h/scman/sc10 and verify that the directory structure now matches what was on the floppy.

  10. Unmount the floppy and eject it from the drive with

    scman> fdeject

  11. You should see a file Makefile in /h/scman/sc10. Recompile the entire SpectroCam software package via

    scman> make

  12. The make procedure puts all the executable files in /h/scman/sc10/bin. Look at this directory when make is done to verify the executables are present. When you are confident the program is running as expected, at least delete the executables in the [new directory]/bin backup directory you made.

Restoring /usr Partition from Tape

Unfortunately, the ezra workstation occasionally trashes the /usr partition on its hard drive, which contains the basic Unix and OpenWindows system needed for it to run. If this happens, the partition can be restored from tape with the following procedure. It is highly recommended the restoration be attempted only after consulting with T. Hayward because this description has not been rigorously verified and even a small mistake could lead to the reformatting of the /h disk partition where SpectroCam data are written.

  1. Connect the CD-ROM drive to the SCSI chain if it is not already present.
  2. Find the SunOS CD-ROM disk and ezra dump tape, stored in red toolbox and/or gray cabinet in the Cornell lab.
  3. Power up the system if necessary, press L1 A.
  4. Type "n" to get "OK" prompt.
  5. Put the SunOS CDROM in the drive.
  6. Boot from CD-ROM with "boot sd(0,6,2)".
  7. Choose (1) from menu to load mini root. Do not reformat.
  8. Reboot at end of mini root procedure.
  9. Rebuild the sd1g file system with "newfs /dev/rsd1g".
  10. Make a new directory with "mkdir /mntu".
  11. Mount the sd1g partition with "mount /dev/sd1g /mntu".
  12. Change to the /mntu directory with "cd /mntu".
  13. Put the ezra dump tape into the tape drive.
  14. Skip to the second tape file with "mt -f /dev/nrst0 fsf 1".
  15. Restore the partition with "restore rf /dev/nrst0". This takes about 35 minutes.
  16. Reboot by typing "reboot".
The partition should now be completely restored. You can log in as scuser, start openwindows, and run the SC-10 programs. Note that the SC-10 software is stored on the /h partition and should not be affected by the reinstallation.