Changes between Version 161 and Version 162 of Download


Ignore:
Timestamp:
2020-10-29T18:32:14+01:00 (3 months ago)
Author:
skyper
Comment:

update of table layout; some more syntax harmonizing

Legend:

Unmodified
Added
Removed
Modified
  • Download

    v161 v162  
    11[[TranslatedPages]]
    22[[PageOutline(2-3,Table of Contents)]]
     3
    34= Download =
    45
     
    89
    910== Recommended options ==
    10 
    1111[[JOSMImage(openlocation, valign=middle, link=[download/josm.jnlp])]] **Start [/download/josm.jnlp josm.jnlp]** (newest tested version) \\
    12 Recommended version, all platforms, automatic update to the newest ''tested version'' monthly ([#Webstart how to start]). \\
    13 \\
     12Recommended version, all platforms, automatic update to the newest ''tested version'' monthly ([#Webstart how to start]). \\ \\
    1413
    1514[[JOSMImage(download, valign=middle, link=[/josm-tested.jar])]] **Download [/josm-tested.jar josm-tested.jar]** (tested version [[Version(tested)]]) \\
    16 All platforms ([#Java how to run]). \\
    17 \\
     15All platforms ([#Java how to run]). \\ \\
     16
    1817
    1918== All download options ==#Moredownloadoptions
    20 
    2119Every [/roadmap month] the team of JOSM [wikitr:/Releases releases] a **tested version** for download.
    2220The MS Windows and Apple Mac variants are built on this tested version.
     
    2826For the latest version is also a Web Start variant available.
    2927
    30 
    31 ||= =||||= For all operating systems =|||||||| || Development ||
    32 ||=Version =||=  Web Start  =||= Download =||= Windows =||= Apple Mac =||= Ubuntu, Debian…  =||= openSUSE =||= Jar / Javadoc / Source =||
    33 ||tested [[Version(tested)]] ||   \
    34 ||   [/download/josm.jnlp josm.jnlp] ||  \
    35 ||   [/josm-tested.jar] ||           \
    36 ||   \\ [/download/windows/josm-setup.exe josm-setup.exe] \\''([#Mswindowswrapper see below])'' ||  \
    37 ||   \\ [/download/macosx/josm-macosx.zip package.zip] \\''([#Macoserrors see below])'' ||  \
    38 ||   ''[#Ubuntu see below]'' ||          \
    39 ||   ''[#Opensuse see below]'' || \
    40 ||   [/nexus/content/groups/public/org/openstreetmap/josm/josm/ org.openstreetmap.josm:josm]:[[Version(tested)]]
    41 ||latest [[Version(latest)]] || \
    42 ||   [/download/josm-latest.jnlp latest.jnlp] ||  \
    43 ||   [/josm-latest.jar] || \
    44 ||   || || ''[#Ubuntu see below]'' || || \
    45 || [https://josm.openstreetmap.de/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Use snapshots] ||
    46 ||=older =|| || [/download/ download/] || || [https://github.com/openstreetmap/josm/releases automatic JOSM.app builds] || [/apt/dists/ dists/] || || [https://josm.openstreetmap.de/nexus/content/groups/public/org/openstreetmap/josm/josm/ tested versions] ||
     28||= =||||= **For all operating systems** =|||||||| ||= **Development** =||
     29||=**Version** =||= **Web Start** =||= **Download** =||= **Windows** =||= **Apple Mac** =||= **Ubuntu, Debian…**  =||= **openSUSE** =||= **Jar / Javadoc / Source** =||
     30||**tested [[Version(tested)]]** ||  \
     31||  [/download/josm.jnlp josm.jnlp]  ||  \
     32||  [/josm-tested.jar]  ||  \
     33||  \\ [/download/windows/josm-setup.exe josm-setup.exe] \\ ''([#Mswindowswrapper see below])''  ||  \
     34||  \\ [/download/macosx/josm-macosx.zip package.zip] \\ ''([#Macoserrors see below])''  ||  \
     35||  ''[#Ubuntu see below]''  ||  \
     36||  ''[#Opensuse see below]''  ||  \
     37||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/ josm]:[[Version(tested)]]  ||
     38||**latest [[Version(latest)]]** || \
     39||  [/download/josm-latest.jnlp latest.jnlp]  ||  \
     40||  [/josm-latest.jar]  || || ||  \
     41||  ''[#Ubuntu see below]''  || ||  \
     42||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/SNAPSHOT/ Use snapshots]  ||
     43||=''**older**'' =|| ||  \
     44||  [/download/ download/]  || ||  \
     45||  [https://github.com/openstreetmap/josm/releases automatic JOSM.app builds]  ||  \
     46||  [/apt/dists/ dists/]  || ||  \
     47||  [/nexus/content/groups/public/org/openstreetmap/josm/josm/ tested versions]  ||
    4748
    4849When running scripts please first check on [/latest latest], [/tested tested] or [/version both] to reduce download bandwidth.
     
    5152If download size is an issue, 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 [wikitr:/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].
    5253
     54
    5355== Linux Repositories ==
    54 
    5556=== JOSM's Debian based mainly for Ubuntu ===#Ubuntu
    56 
    5757This is our own package repository primarily for Ubuntu. It should also work with other Debian based (especially Ubuntu based) distributions, but we do not actively test and maintain any distributions other than Ubuntu.
    5858
    5959The repository contains two packages:
    60 * ''josm''  – Provides the tested version (stable).  Replaces the package from the official Ubuntu repository.
     60* ''josm''  – Provides the tested version (stable). Replaces the package from the official Ubuntu repository.
    6161* ''josm-latest'' – The latest version (nightly). Can be installed parallel to the josm package. The default preference folder is {{{~/.josm-latest}}}.
    6262
     
    6464
    6565==== Installation ====
    66 
    6766Edit the package resource list {{{/etc/apt/sources.list}}}:
    6867
     
    101100}}}
    102101
    103 Download and register the [[/josm-apt.key|public key]]:
     102Download and register the [/josm-apt.key public key]:
    104103{{{#!sh
    105104wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -
     
    167166=== Web Start ===#Webstart
    168167[=#Troubleshootingjhlplink]
    169 If you have problems using webstart 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]. Please note that webstart was dropped by Oracle starting with Java 9. In that case you will need to install [[https://openwebstart.com/|OpenWebStart]] separately.
     168If you have problems using webstart 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]. Please note that webstart was dropped by Oracle starting with Java 9. In that case you will need to install [https://openwebstart.com/ OpenWebStart] separately.
    170169
    171170==== Testing Web Start ====#Webstarttest
     
    177176
    178177=== Virtual Machine ===#Troubleshootingjvm
    179 
    180178==== Out of memory ====
    181 
    182179Nowadays manually controlling Javas memory is seldom needed because available RAM on computers has grown.
    183180Wrongly chosen values can decrease JOSM performance.
    184181
    185182For 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.
    186 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`.
     183If 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`.
    187184Formerly older java programs accepted `-Xmx=512m` or even `-Xmx 512m`. Now those malformed arguments throw error messages.
    188185
    189 
    190186==== VM selection ====#VMselectiononWindowsx64
    191 
    192187On 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.
    193188
    194189On 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.
    195190
    196 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).
     191Check 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).
    197192
    198193For 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!)
     
    204199}}}
    205200
     201
    206202=== Windows josm.exe ===#Mswindowswrapper
    207 
    208203Using josm-setup.exe for installation on Microsoft Windows does the following:
    209204 * Puts the files `josm-tested.jar` and `josm.exe` in directory chosen by the user, default is `C:\Program Files (86)\JOSM\`
     
    224219}}}
    225220
    226 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].
     221For 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].
    227222
    228223While being a 32-bit program, josm.exe needs a 64-bit Java on a 64-bit Windows.
     
    230225prefer JRE's.
    231226
     227
    232228=== macOS Errors ===#Macoserrors
    233229[=#MacOSErrors][=#MacOSXMountainLionErrors]
     
    237233}}}
    238234
    239 [[Image(josm_1st_run.png,width=400,align=right)]]
     235[[Image(josm_1st_run.png,width=400,align=right,link=)]]
    240236
    241237==== Downloaded from the internet ====
    242 
    243238On the first run of JOSM, you will get a message saying "'JOSM.app' is an application downloaded from the internet." **Right-click or ctrl-click on JOSM.app** or josm.jnlp and select 'open'. You will see the same message, but this time with an option to "Open".
    244239
     
    248243In Terminal, run the `brew cask install josm` to install or `brew cask upgrade josm` to upgrade to the current tested version of JOSM.
    249244
     245
    250246=== Known issues ===
    251 
    252 Not closed issues about ...:
    253 * [/query?status=!closed&type=defect&keywords=~java Java issues] - some of the bugs lead to blockers in Oracle JVM (covered at [[JavaBugs]]).
     247Not closed issues about …:
     248* [/query?status=!closed&type=defect&keywords=~java Java issues] - some of the bugs lead to blockers in Oracle JVM (covered at [wiki:JavaBugs JavaBugs]).
    254249* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~linux&order=priority Linux]
    255250* [/query?status=assigned&type=defect&status=needinfo&status=new&status=reopened&keywords=~ubuntu&order=priority Ubuntu]