The Blackdown Java(TM) 2 RE, Standard Edition, v1.4.1-01 is available
in one installation format:

* A shell script with an embedded bzipped tarball which can be used to
  install the Java2 RE in a location chosen by the user
        - Make the shell script executable
                % chmod +x j2re-1.4.1-01-linux-<ARCH>.bin
          (Replace <ARCH> with the architecture of your system, e.g. 
          replace <ARCH> with i586 if your on an Intel system.)
        - Change to the directory you want to install into, e.g /usr/local
                % cd /usr/local
        - Extract the contents of the Java 2 SDK by running the shell script
                % ./j2re-1.4.1-01-linux-<ARCH>.bin
          (Replace <ARCH> with the architecture of your system, e.g. 
          replace <ARCH> with i586 if your on an Intel system.)
        - Add j2re1.4.1/bin to PATH, e.g. if you installed into /usr/local
                % export PATH=/usr/local/j2re1.4.1/bin:$PATH
        - Continue with the Java Plug-In instructions below
        - Continue with the Java Web Start instructions below

* A bzipped tarball which can be used to install the Java2 RE in a
  location chosen by the user
        - Change to the directory you want to install into, e.g /usr/local
                % cd /usr/local
        - Extract the contents of the Java 2 RE
                % tar xvfI j2re-1.3.1-RC1-linux-<ARCH>.tar.bz2
          (Replace <ARCH> with the architecture of your system, e.g. 
          replace <ARCH> with i386 if your on an Intel system.)
        - Add j2re1.3.1/bin to PATH, e.g. if you installed into /usr/local
                % export PATH=/usr/local/j2re1.3.1/bin:$PATH
        - Continue with the Java Plug-In instructions below

* A .deb file containing packages comprising the Java 2 RE
  Installation:
        - Choose one of our mirrors
        - Become root
                % su
        - Add the following line to /etc/apt/sources.list


Java Plug-In install instructions
=================================

Please remove older plug-in versions before installing the 1.4.1-01
plug-in.  E.g. remove ~/.netscape/plugins/javaplugin.so and
~/.netscape/java/.

* Netscape 4 (available only on ix86).

  Create a symbolic link from 
  <Java2 RE installation>/plugin/<ARCH>/netscape4/javaplugin.so to one
  of the directories Netscape 4 searches for plug-ins.
  E.g. 

   % ln -s /usr/local/j2re1.4.1/plugin/i386/netscape4/javaplugin.so \
     ~/.netscape/plugins/

  or

   % su # become root
   % ln -s /usr/local/j2re1.4.1/plugin/i386/netscape4/javaplugin.so \
     /usr/lib/plugins/

  Note: It has to be a symbolic link, copying javaplugin.so will NOT work


* Mozilla / Netscape 7

  Create a symbolic link from 
  <Java2 RE installation>/plugin/<ARCH>/mozilla/javaplugin_oji.so to 
  one of the directories Mozilla/Netscape 7 searches for plug-ins.
  E.g. 

   % ln -s /usr/local/j2re1.4.1/plugin/i386/mozilla/javaplugin_oji.so \
     ~/mozilla-1.0/plugins/
  or
   % su # become root
   % ln -s /usr/local/j2re1.4.1/plugin/i386/mozilla/javaplugin_oji.so \
     /usr/lib/mozilla/plugins/

  Note: It has to be a symbolic link, copying javaplugin.so will NOT work



Java Web Start install instructions
===================================

Please remove older Java Web Start versions before installing the 1.4.1-01
Java Web Start.
Note that Java Web Start has only been tested with per-user installations
so far.

* Unzip <Java2 RE installation>/javaws-1_2-linux-int.zip
  E.g.

        % cd ~/
        % mkdir tmp
        % cd ~/tmp
        % unzip /usr/local/j2re1.4.1/javaws-1_2-linux-int.zip

* Change to the directory where you want to install Java Web Start,
  run the extracted install.sh file, read and accept the license.
  Answer the next question with the path to your Java2 RE installation.
  E.g.

        % cd ~/
        % ./tmp/install.sh
        ...
        Do you agree to the above license terms? [yes or no] 
        yes
        In order to use Java(tm) Web Start you must have a version of Java 2 standard edition
        installed. If you do not, you can download one from http://java.sun.com.
        Please enter the path of your installation (eg /usr/local/java/jdk1.2):
        /usr/local/j2re1.4.1
        Obtaining version...
        You appear to be running 1.4.1
        Creating javaws.cfg...
        Extracting...
        Updating ~/.mailcap...
        Updating ~/.mime.types...
        Determining full JRE versions...

* The Java Web Start program can be started by executing $(HOME)/javaws/javaws

* If you want to use Java Web Start with browser other than Netscape 4 you
  might have to register a new MIME + helper application for it.  Please
  read your browser's or desktop environment documentation to find out
  how to do this.

  The MIME type is "application/x-java-jnlp-file".  The extensions is
  ".jnlp".  The helper application should be javaws (e.g. if you have
  installed Java Web Start in your HOME directory, use ~/javaws/javaws).
  Optionally you can use "Java Web Start" as an description for the
  new MIME type.

* Optionally: Remove the temporary directory created in step 1
  E.g.
        % rm -r ~/tmp

