Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie Konfiguration von IT-Umgebungen für das InterASL Inhalt 0 Übersicht ............................................................................................................................................................... 1 1 Einsatz des Java-Plugins ...................................................................................................................................... 2 1.1 Erforderliche Java-Versionen ............................................................................................................................. 2 1.2 Einstellung der Laufzeitparameter im Java-Plugin-Bedienfeld (Windows XP).................................................... 2 1.2.1 Bedienfeld in den Versionen 1.5.0 und 1.6.0................................................................................................... 3 1.3 Java-Sicherheitseinstellungen / Datei „java.policy“ ............................................................................................ 3 1.3.1 Zweck der Anpassung ..................................................................................................................................... 3 1.3.2 Erforderliche Einträge...................................................................................................................................... 3 1.3.2.1 1.4 1.4.1 2 2.1 Zusätzlicher Eintrag auf Katasterämtern....................................................................................................... 4 Automatisches Update des Java-Plugins ........................................................................................................... 4 Automatisches Update verhindern .................................................................................................................. 5 Verwendung von Web-Browsern........................................................................................................................... 5 Anpassung eines Popupblockers ....................................................................................................................... 6 2.1.1 Internet Explorer .............................................................................................................................................. 6 2.1.2 Firefox 2.0 / 3.0 ............................................................................................................................................... 7 2.1.3 Weitere Popupblocker ..................................................................................................................................... 7 3 Anpassungen im lokalen Netzwerk des InterASL-Nutzers .................................................................................... 8 3.1 Anpassung einer Firewall ................................................................................................................................... 8 3.2 Proxy-Server ...................................................................................................................................................... 9 4 Maßnahmen bei Fehlern ....................................................................................................................................... 9 4.1 Häufige Fehlerquellen ........................................................................................................................................ 9 4.2 Beschreibung der Fehlersituation....................................................................................................................... 9 4.2.1 Sichern der Java-Konsole ............................................................................................................................. 10 4.2.2 Erstellen von Screenshots............................................................................................................................. 10 0 Übersicht Diese Anpassungen sind für die Nutzung des InterASL erforderlich: Anpassung wann erforderlich Java-Plugin installieren immer 1.1 Java-Runtime -Einstellungen immer 1.2 Java-Sicherheitseinstellungen immer 1.3 Popup-Blocker Firewall Proxy immer (Abruf von PDF-Dokumenten) wenn eine Firewall eingesetzt wird (empfohlen) wenn ein Proxy eingesetzt wird (optional) Kapitel 2.1 3.1 3.2 23.04.2009 Seite 1 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie 1 Einsatz des Java-Plugins Ein Java-Applet kommuniziert nicht direkt mit dem Betriebssystem des Client-PC’s sondern mit einer sog. „Virtuellen Maschine“ (VM). Hierdurch wird eine weitgehende Plattformunabhängigkeit von Java-Applets erreicht. Einige Internet-Browser (nicht MS-Internet Explorer ab Version 6) verfügen über eine eingebaute VM. Das Java-Applet „InterASL“ stellt jedoch funktionale Anforderungen, die derzeit von keiner Browserintegrierten VM erfüllt werden. Daher ist die Installation des sog. „Java-Plugins“ erforderlich. 1.1 Erforderliche Java-Versionen Die Versions-Nummern des Java-Plugins gliedern sich in zwei Teile: • der Teil „1.5.0“, „1.6.0“ … kennzeichnet den Stand der Funktionalität • der Teil „_10“ kennzeichnet den Stand der Fehlerkorrektur (Patchlevel) Web-Browser Betriebssystem minimal zulässige Java-Version Internet Explorer 6 Windows XP 1.5.0_12 Internet Explorer 7 u. 8 Windows XP 1.6.0_10 Internet Explorer 7 u. 8 Windows Vista 1.6.0_10 Firefox 2.0.x Windows XP 1.5.0_12 Firefox 2.0.x Windows Vista 1.6.0_10 Firefox 3.0.x Windows XP 1.6.0_10 Firefox 3.0.x Windows Vista 1.6.0_10 Die Java-Generation 1.4.x sollte bei Neuinstallationen nicht verwendet werden, bzw. im Rahmen von regulären Wartungsarbeiten ersetzt werden. Unter den Versionen 1.4.1 und älter lässt sich das InterASL nicht starten. Die Versionen 1.5.x werden tlw. auch als „Java 5“ bezeichnet. Ein passendes Java-Plugin kann über die Web-Seiten http://www.interasl.niedersachsen.de (Internet) oder http://interasl.vkv.niedersachsen.de (Intranet der nds. Landesverwaltung) bezogen werden. 1.2 Einstellung der Laufzeitparameter im Java-Plugin-Bedienfeld (Windows XP) Für den Einsatz des InterASL sind über die Windows-Systemsteuerung Anpassungen am Java-Plugin vorzunehmen. Die Laufzeitparameter sind unter Windows für jede Windows-Kennung einzustellen, unter der an dem jeweiligen Arbeitsplatz gearbeitet wird !!! Die Einstellung als „Admin“ hat keine Kennungs-übergreifende Wirkung. 1. Aufruf der Systemsteuerung über „Startmenü“ Æ „Einstellungen“ 2. Doppelklick auf das Icon „Java-Plugin“ bzw. „Java“ 3. Im „Java-Plugin-Bedienfeld“ (bzw. „Java Control Panel") müssen sog. „Java-Runtime-Einstellungen“ (bzw. Laufzeit-Einstellungen) eingetragen werden. Die entsprechende Zeichenfolge lautet -Xms64M -Xmx256M Dabei ist dabei unbedingt zu beachten: • Groß-/Kleinschreibung ist relevant • hinter „-Xms64M“ muss ein Leerzeichen stehen • hinter den Bindestrichen „-“ dürfen keine Leerzeichen stehen • innerhalb der Zeichenfolgen dürfen keine Leerzeichen vorkommen 23.04.2009 Seite 2 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie Die Position im Java-Plugin-Bedienfeld (bzw. Java Control Panel), an der diese Parameter einzugeben sind, hängt von der verwendeten Java-Version ab. Die verschiedenen Varianten sind unten in den Kapiteln 1.2.x beschrieben. 1.2.1 Bedienfeld in den Versionen 1.5.0 und 1.6.0 Auf der Registerkarte „Java“ muss in der Rubrik „Java-Applet-Laufzeiteinstellungen“ die Schaltfläche „Anzeigen“ angeklickt werden. Daraufhin öffnet sich der Dialog „Java Runtime-Einstellungen“ (Runtime=Laufzeit). In der Spalte „Java-Runtime-Parameter“ ist dann „-Xms64M –Xmx256M“ einzutragen (siehe Grafik unten). 1.3 Java-Sicherheitseinstellungen / Datei „java.policy“ 1.3.1 Zweck der Anpassung In der Datei „java.policy“ wird festgelegt, welche Arten von Funktionen ein Java-Applet (wie z.B. das InterASL) auf dem Client-PC ausführen darf. Zu diesen Funktionen gehören beim InterASL: • Aufbau von Verbindungen zu anderen Daten-Servern als zu dem Server, von dem das Java-Applet geladen wurde • Benutzung der auf dem Client konfigurierten Drucker • Anlegen von Dateien auf dem Client (TIFF, PDF,...) Wenn diese Einstellungen nicht vorgenommen wurden, erscheint beim Start des InterASL die hier abgebildete Fehlermeldung (oder ähnlich): 1.3.2 Erforderliche Einträge Als Text-Editor zum Anpassen der Datei sollte nicht der Windows-Standard-Editor (notepad.exe, im Startmenü „Editor“ genannt) verwendet werden, weil er die Datei „java.policy“ fehlerhaft darstellt. Die Mini-Textverarbeitung „WordPad“ (im Lieferumfang diverser Windows-Varianten enthalten) ist gut geeignet für die Bearbeitung. 23.04.2009 Seite 3 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie Das Verzeichnis der Datei „java.policy“ hängt von der verwendeten Java-Version ab: Versionen 1.5.x: C:\Programme\Java\jre1.5.x\lib\security Versionen 1.6.x: C:\Programme\Java\jre6\lib\security Folgende Einträge müssen vorgenommen werden: Bei Zugriff über das Intranet: grant codeBase "http://interasl.vkv.niedersachsen.de/-" { permission java.security.AllPermission; }; Bei Zugriff über das Internet: grant codeBase "http://www.interasl.niedersachsen.de/-" { permission java.security.AllPermission; }; Diese Zeilen bedeuten, dass nur Applets, die über die o.g. Server der niedersächsischen Vermessungs- und Katasterverwaltung heruntergeladen werden, die erforderlichen Berechtigungen erhalten. Dieser Textblock kann praktisch an beliebiger Stelle in „java.policy“ eingefügt werden. Es ist lediglich zu beachten, dass die Einfügung nicht zwischen einer öffnenden und schließenden geschweiften Klammer („{...}“) der vorhandenen Textblöcke vorgenommen wird. Praktikabel ist eine Einfügung im vorderen Teil der Datei. Beispiel (wenn der Zugriff über das Internet erfolgt): Kommentarzeilen beginnen mit „//“ und sind nicht funktions-relevant. 1.3.2.1 Zusätzlicher Eintrag auf Katasterämtern Für den Einsatz des dezentralen InterASL (nur für die interne Nutzung der Katasterämter) ist zusätzlich der folgende Textblock erforderlich: grant codeBase "http://interasl.katasteramt-xy.niedersachsen.de/-" { permission java.security.AllPermission; }; Die Zeichenfolge „katasteramt-xy“ ist hierbei Amts-spezifisch. 1.4 Automatisches Update des Java-Plugins Nach der Ausführung des Java-Setups ist die Java-Umgebung so konfiguriert, dass sie in regelmäßigen Abständen selbstständig im Internet nach neuen Versionen sucht und diese installiert. Dieses Verfahren führt dazu, dass nach einiger Zeit auf dem PC mehrere Java-Versionen installiert sind, nämlich eine "von Hand" installierte und ggf. weitere, automatisch installierte Versionen. 23.04.2009 Seite 4 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie Die gängigen Browser verwenden beim Start des InterASL die jüngste der installierten JavaVersionen. Das automatische Update hat jedoch Nachteile: • in der automatisch installierten Version sind die Anpassungen aus den Kap. 1.2 und 1.3 nicht enthalten. Der Aufruf des InterASL führt daher nach dem Update zu einer Fehlermeldung. Die Anpassungen müssen nach dem Update manuell durchgeführt werden. • neuere Versionen enthalten nicht immer weniger Fehler, bzw. bringen keine relevanten Verbesserungen. Um diese Probleme zu vermeiden, kann das automatische Update abgeschaltet werden. 1.4.1 Automatisches Update verhindern 1. Start von Windows mit einer Administrator-Kennung 2. Aufruf der Systemsteuerung über "Startmenü" Æ "Einstellungen" 3. Doppelklick auf das Icon "Java", um das "Java Control Panel" zu öffnen. 4. Auf der Registerkarte "Aktualisierung" den Haken bei der Checkbox "Automatisch nach Aktualisierungen suchen" entfernen. Diese Registerkarte ist nur sichtbar, wenn die Windows-Anmeldung mit einer AdminKennung erfolgte. 5. Das "Java Control Panel" mit "OK" schließen. 6. In der folgenden Sicherheitsabfrage auf "Nie prüfen" klicken. 2 Verwendung von Web-Browsern Hinweise zu Browser- und Java-Versionen sind im Kap. 1.1 enthalten. 23.04.2009 Seite 5 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie 2.1 Anpassung eines Popupblockers Ein "Popupblocker" ist eine Funktion, die das Öffnen unerwünschter Browser-Fenster (z.B. Werbung) durch eine Web-Seite verhindern soll. Eine derartige Funktionalität ist in alle modernen Browser integriert, tlw. aber auch in Firewall- oder Proxy-Software sowie in sog. "Toolbars" (zusätzliche Symbolleisten für Browser) vorhanden. Im InterASL werden Popup's verwendet, um Nachweise des Liegenschaftskatasters im PDF-Format darzustellen. Die Blocker-Software ist nicht ohne weiteres in der Lage, zwischen "guten" (z.B. InterASL-PDF) und "bösen" Popup's zu unterscheiden. Daher muss der Popupblocker angepasst werden. 2.1.1 Internet Explorer 1. Internet Explorer 6: Menü "Extras" Æ "Popupblocker" Æ "Popupblockereinstellungen …" anklicken. "Popupblockereinstellungen" ist nur verfügbar, wenn der Popupblocker aktiviert ist Internet Explorer 7 und 8: Menü "Extras" Æ Funktion "Internetoptionen" Æ Registerkarte "Datenschutz" Æ Schaltfäche "Einstellungen" im Bereich "Popupblocker" 2. In die Liste der zugelassenen Seiten die InterASL-Startseite eintragen: Internet: www.interasl.niedersachsen.de Intranet: interasl.vkv.niedersachsen.de 23.04.2009 Seite 6 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie 2.1.2 Firefox 2.0 / 3.0 1. Menü "Extras" Æ "Einstellungen" anklicken 2. Im Einstellungs-Dialog die Rubrik "Inhalt" auswählen (die Grafiken im Dialog können variieren) 3. Die Schaltfläche "Ausnahmen…" neben dem Auswahlfeld "Popup-Fenster blockieren" anklicken 4. In die Liste der zugelassenen Seiten die InterASL-Startseite eintragen. Internet: www.interasl.niedersachsen.de Intranet: interasl.vkv.niedersachsen.de 2.1.3 Weitere Popupblocker Wie eingangs erwähnt, können Popups nicht nur durch den Browser, sondern auch durch ZusatzSoftware blockiert werden. Hierzu gehören: • diverse Toolbars (Google, Yahoo, …) • Firewalls • Proxy-Software • weitere … Auf Details der einzelnen Lösungen kann hier auf Grund der Vielfalt nicht eingegangen werden. Entsprechende Informationen sollten in der jeweiligen Produkt-Dokumentation zu finden sein. 23.04.2009 Seite 7 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie 3 Anpassungen im lokalen Netzwerk des InterASLNutzers Das Java-Applet „InterASL“ kommuniziert mit diversen Prozessen auf dem InterASL-Server. Diese Prozesse werden durch Servernamen und Portnummern identifiziert. Ggf. sind im Netzwerk des Nutzers Anpassungen an einer Firewall und an der Proxy-Konfiguration erforderlich. 3.1 Anpassung einer Firewall Wenn die Arbeitsplätze, an denen das InterASL eingesetzt werden soll, durch eine Firewall gegen Angriffe aus dem Internet geschützt sind, müssen die im InterASL verwendeten Server und PortNummern in der Firewall freigeschaltet werden (nur für ausgehende Verbindungen). Folgende Prozesse werden verwendet: Servername bei Zugriff über ... Intranet Internet Portnummer Intranet/Internet ALK-Daten dsg92001.vkv.niedersachsen.de www.interasl.niedersachsen.de 23002 ALK-Daten (nur Musterkarte Döteberg) dsg92001.vkv.niedersachsen.de www.interasl.niedersachsen.de 23003 Erfassung der Scrollgebühr beim Produkt "ALK Bildschirmpräsentation" dsg92001.vkv.niedersachsen.de www.interasl.niedersachsen.de 23202 Benutzerverwaltung interasl.vkv.niedersachsen.de www.interasl.niedersachsen.de 23800 ALB-Daten dsg92001.vkv.niedersachsen.de www.interasl.niedersachsen.de 23900 diverse Übersichtskarten web92002.lgn.niedersachsen.de www.interasl.niedersachsen.de 23701-23706 Zweck des Prozesses Häufig müssen in den Konfigurations-Dialogen bzw. –Dateien der Firewalls an Stelle der oben angegebenen Servernamen IP-Adressen angegeben werden. Diese lassen sich sowohl unter MS-Windows als auch unter den diversen X-Betriebssystemen mit dem Befehl „nslookup“ ermitteln. Beispiel: In diesem Beispiel lautet die IP-Adresse des Servers „web92002.lgn.niedersachsen.de“ „10.28.200.14“. Der Server „lin92004.lgn.niedersachsen.de“ hat in diesem Beispiel die IP-Adresse ermittelt. Es ist zu beachten, dass sich die IP-Adressen der Serverprozesse ändern können, die Servernamen jedoch unverändert bleiben. Außerdem kann mit dem Befehl „ping“ (unter MS-Windows und diversen X-Betriebssystemen) geprüft werden, ob ein Server vom Client erreichbar ist. 23.04.2009 Seite 8 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie Beispiel: Dieses Beispiel zeigt einen erfolgreichen Test. Der ping-Test lässt leider keinen Rückschluss auf die Funktionsweise des InterASL zu, weil er unter Verwendung des sehr rudimentärem Protokolls UDP durchgeführt wird. Ggf. werden aber auch UDPDaten durch eine Firewall blockiert, was den ping-Test fehlschlagen lässt. 3.2 Proxy-Server Die Daten, die von den oben beschriebenen Serverprozessen geliefert werden, dürfen nicht durch einen Proxy gepuffert werden. Ggf. müssen die oben genannten Server und Port-Nummern in der Konfiguration des Proxy-Servers freigeschaltet werden, sodass der Proxy die Daten nur weiterreicht, ohne Pufferung. 4 Maßnahmen bei Fehlern 4.1 Häufige Fehlerquellen • Wurde die Firewall tatsächlich für alle Prozesse freigeschaltet? • Lässt die Firewall auch tatsächlich den Transfer von Datenströmen zu oder nur den Verbindungsaufbau zu den Serverprozessen? • Hat ein automatisches Update der Java-Umgebung stattgefunden? In diesem Fall müssen die Anpassungen aus den Kap. 1.2 und 1.3 manuell nachgeholt werden. • Wurde die Datei „java.policy“ angepasst (Java-Sicherheitseinstellungen, Kap. 1.3)? Wenn auf dem Arbeitsplatz mehrere Java-Versionen installiert sind, muss die Anpassung in der Version vorgenommen werden, die vom InterASL verwendet wird. Die Versions-Information befindet sich nach dem Start des InterASL in der Java-Konsole. • Wurden die Java-Laufzeitparameter (Kap. 1.2) korrekt eingegeben? Auch hier muss ggf. die richtige Java-Version berücksichtigt werden. Außerdem müssen die Parameter bei Einsatz von MSWindows unter jeder Windows-Kennung vorgenommen werden, die an dem jeweiligen Arbeitsplatz arbeitet. 4.2 Beschreibung der Fehlersituation Eine Voraussetzung für die Korrektur von Konfigurations- oder Programm-Fehlern ist eine genaue Beschreibung der Fehlersituation. Ggf. sind an die LGN, Abteilung Informationstechnologie – Liegenschaftsinformation – folgende Angaben zu übermitteln: 23.04.2009 Seite 9 von 10 Landesvermessung und Geobasisinformation Niedersachsen Abteilung Informationstechnologie • eine Kopie der Java-Konsole (siehe unten) • Beschreibung des Bedienungsablaufs, der zum Fehler geführt hat • fachliche Angaben zur Fehlersituation (betroffenes Flurstück, betroffener Bestand, Adresse, Koordinaten) • Betriebssystem, Arbeitsspeicher des Client-PC’s • Version und Konfiguration des Java-Plugins • Screenshots 4.2.1 Sichern der Java-Konsole In der Java-Konsole werden während der Arbeit mit einem Java-Applet Protokoll- bzw. Fehlermeldungen gesammelt. Diese Meldungen können nach dem Aufreten eines Fehlers, während der Browser noch geöffnet ist wie folgt gesichert werden: 1. Wenn das InterASL gerade eine Dialogbox oder ein Meldungsfenster geöffnet hat, muss diese(s) geschlossen werden (durch Klick auf „OK“, „Schließen“ o.ä.) 2. das Java-Symbol (Kaffeetasse) im System-Tray (siehe Abbildung) mit der rechten Maustaste anklicken und im Popup-Menü den Eintrag „JavaKonsole öffnen“ anklicken. 3. auf der Tastatur die Taste „s“ drücken, um zusätzliche Informationen über das Client-System in die Konsole zu schreiben 4. auf die Schaltfläche „Kopieren“ klicken. Der Inhalt der Konsole befindet sich nun in der Zwischenablage 5. der Inhalt der Zwischenablage kann dann in ein Text-Dokument (z.B. Word) eingefügt werden. In das gleiche Textdokument können ggf. weitere Informationen (z.B. Screenshots) eingefügt werden. 4.2.2 Erstellen von Screenshots Screenshots (Kopien des Bildschirminhalts) können in zwei Varianten sehr einfach erstellt werden: 1. durch gleichzeitiges Drücken der Tasten „Alt“ und „Druck“ wird das aktuelle, im Vordergrund stehende Fenster in die Windows-Zwischenablage kopiert. 2. durch Drücken der Taste „Druck“ wird der gesamte Bildschirm in die Zwischenablage kopiert. Die Zwischenablage kann nur einen Screenshot auf einmal puffern. Das Erstellen eines neuen Screenshots überschreibt den Inhalt der Zwischenablage. Nach dem Kopieren eines Fensters/des Bildschirms in die Zwischenablage kann der Screenshot in ein Word-Dokument oder auch direkt in eine Outlook-Mail eingefügt werden. 23.04.2009 Seite 10 von 10