| 30 | | |
| 31 | | ||= =||||= Minden operációs rendszerre =|||||||||| |
| 32 | | ||=Verzió =||= Web Start =||= Letöltés =||= Windows =||= Apple Mac =||= Ubuntu, Debian… =||= openSUSE =|| |
| 33 | | ||stabil [[Version(tested)]] || \ |
| 34 | | || [/download/josm.jnlp josm.jnlp] || \ |
| 35 | | || [/josm-tested.jar] || \ |
| 36 | | || [[br]] [/download/windows/josm-setup.exe setup.exe] [[br]]''([#Mswindowswrapper lásd alább])'' || \ |
| 37 | | || [[br]] [/download/macosx/josm-macosx.zip package.zip] [[br]]''([#Macoserrors lásd alább])'' || \ |
| 38 | | || ''[#Ubuntu lásd alább]'' || \ |
| 39 | | || ''[#Opensuse lásd alább]'' || |
| 40 | | ||legfrissebb [[Version(latest)]] || \ |
| 41 | | || [/download/josm-latest.jnlp latest.jnlp] || \ |
| 42 | | || [/josm-latest.jar] || \ |
| 43 | | || || || ''[#Ubuntu lásd alább]'' || || |
| 44 | | ||=régebbi =|| || [/download/ download/] || || || [/apt/dists/ dists/] || || |
| 45 | | |
| 46 | | Scriptek futtatásakor a sávszélesség csökkentése érdekében kérlek ellenőrizd előbb a [/latest legfrissebb], [/tested stabil] vagy [/version mindkét] verziót. |
| | 28 | ||= =||||= **Minden operációs rendszerre** =|||||||| ||= **Development** =|| |
| | 29 | ||=**Verzió** =||= **Web Start** =||= **Letöltés** =||= **Windows** =||= **Apple macOS** =||= **Ubuntu, Debian…** =||= **openSUSE** =||= **Jar / Javadoc / Forráskód** =|| |
| | 30 | ||**tested [[Version(tested)]]** || \ |
| | 31 | || [/download/josm.jnlp josm.jnlp] || \ |
| | 32 | || [/josm-tested.jar] || \ |
| | 33 | || \\ [/download/windows/josm-setup.exe josm-setup.exe] \\ [/download/windows/josm-setup.msi josm-setup.msi] \\ [https://apps.microsoft.com/store/detail/josm/XPFCG1GV0WWGZX Microsoft Store]\\ ''([#Mswindowswrapper lásd alább])'' || \ |
| | 34 | || \\ [/download/macosx/josm-macosx.zip JOSM macOS .zip csomag] \\ 'vagy ([#macOS homebrew])'' || \ |
| | 35 | || ''[#Ubuntu lásd alább]'' || \ |
| | 36 | || ''[#Opensuse lásd alább]'' || \ |
| | 37 | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ josm]:[[Version(tested)]] || |
| | 38 | ||**legújabb [[Version(latest)]]** || \ |
| | 39 | || [/download/josm-latest.jnlp latest.jnlp] || \ |
| | 40 | || [/josm-latest.jar] || \ |
| | 41 | || ''lásd a [https://github.com/openstreetmap/josm/releases kiadásokat githubon] || \ |
| | 42 | || ''lásd a [https://github.com/openstreetmap/josm/releases kiadásokat githubon] || \ |
| | 43 | || ''[#Ubuntu lásd alább]'' || || \ |
| | 44 | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Pillanatképek használata] || |
| | 45 | ||=''**régebbi**'' =|| || \ |
| | 46 | || [/download/ download/] || \ |
| | 47 | || ''lásd a [https://github.com/openstreetmap/josm/releases kiadásokat githubon] || \ |
| | 48 | || ''lásd a [https://github.com/openstreetmap/josm/releases kiadásokat githubon] || \ |
| | 49 | || [/apt/pool/universe/j/ pool/] || || \ |
| | 50 | || [/nexus/content/groups/public/org/openstreetmap/josm/josm/ stabil verziók] || |
| | 51 | |
| | 52 | Scriptek futtatásakor a sávszélesség csökkentése érdekében ellenőrizd előbb a [/latest legfrissebb], [/tested stabil] vagy [/version összes] verziót. |
| 51 | | == Tárolók == |
| | 57 | == Linux tárolók == |
| | 58 | |
| | 59 | === A JOSM Debian-alapú tárolója, főként Ubuntu-hoz ===#Ubuntu |
| | 60 | |
| | 61 | Ez a saját csomagtárolónk elsősorban Ubuntuhoz készült. Működnie kell más Debian alapú (főleg Ubuntu alapú) disztribúciókkal is, de Ubuntun kívül nem tesztelünk, és nem tartunk karban más disztribúciót. |
| | 62 | |
| | 63 | A tároló két csomagot tartalmaz: |
| | 64 | * ''josm'' – a stabil (tesztelt) verzió. Lecseréli a disztribúció hivatalos tárolójából származó csomagot. Az alapértelmezett JOSM könyvtárak neve `JOSM`-re van állítva. |
| | 65 | * ''josm-latest'' – a legfrissebb verzió (nightly). Feltelepíthető a josm csomag mellé, mivel az alapértelmezett JOSM könyvtárak neve `JOSM-latest`-re van állítva. |
| | 66 | Mindkét csomag tartalmazza a `/etc/default/josm` valamint a `/etc/default/josm-latest` konfigurációs fájlt a [wikitr:Help/CommandLineOptions#Javaoptions java opciók] számára. |
| | 67 | |
| | 68 | |
| | 69 | Az alább leírt szokásos menet mellett a régebbi DEB fájlok letölthetőek az [/apt/pool/universe/j/ archívumból]. |
| | 70 | |
| | 71 | ==== Telepítés ==== |
| | 72 | |
| | 73 | Szerkeszd a `/etc/apt/sources.list.d/josm.list` csomagforrás-listát: |
| | 74 | |
| | 75 | {{{#!sh |
| | 76 | sudo editor /etc/apt/sources.list.d/josm.list |
| | 77 | }}} |
| | 78 | {{{#!comment |
| | 79 | ### below does not work on GNU Debian systems |
| | 80 | `sudo $EDITOR /etc/apt/sources.list.d/josm.list` |
| | 81 | }}} |
| | 82 | |
| | 83 | add hozzá az egyik alábbi sort, ami megfelel az Ubuntu verziódnak: |
| | 84 | |
| | 85 | {{{#!sh |
| | 86 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt plucky universe |
| | 87 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt oracular universe |
| | 88 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt noble universe |
| | 89 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt jammy universe |
| | 90 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt focal universe |
| | 91 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt bionic universe |
| | 92 | # Más Debian alapú disztribúciók esetében add hozzá ezt: |
| | 93 | deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt alldist universe |
| | 94 | }}} |
| | 95 | |
| | 96 | Másféleképpen az alábbi egysoros paranccsal tudod ugyanezt megtenni Ubuntun (nem működik Ubuntu-alapú rendszereken, pl. Linux Minten): |
| | 97 | {{{#!sh |
| | 98 | 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 |
| | 99 | }}} |
| | 100 | vagy Linux Minten: |
| | 101 | {{{#!sh |
| | 102 | 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 |
| | 103 | }}} |
| | 104 | |
| | 105 | ### az alábbi nem minden rendszeren működik |
| | 106 | és add hozzá a következő sort: |
| | 107 | {{{#!sh |
| | 108 | `deb [signed-by=/usr/local/share/keyrings/josm-apt.gpg] https://josm.openstreetmap.de/apt VERSION universe` |
| | 109 | }}} |
| | 110 | }}} |
| | 111 | Töltsd le a [/josm-apt.key publikus kulcsot]: |
| | 112 | {{{#!sh |
| | 113 | # Hod létre kézzel a letöltött kulcsok könyvtárát, ha még nem volt létrehozva |
| | 114 | sudo mkdir -p /usr/local/share/keyrings |
| | 115 | # Download the key |
| | 116 | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo gpg --dearmor -o /usr/local/share/keyrings/josm-apt.gpg |
| | 117 | }}} |
| | 118 | A korábbi utasítások `apt-key`-t használtak. Ha a kulcs hozzá lett adva a rendszer kulcstartójához, a következő sor eltávolítja azt: |
| | 119 | {{{#!sh |
| | 120 | sudo apt-key del $(apt-key list | grep -B1 "<josm-dev@openstreetmap.org>" | sed '$d' | cut -b 48-51,53-57) |
| | 121 | }}} |
| | 122 | Most frissítsd a forrásokat: |
| | 123 | {{{#!sh |
| | 124 | # Előfordulhat, hogy előbb telepítened kell az ssl támogatást apt-hez: |
| | 125 | sudo apt-get install apt-transport-https |
| | 126 | # Források frissítése |
| | 127 | sudo apt-get update |
| | 128 | }}} |
| | 129 | és telepítsd: |
| | 130 | {{{#!sh |
| | 131 | # Kihagyhatod ezt az első sort, ha ezeket a csomagokat korábban nem telepítetted. |
| | 132 | sudo apt-get remove josm josm-plugins |
| | 133 | |
| | 134 | # A stabil verzióhoz |
| | 135 | sudo apt-get install josm |
| | 136 | # A fejlesztői verzióhoz |
| | 137 | sudo apt-get install josm-latest |
| | 138 | }}} |
| | 139 | |
| | 140 | === GNU Debian ===#GNUDebian |
| | 141 | A saját [#Ubuntu fent látható] Ubuntu csomagjaink Debian-on is működnek, ezek használatát javasoljuk. A `sudo` telepítésétől függően néhány utasítás nem fog működni „normál” felhasználóként, csak `root`-ként. |
| | 142 | A [https://packages.debian.org/stable/josm JOSM stabil verziója] elérhető **''main''** **''utils''** szakaszában, de ez a verzió általában elég régi. \\ |
| | 143 | A sokkal naprakészebb verziókat a [https://backports.debian.org backports tárolóban] találod, lásd [https://backports.debian.org/Instructions Utasítások]. Még ez a verzió is régebbi lehet a mi saját csomagjainkánl. |
| | 144 | Debian 11 (bullseye) óta a [https://packages.debian.org/stable/josm-installer josm-installer] elérhető a **''main''** **''utils''** szakaszában. Ez letölti az aktuális .jar fájlt erről az oldalról, és szükség esetén frissít. |
| 64 | | === Ubuntu ===#Ubuntu |
| 65 | | |
| 66 | | Ez a csomagtároló elsősorban az Ubuntuhoz készült. Működnie kell más Debian alapú (főleg Ubuntu alapú) disztribúciókkal is, de Ubuntun kívül nem tesztelünk és nem tartunk karban más disztribúciót. |
| 67 | | |
| 68 | | A tároló két csomagot tartalmaz: |
| 69 | | * ''josm'' – a stabil (tesztelt) verzió. Lecseréli a hivatalos Ubuntu tárolóból származó csomagot. |
| 70 | | * ''josm-latest'' – a legfrissebb verzió (nightly). Feltelepíthető a josm csomag mellé. Az alapértelmezett beállítások könyvtára a {{{~/.josm-latest}}}. |
| 71 | | |
| 72 | | Az alább leírt szokásos menet mellett a régebbi DEB fájlok letölthetőek az [/apt/pool/universe/j/ archívumból]. |
| 73 | | |
| 74 | | ==== Telepítés ==== |
| 75 | | |
| 76 | | Szerkeszd a csomagforrás {{{/etc/apt/sources.list}}} listát: |
| 77 | | |
| | 157 | |
| | 158 | == Hibaelhárítás == |
| | 159 | === Java ===#Java |
| | 160 | Ha duplán kattintasz egy jar fájlra és nem történik semmi, az általában azt jelenti hogy a Java nincs telepítve. |
| | 161 | A JOSM jelenleg az [https://www.azul.com/downloads/?version=java-21-lts&package=jdk-fx#zulu Azul] vagy [https://bell-sw.com/pages/downloads/?package=jre-full#mn Bellsoft Liberica] JDK-at javasolja. Általánosságban az aktuális Java LTS a javasolt (a cikk írásakor ez a Java 17), de a Java 11-nek is működnie kell. Az aktuális ajánlásokat lásd a [source:/trunk/README README]-ben. De először tegyél egy próbát az operációs rendszereddel érkező Javával, például az [https://en.wikipedia.org/wiki/OpenJDK OpenJDK-val]. |
| | 162 | |
| | 163 | When choosing a download keep in mind: |
| | 164 | |
| | 165 | ''Java'' in this section means a JRE (Java Runtime Engine) which provides a JVM (Java Virtual Machine) to run JOSM, a Java program that is developed using JDK (Java Development Kit) and sometimes launched with the JNLP (Java Network Launch Protocol aka Web Start and successor of Java Plug-ins). |
| | 166 | ==== Testing Java ====#JavaTest |
| | 167 | [=#Troubleshootingjarfile] Checks if Java is installed and why JOSM does not start (example mainly for MS Windows). |
| | 168 | 1. Download [/josm-tested.jar josm-tested.jar] to your desktop. |
| | 169 | |
| | 170 | === Web Start ===#Webstart |
| | 171 | [=#Troubleshootingjhlplink] |
| | 172 | You need to install [https://openwebstart.com/ OpenWebStart] first. It will download and run Java by itself. Please use the 64 bit (`x64`) version of OpenWebStart if you are on Microsoft Windows. The transition from Oracle WebStart to OpenWebStart is still in progress, so in case of issue please create a [/newticket new ticket] or post a comment to #17858. |
| | 173 | You may need to update the default application for opening JNLP files if you previously used Oracle WebStart. See [https://openwebstart.com/docs/OWSGuide.html#_jnlp_file_association jnlp file association] for instructions on setting OpenWebStart as the default program for jnlp files. |
| | 174 | ==== Testing Web Start ====#Webstarttest |
| | 175 | |
| | 176 | === Virtual Machine ===#Troubleshootingjvm |
| | 177 | ==== Out of memory ==== |
| | 178 | Nowadays manually controlling Javas memory is seldom needed because available RAM on computers has grown. |
| | 179 | Wrongly chosen values can decrease JOSM performance. |
| | 180 | 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. |
| | 181 | If needed, use the [wikitr:/Help/CommandLineOptions command line] to set the [https://docs.oracle.com/en/java/javase/11/tools/java.html#GUID-3B1CE181-CD30-4178-9602-230B800D4FAE__BABHDABI Java Option] -Xmx…m, for example `-Xmx512m` or `-Xmx1536m`. In Debian/Ubuntu you can edit the file `/etc/default/josm` respectively `/etc/default/josm-latest`. \\ |
| | 182 | Formerly older java programs accepted `-Xmx=512m` or even `-Xmx 512m`. Now those malformed arguments throw error messages. |
| | 183 | ==== VM selection ====#VMselectiononWindowsx64 |
| | 184 | 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. |
| | 185 | On older versions of 64 bit Windows sometimes the 32 bit mode JRE was additionally installed. Also some browsers brought their own JVM with limited capabilities. In those cases a Web Start from the browser would not use your Java installation but that from the browser. |
| | 186 | Check that there's no other javawebstart in `\Windows\SysWow64`. The Java control panel will not detect it and you can safely delete it. Perform cleanup and only keep the latest versions of each JRE (One or the 32-bit mode, another one for the 64-bit mode). |
| | 187 | For shortcuts created on the desktop for JNLP and running the Javawebstart launcher , make sure to pass VM parameters prefixed with -J and no intermediate space before the VM option. If you have installed both the 32-bit and 64-bit version, you should pass the option "`-d64`" if you want to select the preferred 64-bit VM. Note that some Oracle documentation pages indicate the option "-D64" with the incorrect capitalization!) |
| | 188 | Example of an edited command line for a shortcut on the windows desktop: |
| | 189 | |
| | 190 | }}} |
| | 191 | === Microsoft Windows ===#MSWindows |
| | 192 | ==== josm.exe ====#Mswindowswrapper |
| | 193 | Using josm-setup.exe for installation on Microsoft Windows does the following: |
| | 194 | * Puts two executable files `JOSM.exe` and `HWConsole.exe` in directory `%LOCALAPPDATA%\JOSM` |
| | 195 | * Registers JOSM.exe as target for the file extensions `*.osm`, `*.geojson`, `*.gpx`, `*.jos` and `*.joz`. |
| | 196 | * Places JOSM shortcut icons on the Desktop and in the Start Menu. |
| | 197 | * Adds uninstall data at the appropriate places. |
| | 198 | When starting, JOSM.exe starts JOSM with an embedded version of Java maintained by JOSM developers, based on Azul Zulu. |
| | 199 | JOSM.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| | 200 | HWConsole.exe is similar to JOSM.exe but start JOSM while keeping open a Windows console displaying JOSM standard output (logs). |
| | 201 | JOSM.exe accepts all usual [wikitr:/Help/CommandLineOptions#Programarguments JOSM Program arguments]. See example: |
| 80 | | sudo editor /etc/apt/sources.list |
| 81 | | }}} |
| 82 | | |
| 83 | | add hozzá az egyik alábbi sort, ami megfelel az Ubuntu verziódnak: |
| 84 | | |
| 85 | | {{{ |
| 86 | | #!sh |
| 87 | | deb https://josm.openstreetmap.de/apt trusty universe |
| 88 | | deb https://josm.openstreetmap.de/apt xenial universe |
| 89 | | deb https://josm.openstreetmap.de/apt artful universe |
| 90 | | # Más Debian alapú disztribúciók esetében add hozzá ezt: |
| 91 | | deb https://josm.openstreetmap.de/apt alldist universe |
| 92 | | }}} |
| 93 | | |
| 94 | | Másféleképpen az alábbi egysoros paranccsal tudod ezt megtenni: |
| 95 | | {{{ |
| 96 | | echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | ↩ |
| 97 | | ↪sudo tee /etc/apt/sources.list.d/josm.list > /dev/null |
| 98 | | }}} |
| 99 | | |
| 100 | | {{{#!comment |
| 101 | | ### alább nem minden rendszeren működik |
| 102 | | és add hozzá az alábbi sort: |
| 103 | | ` |
| 104 | | deb https://josm.openstreetmap.de/apt VERSION universe |
| 105 | | ` |
| 106 | | }}} |
| 107 | | |
| 108 | | Töltsd le és regisztráld a [[/josm-apt.key|publikus kulcsot]]: |
| 109 | | {{{ |
| 110 | | #!sh |
| 111 | | wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add - |
| 112 | | }}} |
| 113 | | |
| 114 | | Most frissítsd a forrásokat (lehet hogy telepítened kell a `sudo apt-get install apt-transport-https` csomagot) |
| 115 | | {{{ |
| 116 | | #!sh |
| 117 | | sudo apt-get update |
| 118 | | }}} |
| 119 | | és telepítsd: |
| 120 | | |
| 121 | | {{{ |
| 122 | | #!sh |
| 123 | | # Átugorhatod az első sort, ha ezek a csomagok nem voltak korábban telepítve. |
| 124 | | sudo apt-get remove josm josm-plugins |
| 125 | | |
| 126 | | # Stabil verzió |
| 127 | | sudo apt-get install josm |
| 128 | | # legfrissebb fejlesztői verzió |
| 129 | | sudo apt-get install josm-latest |
| 130 | | }}} |
| 131 | | |
| 132 | | == Hibaelhárítás == |
| 133 | | === Java ===#Java |
| 134 | | [=#Doubleclickonafiledoesnothing Ha duplán kattintasz egy jar fájlra és nem történik semmi] az általában azt jelenti hogy a Java nincs telepítve. |
| 135 | | |
| 136 | | JOSM is tested with Oracles variant, so we recommend to get Java from their pages for [https://www.java.com/download/manual.jsp manual] downloads or [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html intermediate] versions. But first give the Java already distributed with the operating system a try, [https://en.wikipedia.org/wiki/OpenJDK for example]. |
| 137 | | |
| 138 | | When choosing a download keep in mind: |
| 139 | | * A Java Plug-in for web browsers is **not** needed to run JOSM. Therefore results from pages like www.java.com/en/download/installed8.jsp are not relevant. |
| 140 | | * A Java variant with 64 bit is recommended for JOSM. The operating systems architecture is important for deciding between 32 bit Java or 64 bit Java. Because JOSM is **not** affected by the web browsers architecture most recommendations on this page www.java.com/en/download/faq/java_win64bit.xml are not relevant. |
| 141 | | * Avoid pages like www.java.com/en/download which intent to place Java Plug-ins in web browsers. And this is **not** important for JOSM. |
| 142 | | |
| 143 | | For further information visit the [InstallNotes Installation Notes] and [https://www.java.com/en/download/help/troubleshoot_java.xml troubleshooting] pages. |
| 144 | | ''Java'' in this section means a JRE (Java Runtime Engine) which provides a JVM (Java Virtual Machine) to run JOSM, a Java program that is developed using JDK (Java Development Kit) and sometimes launched with the JNLP (Java Network Launch Protocol aka Web Start and successor of Java Plug-ins). |
| 145 | | |
| 146 | | ==== Testing Java ====#Javatest |
| 147 | | [=#Troubleshootingjarfile] Checks if Java is installed and why JOSM does not start (example mainly for MS Windows). |
| 148 | | 1. Download [/download/josm.jnlp josm.jnlp] to your desktop. |
| 149 | | 1. Open a Command Prompt aka Terminal |
| 150 | | 1. Type `cd %homepath%`⏎ and type `cd Desktop`⏎ |
| 151 | | 1. Type `java -version `⏎ Three lines with the version data should appear. If you see something else then Java is not properly installed. |
| 152 | | 1. Type `java -jar josm-tested.jar`⏎. Now JOSM should run, started from the [wikitr:/Help/CommandLineOptions Command Line]. |
| 153 | | 1. Quit JOSM. |
| 154 | | 1. Type `josm-tested.jar`⏎. If JOSM starts again, the Windows Explorer is ready for double clicks on jar files. |
| 155 | | |
| 156 | | |
| 157 | | === Web Start ===#Webstart |
| 158 | | [=#Troubleshootingjhlplink] |
| 159 | | Launching JOSM via Web Start has many more error causes than the traditional way with first downloading a jar file and afterwards starting it. |
| 160 | | So please test [#JavaTest Java] first and then run the tests described below or elsewhere [https://www.java.com/en/download/faq/java_webstart.xml Web Start issues]. |
| 161 | | |
| 162 | | ==== Testing Web Start ====#Webstarttest |
| 163 | | 1. Download [/josm-tested.jar josm.jnlp] to your desktop. |
| 164 | | 1. Open a Terminal and move to the Desktop as above |
| 165 | | 1. Type `javaws josm.jnlp`⏎. This should initially download JOSM, serve a security dialog and then launch JOSM. |
| 166 | | |
| 167 | | |
| 168 | | === Virtual Machine ===#Troubleshootingjvm |
| 169 | | |
| 170 | | ==== Out of memory ==== |
| 171 | | |
| 172 | | Nowadays manually controlling Javas memory is seldom needed because available RAM on computers has grown. |
| 173 | | Wrongly chosen values can decrease JOSM performance. |
| 174 | | |
| 175 | | 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. |
| 176 | | If needed, use the [wikitr: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`. |
| 177 | | Formerly older java programs accepted `-Xmx=512m` or even `-Xmx 512m`. Now those malformed arguments throw error messages. |
| 178 | | |
| 179 | | |
| 180 | | ==== VM selection ====#VMselectiononWindowsx64 |
| 181 | | |
| 182 | | 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. |
| 183 | | |
| 184 | | On older versions of 64 bit Windows sometimes the 32 bit mode JRE was additionally installed. Also some browsers brought their own JVM with limited capabilities. In those cases a Web Start from the browser would not use your Java installation but that from the browser. |
| 185 | | |
| 186 | | Check that there's no other javawebstart in {{{\Windows\SysWow64}}}. The Java control panel will not detect it and you can safely delete it. Perfom cleanup and only keep the latest versions of each JRE (One or the 32-bit mode, another one for the 64-bit mode). |
| 187 | | |
| 188 | | For shortcuts created on the desktop for JNLP and running the Javawebstart launcher , make sure to pass VM parameters prefixed with -J and no intermediate space before the VM option. If you have installed both the 32-bit and 64-bit version, you should pass the option "{{{-d64}}}" if you want to select the preferred 64-bit VM. Note that some Oracle documentation pages indicate the option "-D64" with the incorrect capitalization!) |
| 189 | | |
| 190 | | Example of an edited command line for a shortcut on the windows desktop: |
| 191 | | {{{ |
| 192 | | #!sh |
| 193 | | javaws.exe -J-d64 -J-Xmx2048m josm.jnlp |
| 194 | | }}} |
| 195 | | |
| 196 | | === Windows josm.exe ===#Mswindowswrapper |
| 197 | | |
| 198 | | Using josm-setup.exe for installation on Microsoft Windows does the following: |
| 199 | | * Puts the files `josm-tested.jar` and `josm.exe` in directory chosen by the user, default is `C:\Program Files (86)\JOSM\` |
| 200 | | * Suggests to register josm.exe as target for the file extensions `*.osm` and `*.gpx`. |
| 201 | | * Suggests to place JOSM shortcut icons on the Desktop and in the Start Menu (Currently they are placed for an admin only and can be copied from there, #11398). |
| 202 | | * Asks if the Plug-Ins Imagery offset database and Turn restrictions should be provided. |
| 203 | | * Adds uninstall data at the appropriate places. |
| 204 | | |
| 205 | | 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`. |
| 206 | | Josm.exe acts as a ''wrapper'' and is [wikitr:/USB_Stick portable]. |
| 207 | | |
| 208 | | 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 [wikitr:/Help/CommandLineOptions#Programarguments JOSM Program arguments] too. See example: |
| 209 | | |
| 210 | | {{{ |
| 211 | | #!sh |
| 212 | | # Write a log while starting JOSM and load OSM data |
| 213 | | josm.exe --l4j-debug https://www.osm.org/way/476702262 |
| 214 | | }}} |
| 215 | | |
| 216 | | For giving [wikitr:Help/CommandLineOptions#Javaoptions Java options] to the Java VM josm.exe uses the optional file `josm.l4j.ini` in its directory. In this file each option needs a separate line and comments are possible, see [http://launch4j.sourceforge.net/docs.html#Additional_jvm_options Additional JVM options]. |
| 217 | | |
| 218 | | While being a 32-bit program, josm.exe seems to need a 64-bit Java on 64-bit Windows. |
| 219 | | |
| 220 | | === MacOS Errors ===#Macoserrors |
| 221 | | [=#MacOSErrors][=#MacOSXMountainLionErrors] |
| | 204 | # Load OSM data |
| | 205 | josm.exe https://www.osm.org/way/476702262 |
| | 206 | }}} |
| | 207 | For giving [wikitr:/Help/CommandLineOptions#Javaoptions Java options] to the Java VM, JOSM.exe uses the configuration file `JOSM.cfg` in its app sub-directory. In this file, each option must be on a separate line. |
| | 208 | For example, to change memory allocation, open `%LOCALAPPDATA%\JOSM\app\JOSM.cfg` and add `java-options=-Xmx8192m` (for 8 GB) to a new line under the `[JavaOptions]` header. |
| | 209 | ==== Graphics ====#MicrosoftWindowsGraphics |
| | 210 | Some Windows installations have graphics driver issues (see #23784 for an example). This may exhibit symptoms such as: |
| | 211 | * Black bars in JOSM toolbars |
| | 212 | * Flickering |
| | 213 | * Other unexpected user interface issues |
| | 214 | 1. Download and install Display Driver Uninstaller (DDU, [https://github.com/Wagnard/display-drivers-uninstaller source]) from the official mirror => https://www.wagnardsoft.com/display-driver-uninstaller-DDU- |
| | 215 | 2. From the "Device Type" drop-down on the right, select "GPU". DDU will automatically detect the GPU you're using. |
| | 216 | 3. Click on "Clean and Restart" at the top. This will uninstall the graphics drivers and restart your PC. |
| | 217 | 4. Reinstall the drivers. |
| | 218 | //**WARNING: Create a backup of your PC before using DDU. Although it creates a recovery point by itself, it's ideal to make one yourself just in case.**// |
| | 219 | === macOS ===#macOS |
| | 220 | [=#MacOSErrors][=#MacOSXMountainLionErrors][=#Macoserrors] |
