Home

Virtual Worlds Productions

Software Development Group

Software

FastFwD

Virtual Universe

Service

How to install Java®

Old Software
(no longer supported)

AudioCutter Cinema

AnimFX

IT2

Miscellaneous

Contact

Imprint (Impressum)

Privacy (Datenschutz)

Installing Sun's® Java®

by

Introduction
Java® for Linux
- Installing the Java Runtime Environment® 1.4.x
- Installing Java 3D®
Java® for Windows
- Installing the Java Runtime Environment® 1.4.x
- Installing Java 3D®
Troubleshooting
Java® and Java 3D® for other operatingsystems

Introduction

Java® ist ein plattformübergreifendes System, das es möglich macht, unter Java® entwickelte Software auf jedem beliebigen Computersystem laufen zu lassen, für das die Java Virtual Machine®, die von Sun® und anderen Anbietern zumeist kostenlos zur Verfügung gestellt wird, umgesetzt wurde. Diese so genannte JVM ist mittlerweile für jedes nennenswerte Computersystem verfügbar, so dass eine Java®-Applikation ohne irgend welche Anpassungen auf praktisch jeder Hardware und unter jedem OS läuft. Leider ist die Installation von Java® unter Umständen ein bischen aufwändiger und gerade für Computerneulinge nicht auf Anhieb zu bewältigen.	Java® is a platform-independent system that allows to run the same software on every computer system. Only the Java Virtual Machine®, that is available from Sun® or other vendors (in most cases for free), has to be installed before. This so called JVM is available for every namable computer platform. So a Java® application can be executed without any modifications on nearly every hardware and under nearly every OS. The installation of the JVM itself is a little bit tricky in some cases.
Deswegen soll hier - zusätzlich zu den Informationen auf Suns® Java®-Webseite - noch mal eine kurze Anleitung gegeben werden. Es wird dabei speziell auf die Installation unter Windows und Linux eingegangen. Auf allen anderen Computer- und Betriebssystemen erfolgt die Installation enstsprechend.	Because of this, additional to the installation-notes at Sun's® Java®-website, it will be described here again. As examples we use the installation under Windows and Linux. For all other operating systems it has to be done in a similar way.
Zusätzlich wird auf die Installation der Java3D-API® eingegangen, einer professionellen und hocheffizienten 3D-Engine, die mehr und mehr Bedeutung gewinnt.	Additional there are some information about installation of Java3D-API®, a professional and highly efficient 3D engine with extensive features whith increasing relevance.

Java® for Linux

Installing the Java Runtime Environment® 1.4.x

Als erstes wird die Java Runtime Environment® benötigt. Die JRE 1.4.x kann bei Sun® kostenlos heruntergeladen werden:	First you have to download the Java Runtime Environment®. The actual JRE version 1.4.x is available for free here:
http://java.sun.com/j2se/1.4.2/download.html
Dieses Archiv muss - so fern nicht das RedHat RPM verwendet wurde - anschließend entpackt und die Files nach /usr kopiert werden. Der genaue Ablauf für jedes der angebotenen Download-Pakete der verschiedenen Linux-Distributionen wird hier beschrieben:	If you don't have downloaded the RedHat RPM now you have unpack the archive and to copy the extracted directories to /usr. How this has to be done for the different available Linux-distributions can be also read here:
http://java.sun.com/j2se/1.4.2/jre/install-linux.html
Im folgenden wird der Ablauf bei der Verwendung des RedHat RPM näher beschrieben. Für alle anderen zum Download angebotenen Pakete ist das Verfahren ähnlich.	Following you can find some information about the installation when you use the RedHat RPM. For all other offered packages the procedure is very similar.
Typischerweise wurde die JRE in /usr/java/j2re1.4.2 installiert. Nun muss als erstes der Standardsuchpfad um den Pfad zu den ausführbaren Programmen der JRE gesetzt werden. Das geschieht in der Datei "/etc/profile". Dort sollte bereits ein Eintrag mit der Variablen PATH existieren. An dessen Zeilenende ist der Pfad nach /usr/java/j2re1.4.2/bin durch ":" getrennt anzufügen. Anschließend müßten diese Zeilen etwa so aussehen:	Typically the JRE was installed in /usr/java/j2re1.4.2. As a first step you have to set the environment variable PATH. This has to be done in "/etc/profile" by adding /usr/java/j2re1.4.2/bin separated by a ":" to the existing PATH-entry. After this step these lines have to look like this:
PATH=$PATH:/bin:/...:/usr/java/j2re1.4.2/bin/... export PATH
Anschließend wird der Pfad zu den Klassenbibliotheken benötigt. Das geschieht wieder in der Datei "/etc/profile". Am Ende des PATH-Eintrages ist der Pfad nach /usr/java/j2re1.4.2/lib durch ":" getrennt anzufügen. Anschließend müßten diese Zeilen etwa so aussehen:	Now you have to set the environment variable PATH to the class libraries. This has to be done in "/etc/profile" by adding /usr/java/j2re1.4.2/lib separated by a ":" to the existing PATH-entry. After this step these lines have to look like this:
PATH=$PATH:/bin:/...:/usr/java/j2re1.4.2/bin/: /usr/java/j2re1.4.2/lib/ ... export PATH

