Deprecated: Function set_magic_quotes_runtime() is deprecated in /storage/content/76/1004576/ on line 33 Deprecated: Function split() is deprecated in /storage/content/76/1004576/ on line 95 Deprecated: Function split() is deprecated in /storage/content/76/1004576/ on line 743 jdp:installing [DokuWiki]



  • Processor: Pentium III class CPU with 500 MHz or something equivalent
  • Memory: 256MB RAM
  • Mouse: Generic two button mouse, but a three-button mouse with scrollwheel is highly recommended. JPatch should work on Mac OS-X, but it will not work with a single button mouse!

Operating System

Any OS that supports Java, including Mircrosoft Windows, Linux and Mac OS-X


A Java Runtime Environment (JRE) version 1.4 or later is required. It can be downloaded from Sun Microsystems. You’ll need the J2SE (Standard Edition - Core/Desktop) version of Java. Download and install the JRE to just run java applications (smaller download, does not include the Java compiler). Download and install the JDK (Java Development Kit) which contains the JRE and the Java compiler if you want to create and compile Java applications.


First of all, you have to download a copy of JPatch. You can get it from the SourceForge download site for JPatch. All releases are platform-independant, but they come in two different flavors. You can see the difference when you look at the file extension:

  • jar: This is only the program itself. You don’t need more to run JPatch, but it does not contain demo models and other optional stuff.
  • zip or gz: These releases contain the program and additional files like demo models. Windows users should download the zip version, Linux users the gz (.tar.gz) version.

FIXME What’s the best file format for Mac?

Select you’re version of choice and download it to a directory on your computer.




JPatch can be installed for one user only, or system wide. If you want to install JPatch system wide, you have to have administrator rights (i.e. you have to be able to switch to the root user). Therefore, installing JPatch for one user only is the preferred way.

Installing JPatch for one user

1. Open a terminal (or a konsole, xterm or similar). We will now create a directory in which we install JPatch in. In this example ~/jpatch is used, but you can replace that by any directory you want (you have to have write access to the directory, though).

mkdir ~/jpatch

2. The following part depends on what kind of package you have downloaded: If you have downloaded a single jar file, simply move it to its destination:

mv /path/to/downloaded/jar ~/jpatch

If you downloaded a tar.gz archive, you will have to uncompress it in the right folder:

tar -xvz -f /path/to/downloaded/archive -C ~/jpatch

3. You are now almost ready to run JPatch. Before doing so, we have to find out what the name of the JPatch program file is. Again, if you downloaded the jar package you’re done, because that’s just this very file. Otherwise use

ls ~/jpatch/jpatch*.jar

to find out.

4. Now you’re really done: Run JPatch by executing

java -jar ~/jpatch/filename-you-found-out.jar

Installing JPatch system wide

Installing JPatch system wide is done almost exactly like installing it for a single user: In the instructions above, replace ~/jpatch with /usr/local/jpatch. Make sure that you’re logged in as root, or use the su command to switch to the root user before beginning.

After the installtion, you can make things easier for your users: To allow them to start JPatch by simply executing the command jpatch instead of the whole java -jar …, execute the following commands while you’re still logged in as root:

echo '#!/bin/bash' > /usr/local/bin/jpatch
echo 'java -jar /usr/local/jpatch/filename-you-found-out.jar' >> /usr/local/bin/jpatch
chmod a+x /usr/local/bin/jpatch


  jdp/installing.txt · Last modified: 2005/11/22 10:45