GT3 3.0 Installation

Required Tools

  • JDK 1.3.1+ or JRE if you don't need to build any source. This is a requirement for GT3 core. Some higher level services like the Index Service and Execution Services use Xindice, which has an incompatibility with Sun's 1.3.1 JDK on some platforms. If you are using Sun's JDK, the safest version to use is JDK 1.4 or higher. See Xindice FAQ for more details. Note, however, that version 1.3 will not work because GT3 core requires 1.3.1 or higher. Also, the MMJFS component might not properly work the IBM JDK on Linux.
  • JAAS library is required as a separate download if you are using JDK 1.3.
  • Jakarta Ant 1.5 (required for source distribution, and recommended for binary distribution). You can continue to use ant 1.4.1 if you replace crimson.jar in your $ANT_HOME/lib directory with xerces.jar that comes with our distribution.
  • Junit 3.8.1 is required for most installations. It is optional for a core-only install.

  • YACC (or bison) is required to build Cbindings and the ogsi-find-service-data client from source. Your compiler may already have it installed, but you can download the GNU version if it is not available on your system.

Optional Tools

  • JDK 1.4+ or JRE if you don't need to build any source. You can also use the IBM JDK. Again, this is required by some of the higher level services, like Index service and Execution Service due to Xindice issues with some implementations of JDK 1.3.1.
  • Jakarta Tomcat 4.1.24. 4.0.6 has also been tested to work. We also provide a standalone web service container for testing purposes, which is why Tomcat is optional.
  • Microsoft .NET Framework 1.1, and/or Visual Studio .NET 2003 (April 2003 release)
  • JDBC compliant database. The Reliable File Transfer (RFT) service and Replica Location Service (RLS) use a database backend. For license reasons, we ship the Postgresql JDBC driver, but other JDBC compliant databases should be usable.

Installation on UNIX

There is a walkthrough with a transcript of an actual installation.

Installing Ant:

  1. Download Ant 1.5 distribution from http://jakarta.apache.org/ant. The current distribution as of this writing is 1.5.3.
  2. Unzip ant into your preferred location and set the ANT_HOME environment to point to this location.
  3. Add $ANT_HOME/bin to your PATH environment
  4. Download junit and install it into $ANT_HOME/lib.

Installing JDK 1.4.1:

  1. Follow either Sun or IBM's instructions for installing JDK 1.4.1
  2. Set JAVA_HOME to the installation directory, and put $JAVA_HOME/bin on your PATH

Installing a JDBC compliant database:

In this example, we'll use postgresql. If you're familiar with other JDBC databases like MySQL, you can adapt the instructions to use them instead. The database is used by RFT and RLS.

  1. Download Postgresql from http://www.postgresql.org/
  2. First, you need to make sure that postmaster will be started with the "-i" flag to allow TCP/IP based connections. This will be in /etc/init.d/postgresql. Secondly, if you want to allow remote hosts to connect to your DB, you will need to edit pg_hba.conf. By default, this will only allow connections from 127.0.0.1.
  3. If you install from RPMs, you can initialize the DB by simply running /etc/init.d/postgresql start
  4. We will create a new database user and create two databases after installing GT3.

Installing GT3:

  • Perform the installation as a non-root user.
  • Download the GT3 GPT bundle from the download page.
  • If you plan to run the GT3 GRAM service please note the section on setting up the required setuid scripts below. We recommend that you install as the user that will run the GT3 GRAM service.
  • Open the .tar.gz, and run "./install-gt3 /path/to/install". Make sure that ANT_HOME and JAVA_HOME are set, and that 'ant' and 'java' are on your PATH. If you are using JDK 1.3.1, make sure JAAS is in your CLASSPATH before you run the installer.
  • Don't panic! GPT may spit out some WARNING messages at you. Don't worry about Perl version complaints. It works with 5.6.1, 5.8.0, and 5.005.
  • Now you are ready to use many services in core. Copy endorsed/xalan.jar to $JAVA_HOME/jre/lib/endorsed if you are using JDK 1.4.0 or 1.4.1.
  • Proceed to the Configuration section for information on acquiring certificates and setting up MMJFS. Until you have run "install-gt3-mmjfs", you will still need your installer directory.

For support, please see the Support Page

Charles Bacon, David Wallom
Last modified: Tue Dec 09 15:15:33 CDT 2003