Difference between revisions of "Installation"

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

at least Java Runtime Environment (JRE) 1.5 installed. Windows and Linux users find the latest JRE here

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

Download
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)! :)

(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 platform release (ZIP file). The #Three-step installation applies.

@@ Line 2: / Line 2: @@
 <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:
+=== '''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)
-* 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 ==
-* 1 - In the [http://sourceforge.net/projects/jump-pilot/ 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''':
+=== '''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/
-) The Java version to be run...
+* MacOSX users look here:
-Linux Distros come with a open-source version of Java.
+  http://support.apple.com/downloads/
-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 />
+=== '''Additional Java Libraries''' ===
- $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
+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/
-) Also be sure to correctly specify OpenJUMP's installation folder in ''JUMPHOME''.
+== Three-step Installation ==
+# [[Downloading OpenJUMP|Download]]
+# 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)! :)
-== Installing OpenJUMP on MacOSX ==
+(Inspired by [http://instiki.org Instiki's] three-step installation)
-* 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:
+=== '''Notes on Linux''' ===
-* [[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]
+# 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 Microsoft Windows ==
+=== '''Notes on MacOSX''' ===
-In the [http://sourceforge.net/projects/jump-pilot/ Jump Pilot Project] it is possible to download two versions of OpenJUMP for windows:
+:see [[Installing on Mac OSX]]
-'''OpenJUMP  Win32 installer for Windows'''
+=== '''Notes on Windows''' ===
-* Download the ''OpenJUMP  Win32 installer'' (EXE file). This is a setup file which automatizes the installation
+:In the [http://sourceforge.net/projects/jump-pilot/ Jump Pilot Project] it is possible to download two versions of OpenJUMP for windows:
-* 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  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 ZIP file and decompress it in a folder (e.g. OPENJUMP)
+:;OpenJUMP (ZIP file)
-* In the folder OPENJUMP/BIN search for the files '''OpenJUMP.exe''' or  '''oj_windows.bat''' which are used to launch the software
+:* Download the ZIP file and decompress it in a folder (e.g. OPENJUMP)
-* eventually create a shortcut on the desktop for the launcher
+:* 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
-<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 platform release (ZIP file). The [[#Three-step installation]] applies.