Handbuch OpenJDK als alternative Java-Umgebung ARCHIKART Software AG Oberhammerstr. 2 01979 Lauchhammer Telefon (0 35 74) 46 55-0 Telefax (0 35 74) 46 55-11 NL Berlin Maxstr. 3a 13347 Berlin Tel. (030) 20 38 90 401 NL Zeitz Hauptstr. 30 06729 Elsteraue Tel. (0 34 41) 82 90 720
Hinweis: Die in diesem Handbuch veröffentlichten Informationen können ohne vorherige Ankündigung geändert werden und stellen seitens der ARCHIKART Software AG keine Verpflichtung dar. Die im Folgenden beschriebene Software wird mit einem Softwarevertrag & Berechtigungsschein zur Nutzung von Computerprogrammen geliefert. Die Software darf nur nach den dort genannten Bedingungen verwendet werden. Gewährleistung: Es wird keine Garantie für die Richtigkeit des Inhalts dieses Handbuchs übernommen. Gewährleistung und Haftung hierzu werden im Softwarevertrag & Berechtigungsschein zur Nutzung von Computerprogrammen geregelt. Da sich Fehler, trotz aller Bemühungen, nie vollständig ausschließen lassen, sind wir für Hinweise jederzeit dankbar. Copyright: Die Rechte an den Programmen ARCHIKART und ARCHIKART on Web sowie der zugehörigen Dokumentation liegen bei der ARCHIKART Software AG. Die Weitergabe und Installation erfolgt nur durch diese Firma oder deren autorisierte Händler. Jede Vervielfältigung der Software bzw. Dokumentation, gleich welcher Art, ist unzulässig. Kopien der Software ARCHIKART und ARCHI- KART on Web dürfen nur zum Zweck der Datensicherung für einen registrierten Anwender durchgeführt werden. Der unberechtigte Einsatz der Software bzw. die unberechtigte Weitergabe hat juristische Schritte des Lizenzgebers zur Folge. ARCHIKART Software AG Oberhammerstr. 2 01979 Lauchhammer Telefon: (03574) 4655-0 Fax: (03574) 4655-11 E-Mail: info@archikart.de Webseite: http://www.archikart.de
Inhalt Installation einer alternativen Java-Umgebung... 2 1.1 Vorgehen... 2 1.2 Einrichten von OpenJDK... 2 1.3 Einrichten von IcedTea-Web... 4 1.4 Einrichten der Umgebungsvariablen... 4 1.5 Test Java... 5 1.6 Erstellen der Verknüpfung zur Webstart-Umgebung... 5 Erweiterte Hinweise... 9
Installation einer alternativen Java-Umgebung Oracle stellt in Zukunft keine Updates mehr zu Java SE 8 kostenlos bereit. Wer in Zukunft weiterhin Updates zu Java 8 beziehen möchte, benötigt einen entsprechenden Supportvertrag. Dieser ist allerdings mit zusätzlichen Kosten verbunden. Ab der Version 4.54 wird der ARCHIKART Webserver mit einem freien OpenJDK ausgeliefert (nur 64bit Windows). Auch die Client-Anwendungen sind OpenJDK-kompatibel. Mit einer kleinen Bibliothek lassen sich Themenbrowser und Co. weiterhin als Webstart-Anwendungen nutzen. Hinweis: Die Kopplung von ARCHIKART 4 mit ARCHIKART Karthago-Java basiert weiterhin auf Oracle Java, da nur damit die Funktion des Applets innerhalb von ARCHIKART gewährleistet ist. Hierbei ist lediglich ein Oracle Java 8 kompatibel. Daher empfehlen wir allen Nutzern von ARCHIKART Karthago-Java keine Updates mehr von Oracle Java durchzuführen, auch nicht auf die nächst höhere Version Java 11. Eine Alternative wäre der Erwerb eines kostenpflichtigen Supports von Oracle Java 8. Benötigen Sie keine ARCHIKART-Kopplung mit ARCHIKART-Karthago-Java, können Sie auf ein alternatives Java umsteigen. ARCHIKART empfiehlt Ihnen einen Umstieg auf OpenJDK, das den freien Nachfolger des Java Development Kit (JDK) darstellt. Nachfolgend werden die notwendigen Einstellungen zum Umstieg erläutert. 1
Installation einer alternativen Java- Umgebung 1.1 Vorgehen 1. Einrichten von OpenJDK 2. Einrichten von IcedTea-Web 3. Einrichten der Umgebungsvariablen 4. Test Java 5. Erstellen der Verknüpfung zur Webstart-Umgebung 1.2 Einrichten von OpenJDK Hinweis: Bevor das OpenJDK installiert wird, sollte jede andere Java-Distribution deinstalliert werden. Nach der Deinstallation von Oracle Java laden Sie OpenJDK über folgende Adresse herunter: https://adoptopenjdk.net/index.html?variant=openjdk8&jvmvariant=openj9 AdoptOpenJDK https://adoptopenjdk.net/index.html stellt vorgebaute OpenJDK Binaries zur Verfügung. Bei der Wahl der richtigen Distribution ist sowohl auf die entsprechende Java-Version als auch auf die verwendete Runtime zu achten. Nach wie vor benötigen die Anwendungen von ARCHIKART ein Java 8. Als Runtime testen und empfehlen wir die OpenJ9 Runtime. 2
Installation einer alternativen Java-Umgebung Über den nachfolgenden Link gelangen Sie direkt zu dem benötigten Download für ein Java8 mit der OpenJ9 Runtime für Windows x64. Hier https://adoptopenjdk.net/releases.html?variant=openjdk8&jvmvariant=openj9#x64_win Der Download für weitere Betriebssystem-Plattformen ist möglich. Betätigen Sie dazu den Link Zurück zu Plattformen. Abbildung 1: Download von OpenJDK Hinweis: Zum Starten der ARCHIKART on Web Anwendungen ist das JRE-Download ausreichend. Nachdem die Distribution heruntergeladen wurde, entpacken Sie die *.zip-datei in einen Ordner, der unveränderlich ist und nicht gelöscht wird. Dies kann der Standardordner für Programme sein, z.b. C:\Program Files\Java\jdk8u192-b12, aber auch jeder andere Ordner ist denkbar. Eine verteilte Installation wurde noch nicht getestet, insofern ist von einer Installation auf Netzlaufwerken abzusehen. 3
1.3 Einrichten von IcedTea-Web Da der Webstart-Mechanismus https://de.wikipedia.org/wiki/java_web_start im OpenJDK nicht enthalten ist und damit die ARCHIKART on Web Anwendungen (Karthago, Themenbrowser etc.) nicht automatisch im Browser geöffnet werden, wird sich der frei verfügbaren Webstart-Bibliothek von IcedTea bedient. Weitere Details zu IcedTea finden Sie hier: https://icedtea.classpath.org/wiki/main_page Die letzte Windows Distribution kann über den folgenden Link direkt heruntergeladen werden: http://icedtea.wildebeest.org/download/icedtea-web-binaries/1.7.1/windows/icedtea-web- 1.7.1.win.bin.zip Entpacken Sie die heruntergeladene *.zip-datei in einen Ordner, der unveränderlich ist und nicht gelöscht wird. Idealerweise legen Sie den Ordner analog zu OpenJDK an, z.b. C:\Program Files\IcedTeaWeb. 1.4 Einrichten der Umgebungsvariablen Damit die Java-Programme und auch der Webstart systemweit ausgeführt werden können, müssen die beiden Pfade zu den jeweiligen Binaries der PATH-Variablen hinzugefügt werden. Öffnen Sie dazu die erweiterten Systemeinstellungen und öffnen Sie das Fenster Umgebungsvariablen. Erweitern Sie die systemweite PATH-Variable um die folgenden Verzeichnisse (wenn die Beispielpfade verwendet wurden): - C:\Program Files\Java\jdk8u192-b12\bin - C:\Program Files\IcedTeaWeb\WebStart\bin Optional können Sie noch die JAVA_HOME Umgebungsvariable anlegen: - C:\Program Files\Java\jdk8u192-b12\ Abbildung 2: Erweitern der Systemvariablen 4
Installation einer alternativen Java-Umgebung 1.5 Test Java Um zu prüfen, ob alles korrekt eingestellt ist, kann in einer Kommandozeile die Version des eben installierten OpenJDK erfragt werden. Öffnen Sie dazu eine Konsole und geben Sie den Befehl java -version ein. Die nachfolgende Abbildung zeigt eine erfolgreiche Einrichtung. Abbildung 3: Öffnen der erstellten Verknüpfung zum ARCHKART Themenbrowser 1.6 Erstellen der Verknüpfung zur Webstart-Umgebung Leider ist es mit dem OpenJDK nicht mehr möglich, direkt im Browser auf einen Webstart-Link zu klicken, um so die entsprechende Anwendung zu starten. Es ist aber möglich, auch mit dem OpenJDK eine Ein-Klick-Lösung zu realisieren. Dazu wird der Link zu einer Webstart-Anwendung (z.b. ARCHIKART Themenbrowser, Web Konfiguration) als Verknüpfung auf dem Desktop abgelegt. Öffnen Sie das ARCHIKART on Web Startcenter, wählen Sie eine Anwendung aus und kopieren Sie anschließend die Link-Adresse. Über das Kontextmenü des Desktops erstellen Sie eine neue Verknüpfung. Tragen Sie den javaws-befehl zusammen mit dem kopierten Link für die neue Verknüpfung in das Feld ein und betätigen Sie anschließend die Schaltfläche Weiter. Beispiel: ARCHIKART Web Konfiguration: javaws http://archikart:8080/archikart-webconfig/ ARCHIAKRT Themenbrowser: javaws http://archikart:8080/archikart-tbrowser/start/ ARCHIAKRT Karthago: javaws http://archikart:8080/archikart-tbrowser/karthago/ 5
Abbildung 4: Erstellen einer Verknüpfung zum ARCHKART Themenbrowser Geben Sie den Namen für die Verknüpfung in das Feld ein und betätigen Sie die Schaltfläche Fertig stellen, um die Verknüpfung zu erstellen. Abbildung 5: Erstellen einer Verknüpfung zum ARCHKART Themenbrowser Auf dem Desktop wurde die Verknüpfung erstellt. Per Doppelklick auf die Verknüpfung starten Sie die ARCHIKART on Web Anwendung. 6
Installation einer alternativen Java-Umgebung Es öffnet sich eine Konsole und IcedTea-Web beginnt die Anwendung herunterzuladen. Es erscheint eine Sicherheitsabfrage, ob die ARCHIKART Anwendung ausgeführt werden darf. Betätigen Sie bitte die Schaltfläche Ausführen. Es folgt eine weitere Sicherheitsabfrage, die Sie mit Ja bestätigen müssen, um die ARCHIKART on Web Anwendung zu starten. 7
Im Anschluss öffnet sich die gewählte Anwendung wie gewohnt. Abbildung 6: Öffnen der erstellten Verknüpfung zum ARCHKART Themenbrowser Hinweis: Legen Sie für alle benötigten ARCHIKART on Web Anwendungen eine entsprechende Verknüpfung an. Nach dem Schließen einer Webstart-Anwendung bleibt die Konsole, die beim Start geöffnet wurde, meist offen. Zum Schließen der Konsole drücken Sie eine beliebige Taste. 8
Erweiterte Hinweise Erweiterte Hinweise Die Links zu unseren Webstart-Anwendungen können Parameter wie z.b. login oder eine GisID aufnehmen. Sollte so ein Link verwendet werden, diesen immer mit Anführungszeichen in der Verknüpfung eintragen, sonst werden die Parameter nicht mit übertragen Die JAVA_HOME Umgebungsvariable kann eingerichtet werden, um einigen javabasierten Programmen, z.b. Apache Tomcat, den Start zu ermöglichen. Viele Java-Anwendungen schauen nach einer JAVA_HOME Variablen. Mit <IcedTea-Web>/Webstart/bin/itweb-settings.bat wird die die Konfigurationsoberfläche gestartet - hier lässt sich z.b. die Konsole ein- und ausblenden. Laufzeitumgebungen mit der Hotspot-VM https://de.wikipedia.org/wiki/hotspot (anstatt O- penj9 von Eclipse-Foundation) sollten ebenfalls funktionieren. Allerdings kommen diese von Oracle. Updates vom OpenJDK müssen manuell durchgeführt werden; es gibt keine Mechanismen die auf Updates prüfen. 9