!!!TRANSLATION IS IN PROGRESS!!!

Preuzimanja

Ova stranica pruža osnovne informacije u vezi sa instalacijom JOSM aplikacije i koracima za otklanjanje problema. Da biste počeli sa radom u JOSM aplikaciji, molimo vas da pročitate stranice Introduction (en) i Help. Za veoma kompleksne probleme, pročitajte Napomene o instalaciji (en).

Preporučene opcije

Pokrenite josm.jnlp (najnovija stabilna verzija)
Preporučene verzije, sve platforme, automatsko mesečno ažuriranje na najnoviju stabilnu verziju (kako da počnete).

Preuzmite josm-tested.jar (stabilna verzija 19555)
Sve platforme (kako da pokrenete).

Sve opcije preuzimanja

Svakog meseca razvojni tim JOSM aplikacije izdaje (en) stabilnu verziju za preuzimanje. Stabilna verzija se izdaje za MS Windows i Apple Mac. Kada kliknete na josm.jnlp kako biste pokrenuli JOSM, uvek ćete dobiti najnoviju stabilnu verziju. Java Web Start (en) je mehanizam koji stoji iza ovoga.

Svake večeri, pravi se noćno izdanje koje se obeležava kao najnovija verzija. Ove verzije mogu da sadrže ozbiljne greške, ali obično ispravno funkcionišu. Za najnovije verzije, takođe je dostupan Web Start.

	Za sve operativne sisteme
Verzija	Web Start	Preuzimanje	Windows	Apple Mac	Ubuntu, Debian…	openSUSE
stabilna 19555	josm.jnlp	josm-tested.jar	setup.exe (pogledajte ispod)	package.zip (pogledajte ispod)	pogledajte ispod	pogledajte ispod
najnovija 19573	latest.jnlp	josm-latest.jar			pogledajte ispod
older		download/			dists/

Kada pokrećete skripta, molimo vas da uvek prvo proverite koja je najnovija, stabilna ili obe verzije kako biste izbegli nepotrebno preuzimanje i time smanjili saobraćaj.

Uklanjanje prevoda
Ukoliko je veličina preuzimanja potencijalni problem, dostupne su i manje datoteke stabilne verzije. Za preuzimanje verzije koja ima samo engleski jezik, na kraju u adresne linije dodajte ?lang=en. Da biste imali samo jedan prevod, zamenite en sa jezičkim kôdom (en) po vašoj želji (morate uneti početno malo slovo, samo jezika koji su podržani). Nadalje, veličinu datoteke možete smanjiti uklanjanjem informacija kojima se potvrđuje verodostojnost, dodavanjem ?unsigned=1.

Repozitorijumi

openSUSE

Stabilna verzija JOSM aplikacije je dostupna pod Application:Geo repozitorijumu.

Prvo dodajte root korisnika u yast ili pomoću zypper repozitorijuma (zamenite verziju u URL adresi sa onom koju koristite):

zypper ar -f https://download.opensuse.org/repositories/Application:/Geo/openSUSE_Leap_15.0 Application:Geo

Zatim jednostavno instalirajte josm i josm-fonts pakete.

Ubuntu

Ovaj paket je deo primarnog repozitorijuma za Ubuntu. On bi takođe trebalo da radi sa drugim Debian distribucijama (naročito onim čija je osnova Ubuntu), ali ne možemo aktivno da testiramo i održavamo nijednu drugu distribuciju sem Ubuntu.

Repozitorijum sadrži dva paketa:

• josm – Pruža testiranu verziju (stabilnu). Zamenite paket sa zvaničnim Ubuntu repozitorijumom.
• josm-latest – Najnovija verzija (noćna). Može se instalirati paralelno sa josm paketom. Podrazumevana fascikla je ~/.josm-latest.

Pored uobičajne procedure koja je opisana ispod, stariji DEB-ovi mogu samostalno da se preuzmu iz arhive.

Instalacija

Uredite paket liste resursa /etc/apt/sources.list:

sudo editor /etc/apt/sources.list

i dodajte jednu od sledećih linija u skladu sa vašom verzijom Ubuntu operativnog sistema:

deb https://josm.openstreetmap.de/apt xenial universe
deb https://josm.openstreetmap.de/apt artful universe
deb https://josm.openstreetmap.de/apt bionic universe
deb https://josm.openstreetmap.de/apt disco universe
# For other Debian based distributions add:
deb https://josm.openstreetmap.de/apt alldist universe

Pored toga, isto ovo možete da obavite upisom sledeće linije u Ubuntu operativnom sistemu:

echo deb https://josm.openstreetmap.de/apt $(lsb_release -sc) universe | ↩
↪sudo tee /etc/apt/sources.list.d/josm.list > /dev/null

Preuzimanje i registracija javnog ključa:

wget -q https://josm.openstreetmap.de/josm-apt.key -O- | sudo apt-key add -

Sada osvežite svoj izvor (može biti potrebno da instalirate sudo apt-get install apt-transport-https)

sudo apt-get update

i instalirajte:

