Difference between revisions of "Installation"

From OpenJUMP Wiki
Jump to navigation Jump to search
(Created page with ''''back to''' Index page <hr /> == Java Setup == OpenJUMP can run on Linux, Unix, MacOSX, Microsoft Windows (from 98 to Vista) and any Operation System that supports Java.…')
 
 
(20 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
<hr />
 
<hr />
  
== Java Setup ==
+
== Requirements ==
  
OpenJUMP can run on Linux, Unix, MacOSX, Microsoft Windows (from 98 to Vista) and any Operation System that supports Java.
 
  
 +
OpenJUMP can run on Linux, Unix, MacOSX, Microsoft Windows 98 and later and any operation system that supports Java.
 
OpenJUMP requires:
 
OpenJUMP requires:
 +
 +
=== '''Memory''' ===
 
* 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)
 
* 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 [http://java.sun.com/javase/downloads/index_jdk5.jsp JRE 1.5] installed.
 
 
Some plugins could also require the installation of [https://jai.dev.java.net/binary-builds.html Java(TM) Advanced Imaging (JAI))] and [https://java3d.dev.java.net/binary-builds-old.html Java3d]
 
  
== Installing OpenJUMP on Linux ==
+
=== '''Java 1.5 or later''' ===
 +
* at least [http://www.oracle.com/technetwork/java/javase/downloads/ Java Runtime Environment (JRE) 1.5] installed. Windows and Linux users find the latest JRE here
 +
http://www.oracle.com/technetwork/java/javase/downloads/
  
* 1 - In the [http://sourceforge.net/projects/jump-pilot/ Jump Pilot Project] download OpenJUMP Platform Indipendent
+
* MacOSX users look here:
* 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
+
http://support.apple.com/downloads/
You will see the following folder structure:
 
** c:/OpenJUMP/
 
** c:/OpenJUMP/bin
 
** 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'''
 
* 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:
 
chmod +x openjump.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:
 
./openjump.sh
 
  
'''A few notes about Linux installation''':  
+
=== '''Additional Java Libraries''' ===
 +
Some plugins could also require the installation of Java(TM) Advanced Imaging (JAI) or Java3D available from
 +
http://java.sun.com/javase/technologies/desktop/media/
  
1) The Java version to be run...
+
== Three-step Installation ==
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:
 
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: <br />
+
# [[Downloading OpenJUMP|Download]]
$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
+
# From the bin directory, run the starter for your operating system
 +
#; Windows
 +
#: OpenJUMP.exe or oj_windows.bat
 +
#; Linux
 +
#: oj_linux.sh
 +
#; MacOSX
 +
#: OpenJUMP(.app) or oj_macosx.command
 +
# ''Chuckle''... There Is No Step Three (TM)! :)
  
2) Also be sure to correctly specify OpenJUMP's installation folder in ''JUMPHOME''.
+
(Inspired by [http://instiki.org Instiki's] three-step installation)
  
  
== Installing OpenJUMP on MacOSX ==
+
=== '''Notes on Linux''' ===
  
* 1 -  open a ''terminal'' window
+
# In the BIN folder there is a startup script for Linux/Unix: '''oj-linux.sh'''
* 2 - move to the "bin" folder (using "ls" and "cd" commands in the terminal)
+
# 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:
* 3 - if you arrived in the bin folder, openjump can be started by typing: "sh openjump.sh" and pressing enter
+
#: <pre>chmod +x oj-linux.sh</pre>
 +
: Some Linux Distro like Ubuntu and Debian allows to make script executable by "property" window.
 +
: (+x parameter makes openjump script executable)
  
Other information can be found here:
+
=== '''Notes on MacOSX''' ===
* [[Installing on Mac OSX]]
 
* [[OpenJUMP Install Instructions]] tips for all Operative Systems.
 
* [[ComparingOpenJump]], demonstrating first experiences from Eric with OJ on MacOSX
 
  
More information about StartUp scrip for MacOSX can be found [http://www.osxfaq.com/Tutorials/LearningCenter/HowTo/Startup/index.ws here]
+
:see [[Installing on Mac OSX]]
  
== Installing OpenJUMP on Microsoft Windows ==
+
=== '''Notes on Windows''' ===
  
In the [http://sourceforge.net/projects/jump-pilot/ Jump Pilot Project] it is possible to download two versions of OpenJUMP for windows:
+
:In the [http://sourceforge.net/projects/jump-pilot/ Jump Pilot Project] it is possible to download two versions of OpenJUMP for windows:
  
'''OpenJUMP  Win32 installer 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
  
* Download the ''OpenJUMP  Win32 installer'' (EXE file). This is a setup file which automatizes the installation
+
:;OpenJUMP (ZIP file)
* 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
+
:* 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 (ZIP file)'''
 
  
* Download the ZIP file and decompress it in a folder (e.g. OPENJUMP)
+
== '''The Nightly Build''' ==
* In the folder OPENJUMP/BIN search for the files '''OpenJUMP.exe''' or  '''OpenJUMP.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
+
:OpenJUMP Nightly Build is basically the latest developer version of OpenJUMP all platform release (ZIP file). The [[#Three-step installation]] applies.

Latest revision as of 22:01, 15 October 2011

back to Index page


Requirements

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

Memory

  • 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)

Java 1.5 or later

http://www.oracle.com/technetwork/java/javase/downloads/
  • MacOSX users look here:
http://support.apple.com/downloads/

Additional Java Libraries

Some plugins could also require the installation of Java(TM) Advanced Imaging (JAI) or Java3D available from

http://java.sun.com/javase/technologies/desktop/media/

Three-step Installation

  1. Download
  2. From the bin directory, run the starter for your operating system
    Windows
    OpenJUMP.exe or oj_windows.bat
    Linux
    oj_linux.sh
    MacOSX
    OpenJUMP(.app) or oj_macosx.command
  3. Chuckle... There Is No Step Three (TM)! :)

(Inspired by Instiki's three-step installation)


Notes on Linux

  1. In the BIN folder there is a startup script for Linux/Unix: oj-linux.sh
  2. 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 parameter makes openjump script executable)

Notes on MacOSX

see Installing on Mac OSX

Notes on 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


The Nightly Build

OpenJUMP Nightly Build is basically the latest developer version of OpenJUMP all platform release (ZIP file). The #Three-step installation applies.