Installing Java 3D®

Das optionale Paket, das die 3D Engine für Java enthält kann hier kostenlos heruntergeladen werden:	The optional package which contains the 3D engine for Java can be downloaded here for free:
http://www.blackdown.org/java-linux/mirrors.html
Hier muß lediglich ein naheliegender Downloadserver und der Prozessor (i386 oder PPC) ausgewählt sowie anschließend die Runtime Environment ("java3d-re-[...].bin") in der Version 1.3.x heruntergeladen werden.	Simply select a download-location next to you, choose the processor your linux runs onto (i386 or PPC) and download the runtime environment ("java3d-re-[...].bin") version 1.3.x.
Die Installation selber setzt lediglich voraus, dass bereits eine JRE installiert wurde. Ist das der Fall, muss das heruntergeladene File das als Executeable vorliegt aus dem Basisverzeichnis der JRE heraus ausgeführt werden, um die Installation zu starten. Dazu muss mit folgenden Befehlen nur in dieses Verzeichnis gewechselt und das .bin-File des Java-3D-Paketes gestartet werden:	The following installation procedure simply requires a correctly installed JRE. If it exists you simply have to execute the file you downloaded out of the base directory of the JRE to start the installation procedure. To do that you have to change to this location and to execute the .bin-file of the Java-3D-package with the following commands:
cd /usr/java/j2re1.4.2 /bin/sh ~/java3d-re-1.3.1-fcs-linux-[...].bin

Java® for Windows

Installing the Java Runtime Environment® 1.4.x

Als erstes wird die Java Runtime Environment® benötigt. Die aktuelle JRE 1.4.x kann bei Sun® kostenlos heruntergeladen werden:	First you have to download the Java Runtime Environment®. The actual JRE version 1.4.x is available for free and can be downloaded here:
http://java.sun.com/j2se/1.4.2/download.html
Das heruntergeladene Setup-Programm muss ausgeführt werden. Es wird empfohlen, anschließend die Umgebungsvariable PATH zu verändern, allerdings ist das nicht mehr zwingend erforderlich:	Now you have to execute the resulting setup-program. It is recommended to edit the environment-variable PATH afterwards but this isn't mandatory:
Die Umgebungsvariable PATH muß sowohl auf die ausführbaren Programme als auch auf die Java-Libs zeigen. Die Umgebungsvariable CLASSPATH wird in Version 1.4.x nicht mehr benötigt, da jetzt alle Klassen gefunden werden, die sich im PATH befinden. Der dazu erforderliche Eintrag muß in der "AUTOEXEC.BAT" bzw. mit Hilfe der Ressourcenverwaltung in der Systemsteuerung erfolgen und könnte - je nach Ort der Installation - so aussehen:	If you change the environment variable PATH you have to edit your "AUTOEXEC.BAT" or to modify the environment variables settings in your system control. PATH has to point to the executeable program files and to the Java-libraries. The old CLASSPATH isn't needed any longer because JRE 1.4.x will find all classes via environment varibale PATH. So your new entry could look like this:
SET PATH=C:\Programme\Java\j2re1.4.2\bin; C:\Programme\Java\j2re1.4.2\lib;%PATH% oder/or SET PATH=C:\Program Files\Java\j2re1.4.2\bin; C:\Program Files\Java\j2re1.4.2\lib;%PATH%
C:\Programme\Java\j2re1.4.2\ ist hier die Position, an der die komplette JRE vom Setup-Programm installiert wurde. In diesem Verzeichnis befinden sich die Unterverzeichnisse bin\ und lib\, die die JVM selber und die benötigten Klassen enthalten. Auf diese Unterverzeichnisse wird mit obigem Eintrag die Umgebungsvariable PATH gesetzt, damit Java-Applikationen die JVM finden und die JVM selbst die benötigten Klassen findet.	Here C:\Program Files\Java\j2re1.4.2\ is the position where the setup-program installed the complete JRE. Inside this directory you can find the subdirectories bin\ and lib\ which contain the (executeable) JVM itself and the required classes. The above entry sets the environment variable PATH to these directories to make Java-applications executeable using the JVM and to let the JVM itself find the required classes.
Eine zusätzliche Installationsanleitung ist hier verfügbar:	Additional installation information are available here:
http://java.sun.com/j2se/1.4.2/jre/install-windows.html

Installing Java 3D®

