Name

logPublish

Synopsis

logPublish nodeURL -[hsntp] [-start startTime] [-stop stopTime] deviceID logDirectory

Description

The logPublish utility reads packets from the device log for deviceID, stored in logDirectory. The packets are published to the Shore Side Data System (SSDS) database. The SSDS ingest server must be accessible from the host on which logPublish is executed.

The device log consists of two files, one the .dat extension and one with .idx extension. The .dat file contains the data, and the .idx is an index to enable effient searches of the data file.

The file names use the format

<deviceID>_0.dat, <deviceID>_0.idx

For example, the log for device 1473 consists of files 1473_0.dat and 1473_0.idx. If the log files for the specified device already exist, getPackets will append to the log.

The logged packets can subsequently be displayed with the logView utility.

Options

Option Description Values
nodeURL IP address or host name of SIAM node e.g. 134.89.88.1, mooring.moos.mbari.org
logDirectory Path to log files $SIAM_HOME/logs
-h Print usage message -
-s Sticky - record last sequence number in file (1). On subsequent sticky calls, publish sequence numbers -
-n No wrap - do not use Exportable wrapper -
-t Test mode, i.e., do everything but publish -
-p Print, i.e., print packets (w/ -test only) -

-start startTime

-stop stopTime

Publish packets from within the specified time window. startTime and stopTime are date/time strings using the format:
mm/dd/yyyy[Thh:mm[:ss]]
The time should be specified in UTC(?)
04/01/2010, 03/15/2009T11:34
deviceID

long (64-bit) integer uniquely identifying the instrument service

log utilities specify instruments using deviceIDs instead of instrument ports
14533,997,1003, etc.

Example output:

					none
					

Environment

The following environment variables must be set:

Variable Description Example
JAVA_HOME location of Java installation
/j9, /opt/java/jdk1.3.1, etc.
JAVA Path to JVM command For MMC
$JAVA_HOME/bin/j9

For Sun JVM (e.g. linux, win32, mac OS)
$JAVA_HOME/bin/java
SIAM_HOME top of the SIAM directory tree -
SIAM_CLASSPATH Path including all SIAM and supporting classes For MMC
$JAVA_HOME/lib/jclMax/classes.zip:$JAVA_HOME/lib/prsnlmot.jar:$JAVA_HOME/lib/RXTXcomm.jar:$SIAM_HOME/classes

For linux/win32
$SIAM_HOME/classes

See Also