Difference between revisions of "Installation"

From OpenJUMP Wiki
Jump to navigation Jump to search
Line 20: Line 20:
 
** c:/OpenJUMP/bin
 
** c:/OpenJUMP/bin
 
** c:/OpenJUMP/lib
 
** c:/OpenJUMP/lib
* 3 - In the BIN folder there are the statup scripts for Linux/Unix: '''openjump-unix.sh''' or '''openjump.sh'''. There is an  improved script for unix: '''openjump-unix2.sh'''
+
* 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 '''openjump.sh''' file, open the consolle and write:
+
* 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 openjump.sh
+
  chmod +x oj-linux.sh
 
Some Linux Distro like Ubuntu and Debian allows to make script executable by "property" window.
 
Some Linux Distro like Ubuntu and Debian allows to make script executable by "property" window.
 
(+x commmnd makes openjump script executable)
 
(+x commmnd makes openjump script executable)
 
* 5 - Run Openjump by consolle with this command:
 
* 5 - Run Openjump by consolle with this command:
  ./openjump.sh
+
  ./oj-linux.sh
  
 
'''A few notes about Linux installation''':  
 
'''A few notes about Linux installation''':  
Line 32: Line 32:
 
1) The Java version to be run...
 
1) The Java version to be run...
 
Linux Distros come with a open-source version of Java.  
 
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/openjump-unix.sh'' script:  
+
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  
 
  JAVA_HOME=/usr/java/latest/bin  
 
(usually there but distro-dependent -- or wherever you've installed it)
 
(usually there but distro-dependent -- or wherever you've installed it)
Line 46: Line 46:
 
* 1 -  open a ''terminal'' window
 
* 1 -  open a ''terminal'' window
 
* 2 - move to the "bin" folder (using "ls" and "cd" commands in the terminal)
 
* 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 openjump.sh" and pressing enter
+
* 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:
 
Other information can be found here:
Line 67: Line 67:
  
 
* Download the ZIP file and decompress it in a folder (e.g. OPENJUMP)
 
* 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  '''OpenJUMP.bat''' which are used to launch the software
+
* 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
 
* eventually create a shortcut on the desktop for the launcher
  

Revision as of 15:29, 24 July 2011

back to Index page


Java Setup

OpenJUMP can run on Linux, Unix, MacOSX, Microsoft Windows (from 98 to Vista) 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