[[TranslatedPages(revision=204)]] [[PageOutline(2-3,Inhaltsverzeichnis)]] = Download = Diese Seite bietet Hinweise zur Installation und zum Aufrufen von JOSM. Für die Arbeit mit JOSM gibt es die [wikitr:/Introduction Einführung] und die [wikitr:/Help Hilfe]-Seiten. Und für sehr komplexe Fragen die [wikitr:/InstallNotes Installationsdetails]. == Empfohlene Optionen ==#Recommendedoptions [[JOSMImage(openlocation,valign=middle,link=[/download/josm.jnlp],title="JOSM via Java Web Start starten",alt="JOSM Web-Start starten")]] **Starten [/download/josm.jnlp josm.jnlp]** (Neueste stabile Freigabe) \\ Empfohlene Version, für alle Plattformen, monatliche automatische Aktualisierung ([#Webstart Wie starten]). \\ \\ [[JOSMImage(download, valign=middle, link=[/josm-tested.jar],title="JOSM herunterladen",alt="JOSM tested herunterladen")]] **Herunterladen [/josm-tested.jar josm-tested.jar]** (Version [[Version(tested)]], Stabile Freigabe) \\ Alle Plattformen ([#Java Wie aufrufen]). \\ \\ == Alle Download-Optionen ==#Moredownloadoptions Jeden [/roadmap Monat] erstellt das Team von JOSM eine stabile [wikitr:/Releases Freigabe], genannt **tested version**, zum Herunterladen. Die Varianten für MS Windows und Apple macOS beruhen darauf. Beim Klick auf josm.jnlp wird immer die neueste stabile JOSM-Freigabe gestartet. [=#DevelopmentVersion] Jede [/log/josm/?verbose=on&limit=20 Nacht] erzeugen die Built-Systeme eine Entwicklungsversion, genannt **latest version**. Diese Versionen können schwere Fehler enthalten. Aber meistens funktionieren sie gut. Auch hierfür ist ein Web-Start verfügbar. ||= =||||= **Für alle Betriebssysteme** =||||||||= =||= **Development** =|| ||=**Version** =||= **Web-Start** =||= **Herunterladen** =||= **Windows** =||= **Apple macOS** =||= **Ubuntu, Debian…** =||= **openSUSE** =||= **Jar / Javadoc / Quelle** =|| ||=**Stabile Freigabe (Version [[Version(tested)]])** =|| \ || [/download/josm.jnlp josm.jnlp] || \ || [/josm-tested.jar] || \ || \\ [/download/windows/josm-setup.exe setup.exe] \\ [/download/windows/josm-setup.msi josm-setup.msi] \\ [https://apps.microsoft.com/store/detail/josm/XPFCG1GV0WWGZX Microsoft Store]\\ ''([#Mswindowswrapper siehe unten])'' || \ || \\ [/download/macosx/josm-macosx.zip JOSM macOS .zip Paket] \\ '''oder ([#macOS homebrew])'' || \ || ''[#Ubuntu siehe unten]'' || \ || ''[#openSUSE siehe unten]'' || \ || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ josm]:[[Version(tested)]] || ||=**Entwicklungsversion [[Version(latest)]]** =|| \ || [/download/josm-latest.jnlp latest.jnlp] || \ || [/josm-latest.jar] || || || \ || ''[#Ubuntu siehe unten]'' || || \ || [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Schnappschuss verwenden] || ||=''**ältere**'' =|| || \ || [/download/ download/] || || \ || [https://github.com/openstreetmap/josm/releases automatische JOSM.app Erstellung] || \ || [/apt/pool/universe/j/ pool/] || || \ || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ tested versions] || Herunterladeskripte sollten zunächst [/latest latest], [/tested tested] oder [/version alle] prüfen, um die Bandbreite zu reduzieren. ** Übersetzungen weglassen **[=#Striptranslations] \\ Falls die Dateigröße ein Problem ist, werden kleinere Dateien der stabilen Freigabe angeboten. Für Programmdateien nur mit Englischer Sprache hänge [/josm-tested.jar?lang=en ?lang=en] an die URL. Um eine Übersetzung zu erhalten, ersetze das `en` it dem entsprechenden [wikitr:/TracLanguages Sprachkürzel] (kleiner erster Buchstabe, nur unterstützte Sprachen). Die Dateigröße kann weiter um die Signaturen reduziert werden durch das Anhängen von [/josm-tested.jar?lang=en&unsigned=1 ?unsigned=1]. == Linux Repositories == === Eigenes Debian-basierendes hauptsächlich für Ubuntu ===#Ubuntu Dies ist unsere eigenes Paket-Repository hauptsächlich für Ubuntu. Es sollte auch mit anderen auf Debian-basierenden (insbesondere Ubuntu-basierenden) Distributionen funktionieren, aber wir testen und unterstützen keine anderen Distributionen außer Ubuntu aktiv. Das Repository enthält zwei Pakete: * ''josm'' – Enthält die stabile Freigabe (tested). Ersetzt das Paket aus dem offiziellen Repository der Distribution. Der Standardname der JOSM-Verzeichnisse ist auf `JOSM` gesetzt. * ''josm-latest'' – Die nächtliche Entwicklungsversion. Kann parallel zum josm-Paket installiert werden, daher ist der Standardname der JOSM-Verzeichnisse auf `JOSM-latest` gesetzt. Beide Pakete liefern `/etc/default/josm` bzw. `/etc/default/josm-latest` als Konfigurationsdatei für [wikitr:Help/CommandLineOptions#Javaoptions Java-Optionen]. Zusätzlich zum unten beschrieben Prozedere können ältere DEBs manuell [/apt/pool/universe/j/josm/ heruntergeladen] und installiert werden. ==== Installation ==== Die Paketquellenliste `/etc/apt/sources.list.d/josm.list` muss angepasst werden: {{{#!sh sudo editor /etc/apt/sources.list.d/josm.list }}} und eine der folgenden Zeilen entsprechend der Ubuntu-Version eingefügt werden: {{{#!sh deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt lunar universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt kinetic universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt impish universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt hirsute universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt groovy universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt eoan universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt disco universe deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe # For other Debian based distributions add: deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe }}} Alternativ kann dies auch mit dem folgenden Einzeiler in Ubuntu erfolgen (jedoch nicht in Ubuntu-basierenden Distributionen wie Linux Mint): {{{#!sh echo "deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(lsb_release -sc) universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null }}} oder für Linux Mint: {{{#!sh echo "deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt $(grep ^DISTRIB_CODENAME= /etc/upstream-release/lsb-release| awk -F = '{print $(2)}') universe" | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null }}} {{{#!comment ### below did not work on all systems and add the following line: {{{#!sh `deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe` }}} }}} Den [/josm-apt.key öffentlichen Schlüssel] herunterladen: {{{#!sh # Das Verzeichnis für manuell heruntergeladene Schlüssel erstellen, falls es noch nicht erstellt wurde sudo mkdir -p /usr/local/share/keyrings # Den Schlüssel herunterladen wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo gpg --dearmor -o /usr/local/share/keyrings/josm-apt.gpg }}} In der Vergangenheit verwendete die Anleitung `apt-key`. Folgende Zeile entfernt den Schlüssel, falls er zum Systeminternen Schlüsselring hinzugefügt wurde {{{#!sh sudo apt-key del $(apt-key list | grep -B1 "" | sed '$d' | cut -b 48-51,53-57) }}} Nun die eigene Paketliste auffrischen {{{#!sh # Ggf. ist SSL-Unterstützung für apt im Vorhinein zu installieren: sudo apt-get install apt-transport-https # Paketliste auffrischen sudo apt-get update }}} und installieren: {{{#!sh # Die erste Zeile ist entbehrlich, falls diese Pakete vorher nicht installiert waren.) sudo apt-get remove josm josm-plugins # Für die stabile Freigabe sudo apt-get install josm # Für die Entwicklungsversion sudo apt-get install josm-latest }}} === GNU Debian ===#GNUDebian Unsere eigenen "Ubuntu" Pakete, [#Ubuntu weiter oben] funktionieren auf Debian und wir empfehlen sie zu benutzen. Abhängig von den Einstellungen von `sudo` werden einige Anleitungen nicht als "normaler" User funktionieren, sondern nur als `root`. Seit Debian 11 (bullseye), ist [https://packages.debian.org/stable/josm-installer josm-installer] unter **''main''** in dem Abschnitt **''utils''** verfügbar. Es läd die aktuelle .jar Datei von dieser Webseite herunter und aktualisiert sie falls nötig. Die 'tested version' von [https://packages.debian.org/stable/josm JOSM] ist unter **''main''** in dem Abschnitt **''utils''** verfügbar, jedoch ist sie meist recht alt. Bitte, benutze das [https://backports.debian.org Backports Repository] um eine aktuelle Version zu erhalten, siehe [https://backports.debian.org/Instructions Anleitung (en)]. Jedoch kann auch diese Version recht alt sein. === openSUSE ===#openSUSE Die freigegebene Version von JOSM ist im Application:Geo Repository verfügbar. Füge zuerst als root-Benutzer in yast oder mit zypper das Repository hinzu (für Tumbleweed **$releasever** durch **openSUSE_Tumbleweed** ersetzen): {{{ zypper ar -f 'https://download.opensuse.org/repositories/Application:/Geo/$releasever' Application:Geo }}} Dann installiere einfach das ''josm'' und das ''josm-fonts'' Paket. == Fehlerbeseitigung ==#Troubleshooting === Java ===#Java [=#Doubleclickonafiledoesnothing Wenn nach dem Doppelklick auf eine jar-Datei nichts passiert], ist häufig Java nicht installiert. JOSM wurde getestet mit Varianten von Oracles, daher empfahlen wir Java von der dortigen [https://www.java.com/de/download/manual.jsp manuellen Download]-Seite oder Seite [https://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html mit Zwischenprüfung] zu beziehen. JOSM empfiehlt jetzt [https://www.azul.com/downloads/?package=jre-fx#download-openjdk Azul] oder [https://bell-sw.com/pages/downloads/?package=jre-full#mn Bellsoft Liberica] JDK's. Im Allgemeinen sollte die aktuelle Java Version mit Langzeitunterstützung (LTS) bevorzugt werden (im Moment des Schreibens ist das Java 17), aber Java 8 funktioniert auch. Siehe [source:/trunk/README README] für aktuelle Empfehlungen. Aber zuerst sollte das Java ausprobiert werden, das mit dem Betriebssystem verteilt wird, [https://en.wikipedia.org/wiki/OpenJDK zum Beispiel]. Beachte beim Auswählen eines Java-Downloads: * Es wird **kein** Java-Plugin im Web Browser benötigt, um JOSM zu nutzen. Daher sind Aussagen von Seiten wie www.java.com/de/download/installed8.jsp nicht relevant. * Ein 64 Bit-Java wird für JOSM empfohlen. Die Systemarchitektur des Betriebssystems ist leitend für die Entscheidung zwischen 32 Bit- und 64 Bit-Java. Weil JOSM **nicht** von der Architektur des Web Browsers abhängt, sind die meisten Empfehlungen auf www.java.com/de/download/faq/java_win64bit.xml nicht relevant. * Vermeide Seiten wie www.java.com/de/download deren Ziel die Platzierung von Java-Plugins in Web Browsern ist. Dies ist **nicht** wichtig für JOSM. Für weitere Informationen siehe die [wikitr:/InstallNotes Installationsnotizen] und [https://www.java.com/de/download/help/troubleshoot_java.xml Oracles Störungs]seite. ''Java'' in diesem Abschnitt bezeichnet eine JRE (Java Runtime Engine) die eine JVM (Java Virtual Machine) bereitstellt für JOSM, ein Java-Programm, das entwickelt wird unter Benutzung des JDK (Java Development Kit) und häufig gestartet wird über das JNLP (Java Network Launch Protocol aka Web-Start und Nachfolger von Java-Plugins für Web Browser). ==== Java testen ====#JavaTest [=#Troubleshootingjarfile] Prüft, ob Java installiert ist und warum JOSM ggf. nicht startet (Beispiel hauptsächlich für MS Windows). 1. Lade [/josm-tested.jar josm-tested.jar] herunter auf den Desktop. 1. Öffne eine Eingabeaufforderung aka Terminal 1. Gib `cd %homepath%`⏎ und `cd Desktop`⏎ ein. 1. Gib `java -version `⏎ ein. Drei Zeilen mit einer Versionsangabe sollten erscheinen. Falls nicht, ist Java nicht richtig installiert. 1. Gib `java -jar josm-tested.jar`⏎ ein. Nun sollte JOSM laufen, gestartet von der [wikitr:/Help/CommandLineOptions Befehlszeile]. 1. Beende JOSM. 1. Gib `josm-tested.jar`⏎ ein. Falls JOSM wieder startet, ist der Windows Explorer bereit, mit einem Doppelklick jar-Dateien zu starten. === Web-Start ===#Webstart [=#Troubleshootingjhlplink] Zuerst muss [https://openwebstart.com/ OpenWebStart] installiert werden. Dies wird Java herunterladen und starten. Der Übergang von Oracle WebStart zu OpenWebStart ist noch am Laufen, so im Fall von Problemen erstellt bitte ein [/newticket neues Ticket] oder schreibt einen Kommentar unter #17858. Eventuell müssen das Standardprogramm zum Offnen von jnlp-Datein neu zugewiesen werden, falls vorher Oracle WebStart verwendet wurde. Siehe https://openwebstart.com/docs/OWSGuide.html#_jnlp_file_association jnlp-Dateizuweisung (en)] für Anweisungen zum Setzten von OpenWebStart als Standardprogramm für jnlp-Dateien. ==== Web-Start testen ====#Webstarttest 1. Lade [/download/josm.jnlp josm.jnlp] herunter auf den Desktop. 1. Öffne eine Eingabeaufforderung und gehe zum Desktop, wie oben. 1. Gib `javaws josm.jnlp`⏎ ein. Dies sollte JOSM herunterladen, einen Sicherheitsdialog anzeigen und dann JOSM aufrufen. 1. Falls dies scheitert, gib `javaws -verbose josm.jnlp`⏎ ein. Dies sollte zuerst einen Dialog mit Informationen über die JVM anzeigen und dann JOSM starten. === Virtuelle Maschine ===#Troubleshootingjvm ==== Speichermangel ====#Outofmemory Heutzutage ist eine manuelle Beeinflussung des Speichers für Java nur noch selten nötig, weil der verfügbare Arbeitsspeicher in Computern angewachsen ist. Schlecht gewählte Einstellungen können die Leistung von JOSM beeinträchtigen. Bei einigen Aufgaben hat JOSM einen erhöhten Bedarf an Arbeitsspeicher. Einerseits mag es notwendig sein, viel Speicher für zahlreiche Plugins und Features bereitzustellen. Auf der anderen Seite können langsamere Maschinen durch eine Begrenzung des Speichers für Java stabilisiert werden. Bei Bedarf kann in der [wikitr:/Help/CommandLineOptions#Javaoptions Befehlszeile] die [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BABHDABI Java-Optionen] -Xmx…m gesetzt werden, zum Beispiel `-Xmx512m` oder `-Xmx1536m`. Für Debian/Ubuntu kann die Datei `/etc/default/josm` bzw. `/etc/default/josm-latest` bearbeitet werden. \\ Früher akzeptierten ältere Java-Umgebungen auch `-Xmx=512m` oder sogar`-Xmx 512m`. Heute gilt dies als unförmiges Argument und erzeugt eine Fehlermeldung. ==== VM-Auswahl ====#VMselectiononWindowsx64 Bei aktuellen MS Windows-Ausgaben wird Java standardmäßig im Verzeichnis `C:\Program Files\Java\` installiert. Zusätzliche Teile werden platziert in `C:\Program Files\Oracle\Java\`. Dort befindet sich als Ziel für die Umgebungsvariable PATH das Verzeichnis `.\javapath\`. Es enthält die drei virtuellen Dateien `java.exe`, `javaw.exe` und `javaws.exe`. Dies sind symbolische Links auf die tatsächlichen Dateien der aktuellen Java-Installation. Auf älteren 64-bit Windows Versionen wurde manchmal der 32-bit JRE Modus zusätzlich installiert. Auch lieferten einige Browser ihr eigenes, limitiertes Java und Java Web Start, das irgendwo anders installiert wird. Dies kann dazu führen, dass das JNLP mit dieser Ersatz-JRE ausgeführt wird. Überprüfen Sie zum Beispiel, dass nicht ein anderer Javawebstart unter \Windows\SysWow64 existiert. Man sollte es nicht benötigen (die Java Kontrollleiste wird es nicht erkennen) und es kann sicher entfernt werden. Man sollte aufräumen und nur die neueste Version des JRE (eine für den 32-bit Modus, eine andere für den 64-bit Modus) behalten. Bei Starter für JNLP welche auf der Windows Arbeitsfläche erstellt wurden und Java Web Start starten ist es wichtig sicher zu stellen, dass VM Parameter mit einem Präfix `-J` ohne anschließendes Leerzeichen vor der VM Option übergeben werden. Falls sowohl eine 32-bit als auch eine 64-bit Version installiert ist, sollte die Option "`-d64`" übergeben werden um die bevorzugte 64-bit VM auszuwählen. Anmerkung: Einige Oracle Dokumentationsseiten geben die Option fälschlicher weise mit Großbuchstaben an, "-D64". Beispiel einer bearbeiteten Kommandozeile für den Starter welcher auf der Windows Arbeitsfläche erstellt wurde nachdem JOSM nur ein einziges Mal vom JNLP aus ausgeführt und wieder beendet wurde: {{{ #!sh javaws.exe -J-d64 -J-Xmx2048m josm.jnlp }}} Man braucht hier nicht das Ende mit den "snipped" Abschnitten ändern. Wichtig ist nur der Pfad zu javaws.exe und das Hinzufügen der Optionen `-J-d64` für den 64-bit Modus, welcher zum Arbeiten mit großen Datensätzen benötigt wird, und `-Xmx=2048m` um die VM Größe zu erhöhen (auf 2GB in diesem Beispiel). === Windows JOSM.exe ===#Mswindowswrapper Die Installation von josm-setup.exe auf Microsoft Windows bewirkt: * das Speichern der ausführbaren Dateien `JOSM.exe` und `HWConsole.exe` im Verzeichnis `%LOCALAPPDATA%\JOSM` * das Registrieren von JOSM.exe als Ziel für die Dateinamenserweiterungen `*.osm`, `*.geojson`, `*.gpx`, `*.jos` und `*.joz`. * das Platzieren von JOSM-Symbolen auf dem Desktop und im Startmenü. * das Ablegen der Deinstallationsinformationen. Wenn JOSM.exe startet, wird die eingebettete Java Version, welche von den JOSM-Verantwortlichen gewartet wird und auf Azul Zulu basiert, gestartet. JOSM.exe handelt als ''wrapper'' und ist [wikitr:/USB_Stick portabel]. HWConsole.exe ist ähnlich zu JOSM.exe aber es wird ein Windowskonsolenfenster für die Standardausgabe (logs) offen gehalten. JOSM.exe akzeptiert alle [wikitr:/Help/CommandLineOptions#Programarguments JOSM-Programmargumente] auch. Zum Beispiel: {{{ #!sh # OSM-Daten laden josm.exe https://www.osm.org/way/476702262 }}} Um Java-Optionen an die Java-VM zu übergeben wird die Datei `JOSM.cfg` im Anwendungsunterverzeichnis von JOSM.exe verwendet. In dieser Datei benötigt jede Option eine eigene Zeile und Kommentare sind möglich. === macOS ===#macOS [=#MacOSErrors][=#MacOSXMountainLionErrors][=#Macoserrors] {{{ #!comment old section title, keeping as anchor for old links }}} ==== Mit brew ====#brew macOS Benutzende können den Paketmanager [https://brew.sh/ homebrew] zum Installieren und Aktualisieren von JOSM verwenden. Im Terminal. gib den Befehl `brew install --cask josm` zum Installieren von JOSM oder den Befehl `brew upgrade --cask josm` zum Aktualisieren der JOSM-Version auf die letzte stabile Freigabe ein. === Bekannte Probleme ===#Knownissues Offene Fehlertickets über: * [/query?status=!closed&type=defect&keywords=~java Java Fehler] - Einige davon sind ''blockers'' in Oracles JVM (siehe [wiki:JavaBugs JavaBugs]). * [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux] * [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu] * [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority MacOS] * [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority MS Windows]