- Download a Java Runtime and required extentions
J2SE v 1.4.2_05 JRE, Java Advanced Imaging & Java Imaging IO
J2SE v 5.0 RC JRE, Java Advanced Imaging & Java Imaging IO
SDK 1.4.2, Java 3D and Advanced Imaging Update & Java Imaging IO - Download the 3.1 M1 "RCP Runtime Binary" suitable for your platform
Windows 98/ME/2000/XP
Linux (x86/GTK 2)
Max OSX (Max/Carbon) - not well tested with UDIG - Unzip the RCP Runtime Binary where you would like to install UDIG
- Download UDIG 0.2 is and unzip it into your RCP Runtime Binary folder
- Run udig and enjoy
Fixes - Thanks Everyone
Fix your udig.bat, udig.sh to something that works:
eclipse.exe -application net.refractions.udig.ui.uDig -vmargs -Dosgi.parentClassloader=ext
This allows UDIG 0.2 to correctly find JAI, have a splash screen and generally behave nicely. In UDIG 0.3 this will be seemless.
To run eclipse.exe directly add these two lines to your config.ini:
osgi.parentClassloader=ext eclipse.application=net.refractions.udig.ui.uDig
Both these fixes will be included in the next release.
Mac OS X
Thanks to [~mrevelle] for the following:
For Mac OS X, you will just want to start up uDig by running Eclipse.app in the RCP directory. Running from Terminal with the uDig.sh will start up uDig but I can't find a way to switch focus to the application. Also, might need to figure out how to reference JAI and ImageIO in OS X (maybe it's done automatically?), I know I have the packages installed, and I know they work because I use them in my own Java apps?
Here is what I'm using in uDig.sh for Mac OS 10.3.5:
#!/bin/bash
JRE=$JAVA_HOME/jre/lib/ext
JAI_CP=$JRE/clibwrapper_jiio.jar:$JRE/jai_codec.jar:$JRE/jai_core.jar:$JRE/jai_imageio.jar:$JRE/mlibwrapper_jai.jar
java -Xbootclasspath/a:$JAI_CP -Dosgi.splashLocation=splash/splash.bmp -classpath startup.jar org.eclipse.core.launcher.Main -application net.refractions.udig.ui.uDig -os macosx -ws carbon -arch ppc -nl en_US
I cannot connect to Oracle
To connect to Oracle your need their proprietary libraries.
In order to use the Oracle module you need the JDBC driver from Oracle. Unlike most external libraries used in GeoTools, we cannot redistribute this jar. However, you can obtain them from the Oracle website, free of charge, after registering.
- Download Oracle JDBC Driver
- Update net.refractions.udig.libs/lib plugin directory:
- place the jar in the lib directory
- update plugin.xml with the following xml snipit:
<library name="lib/ojdbc14.jar.jar">
<export name="*"/>
</library>
For Mac OS X, you will just want to start up uDig by running Eclipse.app in the RCP directory. Running from Terminal with the uDig.sh will start up uDig but I can't find a way to switch focus to the application. Also, might need to figure out how to reference JAI and ImageIO in OS X (maybe it's done automatically?), I know I have the packages installed, and I know they work because I use them in my own Java apps...
Here is what I'm using in uDig.sh for Mac OS 10.3.5:
#!/bin/bash
JRE=$JAVA_HOME/jre/lib/ext
JAI_CP=$JRE/clibwrapper_jiio.jar:$JRE/jai_codec.jar:$JRE/jai_core.jar:$JRE/jai_imageio.jar:$JRE/mlibwrapper_jai.jar
java -Xbootclasspath/a:$JAI_CP -Dosgi.splashLocation=splash/splash.bmp -classpath startup.jar org.eclipse.core.launcher.Main -application net.refractions.udig.ui.uDig -os macosx -ws carbon -arch ppc -nl en_US
This is offered as constructive criticism.
"Remember, you have to have Java 1.5 installed...
JAVA_HOME=/usr/java/j2sdk1.4...."
Some additional notes for windows:
Step 1 - installing the RCP just consisted of unzipping the downloaded file anywhere.
Step 4 - on windows 2000/ XP, environment variables can be set in control pannel/ System/ Advanced Tab / Environment Variables. Add a new "JAVA_HOME" user variable with a value of "C:\Program Files\Java\j2re1.4.2" (no quotes and you will need to modify the path for your own system). You do not need to set the CLASSPATH variable.
Step 6 - A udig.bat file that correctly quotes the classpath (to allow spaces in file paths) is posted at http://lists.refractions.net/pipermail/udig-devel/2004-September/000179.html
The CLASSPATH variable should not be needed as the bootclasspath is set inside the bat and sh files. As a general rule setting the CLASSPATH has been discoraged since (iirc) Java 1.3
In addition I had to edit the .bat file so that the bootclasspath was quoted as my Java in instaled inside a directory with spaces. (i.e. Program Files)