Difference between revisions of "Installation"

Revision as of 18:36, 5 August 2011

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

Installation

Three-step installation

Download
In the bin directory, run the startup script (requires java 1.5 or greater)
Chuckle... There Is No Step Three (TM)! :)

(Inspired by Instiki's three-step installation)

Notes on Linux

In the BIN folder there is a startup script for Linux/Unix: oj-linux.sh
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 platfoirm release (ZIP file). See also #Three-step installation step.

@@ Line 13: / Line 13: @@
 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 ==
+== Installation ==
-* 1 - In the [http://sourceforge.net/projects/jump-pilot/ Jump Pilot Project] download OpenJUMP Platform Indipendent
+=== Three-step installation ===
-* 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''':
+# Download
+# In the bin directory, run the startup script (requires [http://developers.sun.com/downloads/ java] 1.5 or greater)
+# ''Chuckle''... There Is No Step Three (TM)! :)
-) The Java version to be run...
+(Inspired by [http://instiki.org Instiki's] 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/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: <br />
+=== Notes on Linux ===
- $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
-) Also be sure to correctly specify OpenJUMP's installation folder in ''JUMPHOME''.
+# In the BIN folder there is a startup script for Linux/Unix: '''oj-linux.sh'''
+# 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:
+#: <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)
-== Installing OpenJUMP on MacOSX ==
+=== Notes on MacOSX ===
-* 1 -  open a ''terminal'' window
+see [[Installing on Mac OSX]]
-* 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:
+=== Notes on Windows ===
-* [[Installing on Mac OSX]]
-* [[OpenJUMP Install Instructions]] tips for all Operative Systems.
-* [[Comparing OpenJUMP]], demonstrating first experiences from Eric with OJ on MacOSX (sstein: seems like we lost this page)
-More information about StartUp scrip for MacOSX can be found [http://www.osxfaq.com/Tutorials/LearningCenter/HowTo/Startup/index.ws here]
-== Installing OpenJUMP on Microsoft 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
-'''OpenJUMP (ZIP file)'''
+;'''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
@@ Line 72: / Line 50: @@
-<hr/>
+=== The Nightly Build ===
-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 platfoirm release (ZIP file). See also [[#Three-step installation]] step.