====== mondump ======

''mondump'' is a program based on the PCFS ''monit2'' software that retrieves monitoring information and sends it to a central server. The information is used by scheduling software to decide how to use the telescope. ''mondump'' can be run from the command line or via a PCFS procedure (e.g. ''midob'') if desired, but it is called regularly by [[development:dynamicobserving:dysched|dysched.pl]] to keep the server up to date.

Note that ''mondump'' does not send the telescope availability flag which the scheduling software uses to decide whether to include the station or not. This is set and updated by [[development:dynamicobserving:ds_redbutton.pl|ds_redbutton.pl]].

===== Download =====

There are two versions: One that will probably only work on AuScope telescopes (and possibly Warkworth) as it contains some station-specific data, and a generic version with no station-specific data. Both versions consist of several pieces of source code and a Makefile. They can be downloaded as compressed tar files here:
  - {{:development:dynamicobserving:mondump.tar.gz|mondump.tar.gz}} AuScope version
  - {{:development:dynamicobserving:mondump_nost.tgz|mondump_nost.tgz}} Generic version

===== Configuration and Installation =====

==== AuScope version ====

On the PCFS, log in as ''prog'':
  - ''cd /usr2/st''
  - ''tar xzvf mondump.tar.gz''
    - This will create a directory called ''/usr2/st/mondump'' 
  - ''cd mondump''
    - This directory contains the code and Makefile you need
    - By default, the software is configured to send monitoring data to fourier.phys.utas.edu.au on a TCP socket connection on port 63000. If you want to change the destination or port number, edit the code in ''mdumpout.c'' and change the definition of ''portno'' and/or the server address on line 344
    - //You need to do this!:// The two-letter antenna ID is currently hard-wired in and is ''hb'' (Hobart 12m) by default. Edit ''mdumpout.c'' and change the line <code>strcat(outbuff, "info hb ");</code> Replace ''hb'' with your antenna's two-letter code.
  - Now compile the software to create a binary called ''mondump'':
    - ''make''

''mondump'' can be tested from the command line:

<code>/usr2/st/mondump/mondump</code>

==== Generic version ====

On the PCFS, log in as ''prog'':
  - ''cd /usr2/st''
  - ''tar xzvf mondump_nost.tgz''
    - This will create a directory called ''/usr2/st/mondump_nost'' 
  - ''cd mondump_nost''
    - This directory contains the code and Makefile you need
    - By default, the software is configured to send monitoring data to fourier.phys.utas.edu.au on a TCP socket connection on port 63000. If you want to change the destination or port number, edit the code in ''mdumpout.c'' and change the definition of ''portno'' and/or the server address on line 344
    - //You need to do this!:// The two-letter antenna ID is currently hard-wired in and is ''hb'' (Hobart 12m) by default. Edit ''mdumpout.c'' and change the line <code>strcat(outbuff, "info hb ");</code> Replace ''hb'' with your antenna's two-letter code.

  - Now compile the software to create a binary called ''mondump'':
    - ''make''

''mondump'' can be tested from the command line:

<code>/usr2/st/mondump_nost/mondump</code>