Download

Diese Seite bietet Hinweise zur Installation und zum Aufrufen von JOSM. Für die Arbeit mit JOSM gibt es die Einführung und die Hilfe-Seiten. Und für sehr komplexe Fragen die Installationsdetails.

Empfohlene Optionen

Starten josm.jnlp (Neueste stabile Freigabe)
Empfohlene Version, für alle Plattformen, monatliche automatische Aktualisierung (Wie starten).

Herunterladen josm-tested.jar (Version 19253, Stabile Freigabe)
Alle Plattformen (Wie aufrufen).

Alle Download-Optionen

Jeden Monat erstellt das Team von JOSM eine stabile Freigabe (en), genannt tested version, zum Herunterladen. Die Varianten für MS Windows und Apple Mac beruhen darauf. Beim Klick auf josm.jnlp wird immer die neueste stabile JOSM-Freigabe gestartet.

Jede 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 Mac	Ubuntu, Debian…	openSUSE	Jar / Javadoc / Quelle
Stabile Freigabe (Version 19253)	josm.jnlp	josm-tested.jar	setup.exe (siehe unten)	package.zip (siehe unten)	siehe unten	siehe unten	josm:19253
Entwicklungsversion 19265	latest.jnlp	josm-latest.jar			siehe unten		Schnappschuss verwenden
ältere		download/		​automatische JOSM.app Erstellung	dists/		tested versions

Herunterladeskripte sollten zunächst latest, tested oder both prüfen, um die Bandbreite zu reduzieren.

Übersetzungen weglassen
Falls die Dateigröße ein Problem ist, werden kleinere Dateien der stabilen Freigabe angeboten. Für Programmdateien nur mit Englischer Sprache hänge ?lang=en an die URL. Um eine Übersetzung zu erhalten, ersetze das en it dem entsprechenden Sprachkürzel (en) (kleiner erster Buchstabe, nur unterstützte Sprachen). Die Dateigröße kann weiter um die Signaturen reduziert werden durch das Anhängen von ?unsigned=1.

Linux Repositories

Eigenes Debian-basierendes haupsächlich für 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 Ubuntu-Repository.
• josm-latest – Die nächtliche Entwicklungsversion. Kann parallel zum josm-Paket installiert werden. Der Standardeinstellungsordner ist ~/.josm-latest.

Zusätzlich zum unten beschrieben Prozedere können ältere DEBs manuell heruntergeladen und installiert werden.

Installation

Die Paketquellenliste /etc/apt/sources.list muss angepasst werden:

sudo editor /etc/apt/sources.list

und eine der folgenden Zeilen entsprechend der Ubuntu-Version eingefügt werden:

deb https://josm.openstreetmap.de/apt hirsute universe
deb https://josm.openstreetmap.de/apt groovy universe
deb https://josm.openstreetmap.de/apt focal universe
deb https://josm.openstreetmap.de/apt eoan universe
deb https://josm.openstreetmap.de/apt disco universe

# For other Debian based distributions add:
deb 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):

echo deb 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:

echo deb 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

Den öffentlichen Schlüssel herunterladen und registrieren:

wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -

Die eigene Paketliste auffrischen (ggf. ist sudo apt-get install apt-transport-https zu installieren)

sudo apt-get update

und installieren:

# 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

Die 'tested version' von JOSM ist unter main in dem Abschnitt utils verfügbar.

Bitte, benutze das ​Backports Repository um eine aktuelle Version zu erhalten, siehe ​Anleitung (en).

openSUSE

Die stabile Freigabe von JOSM ist verfügbar im Application:Geo Repository.

Füge zuerst als root-Benutzer in yast oder mit zypper das Repository hinzu (ersetze die Version in der URL mit der, die du nutzt):

zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.0 Application:Geo

Dann installiere einfach das josm und das josm-fonts Paket.

Fehlerbeseitigung

Java

Wenn nach dem Doppelklick auf eine jar-Datei nichts passiert, ist häufig Java nicht installiert.

JOSM wird getestet mit Oracles JVM, daher empfehlen wir Java von der dortigen ​manuellen Download-Seite oder Seite ​mit Zwischenprüfung zu beziehen. Aber zuerst sollte das Java ausprobiert werden, das mit dem Betriebsystem verteilt wird, ​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 Installationsnotizen und ​Oracles Störungsseite. 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

Prüft, ob Java installiert ist und warum JOSM ggf. nicht startet (Beispiel hauptsächlich für MS Windows).

