Installation

From OpenJUMP Wiki
Revision as of 18:25, 5 August 2011 by Edso (talk | contribs)
Jump to navigation Jump to search

back to Index page


Requirements

Java 1.5 or later

OpenJUMP can run on Linux, Unix, MacOSX, Microsoft Windows 98 and later and any operation system that supports Java.

OpenJUMP requires:

  • minimum 124 MB to run, better 256 MB (note: if the script files are used for starting, then one can assign less memory using the -Xmx option)
  • At least JRE 1.5 installed.

Some plugins could also require the installation of Java(TM) Advanced Imaging (JAI)) and Java3d

Installing OpenJUMP on Linux

  • 1 - In the Jump Pilot Project download OpenJUMP Platform Indipendent
  • 2 - The platform-independent version of OpenJUMP comes under the form of a compressed archive (ZIP). To install, decompress the archive in your hard drive, for example into c:/OpenJUMP

You will see the following folder structure:

    • c:/OpenJUMP/
    • c:/OpenJUMP/bin
    • c:/OpenJUMP/lib
  • 3 - In the BIN folder there is a startup script for Linux/Unix: oj-linux.sh
  • 4 - Eventually, to run OpenJUMP first make the startup script executable. For instance, if you want to use oj-linux.sh file, open the console and write:
chmod +x oj-linux.sh

Some Linux Distro like Ubuntu and Debian allows to make script executable by "property" window. (+x commmnd makes openjump script executable)

  • 5 - Run Openjump by consolle with this command:
./oj-linux.sh

A few notes about Linux installation:

1) The Java version to be run... Linux Distros come with a open-source version of Java. OpenJUMP will use that per default. Should one want to use Sun's Java (recommended) some changes are necessary to the JUMPHOME/bin/oj-linux.sh script:

JAVA_HOME=/usr/java/latest/bin 

(usually there but distro-dependent -- or wherever you've installed it)

The last line of the script (calling Java) should be like this:

$JAVA_HOME%/java -Dswing.defaultlaf=javax.swing.plaf.metal.MetalLookAndFeel -Dlog4j.configuration=file:./log4j.xml -Xms512M -Xmx1024M -cp $CLASSPATH com.vividsolutions.jump.workbench.JUMPWorkbench -properties workbench-properties.xml -plug-in-directory $LIB/ext 

2) Also be sure to correctly specify OpenJUMP's installation folder in JUMPHOME.


Installing OpenJUMP on MacOSX

  • 1 - open a terminal window
  • 2 - move to the "bin" folder (using "ls" and "cd" commands in the terminal)
  • 3 - if you arrived in the bin folder, openjump can be started by typing: "sh oj-linux.sh" and pressing enter

Other information can be found here:

More information about StartUp scrip for MacOSX can be found here

Installing OpenJUMP on Microsoft Windows

In the Jump Pilot Project it is possible to download two versions of OpenJUMP for windows:

OpenJUMP Win32 installer for Windows

  • Download the OpenJUMP Win32 installer (EXE file). This is a setup file which automatizes the installation
  • Run the file to setup OpenJUMP. The software will be installed in the computer and a new icon "OpenJUMP" will be created in the desktop to launch the program

OpenJUMP (ZIP file)

  • Download the ZIP file and decompress it in a folder (e.g. OPENJUMP)
  • In the folder OPENJUMP/BIN search for the files OpenJUMP.exe or oj_windows.bat which are used to launch the software
  • eventually create a shortcut on the desktop for the launcher



OpenJUMP Nightly Build is basically the same version of OpenJUMP (ZIP file). See also OpenJUMP Install Instructions page