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
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.
| 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
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 |