Version: 1.0.3.

About igpp.tools

The igpp-tools is a collection of tools for data movement and maintenance and includes the following tools:

igpp.tools.md5check

Calculate and maintain MD5 checksums for files.

igpp.tools.Monitor

Monitors locations in a file system and then executes scripts when files appear.

igpp.tools.Scan

Scan portions of a file system and determine the minimum and maximum values for creation date, modification date and size.

igpp.tools.Task

Run a task on one or more files in a directory and sub-directories.

igpp.tools.Webcp

Copy files from the web given a URL to the local system. A very simple tool similar to curl or wget.

System Requirements

The igpp-tools collection was developed using Java and will run on any platform with a supported Java Runtime Environment (JRE). The software was specifically developed under Java version 1.6 and has only been tested with this version. You can determine which version of Java you are running with the command:

% java -version

java version "1.6.0_26"

Java(TM) SE Runtime Environment (build 1.6.0_26-b03-384-10M3425)

Java HotSpot(TM) 64-Bit Server VM (build 20.1-b02-384, mixed mode)

Unpacking the Package

Download the igpp.tools package from the IGPP web site site. The binary distribution is available in a zip package. The installation directory may vary from environment to environment but in UNIX-based environments it is typical to install software packages in the /usr/local directory and in Windows-based environments it is typical to install software packages in the C:\Program Files directory. Unpack the selected binary distribution file with the following command:

% unzip igpp-tools-1.0.3.zip

The unzip will result in the creation of the igpp-tools-1.0.3 directory with the following directory structure:

README.txt

A README file directing the user to the available documentation for the project.
LICENSE.txt

The copyright notice from the Regents of the University of California detailing the restrictions regarding the use and distribution of this software. Although the license is strictly worded, the software has been classified as Technology and Software Publicly Available (TSPA) and is available for anyone to download and use.
bin/

This directory contains batch and shell scripts for executing the tool.
doc/

This directory contains a local web site with documentation, api javadoc, and other related information. Just point the desired web browser to the index.html file in this directory.
examples/

This directory contains examples of using the tool.
lib/

This directory contains the dependent jar files for the tool along with the executable jar file (igpp-docgen-1.3.0.jar) containing the igpp.docgen tool software.

Using the Tool

Shell scripts to run the tools are in the "bin" directory in the distribution. You can run the tool on a Linux system with the command:

% tools

or on a Windows system with the command:

% tools.bat

Documentation for each tool can be viewed by passing the "-h" options to the tool.