java it will run on virtually all java platforms. If you have any problems
please email the INTERFACES list.
-Once you have ANT, cd to the src directory and type "ant". This will compile
-the correct driver for your JVM, and build a .jar file (Java ARchive) called
-postgresql.jar
+Once you have ANT, run the configure script in the top-level directory with
+the --with-java option. Then proceed with 'make' and 'make install' as
+usual. This will compile the correct driver for your JVM, and build a .jar
+file (Java ARchive) called postgresql.jar. The file will be installed in
+the directory PREFIX/share/java.
That jar file will contain the driver for _your_ version of the JDK.
-Note: As of 7.1, you build from pgsql/src and not pgsql/src/interfaces/jdbc.
-Well you can, but building from the top will also build some extra utilities
-located under /contrib at the same time. Also later on (either 7.1.1 or 7.2)
-it's intended to have the main configure script to build the driver
-automatically if it finds both a JDK & ANT installed, so this is the first step
-towards that.
+Note: As of 7.1, you can build from the top-level directory or from
+src/interfaces/jdbc.
REMEMBER: Once you have compiled the driver, it will work on ALL platforms
that support that version of the API. You don't need to build it for each
still hear from people who ask me "I've compiled it ok under Solaris, but it
won't compile under Linux" - there's no difference.
-I advise you don't try running javac outside of ANT as it builds some classes
-on the fly.
+Don't try to run javac directly. Don't try to run ant directly. Neither
+will work.
Possible problems
INSTALLING THE DRIVER
-To install the driver, the .class files have to be in the classpath. To do
-this, copy the postgres.jar file into a directory, and add it to the classpath.
+To install the driver, the .class files have to be in the classpath.
ie: under LINUX/SOLARIS (the example here is my linux box):
- export CLASSPATH=.:/usr/local/lib/postgresql.jar
+ export CLASSPATH=.:/usr/local/pgsql/share/java/postgresql.jar
Please don't be tempted to extract the files from the .jar file. There are a
lot of files in there, and you may break the Exception handling.