Jiggle Installation Instructions
Summary of what you need to run Jiggle:
A reasonably fast processor and at least 2G of memory
The Java Run-Time Environment (JRE)
Application and supporting jar files
Program properties files
Script to start program (you can create a desktop shortcut to invoke it).
Oracle database having NCEDC schema tables,
JASI views and the required PL/SQL packages.
- Create a valid Java runtime environment on your computer.
If the Java Run-Time Environment (JRE) is not installed on your system, download and install the latest Java JRE or JDK.
The JRE is the Java Runtime Environment. The JDK (Java Development Kit) is the JRE plus compilers and tools.
The latest version of Jiggle with the Swarm option requires Java runtime 1.5 or higher.
Download the latest Java release
- Create a directory for the Jiggle program and its libraries.
The Jiggle application directory "folder" can be anywhere or a standard application directory:
Unix : /usr/jiggle
Windows : C:\Program Files\Jiggle
For a quick setup download and unzip into a root directory of your choice:
Unzipping creates a directory named "Jiggle" below the root directory, and all .jar files and scripts are located in
a /bin subdirectory, all properties files are located in a /props subdirectory, and all documentation files are located
in a /doc subdirectory.
After extraction, update the included jiggle.jar by downloading the appropriate jiggleTest.. jar (see links below) and
rename the new file to jiggle.jar after deleting the old one. You do not need to download any other files.
Included are example startup scripts for Unix (jiggle.command) and Windows (jiggle.bat).
Edit these files, if necessary, to change java runtime reference, directory path variables, or input property filename. Once the application is
started using a script, a popup dialog will prompt you for your local network code and the database connection values if they are undefined in
the properties file. Channel data are read from a disk cache file, and if it does not already exist, a database query will build it; however,
the query does take quite a while to process, so be patient.
- Download the appropriate jiggle jar file and put it in the application directory created above
(Version Release Notes).
The "Beta build" version below is the latest code build. Whatever jar version you download,
you should rename it to match your startup (script) command reference jar filename.
Latest version: Version 2014-4-30 and later require change to Origin.type column constraint in db
The ORACLE JDBC jar: ojdbc7.jar must be used with Jiggle jar files below.
Java8 jiggle18-p7.jar (2017-06-27)
Java7 jiggle18-p7g.jar for GTYPE enabled schema only (2017-06-27)
The ORACLE JDBC jar: ojdbc6.jar must be used with Jiggle jar files below.
Java7 jiggle17-p6g.jar for GTYPE enabled schema only (2017-06-27)
Java7 jiggle16-p6g.jar for GTYPE enabled schema only (2017-06-27)
Java7 jiggle17-p6.jar (2017-06-27)
Java6 jiggle16-p6.jar (2017-06-27)
NOTE: when using these Jiggle jars with existing command scripts, replace references to ojdbc14.jar with ojdbc6.jar. The 'p6' jars have ojdbc6.jar in their manifest classpath.
NOTE: option to use 2 new database tables: EVENTPREFOR and ORGPREFPRIORITY. If enabled, these tables must exist, and a new ORGPREF package and
the latest EPREF package must be installed in the database. To enable the option, user adds the property "useEventPreforTable=true" to his
properties file. The Jiggle jars will work with your existing database schema with this option disabled.
- New users must download the supporting jar library files described below.
Put these jars in the same directory that contains the jiggle.jar file.
Do NOT unpack these jar files.
Oracle JDBC drivers (check Oracle site for updates of jars, do not download ojdbc7.jar if your client host java is Java6):
(ojdbc7.jar) or (ojdbc6.jar)
OpenMap (Java 1.4): (openmap.jar)
QWClient map layer (Java 1.4): (QWClient.jar)
All of the above 1.4 jars in one zip: (all-in-one14.zip).
extract this zip archive into jiggle jar directory.
Optional Swarm utility (Java 1.5): (swarm-avo.zip)
extract this zip archive into jiggle jar directory.
- Download supporting map data files
Download and unzip map data files into jiggle jar directory from: (mapdata.zip)
These map data files are referenced by some optional layers defined in the openmap.properties file
The user can change the default locations when needed for a custom configuration.
- Define a user directory for Jiggle properties files.
Define/create a directory for properties files and in the java command line set JIGGLE_USER_HOMEDIR to this path
(paths containing spaces should be surrounded by quotes). Copy the application's .props, .properties files into this directory.
Typical paths are a parallel directory to the application's jar files (e.g. ../props) or under the user's home directory root,
- WindowsXP "C:\Program Files\Jiggle\props" or %USERPROFILE% (e.g. "C:\Documents and Settings\Kate\jiggle")
- UNIX /usr/Jiggle/props or $HOME (e.g. /home/Kate/jiggle)
Download example properties files (properties.zip)
Unzip the downloaded example properties files into your Jiggle user home directory (e.g. jiggle/props).
By default the Jiggle application loads its user's properties from the file named jiggle.props,
but an alternative filename can be specified as the first command line argument (%1, on windows, or $1 on unix).
If the input command line named file (which defaults to jiggle.props when absent) does not exist, Jiggle will use default property values
which can be saved to jiggle.props, or first, be reset using the GUI's 'Edit properties...' popup dialog and then saved.
The only properties that a user must define are those that specify the local network id, database connection properties,
hypoinverse location server properties, and waveserver properties.
Additional setup/properties files used by the application are defined by property values in the main properties file, they are:
- eventSelection.props contains properties defining the event catalog selection filter settings.
properties defining map setup and layers that can be added, removed, or modified.
- xxMagEng.props contains properties defining magnitude engine setup for a magnitude type xx (e.g. ml, md).
- xxMagMeth.props contains properties defining magnitude method setup for a magnitude type xx (e.g. ml, md).
- xchannelList.cache a serialized object binary file that is created in your .jiggle user home directory
after the application startup containing channel data that was returned from a query of the database. This file is read
into a Java the next time the program is started to avoid the long time wait needed to process the database query.
contains map configuration properties that reference map data files which, by default, are located in
the mapdata subdirectory tree below the JIGGLE_HOME (jar file) directory.
For more information see additional properties file property definitions.
Create a runtime script or bat file
The script or .bat file is in the same directory as the jiggle.jar and contains a line of the form:
java -Xms128M -Xmx512M -DgraphicsOption... -DJIGGLE_HOME=ProgramPath-DJIGGLE_USER_HOMEDIR=UserPropPath -jar jiggle.jar
The -D command line options define system properties where ProgramPath is the directory containing the application's jar files and
UserPropPath is the directory containing the properties files.
Start the program
Invoke the startup script from a command window or create a mouse click startup shortcut for the script on your desktop.
Example Jiggle screenshot
To Jiggle home page
To top of page