JReceiver: Server Install - Java Runtime

Java

JReceiver presently requires a Java environment, equivalent to Sun's Java Runtime Environment (JRE) 1.3 or later.

Linux

Your Linux distribution very likely contains a Java package that you can install from CD. Consult your distribution documentation to see if it offers one that meets the requirement(s) stated above. If not, you'll have to download a JRE to install.

An example of Java installation for a Debian-based Linux distribution:

    apt-get install java-common

TODO: some more examples please

Obtaining Sun's JRE

You can download Sun's JRE from here.

The JRE for Linux is typically downloaded as a ~15mb script.

Extract by running the script and set up a symlink

    cd /usr/local
    chmod 755 /download/j2re-1_XXXX-linux-i386.bin
    /download/j2re-1_XXXX-linux-i386.bin
    ln -s jre1.XXXX jre

Configure

Edit your /etc/profile (Debian) or /etc/profile.local (SuSE) to add an environment variable:

    JAVA_HOME=/usr/local/jre
    CLASSPATH="$JAVA_HOME/lib/rt.jar"
    export JAVA_HOME CLASSPATH

And optionally append

    /usr/local/jre/bin

to the PATH in that same file as well.

Special note to JDK users: the path will be $JAVA_HOME/jre/lib/rt.jar.

Verify

Restart (or manually export variables) and try a simple test

    $JAVA_HOME/bin/java -version

You should see something that resembles

    java version "1.XXXX"
    Java(TM) 2 Runtime Environment, Standard Edition (build 1.XXXX)
    Java HotSpot(TM) Client VM (build 1.XXXX, mixed mode)

If you're having problems

Consult Sun's installation notes at: 1.3.x, 1.4.x

Windows

Which JRE/JDK distribution to download?

Though JReceiver can work with JRE/JDK 1.3.X, most users will probably want to use a more recent version, such as

    Java(TM) 2 Runtime Environment, Standard Edition 1.4.X

These can be found here.

For US users, the International English version (containing support for additional codepages) is no longer necessary.

Install Files

Download the distribution and run the setup per Sun's instructions.

Configure

Set a system environment variable JAVA_HOME to the directory you specified during JRE installation:

Variable Name Variable Value
JAVA_HOME C:\Program Files\Java\j2re1.X.X

To set an environment variable in Windows 2000, right-click on "My Computer" and select properties. Select the "Advanced" tab, click the "Environment Variables" button, and click the "New" button beneath the "System Variables" box. (Don't set it as a user variable in the top box.)

VERIFY

Open a new Command Prompt (Start / Accessories / Command Prompt) and try a simple test

    "%JAVA_HOME%/bin/java" -version

You should see something that resembles

    java version "1.X.X"
    Java(TM) 2 Runtime Environment, Standard Edition (build 1.X.X)
    Java HotSpot(TM) Client VM (build 1.X.X, mixed mode)

If you're having problems

Consult Sun's installation notes at: 1.3.x, 1.4.x

NEXT STEP: [Install MySQL]


Copyright © 2001-2002, Reed Esau & the JReceiver Project (http://jreceiver.sourceforge.net), All Rights Reserved