Installation Notes for 3rd Party Packages

Java SDK

General

Follow the Installation instructions provided with the SDK download.

Win32/Cygwin

GNU Utilities

There are several core utilities and tools that are needed to build and run SIAM:

System
coreutils, shellutils
bash, csh, expect
Admin
sudo*
GRUB*
cron*
diskfree
stat*, netstat*, top*
gzip, tar
mailutils*
Software Development
gcc, make**, binutils
automake, autoconf, libtool
C, C++, perl
gdb
Libc, ncurses
textutils
awk, gawk, sed, grep
diff
emacs*, vim
Network
inetutils, xinetd
ping
e2fsprogs
traceroute*
ntp
wget,wput
apache, boa, or other web server*
Optional
links, lynx or other web browser (MMC: for configtool)
chainsaw (log4j front-end)

* - optional (recommended)
** - Cygwin currently distributes only Gnu make v3.81, which does not support Windows pathnames with colons (kind of odd for Cygwin, no?).
The Java compiler for Windows insists on DOS (or mixed, e.g. c:/path/...) path names, so can’t handle the strict POSIX style enforced by make 3.81.
There are 3.80 make Cygwin binaries floating around, but these don’t work with the current cygwin dll.
One (tested) alternative is to use MinGW make 3.80, available from sourceforge (http://sourceforge.net/projects/mingw/).
One could also try building make 3.80 from source.

RXTX

Mac OS

Install the binary package (RXTX.pkg).
There are instructions for how to build and install the binaries manually on the RXTX wiki (requires XCode tools).

File Name Location
librxtxSerial.jnilib /Library/Java/Extensions
RXTXcomm.jar /Library/Java/Extensions

Run fixperm.sh included with the distribution to set lock permissions

Linux

Untar the distribution and install the contents to the following locations, where JAVA_HOME is the location of the Java SDK:

File Name Location
librxtxSerial.so JAVA_HOME/jre/lib/[machine type] (i386 for instance)
RXTXcomm.jar JAVA_HOME/jre/lib/ext

Make sure the user is in group lock or uucp so lockfiles work.
Make sure the library is in LD_LIBRARY_PATH

Win32/Cygwin

Untar the distribution and install the contents to the following locations, where JAVA_HOME is the location of the Java SDK:

File Name Location
rxtxSerial.dll JAVA_HOME/jre/bin
RXTXcomm.jar JAVA_HOME/jre/lib/ext

The following Java environment must be set for all distributions

Variable Value
RXTXcomm.jar must be in the classpath A copy of RXTXcomm.jar is in SIAM_HOME/jars; this jar should be included in SIAM_CLASSPATH.
Java system property "gnu.io.rxtx.SerialPorts" must be set for SIAM; otherwise, the RXTX must scan for ports, and this can take a very long time. SIAM uses the "platformSerialPorts" property in siamPort.cfg to pass this value to RXTX. Delimited list of serial ports; For Win32, the delimiter is semicolon, for Linux/MacOS, use colon.
platformSerialPorts = /dev/ttys0:\
/dev/ttys1:\
/dev/ttys2:\
/dev/ttys3:
Attempting to open a port not in this list results in a PortNotFoundException.

Open Source Data Turbine