| 4 | | == Überblick == |
| 5 | | |
| 6 | | || ||= Betriebssystem unabhängig =||= [https://www.java.com/de/download/faq/java_webstart.xml Web Start] =||= Windows =||= Mac OS X =||= Ubuntu, … =||= openSUSE =|| |
| 7 | | ||= **tested** [[Version(tested)]] =|| **[/josm-tested.jar jar ]** || [/download/josm.jnlp jnlp] || [/download/windows/josm-setup.exe setup.exe] ([wiki:USB_Stick portable]) || [/download/macosx/josm-macosx.zip package.zip] || ''[#Ubuntu siehe unten]'' || ''[#openSUSE siehe unten]'' || |
| 8 | | ||= latest [[Version(latest)]] =|| [/josm-latest.jar jar] || [/download/josm-latest.jnlp jnlp] || || || ''[#Ubuntu siehe unten]'' || || |
| 9 | | ||= ältere =|| [/download/ download/] || || || || || || |
| 10 | | |
| 11 | | * **Welche Version sollte ich benutzen ?** (siehe auch: [wiki:Releases Veröffentlichungssystem]) |
| 12 | | * ''tested'' wird etwa monatlich veröffentlicht und sollte keine schwereren Fehler enthalten. |
| 13 | | * ''latest'' wird täglich veröffentlicht und kann mehr Fehler enthalten. |
| 14 | | * Wenn möglich sollte die Web-Start Version verwendet werden damit die automatische Aktualisierung funktioniert. |
| 15 | | |
| 16 | | * Die .jar-Datei mit 'jarsigner' verifizieren |
| 17 | | |
| 18 | | ---- |
| 19 | | [[PageOutline(2-3,Page Outline)]] |
| 20 | | |
| 21 | | * **Beachten Sie, dass es ziemlich regelmäßige Aktualisierungen gibt und man versuchen sollte eine neuere Version (und auch neuere Pluginversion) zu benutzen. |
| 22 | | * [/download/josm.jnlp JOSM-WebStart] aufrufen (ohne Installation) |
| 23 | | * **[/josm-tested.jar tested JOSM ]** Version [[Version(tested)]] herunterladen |
| 24 | | * [/download/windows/josm-setup.exe Windows JOSM Installer] Version [[Version(windows)]] herunterladen |
| 25 | | * [/download/macosx/josm-macosx.zip Mac OS X JOSM Paket] Version [[Version(macos)]] herunterladen |
| 26 | | * Einen [wiki:USB_Stick USB Stick (en)] herrichten um JOSM auf jeder fremden Windows Computer zu verwenden. |
| 27 | | * Für Download-Scripte die Versionskontroll für [/latest latest] und [/tested tested] (oder [/version beide]) verwenden um Download-Bandbreite zu reduzieren |
| 28 | | * Falls die Downloadgröße ein Problem ist: |
| 29 | | * Hänge **?lang=…** an die Downloadlinkadresse für beide Veröffentlichungen an, um nicht benötigte Sprachen zu entfernen (d.h. mit **?lang=de** wird JOSM in nur deutscher Sprache heruntergeladen). |
| 30 | | * **Anmerkung**: Um Ländererweiterungen des [[wiki:De:Translations|Sprachcodes]] zu trennen wird der Unterstrich verwendet, z.B. **?lang=en_GB**. |
| 31 | | * Hänge **?unsigned=1** an, um die Codesignaturinformationen zu entfernen |
| 32 | | * Wenn **lang** und **unsigned** verwendet werden, ist das Trennzeichen ein **&**-Zeichen, wie in **?lang=de&unsigned=1** |
| 33 | | |
| 34 | | == Mac OS X Mountain Lion Fehler ==#MacOSXMountainLionErrors |
| 35 | | [[Image(#8787:damaged_josm_app.png,align=right,margin-top=-35)]] |
| 36 | | Diese misverständliche Fehlermelding kann erscheinen: **JOSM.app is damaged and can't be opened. You should move it to the Trash.** |
| 37 | | |
| 38 | | Um die Installation fortzusetzten muß man in die OS X Einstellungen gehen und unter 'Sicherheit und Privatsphäre' die Einstellungen ändern um das Herunterladen von 'überall' erlauben. |
| 39 | | |
| 40 | | Nachdem JOSM das erste Mal ausgeführt wurde kann man zu den Einstellungen zurückkehren und diese auf den vorherigen Stand zurücksetzten. |
| 41 | | |
| 42 | | |
| 43 | | == Entwicklerversion ==#DevelopmentVersion |
| 44 | | * Die **[/josm-latest.jar neueste JOSM-Version]** [[Version(latest)]] herunterladen (kann mehr Fehler als "tested" enthalten, mit Vorsicht zu genießen) |
| | 5 | Diese Seite bietet erste Hinweise zur Installation von JOSM und zur Fehlerbehebung. |
| | 6 | Für die ersten Schritte mit JOSM gibt es die [[wikitr:Introduction|Einführung]] und die [[wikitr:Help|Hilfe]]-Seiten. |
| | 7 | Und für sehr komplexe Fragen die [[wikitr:InstallNotes|Installationsnotizen]]. |
| | 8 | |
| | 9 | == Empfohlene Optionen ==#Recommendedoptions |
| | 10 | |
| | 11 | [[Image(source:trunk/images/openlocation.png, valign=middle, link=download/josm.jnlp )]] **Launch [/download/josm.jnlp josm.jnlp]** (newest tested version) [[br]] Recommended version, all platforms, automatic update to the newest ''tested version'' monthly ([wiki:#Troubleshootingjnlplink how to launch]).[[br]] |
| | 12 | |
| | 13 | [[br]] |
| | 14 | [[Image(source:trunk/images/download.png, valign=middle, link=)]] **Download [/josm-tested.jar josm-tested.jar]** (tested version [[Version(tested)]]) [[br]] All platforms ([wiki:Download#Troubleshootingjarfile how to start]). |
| | 15 | |
| | 16 | [[br]] |
| | 17 | |
| | 18 | == All download options ==#Moredownloadoptions |
| | 19 | |
| | 20 | Jeden [/roadmap Monat] bietet das Team von JOSM eine stabile [wiki:Releases Freigabe], genannt **tested version**, zum Herunterladen an. |
| | 21 | Die Varianten für MS Windows und Apple Mac beruhen auf dieser stabilen Freigabe. |
| | 22 | Beim Klick auf josm.jnlp wird immer die neueste stabile Freigabe von JOSM gestartet. Der [wiki:InstallNotes#Webstart Web Start]-Mechanismus von Java sorgt dafür. |
| | 23 | |
| | 24 | [=#DevelopmentVersion] |
| | 25 | Jede [/log/josm/?verbose=on&limit=20 Nacht] erzeugen die Built-Systeme eine Entwicklungsversion, genannt **latest version**. |
| | 26 | Diese Versionen können schwere Fehler enthalten. Aber meistens funktionieren sie auch gut. |
| | 27 | Auch für diese Version ist eine Web Start-Variante verfügbar. |
| | 28 | |
| | 29 | |
| | 30 | ||= =||||= Für alle Betriebssysteme =|||||||||| |
| | 31 | ||=Version =||= Web Start =||= Herunterladen =||= Windows =||= Apple Mac =||= Ubuntu, Debian… =||= openSUSE =|| |
| | 32 | ||Stabil [[Version(tested)]] || \ |
| | 33 | || [/download/josm.jnlp josm.jnlp] || \ |
| | 34 | || [/josm-tested.jar] || \ |
| | 35 | || [[br]] [/download/windows/josm-setup.exe setup.exe] [[br]]''([wiki:USB_Stick portable])'' || \ |
| | 36 | || [[br]] [/download/macosx/josm-macosx.zip package.zip] [[br]]''([#MacOSerrors siehe unten])'' || \ |
| | 37 | || ''[#Ubuntu siehe unten]'' || \ |
| | 38 | || ''[#openSUSE siehe unten]'' || |
| | 39 | ||Entwicklung [[Version(latest)]] || \ |
| | 40 | || [/download/josm-latest.jnlp latest.jnlp] || \ |
| | 41 | || [/josm-latest.jar] || \ |
| | 42 | || || || ''[#Ubuntu siehe unten]'' || || |
| | 43 | ||=ältere =|| || [/download/ download/] || || || [/apt/dists/ dists/] || || |
| | 44 | |
| | 45 | Herunterladeskripte sollten zunächst [/latest latest], [/tested tested] oder [/version both] prüfen, um die Bandbreite zu reduzieren. |
| | 46 | |
| | 47 | ** Übersetzungen weglassen **[=#Striptranslations] \\ |
| | 48 | Falls die Dateigröße ein Problem ist, werden kleinere Dateien der stabilen Freigabe angeboten. smaller files of the tested version are available. For downloads containing only English append [/josm-tested.jar?lang=en ?lang=en] to the URL. To include one translation replace `en` with the [wiki:/TracLanguages language code] you want (lowercase first character, supported languages only). You can further reduce the file size by stripping the signing information off with appending [/josm-tested.jar?lang=en&unsigned=1 ?unsigned=1]. |
| | 49 | |
| | 50 | == Repositories == |
| | 51 | |
| | 52 | === openSUSE ===#openSUSE |
| | 53 | |
| | 54 | Die stabile Freigabe von JOSM ist verfügbar im Application:Geo Repository. |
| | 55 | |
| | 56 | 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): |
| | 57 | {{{ |
| | 58 | zypper ar -f http://download.opensuse.org/repositories/Application:/Geo/openSUSE_13.2 Application:Geo |
| | 59 | }}} |
| | 60 | |
| | 61 | Dann installiere einfach das **josm** und das **josm-fonts** Packet. |
| | 62 | |
| | 63 | == Ubuntu ==#Ubuntu |
| | 64 | |
| | 65 | Dies ist ein 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. |
| | 66 | |
| | 67 | Das Repository enthält zwei Pakete: |
| | 68 | * ''josm'' – Enthält die stabile Freigabe (tested). Ersetzt das Paket aus dem offiziellen Ubuntu-Repository. |
| | 69 | * ''josm-latest'' – Die nächtliche Entwicklungsversion. Kann parallel zum ´josm´-Paket installiert werden. Der Standardeinstellungsordner ist {{{~/.josm-latest}}}. |
| | 70 | |
| | 71 | Hinweis: zusätzlich zum normalen Prozedere, welches unten beschrieben ist, können ältere DEBs von den folgenden Pfaden manuell heruntergeladen und installiert werden: [https://josm.openstreetmap.de/apt/pool/universe/j/josm/ für josm] [https://josm.openstreetmap.de/apt/pool/universe/j/josm-latest/ für josm-latest] |
| | 72 | |
| | 73 | ==== Installation ==== |
| | 74 | |
| | 75 | Die Paketquellenliste {{{/etc/apt/sources.list}}} muss angepasst werden: |
| | 76 | |
| | 77 | {{{ |
| | 78 | #!sh |
| | 79 | sudo editor /etc/apt/sources.list |
| | 80 | }}} |
| | 81 | |
| | 82 | und eine der folgenden Zeilen entsprechend der Ubuntu-Version eingefügt werden: |
| | 83 | |
| | 84 | {{{ |
| | 85 | #!sh |
| | 86 | deb https://josm.openstreetmap.de/apt trusty universe |
| | 87 | deb https://josm.openstreetmap.de/apt xenial universe |
| | 88 | deb https://josm.openstreetmap.de/apt artful universe |
| | 89 | # For other Debian based distributions add: |
| | 90 | deb https://josm.openstreetmap.de/apt alldist universe |
| | 91 | }}} |
| | 92 | |
| | 93 | Alternativ kann dies auch mit dem folgenden Einzeiler erfolgen: |
| | 94 | {{{ |
| | 95 | echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | ↩ |
| | 96 | ↪sudo tee /etc/apt/sources.list.d/josm.list > /dev/null |
| | 97 | }}} |
| | 98 | |
| | 99 | {{{#!comment |
| | 100 | ### below did not work on all systems |
| | 101 | and add the following line: |
| | 102 | ` |
| | 103 | deb https://josm.openstreetmap.de/apt VERSION universe |
| | 104 | ` |
| | 105 | }}} |
| | 106 | |
| | 107 | Den [[/josm-apt.key|öffentlichen Schlüssel]] herunterladen und registrieren: |
| | 108 | {{{ |
| | 109 | #!sh |
| | 110 | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - |
| | 111 | }}} |
| | 112 | |
| | 113 | Die eigene Paketliste auffrischen (ggf. ist `sudo apt-get install apt-transport-https` zu installieren) |
| | 114 | {{{ |
| | 115 | #!sh |
| | 116 | sudo apt-get update |
| | 117 | }}} |
| | 118 | und installieren: |
| | 119 | () |
| | 120 | {{{ |
| | 121 | #!sh |
| | 122 | # Die erste Zeile ist entbehrlich, falls diese Pakete vorher nicht installiert waren.) |
| | 123 | sudo apt-get remove josm josm-plugins |
| | 124 | |
| | 125 | # Für die stabile Freigabe |
| | 126 | sudo apt-get install josm |
| | 127 | # für die Entwicklungsversion |
| | 128 | sudo apt-get install josm-latest |
| | 129 | }}} |
| | 130 | |
| | 131 | == Fehlerbeseitigung ==#Troubleshooting |
| | 132 | === Java ===#Java |
| | 133 | [=#Doubleclickonafiledoesnothing Wenn nach dem Doppelklick auf eine jar-Datei nichts passiert], ist häufig Java nicht installiert. |
| | 134 | |
| | 135 | JOSM wird getestet mit Oracles JVM, daher empfehlen wir Java von der dortigen [https://www.java.com/de/download/manual.jsp manuellen Download]seite zu beziehen. Aber zuerst sollte das Java ausprobiert werden, dass mit dem Betriebsystem verteilt wird, [https://en.wikipedia.org/wiki/OpenJDK zum Beispiel]. |
| | 136 | |
| | 137 | Beachte beim Auswählen eines Java-Downloads: |
| | 138 | * 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. |
| | 139 | * Eine Java-Variante mit 64 Bit wird für JOSM empfohlen. Die Systemarchitektur des Betriebssystems (32 oder 64 Bit) ist leitend für die Entscheidung zwischen 32 Bit-Java 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. |
| | 140 | * Vermeide Seiten wie www.java.com/de/download deren Ziel die Platzierung von Java-Plugins in Web Browsern ist. Und dies ist **nicht** wichtig für JOSM. |
| | 141 | |
| | 142 | Für weitere Informationen siehe die [[wikitr:InstallNotes|Installationsnotizen]] und [https://www.java.com/de/download/help/troubleshoot_java.xml Oracles Störungs]seite. |
| | 143 | ''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). |
| | 144 | |
| | 145 | ==== Java testen ====#Javatest |
| | 146 | [=#Troubleshootingjarfile] Prüft ob Java installiert ist und warum JOSM ggf. nicht startet (Beispiel hauptsächlich für MS Windows). |
| | 147 | 1. Lade [/josm-tested.jar josm-tested.jar] herunter auf den Desktop. |
| | 148 | 1. Öffne eine Eingabeaufforderung aka Terminal |
| | 149 | 1. Tippe `cd %homepath%`⏎ und tippe `cd Desktop`⏎ |
| | 150 | 1. Tippe `java -version `⏎ Drei Zeilen mit einer Versionsangabe sollten erscheinen. Falls etwas anderes erscheint, ist Java nicht richtig installiert. |
| | 151 | 1. Tippe `java -jar josm-tested.jar`⏎. Nun sollte JOSM laufen, gestartet von der [wikitr:/Help/CommandLineOptions Befehlszeile]. |
| | 152 | 1. Beende JOSM. |
| | 153 | 1. Tippe `josm-tested.jar`⏎. Falls JOSM wieder startet, ist der Windows Explorer bereit, mit einem Doppelklick jar-Dateien zu starten. |
| | 154 | |
| | 155 | |
| | 156 | === Web Start ===#Webstart |
| | 157 | [=#Troubleshootingjhlplink] |
| | 158 | Das Aufrufen von JOSM mittels Web Start kann weitaus mehr Fehlerursachen haben als der übliche Weg über das Herunterladen einer jar-Datei und deren anschließendes Starten. |
| | 159 | Daher sollte zunächst [#JavaTest Java getestet] werden und danach stehen weitere Test wie im folgenden beschrieben an oder anderwärts [https://www.java.com/en/download/faq/java_webstart.xml Web Start Probleme]. |
| | 160 | |
| | 161 | ==== Testing Web Start ====#Webstarttest |
| | 162 | 1. Lade [/josm-tested.jar josm.jnlp] herunter auf den Desktop. |
| | 163 | 1. Öffne eine Eingabeaufforderung und gehe zum Desktop wie vor. |
| | 164 | 1. Tippe `javaws josm.jnlp`⏎. Dies sollte zuerst JOSM herunterladen, einen Sicherheitsdialog anbieten und dann JOSM aufrufen. |
| | 165 | |
| | 166 | |
| | 167 | === Virtuelle Maschine ===#Troubleshootingjvm |
| | 168 | |
| | 169 | ==== Out of memory ==== |
| | 170 | |
| | 171 | Nowadays manually controlling Javas memory is seldom needed because available RAM on computers has grown. |
| | 172 | Wrongly chosen values can decrease JOSM performance. |
| | 173 | |
| | 174 | For some tasks, JOSM has a large appetite for memory. On the one hand, it may be necessary to configure a memory size that supports more plugins and features. On the other hand can slow machines be stabilized by restricting Javas memory use. |
| | 175 | If needed, use the [wiki:Help/CommandLineOptions command line] to set the [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BABHDABI Java Option] -Xmx…m, for example `-Xmx512m` or `-Xmx1536m`. |
| | 176 | Formerly older java programs accepted `-Xmx=512m` or even `-Xmx 512m`. Now those malformed arguments throw error messages. |
| | 177 | |
| | 178 | |
| | 179 | ==== VM selection ====#VMselectiononWindowsx64 |
| | 180 | |
| | 181 | On current versions of MS Windows by default Java is installed mainly in the `C:\Program Files\Java\` directory. Additional parts are placed in `C:\Program Files\Oracle\Java\`. There is a `.\javapath\` directory as target for the PATH environment variable. It is the home for the three virtual files `java.exe`, `javaw.exe` and `javaws.exe`. This files are symbolic links form the current Java installations. |
| | 182 | |
| | 183 | Unter Windows, muß man sich bewußt sein das einige Browser ihre mitgelieferten eigenen JRE nur im 32 bit Modus installieren und zusätzlich ihre eigenen Javawebstartwerkzeuge irgendwo anders mit unterschiedlichen Dateizuweisung installieren. Dies kann dazu führen, dass die JNLP mit diesem Ersatz-JRE ausgeführt wird, da es die falsche Javawebstartversion startet, welche nur die 32-bit VM unterstützt und manchmal mit einer eingeschränkten Unterstützung der VM Optionen und mit einer VM Größe, welche nicht 256MB übersteigt, erstellt wurde. |
| | 184 | |
| | 185 | Ü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. |
| | 186 | |
| | 187 | Für JNLP Start-Icon auf der Arbeitsfläche und um den Javawebstart (from \windows\system32) auszuführen, sollte man sicherstellen, dass man die VM Parameter mit vorangestellten -J und ohne Zwischenleerzeichen vor der VM Option übergibt. Wenn man beide, die 32-bit und die 64-bit, Version installiert hat, sollte man die Option "-d64" übergeben falls man das bevorzugte 64-bit VM auswählen will. Angemerkt sei, dass einige Oracle Dokumentationsseiten auf die Option "-D64" mit falschem Großbuchstaben verweisen. |
| | 188 | |
| | 189 | 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: |
| | 190 | |
| | 191 | javaws.exe -J-d64 -J-Xmx2048m josm.jnlp |
| | 192 | |
| | 193 | 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). |
| | 194 | |
| | 195 | === Windows josm.exe ===#Mswindowswrapper |
| | 196 | |
| | 197 | Using josm-setup.exe for installation on Microsoft Windows does the following: |
| | 198 | * Puts the files `josm-tested.jar` and `josm.exe` in directory chosen by the user, default is `C:\Program Files (86)\JOSM\` |
| | 199 | * Suggests to register josm.exe as target for the file extensions `*.osm` and `*.gpx`. |
| | 200 | * Suggests to place JOSM shortcut icons on the Desktop and in the Start Menu (Currently they are placed for an admin [ticket:11398 only] and can be copied from there). |
| | 201 | * Asks if the Plug-Ins Imagery offset database and Turn restrictions should be provided. |
| | 202 | * Adds uninstall data at the appropriate places. |
| | 203 | |
| | 204 | When starting, josm.exe searches its directory for the jar file and runs the command `\path\to\javaw.exe -Xms128m -Xmx1024m -jar \path\to\josm-tested.jar`. |
| | 205 | Josm.exe acts as a ''wrapper'' and is [wiki:/USB_Stick portable]. |
| | 206 | |
| | 207 | When josm.exe finds the argument `--l4j-debug`, it writes the log file `launch4j.log` into the current directory if that is writeable. Some other [http://launch4j.sourceforge.net/docs.html#Runtime_options options] are possible and all usual [wiki:/Help/CommandLineOptions#Programarguments JOSM Program arguments] too. See example: |
| | 208 | |
| | 209 | {{{ |
| | 210 | #!sh |
| | 211 | # Write a log while starting JOSM and load OSM data |
| | 212 | josm.exe --l4j-debug http://www.osm.org/way/476702262 |
| | 213 | }}} |
| | 214 | |
| | 215 | |
| | 216 | === MacOS Errors === |
| | 217 | [=#MacOSXMountainLionErrors] |
| | 218 | {{{ |
| | 219 | #!comment |
| | 220 | old section title, keeping as anchor for old links |
| | 221 | }}} |
| | 222 | ==== Heruntergeladen aus dem Internet ==== |
| | 223 | Falls die Meldung "'JOSM.app' ist ein Programm, dass aus dem Internet geladen wurde." oder ähnlich angezeigt wird, ist auf JOSM.app oder auf josm.jnlp nach **Rechtsklick** im Kontextmenü ''öffnen'' auszuwählen. Dann wird die gleiche Meldung erneut angezeigt, hat aber den zusätzlichen Befehlsknopf "Öffen". Diese Sicherheitsprozedur ist nur beim erstmaligen Starten von JOSM notwendig. |
| | 224 | |
| | 225 | ==== Damaged ==== |
| | 226 | [[Image(#8787:damaged_josm_app.png,width=300,align=right,margin-top=-50,margin-left=30)]] |
| | 227 | Falls eine Meldung "'JOSM.app' ist beschädigt und kann nicht geöffnet werden. Sie sollte in den Papierkorb verschoben werden" erscheint, ist vorübergehend der "Gatekeeper" zu deaktivieren. |
| | 228 | |
| | 229 | Dazu muß in den OS X Einstellungen unter 'Sicherheit und Privatsphäre' das Herunterladen von 'überall' erlauben. Nachdem JOSM das erste Mal ausgeführt wurde, kann diese Einstellung wieder zurückgesetzt werden. |
| | 230 | |
| | 231 | Falls diese Umschaltfläche im Register 'Sicherheit und Privatsphäre' fehlt, ist ein Terminal zu öffnen. Der folgende Befehl könnte die Umschaltfläch erkennbar machen. [[Image(SecurityPrivacy.png,align=right,float=left,width=300)]] |
| | 232 | {{{ |
| | 233 | sudo spctl --master-disable |
| | 234 | }}} |
| | 235 | Siehe auch https://support.apple.com/de-de/HT201940 |
| 65 | | == openSUSE Repository#openSUSE |
| 66 | | |
| 67 | | Die stabile Version von JOSM ist verfügbar im Application:Geo Repository. |
| 68 | | |
| 69 | | Füge zuerst als root user in yast oder mit zypper das Repository hinzu (ersetze die Version in der URL mit der, die du nutzt): |
| 70 | | {{{ |
| 71 | | zypper ar -f http://download.opensuse.org/repositories/Application:/Geo/openSUSE_13.2 Application:Geo |
| 72 | | }}} |
| 73 | | |
| 74 | | Dann installiere einfach das **josm** und das **josm-fonts** Packet. |
| 75 | | |
| 76 | | == Ubuntu Repository ==#Ubuntu |
| 77 | | Dies ist ein 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. |
| 78 | | [[BR]] |
| 79 | | Hinweis: zusätzlich zum normalen Prozedere, welches unten beschrieben ist, können ältere DEBs von den folgenden Pfaden manuell heruntergeladen und installiert werden: [https://josm.openstreetmap.de/apt/pool/universe/j/josm/ für josm] [https://josm.openstreetmap.de/apt/pool/universe/j/josm-latest/ für josm-latest] |
| 80 | | |
| 81 | | Das Repository enthält zwei Pakete: |
| 82 | | {{{josm}}}:: |
| 83 | | ''Die getestete Version (tested)''[[br]] |
| 84 | | Ersetzt das Paket aus dem offiziellen Ubuntu Repository. |
| 85 | | {{{josm-latest}}}:: |
| 86 | | ''Die Entwicklungsversion (nächtlich erstellt)''[[br]] |
| 87 | | Kann parallel zum {{{josm}}} Paket installiert werden. Der Standardeinstellungsordner ist {{{~/.josm-latest}}}. |
| 88 | | |
| 89 | | === Installation === |
| 90 | | Die Paketquellenliste {{{/etc/apt/sources.list}}} muss angepasst werden: |
| 91 | | {{{ |
| 92 | | #!sh |
| 93 | | sudo editor /etc/apt/sources.list |
| 94 | | }}} |
| 95 | | |
| 96 | | und eine der folgenden Zeilen entsprechend der Ubuntu-Version eingefügt werden: |
| 97 | | |
| 98 | | {{{ |
| 99 | | deb https://josm.openstreetmap.de/apt lucid universe |
| 100 | | deb https://josm.openstreetmap.de/apt precise universe |
| 101 | | deb https://josm.openstreetmap.de/apt quantal universe |
| 102 | | deb https://josm.openstreetmap.de/apt raring universe |
| 103 | | deb https://josm.openstreetmap.de/apt saucy universe |
| 104 | | deb https://josm.openstreetmap.de/apt trusty universe |
| 105 | | deb https://josm.openstreetmap.de/apt utopic universe |
| 106 | | deb https://josm.openstreetmap.de/apt vivid universe |
| 107 | | deb https://josm.openstreetmap.de/apt wily universe |
| 108 | | deb https://josm.openstreetmap.de/apt xenial universe |
| 109 | | }}} |
| 110 | | |
| 111 | | Alternativ kann dies auch mithilfe des folgenden Einzeilers realisiert werden: |
| 112 | | {{{ |
| 113 | | echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | sudo tee /etc/apt/sources.list.d/josm.list > /dev/null |
| 114 | | }}} |
| 115 | | |
| 116 | | Bei anderen Debian-basierenden Distributionen füge die folgende Zeile ein: |
| 117 | | |
| 118 | | {{{ |
| 119 | | deb https://josm.openstreetmap.de/apt alldist universe |
| 120 | | }}} |
| 121 | | |
| 122 | | {{{#!comment |
| 123 | | ### below did not work on all systems |
| 124 | | |
| 125 | | und die folgende Zeile muss eingefügt werden: |
| 126 | | {{{ |
| 127 | | deb https://josm.openstreetmap.de/apt VERSION universe |
| 128 | | }}} |
| 129 | | }}} |
| 130 | | |
| 131 | | Den [[/josm-apt.key|öffentlichen Schlüssel]] herunterladen und registrieren: |
| 132 | | {{{ |
| 133 | | #!sh |
| 134 | | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - |
| 135 | | }}} |
| 136 | | |
| 137 | | Die eigenen Paketliste auffrischen |
| 138 | | {{{ |
| 139 | | #!sh |
| 140 | | sudo apt-get update |
| 141 | | }}} |
| 142 | | |
| 143 | | und installieren: |
| 144 | | {{{josm}}}:: |
| 145 | | (Die erste Zeile kann weggelassen werden sofern diese Pakete nicht vorher installiert wurden.) |
| 146 | | {{{ |
| 147 | | #!sh |
| 148 | | sudo apt-get remove josm josm-plugins |
| 149 | | sudo apt-get install josm |
| 150 | | }}} |
| 151 | | |
| 152 | | {{{josm-latest}}}:: |
| 153 | | {{{ |
| 154 | | #!sh |
| 155 | | sudo apt-get install josm-latest |
| 156 | | }}} |
| 157 | | |
| 158 | | === Nützliche Optionen === |
| 159 | | Wenn JOSM der Speicher ausgeht, kann man die maximale Größe des zugewiesenen Speichers (400 MB in diesem Beispiel) erhöhen: |
| 160 | | {{{ |
| 161 | | JAVA_OPTS="-Xmx400M" josm |
| 162 | | }}} |
| 163 | | |
| 164 | | Mit einem anderem Einstellungenordner starten. |
| 165 | | {{{ |
| 166 | | JAVA_OPTS="-Djosm.home=$HOME/.josm-tmp" josm |
| 167 | | }}} |
| 168 | | |
| 169 | | |
| 170 | | |
| 171 | | == Störungen beheben == |
| 172 | | === Java ===#Java |
| 173 | | [=#Doubleclickonafiledoesnothing] |
| 174 | | Wenn nach dem Doppelklick auf eine jar-Datei nichts passiert, ist häufig Java nicht installiert. |
| 175 | | |
| 176 | | JOSM wird entwickelt und getestet mit Oracles JVM, daher empfehlen wir Java von der dortigen [https://www.java.com/de/download/manual.jsp manuellen Download]seite zu beziehen. |
| 177 | | Die Systemarchitektur des Betriessystems (32 oder 64 Bit) ist leitend beim [https://www.java.com/de/download/faq/java_win64bit.xml auswählen] der Installationsdateien. Java 64 Bit wird empfohlen für JOSM. |
| 178 | | Zum Vermeiden ist die Seite java.com/de/download, weil die dortigen Automatiken trügerisch sein können. |
| 179 | | Es wird **kein** Java-Plugin im Web Browser benötigt, um JOSM zu nutzen. |
| 180 | | |
| 181 | | Für weitere Informationen siehe die [InstallNotes Installationshinweise] und [https://www.java.com/en/download/help/troubleshoot_java.xml Oracles Störungs]seite |
| 182 | | |
| 183 | | ==== Testen der Java-Installation ====#Javatest |
| 184 | | [=#Troubleshootingjarfile] Prüft, was den Start von JOSM verhindet, die Beispiele sind für MS Windows. |
| 185 | | 1. Lade [/josm-tested.jar josm-tested.jar] herunter auf den Desktop. |
| 186 | | 1. Öffne eine Eingabeaufforderung. |
| 187 | | 1. Gib ein `cd %homepath%\Desktop`⏎ |
| 188 | | 1. Gbi ein `java -version `⏎ Drei Zeilen mit Versionsangaben sollten erscheinen. Wenn etwas anderes erschein, ist Java nicht richtig installiert. |
| 189 | | 1. Gin ein `java -jar josm-tested.jar`⏎. JOSM sollte jetzt laufen, gestartet von der [wiki:/Help:CommandLineOptions KOmmandozentrale]. |
| 190 | | 1. Beende JOSM. |
| 191 | | 1. Ginb ein `josm-tested.jar`⏎. Falls JOSM wieder startet, ist der Windows Explorer bereit für Doppelklicks auf jar-Dateien. |
| 192 | | |
| 193 | | |
| 194 | | === Web Start === |
| 195 | | [=#Troubleshootingjhlplink] |
| 196 | | Das Starten von JOSM über den Web Start-Mechanismus birgt viel mehr Schwierigkeiten als der übliche Weg mit dem Herunterladen einer jar-Datei und ihrem nachfolgenden Aufrufen. |
| 197 | | Daher sollte zunächst [#JavaTest Java] geprüft werden und erst danach der folgende Test absolviert oder anderwärts [https://www.java.com/de/download/faq/java_webstart.xml Was ist Java Web Start...?] geprüft werden. |
| 198 | | |
| 199 | | ==== Testen des Java Web Start ====#Webstarttest |
| 200 | | 1. Lade [/josm-tested.jar josm.jnlp] auf den Desktop herunter. |
| 201 | | 1. Öffne eine Eingabeaufforderung und bewege die Kommandozeile auf den Desktop. |
| 202 | | 1. Gib ein `javaws josm.jnlp`⏎. Dies sollte den ersten Download von JOSM starten, einen Sicherheitsdialog anbieten und das JOSM starten. |
| 203 | | |
| 204 | | |
| 205 | | === Virtuelle Machine ===#Troubleshootingjvm |
| 206 | | |
| 207 | | ==== Speichermangel ====#Outofmemory |
| 208 | | |
| 209 | | Nowadays manually controlling Javas memory is seldom needed because available RAM on computers has grown. |
| 210 | | Wrongly chosen values can decrease JOSM performance. |
| 211 | | |
| 212 | | For some tasks, JOSM has a large appetite for memory. On the one hand, it may be necessary to configure a memory size that supports more plugins and features. On the other hand can slow machines be stabilized by restricting Javas memory use. |
| 213 | | If needed, use the [wiki:Help/CommandLineOptions command line] to set the [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BABHDABI Java Option] -Xmx…m, for example `-Xmx512m` or `-Xmx1536m`. |
| 214 | | Formerly older java programs accepted `-Xmx=512m` or even `-Xmx 512m`. Now those malformed arguments throw error messages. |
| 215 | | |
| 216 | | |
| 217 | | ==== Auswahl der virtuellen Maschine ====#VMselectiononWindowsx64 |
| 218 | | |
| 219 | | On current versions of MS Windows by default Java is installed mainly in the `C:\Program Files\Java\` directory. Additional parts are placed in `C:\Program Files\Oracle\Java\`. There is a `.\javapath\` directory as target for the PATH environment variable. It is the home for the three virtual files `java.exe`, `javaw.exe` and `javaws.exe`. This files are symbolic links form the current Java installations. |
| 220 | | |
| 221 | | Unter Windows, muß man sich bewußt sein das einige Browser ihre mitgelieferten eigenen JRE nur im 32 bit Modus installieren und zusätzlich ihre eigenen Javawebstartwerkzeuge irgendwo anders mit unterschiedlichen Dateizuweisung installieren. Dies kann dazu führen, dass die JNLP mit diesem Ersatz-JRE ausgeführt wird, da es die falsche Javawebstartversion startet, welche nur die 32-bit VM unterstützt und manchmal mit einer eingeschränkten Unterstützung der VM Optionen und mit einer VM Größe, welche nicht 256MB übersteigt, erstellt wurde. |
| 222 | | |
| 223 | | Überprüfen Sie zum Beispiel, dass nicht ein anderer Javawebstart unter {{{\Windows\SysWow64}}} existiert. |
| 224 | | 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. |
| 225 | | |
| 226 | | Für JNLP Start-Icon auf der Arbeitsfläche und um den Javawebstart (from {{{\windows\system32}}}) auszuführen, sollte man sicherstellen, dass man die VM Parameter mit vorangestellten {{{-J}}} und ohne Zwischenleerzeichen vor der VM Option übergibt. Wenn man beide, die 32-bit und die 64-bit, Version installiert hat, sollte man die Option "{{{-d64}}}" übergeben falls man das bevorzugte 64-bit VM auswählen will. Angemerkt sei, dass einige Oracle Dokumentationsseiten auf die Option "-D64" mit falschem Großbuchstaben verweisen. |
| 227 | | |
| 228 | | 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: |
| 229 | | {{{ |
| 230 | | #!sh |
| 231 | | javaws.exe -J-d64 -J-Xmx2048m josm.jnlp |
| 232 | | }}} |
| 233 | | |
| 234 | | 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). |
| | 277 | === Bekannte Probleme ===#Knownissues |
| | 278 | |
| | 279 | Offene Fehlertickets über: |
| | 280 | * [https://josm.openstreetmap.de/query?status=!closed&type=defect&keywords=~java Java Fehler] - Einige davon sind ''blockers'' in Oracles JVM (siehe [[JavaBugs]]). |
| | 281 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux] |
| | 282 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu] |
| | 283 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority MacOS] |
| | 284 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority MS Windows] |