Das optionale Paket, das die 3D Engine für Java enthält kann hier kostenlos heruntergeladen werden:	The optional package which contains the 3D engine for Java can be downloaded here for free:
http://java.sun.com/products/java-media/3D/1.3/download.html
Hier kann zwischen den Runtimes (nicht dem SDK für ein existierendes JDK!) für DirectX® oder OpenGL® ausgewählt werden. Die Version für OpenGL empfiehlt sich für WindowsNT® sowie Windows-Betriebssysteme, auf denen kein DirectX installiert ist, da die OpenGL-Treiber in den meisten Fällen bereits Teil der Grafikkartentreiber sind. Auch ist OpenGL® DirectX® in punkto Geschwindigkeit in vielfach Überlegen. Es sollte also bevorzugt "Java 3D for Windows (OpenGL Version) Runtime for the JRE" zu wählen.	Here you can choose between runtimes (not SDK's for an existing JDK!) for DirectX® or OpenGL®. The version for OpenGL is recommended for WindowsNT® and/or Windows-systems which don't own DirectX. This version should work properly because most drivers for graphics cards already include the OpenGL-drivers. Additionally OpenGL® is often faster than DirectX®. So it is recommended to choose "Java 3D for Windows (OpenGL Version) Runtime for the JRE" preferentially.
Die Runtime für DirectX sollte nur verwendet werden, wenn DirectX® bereits installiert wurde. Dann ist als Download "Java 3D for Windows (DirectX Version) Runtime for the JRE" zu wählen. Es wird DirectX Version 8.0 oder höher benötigt.	The runtime for DirectX should be used only if DirectX was already installed. Select "Java 3D for Windows (DirectX Version) Runtime for the JRE" for downloading in this case. DirectX version 8.0 or higher is required.
Die folgende Installationsprozedur setzt lediglich voraus, dass bereits eine JRE installiert wurde. Ist das der Fall, kann das heruntergeladene File durch Doppelklicken gestartet werden.	The following installation procedure simply requires a correctly installed JRE. If it exists you simply have to execute the file you downloaded by double clicking to start the automatic installation procedure.

Troubleshooting

Passiert nach z.B. dem Start des JavaRunners, bzw. nach dem Start eines Scriptfiles, das die JVM ausführen sollte nichts, so ist eventuell der Standard-Suchpfad falsch gesetzt worden oder die Definition des CLASSPATH (ab Version 1.4.x ist das ebenfalls der Standard-Suchpfad PATH) ist unvollständig. Um eine Fehlermeldung zu erhalten, muß der JavaRunner bzw. das Startscript von einer Konsole aus gestartet werden. Es wird dann eine Fehlermeldung ausgegeben, die Aufschluß über die Ursache gibt. Alternativ kann der Befehl zum Starten auch direkt eingegeben werden:	If nothing happens after starting e.g. the JavaRunner or the script file which normally executes the JVM and the Java-application, something in the installation is wrong. To find out if the variable PATH or CLASSPATH (for versions 1.4.x or higher this is no longer CLASSPATH but PATH) was set wrong, an error message will be needed. To get this, you have to run the script or the JavaRunner using a console. Instead of this you can start it directly using following command:
java -classpath programname.jar programname
Folgende typischen Fehlermeldungen sind möglich:	Following error messages are possible:
Command not found
Das Programm "JAVA.EXE" konnte nicht gefunden werden. Es ist zu überprüfen, ob der Standardsuchpfad PATH zu den Binär-Daten im Unterverzeichnis bin/ der JRE korrekt gesetzt wurde.	The executeable "JAVA.EXE" couldn't be found. Please check if the variable PATH was set to a correct path to the binaries in the subdirectory bin/ of the JRE.
Couldn't find java/lang/thread
Das JAR-Archiv der JRE® "rt.jar" konnte nicht gefunden werden. Es ist zu überprüfen, ob die Variable PATH auf ihr Verzeichnis gesetzt wurde. Dieses JAR-Archiv befindet sich typischerweise im Unterverzeichnis lib/ der JRE.	The JAR-archive "rt.jar" of the JRE® couldn't be found. Please check if the variable PATH was set correct to its directory. Typically this JAR-archive can be found in the subdirectory lib/ of the JRE.

Java® for other operating systems

Java® wurde für viele Hardwareplattformen und Betriebssysteme portiert und bietet deswegen echte plattformunabhängigkeit. Eine Liste aller (offiziellen) Ports ist ebenfalls bei Sun® erhältlich und wird regelmäßig aktualisiert:	Java® was ported for many hardware platforms and operating systems. An actual list of all (official) ports can be also found at Sun's® Java®-website:
http://java.sun.com/j2se/1.4.2/ports.html
Java 3D® ist ebenfalls für mehrere Hardwareplattformen und Betriebssysteme verfügbar. Eine Auflistung ist hier zu finden:	Java 3D® was ported for different hardware platforms and operating systems too. You can find a list of all available ports here:
http://java3d.virtualworlds.de/download.php

-