1. Lade josm-tested.jar herunter auf den Desktop.
2. Öffne eine Eingabeaufforderung aka Terminal
3. Gib cd %homepath%⏎ und cd Desktop⏎ ein.
4. Gib java -version ⏎ ein. Drei Zeilen mit einer Versionsangabe sollten erscheinen. Falls nicht, ist Java nicht richtig installiert.
5. Gib java -jar josm-tested.jar⏎ ein. Nun sollte JOSM laufen, gestartet von der Befehlszeile.
6. Beende JOSM.
7. Gib josm-tested.jar⏎ ein. Falls JOSM wieder startet, ist der Windows Explorer bereit, mit einem Doppelklick jar-Dateien zu starten.

Web-Start

Falls es Problem mit Web-Start gibt, versuche bitte zuerst Java zu testen, danach gehe durch alle unten oder anderwärts beschriebenen Tests, ​Web Start Probleme. Oracle hat Web-Start von Java 9 an eingestellt. In diesem Fall ist es nötig, ​OpenWebStart separate zu installieren.

Web-Start testen

1. Lade josm.jnlp herunter auf den Desktop.
2. Öffne eine Eingabeaufforderung und gehe zum Desktop, wie oben.
3. Gib javaws josm.jnlp⏎ ein. Dies sollte JOSM herunterladen, einen Sicherheitsdialog anzeigen und dann JOSM aufrufen.
4. 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

Speichermangel

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 Befehlszeile die ​Java-Optionen -Xmx…m gesetzt werden, zum Beispiel -Xmx512m oder -Xmx1536m. 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

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.

Unter Windows liefern einige Browser ihr eigenes Java nebst 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 Kontrolleiste 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.

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:

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

Die Installation von josm-setup.exe auf Microsoft Windows bewirkt:

• das Speichern der Dateien josm.exe und josm-tested.jar in einem benutzergewählten Verzeichnis, standardmäßig C:\Program Files (86)\JOSM\
• den Vorschlag, josm.exe as Ziel für die Dateinamenserweiterungen *.osm und *.gpx zu registrieren,
• den Vorschlag, JOSM-Symbole auf dem Desktop und im Startmenü zu platzieren (Derzeit nur für einen Administrator, können von dort kopiert werden, #11398).
• die Frage, ob die Plugins Imagery offset database und Turn restrictions bereitgestellt werden sollen und
• das Ablegen der Deinstallationsinformationen.

Wenn josm.exe startet, sucht es in seinem Verzeichnis nach josm-tested.jar und ruft dann den Befehl \path\to\javaw.exe -Xms128m -Xmx1024m -jar \path\to\josm-tested.jar auf. Josm.exe handelt als wrapper und ist portabel (en).

Sollte josm.exe die Option --l4j-debug finden, schreibt es die Logdatei launch4j.log in sein Verzeichnis, sofern das beschreibbar ist. Weitere ​Optionen sind möglich und alle JOSM-Programmargumente auch. Zum Beispiel:

# Schreibt ein Log beim Starten von JOSM und dem Laden von OSM-Daten
josm.exe --l4j-debug https://www.osm.org/way/476702262

Um Java-Optionen an die Java-VM zu übergeben wird die optionale Datei josm.l4j.ini im selben Verzeichnis von josm.exe verwendet. In dieser Datei benötigt jede Option eine eigene Zeile und Kommentare sind möglich, siehe ​Zusätzliche JVM-Optionen.

Fehler bei macOS

Heruntergeladen aus dem Internet

Beim ersten Aufruf von JOSM, wird eine Meldung, dass 'JOSM.app' eine aus dem Internet heruntergeladene Anwendung ist, angezeigt. Wähle "öffnen" im Kontextmenü von JOSM.app oder josm.jnpl durch Rechts-Klick bzw. Strg-Klick. Dann wird die gleiche Meldung erneut angezeigt, hat aber die zusätzliche Schaltfläche "Öffen".

Mit brew

macOS Benutzende können den Paketmanager ​homebrew zum Installieren und Aktualisieren von JOSM verwenden. Die Verwendung von brew cask verhindert die oben erwähnten Probleme.

Im Terminal. gib den Befehl brew cask install josm zum Installieren von JOSM oder den Befehl brew cask upgrade josm zum Aktualisieren der JOSM-Version auf die letzte stabile Freigabe ein.

Bekannte Probleme

Offene Fehlertickets über:

• Java Fehler - Einige davon sind blockers in Oracles JVM (siehe JavaBugs).
• Linux
• Ubuntu
• MacOS
• MS Windows