# Uvek možete da preskočite prvu liniju ukoliko ovi paketi nisu ranije već instalirani.
sudo apt-get remove josm josm-plugins

# Za stabilnu verziju
sudo apt-get install josm
# Za verziju koja je u razvoju
sudo apt-get install josm-latest

Otklanjanje problema

Java

Kada dvostrukim klikom pokrenete jar datoteku i ništa se ne dogodi u većini slučajeva to znači da Java nije instalirana.

JOSM je proveren u Oracles varijanti, tako da vam preporučujemo da ​samostalno preuzmete Java sa njihovih stranica ili da preuzmete ​posredničke verzije. Ali prvo isprobajte da li je Java već stigla sa operativnim sistemom, ​na primer.

Kada birate koju verziju da preuzmete, imajte na umu da:

• Java dodatak za Web pregledače nije potreban da bi JOSM radio. Iz tog razloga, stranice poput www.java.com/en/download/installed8.jsp nisu relevantne.
• Java varijanta za 64-bitni sistem je preporučena za JOSM. Arhitektura operativnog sistema je važna kako bi se opredelili između 32-bittne ili 64-bitne Java podrške. Zbog toga, na JOSM se ne odnosi arhitektura Web pregledača, tako da preporuke na www.java.com/en/download/faq/java_win64bit.xml nisu relevantne.
• Izbegavate stranice poput www.java.com/en/download koje pokušavaju da instaliraju Java dodatke za Web pregledače. I zapamtite, ništa od ovoga nije potrebno za rad JOSM aplikacije.

For further information visit the Installation Notes and ​troubleshooting pages. 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).

Testing Java

Checks if Java is installed and why JOSM does not start (example mainly for MS Windows).

1. Download josm-tested.jar to your desktop.
2. Open a Command Prompt aka Terminal
3. Type cd %homepath%⏎ and type cd Desktop⏎
4. Type java -version ⏎ Three lines with the version data should appear. If you see something else then Java is not properly installed.
5. Type java -jar josm-tested.jar⏎. Now JOSM should run, started from the Command Line (en).
6. Quit JOSM.
7. Type josm-tested.jar⏎. If JOSM starts again, the Windows Explorer is ready for double clicks on jar files.

Web Start

Launching JOSM via Web Start has many more error causes than the traditional way with first downloading a jar file and afterwards starting it. So please test Java first and then run the tests described below or elsewhere ​Web Start issues.

Testing Web Start

1. Download josm.jnlp to your desktop.
2. Open a Terminal and move to the Desktop as above
3. Type javaws josm.jnlp⏎. This should initially download JOSM, show a security dialog and then launch JOSM.
4. If that fails, then type javaws -verbose josm.jnlp⏎. This should first show a dialog with information about the JVM and then launch JOSM.

Virtual Machine

Out of memory

Nowadays manually controlling Javas memory is seldom needed because available RAM on computers has grown. Wrongly chosen values can decrease JOSM performance.

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. If needed, use the command line (en) to set the ​Java Option -Xmx…m, for example -Xmx512m or -Xmx1536m. Formerly older java programs accepted -Xmx=512m or even -Xmx 512m. Now those malformed arguments throw error messages.

VM selection

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.

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.

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).

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!)

Example of an edited command line for a shortcut on the windows desktop:

javaws.exe -J-d64 -J-Xmx2048m  josm.jnlp 

Windows josm.exe

Using josm-setup.exe for installation on Microsoft Windows does the following:

• Puts the files josm-tested.jar and josm.exe in directory chosen by the user, default is C:\Program Files (86)\JOSM\
• Suggests to register josm.exe as target for the file extensions *.osm and *.gpx.
• 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).
• Asks if the Plug-Ins Imagery offset database and Turn restrictions should be provided.
• Adds uninstall data at the appropriate places.

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. Josm.exe acts as a wrapper and is portable (en).

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 ​options are possible and all usual JOSM Program arguments (en) too. See example:

# Write a log while starting JOSM and load OSM data
josm.exe --l4j-debug https://www.osm.org/way/476702262

For giving Java options (en) 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 ​Additional JVM options.

While being a 32-bit program, josm.exe seems to need a 64-bit Java on 64-bit Windows.

MacOS Errors

Apple has two mechanisms to protect you from using JOSM: ​File Quarantine and ​Gatekeeper.

Downloaded from the internet

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.

Damaged

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 that radio button is missing from the Security & Privacy preferences panel, open the Terminal window. The following command may become the radio button to appear.

sudo spctl --master-disable

Using brew

MacOS users may choose ​homebrew package manager as a universal way to install and update their JOSM instance.

Using brew cask eliminates most of the above-mentioned issues. (see. ​https://caskroom.github.io/).

Open Terminal and run the next commands to install or upgrade JOSM to the current tested version, respectively:

brew cask install josm

brew cask upgrade josm

Known issues

Not closed issues about ...:

• Java issues - some of the bugs lead to blockers in Oracle JVM (covered at JavaBugs).
• Linux
• Ubuntu
• MacOS
• Windows