Changes between Version 115 and Version 116 of Download


Ignore:
Timestamp:
2017-08-18T10:26:36+02:00 (5 weeks ago)
Author:
bastiK
Comment:

reorder some sections

Legend:

Unmodified
Added
Removed
Modified
  • Download

    v115 v116  
    1212* [[Image(source:trunk/images/download.png, valign=middle, link=)]] '''Download [/josm-tested.jar josm-tested.jar] (version [[Version(tested)]])''' - all platforms ([wiki:Download#Troubleshootingjarfile not able to run a file?]). Additional memory and other tips covered at [[Help/CommandLineOptions]].
    1313
    14 One of the two options above should work. Information below is optional and for troubleshooting.
    15 
    16 [[br]]
    17 [[br]]
    18 [[br]]
    19 [[br]]
    20 [[br]]
    2114[[br]]
    2215
     
    3831 * For download scripts use version check for [/latest latest] and [/tested tested] (or [/version both]) to reduce download bandwith
    3932
    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
    10734
    10835Tested version of JOSM is available in the Application:Geo repository.
     
    193120}}}
    194121
    195 === VM selection on Windows x64 ===
     122== Troubleshooting ==
     123=== Troubleshooting jar file ===
     124
     125==== Double click on a file does nothing ====
     126
     127In 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
     133If 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
     139If 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
     14510786 .jar: 10.2M[[br]]
     14610786 .jar?lang=de: 8151k[[br]]
     14710786 .jar?lang=de&unsigned=1: 7688k
     148
     149=== Troubleshooting jhlp link ===
     150
     151Assuming, [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
     157In more extensive edit sessions, you may get an "out of memory" error.
     158
     159To avoid this, the assigned memory can be increased with {{{-Xmx}}} option, see [[Help/CommandLineOptions]] for details.
     160
     161==== VM selection on Windows x64 ====
    196162
    197163For Windows, beware that some browsers may install their own JRE only in 32 bit mode, but may also install their version of the Javawebstart tool somewhere else with different file associations. This may cause your JNLP to start with this alternate JRE because it runs the wrong version of Javawebstart which only supports the 32 bit VM, and sometimes is built with a restricted support for VM options and a max VM size not exceeding 256MB.
     
    207173}}}
    208174You don't need to change the end of the command line with the snipped parts here. Just check the path for {{{javaws.exe}}} and add options {{{-J-d64}}} for the 64-bit mode needed to work with large OSM datasets, and {{{-Xmx=2048m}}} to increase the VM size (to 2GB here).
     175
     176=== Mac OS X errors ===
     177[=#MacOSXMountainLionErrors]
     178{{{
     179#!comment
     180old section title, keeping as anchor for old links
     181}}}
     182[[Image(#8787:damaged_josm_app.png,align=right,margin-top=-35)]]
     183
     184If 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
     186If 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{{{
     189sudo spctl --master-disable
     190}}}
     191
     192=== Known and open issues in JOSM ===
     193
     194Not 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]
    209200
    210201== See also ==