.. ......................................
.. UHDAS/CODAS restructured text document
.. ......................................

Daily text email (Tutorial)
-----------------------------

-----

The first page of a text email looks like this:

.. image:: instructions_checkdaily_00.png
   :scale: 50
   :alt: UHDAS daily email: page 1



The next set of images will step through the parts of the 
email and how to read them

-----


**time**  (when the email was generated)

.. image:: instructions_checkdaily_01.png
   :scale: 50
   :alt: UHDAS daily email: page 1, "timestamp"


-----

**cruise status**  (active? no cruise set?)

.. image:: instructions_checkdaily_02.png
   :scale: 50
   :alt: UHDAS daily email: page 1, "cruise status"


-----

**processing status**  (is the CODAS database recent?)


.. image:: instructions_checkdaily_03.png
   :scale: 50
   :alt: UHDAS daily email: page 1, "processing status"


-----

**attitude devices** (statistics of accurate heading devices)


.. image:: instructions_checkdaily_04.png
   :scale: 50
   :alt: UHDAS daily email: page 1, "accurate heading device statistics"


-----

**bottom track**

Newer installations say whether bottom track is on or off.
Bottom track should be **OFF** if the bottom is out of range.
Keep this in mind when you look at the figures.  Are they in
deep water with bottom track on?


.. image:: bottomtrack.png
   :scale: 50
   :alt: UHDAS daily email: "bottom track"


----

**computer information**
     - how long has the computer been running? recently rebooted?
     - NTP server: found? 


.. image:: instructions_checkdaily_05.png
   :scale: 50
   :alt: UHDAS daily email: page 1, "computer status"

-----

**check the link**
     - go look at the figure


.. image:: instructions_checkdaily_06.png
   :scale: 50
   :alt: UHDAS daily email: page 1, "computer status"


----

**checking the WWW figure**

.. image:: instructions_checkdaily_07.png
   :scale: 50
   :alt: UHDAS daily email: example of figures on www




Daily text email: Indications of Trouble
------------------------------------------


Reset Ashtech
~~~~~~~~~~~~~~
All too common.  Everything is fine with the UHDAS system, but the
Ashtech has performed badly over the last day.  Check the messages to
see if it is down.  Reset the Ashtech.

.. image:: instructions_examplebad_03.png
   :scale: 50
   :alt: UHDAS daily email: Ashtech down.  reset.



Processing stopped: cause unknown
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Troubleshooting is required to understand the cause.  It is most likely to be
a problem with the timestamps.  Look in the diagnostic files to see whether
all the files are updating as expected.  The most likely solution is to start
another named cruise segment.

.. image:: instructions_examplebad_02.png
   :scale: 50
   :alt: UHDAS daily email: processing stopped; cause unknown


Kernel bug: "restart logging"
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

In this case, a simple "stop logging", "start logging" is sufficient

.. image:: instructions_examplebad_01.png
   :scale: 50
   :alt: UHDAS daily email: kernel bug