GT3 3.2 Installation
Required Tools
- JDK 1.3.1+ or
JRE if you don't need to build any source. Some known sources
of JDK version related troubles: 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.
See
Xindice FAQ for more details. Version 1.4.1 of the JDK has
experience hanging issues during compilation. There are no
known troubles with JDK 1.4.2.
- JAAS
library is required as a separate download if you are
using JDK 1.3.x
- 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.
- 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
- 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.
- Junit 3.8.1 if you want to
run tests from source.
- 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:
- Download Ant 1.5 distribution from http://jakarta.apache.org/ant.
The current distribution as of this writing is 1.5.3.
- Unzip ant into your preferred location and set the ANT_HOME
environment to point to this location.
- Add $ANT_HOME/bin to your PATH environment
- Download junit and install it
into $ANT_HOME/lib.
Installing JDK 1.4.2:
- Follow either Sun or IBM's instructions for installing JDK 1.4.1
- 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.
- Download Postgresql from http://www.postgresql.org/
- 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.
- If you install from RPMs, you can initialize the DB by simply
running /etc/init.d/postgresql start
- 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 base installer bundle from the download page.
- As part of the GRAM security architecture, it is important that
the account under which you plan to run the GT3 container is a member
of the group that installs the software. This group should only
contain privileged members.
- 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.
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. If you are using
JDK 1.4.x, copy $GLOBUS_LOCATION/endorsed/xalan.jar to
$JAVA_HOME/jre/lib/endorsed. See the Apache XML security page
for more details.
- 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: Thu Jul 24 06:25:33 CDT 2003