40 | | == Troubleshooting == |
41 | | === Troubleshooting jar file === |
42 | | |
43 | | ==== Double click on a file does nothing ==== |
44 | | |
45 | | In most cases this means Java (JVM) wasn't installed. JOSM is tested and developed with Oracle JVM, therefore it is recommended to get it from java.com site. |
46 | | |
47 | | * https://www.java.com/en/download/ - main resource, usually Installation process goes without any problems |
48 | | * https://www.java.com/en/download/help/download_options.xml - additional steps for all systems |
49 | | * https://www.java.com/en/download/help/index_installing.xml?os=All+Platforms&j=8&n=20 - please narrow down your question at their help portal about questions during installation |
50 | | |
51 | | If at least one Java was installed, refer to pages: |
52 | | * https://www.java.com/en/download/help/troubleshoot_java.xml - it contains most common troubleshooting questions |
53 | | * https://www.java.com/en/download/help/ - this page contains "Top 8 Java Issues", one of them may be yours |
54 | | |
55 | | ==== Strip down unnecessary translations in .jar ==== |
56 | | |
57 | | If download size is an issue for you: |
58 | | * Append **?lang=…** to the download link address for both releases to strip unused translations (e.g. **?lang=de** will download JOSM in German language only). |
59 | | * **Note**: Use underscore to separate [[Translations|language codes]] with country code extensions, e.g. **?lang=en_GB** |
60 | | * Append **?unsigned=1** to strip the code signing information |
61 | | * When **lang** and **unsigned** are used the separation is a **&** sign like in **?lang=de&unsigned=1** |
62 | | |
63 | | 10786 .jar: 10.2M[[br]] |
64 | | 10786 .jar?lang=de: 8151k[[br]] |
65 | | 10786 .jar?lang=de&unsigned=1: 7688k |
66 | | |
67 | | === Troubleshooting jhlp link === |
68 | | |
69 | | Assuming, [wiki:Download#Doubleclickonafiledoesnothing JVM was already installed], read [https://www.java.com/en/download/faq/java_webstart.xml Web Start] help. |
70 | | |
71 | | === Troubleshooting JVM === |
72 | | |
73 | | ==== Out of memory ==== |
74 | | |
75 | | In more extensive edit sessions, you may get an "out of memory" error. |
76 | | |
77 | | To avoid this, the assigned memory can be increased with {{{-Xmx}}} option, see [[Help/CommandLineOptions]] for details. |
78 | | |
79 | | === Known and open issues in JOSM === |
80 | | |
81 | | Not closed issues about ...: |
82 | | * [https://josm.openstreetmap.de/query?status=!closed&type=defect&keywords=~java Java issues] - some of the bugs lead to blockers in Oracle JVM (covered at [[JavaBugs]]). |
83 | | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux] |
84 | | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu] |
85 | | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority MacOS] |
86 | | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority Windows] |
87 | | |
88 | | == Possibly outdated content below == |
89 | | |
90 | | === Mac OS X errors === |
91 | | [=#MacOSXMountainLionErrors] |
92 | | {{{ |
93 | | #!comment |
94 | | old section title, keeping as anchor for old links |
95 | | }}} |
96 | | [[Image(#8787:damaged_josm_app.png,align=right,margin-top=-35)]] |
97 | | |
98 | | If you get an error saying "'JOSM.app' is an application downloaded from the internet." you can bypass this by **right-clicking on JOSM.app** or josm.jnlp and selecting 'open'. You should then see the same message but this time with an option to "Open" regardless. This is only necessary on the first run of JOSM. |
99 | | |
100 | | If you get an error saying "'JOSM.app' is damaged and can't be opened. You should move it to the Trash", then you need to temporarily disable gatekeeper. Open System Preferences and the 'Security & Privacy' options. Set 'Allow applications downloaded from:' to 'Anywhere'. If the that radio button is missing from the Security & Privacy preferences panel, the following may be entered using a terminal window to make it appear: |
101 | | |
102 | | {{{ |
103 | | sudo spctl --master-disable |
104 | | }}} |
105 | | |
106 | | === openSUSE repository === #openSUSE |
| 33 | === openSUSE repository ===#openSUSE |
195 | | === VM selection on Windows x64 === |
| 122 | == Troubleshooting == |
| 123 | === Troubleshooting jar file === |
| 124 | |
| 125 | ==== Double click on a file does nothing ==== |
| 126 | |
| 127 | In most cases this means Java (JVM) wasn't installed. JOSM is tested and developed with Oracle JVM, therefore it is recommended to get it from java.com site. |
| 128 | |
| 129 | * https://www.java.com/en/download/ - main resource, usually Installation process goes without any problems |
| 130 | * https://www.java.com/en/download/help/download_options.xml - additional steps for all systems |
| 131 | * https://www.java.com/en/download/help/index_installing.xml?os=All+Platforms&j=8&n=20 - please narrow down your question at their help portal about questions during installation |
| 132 | |
| 133 | If at least one Java was installed, refer to pages: |
| 134 | * https://www.java.com/en/download/help/troubleshoot_java.xml - it contains most common troubleshooting questions |
| 135 | * https://www.java.com/en/download/help/ - this page contains "Top 8 Java Issues", one of them may be yours |
| 136 | |
| 137 | ==== Strip down unnecessary translations in .jar ==== |
| 138 | |
| 139 | If download size is an issue for you: |
| 140 | * Append **?lang=…** to the download link address for both releases to strip unused translations (e.g. **?lang=de** will download JOSM in German language only). |
| 141 | * **Note**: Use underscore to separate [[Translations|language codes]] with country code extensions, e.g. **?lang=en_GB** |
| 142 | * Append **?unsigned=1** to strip the code signing information |
| 143 | * When **lang** and **unsigned** are used the separation is a **&** sign like in **?lang=de&unsigned=1** |
| 144 | |
| 145 | 10786 .jar: 10.2M[[br]] |
| 146 | 10786 .jar?lang=de: 8151k[[br]] |
| 147 | 10786 .jar?lang=de&unsigned=1: 7688k |
| 148 | |
| 149 | === Troubleshooting jhlp link === |
| 150 | |
| 151 | Assuming, [wiki:Download#Doubleclickonafiledoesnothing JVM was already installed], read [https://www.java.com/en/download/faq/java_webstart.xml Web Start] help. |
| 152 | |
| 153 | === Troubleshooting JVM === |
| 154 | |
| 155 | ==== Out of memory ==== |
| 156 | |
| 157 | In more extensive edit sessions, you may get an "out of memory" error. |
| 158 | |
| 159 | To avoid this, the assigned memory can be increased with {{{-Xmx}}} option, see [[Help/CommandLineOptions]] for details. |
| 160 | |
| 161 | ==== VM selection on Windows x64 ==== |
| 175 | |
| 176 | === Mac OS X errors === |
| 177 | [=#MacOSXMountainLionErrors] |
| 178 | {{{ |
| 179 | #!comment |
| 180 | old section title, keeping as anchor for old links |
| 181 | }}} |
| 182 | [[Image(#8787:damaged_josm_app.png,align=right,margin-top=-35)]] |
| 183 | |
| 184 | If you get an error saying "'JOSM.app' is an application downloaded from the internet." you can bypass this by **right-clicking on JOSM.app** or josm.jnlp and selecting 'open'. You should then see the same message but this time with an option to "Open" regardless. This is only necessary on the first run of JOSM. |
| 185 | |
| 186 | If you get an error saying "'JOSM.app' is damaged and can't be opened. You should move it to the Trash", then you need to temporarily disable gatekeeper. Open System Preferences and the 'Security & Privacy' options. Set 'Allow applications downloaded from:' to 'Anywhere'. If the that radio button is missing from the Security & Privacy preferences panel, the following may be entered using a terminal window to make it appear: |
| 187 | |
| 188 | {{{ |
| 189 | sudo spctl --master-disable |
| 190 | }}} |
| 191 | |
| 192 | === Known and open issues in JOSM === |
| 193 | |
| 194 | Not closed issues about ...: |
| 195 | * [https://josm.openstreetmap.de/query?status=!closed&type=defect&keywords=~java Java issues] - some of the bugs lead to blockers in Oracle JVM (covered at [[JavaBugs]]). |
| 196 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux] |
| 197 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu] |
| 198 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~macos&order=priority MacOS] |
| 199 | * [https://josm.openstreetmap.de/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~windows&order=priority Windows] |