Page Operations
Browse Space
- Download a Java Runtime and required extentions (download versions with a installer, not a .zip)
- Download the 3.1 M2 "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 0.3.
Note: Currently no spaces should be in the directory path: "c:\Program Files" is not legal. It is recommended to unzip eclipse RCP in c:\ - Download UDIG 0.3 is and unzip it into your RCP Runtime Binary folder.
If eclipse RCP was unzipped in c:\ then UDIG should be unzipped in c:\eclipse. Choose accept/ok when prompted to replace files. - Run eclipse executable and enjoy
Installation Tips & Tricks - Thanks Everyone
Thank you for installing UDIG 0.3 - the rest of this document is edited by the community can contains late breaking work arounds and fixes.
If you are using this page via online help you the live version of this page here:
Please help out and provide feedback, the above link allows for both editing by everyone, and comments to be added to the page.
Gotcha's
There are a few Gotcha's that numerous people have encountered:
- UDIG must be installed in the eclipse RCP directory. ie. the UDIG plugin directory should correspond to the eclipse RCP plugin directory. It is normal to get a prompt asking to replace files. UDIG supplies a config.ini file that replaces the one shipped with eclipse RCP.
- Make SURE that Java advanced imaging and image i/o are installed in the Java 1.5 directory not a different java install.
- The current version of eclipse RCP cannot be installed in a directory with a space. ie "Program Files". It is recommended to unzip eclipse RCP in c:\ and unzip UDIG in C:\eclipse
What is Java Advanced Imaging not recognized on my CLASSPATH?
Java Advanced Imaging is a JRE extention and should be installed in your JRE.
Installation should produce the following:
- JRE/ext/libs - is where the JAR jars
- JRE/bin - will contain native libraries
This process makes JAI a member of the BOOTCLASSPATH, and available to all applications
rather than a member of the Application specific CLASSPATH.
If you have used a Linux RPM to install JAI be aware that this will not work:
If this remains an issue we may be able to ask UDIG to search for content on the CLASSPATH as well.
Mac OS X And Java Advanced Imaging IO
When setting up Java Advanced Imaging IO use a linux CLASSPATH install and just use the jars.
Manual Install of Image IO Extensions:
- The download contains:
clibwrapper_jiio.jar required jar jai_imageio.jar required jar milibwrapper_jai.jar fatal jar (JAI already installed one) - Copy the two required jars (clibwrapper_jiio.jar & jai_imageio.jar ) to:
- JRE:lib:ext
This procedure works for most operating systems - if you need to do things by hand.
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?
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>
