| 134 | | [=#Doubleclickonafiledoesnothing When you double-click on a jar file and nothing happens] in most cases this means Java isn't installed. |
| 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 [/josm-tested.jar josm-tested.jar] 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. |
| | 138 | [=#Doubleclickonafiledoesnothing jar 파일을 더블 클릭했을 때 아무 일도 일어나지 않는다면] 대부분은 Java가 설치되지 않은 경우입니다. |
| | 139 | |
| | 140 | JOSM은 Oracle에서 배포판 프로그램에서 검사받았기 때문에, Oracle 홈페이지에서 [https://www.java.com/download/manual.jsp 수동으로]Java를 다운로드하거나 [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Java SE]를 다운로드하는 것을 권장합니다. 하지만 처음에는 운영 체제가 배포한 Java([https://en.wikipedia.org/wiki/OpenJDK 예시])가 이미 주어집니다. |
| | 141 | |
| | 142 | 다운로드할 때 다음을 명심하세요. |
| | 143 | * 웹 브라우저용 Java 플러그인은 JOSM을 구동하는 데 필요하지 **않습니다.** 그러므로 [https://www.java.com/ko/download/installed8.jsp www.java.com/ko/download/installed8.jsp] 같은 페이지의 결과와는 아무런 관련이 없습니다. |
| | 144 | * JOSM을 구동하는 데에는 64비트 Java를 권장합니다. 32비트/64비트 java를 선택할 때는 운영 체제 아키텍처가 중요합니다. 왜나하면 JOSM은 웹 브라우저 아키텍처에 영향을 받지 **않기** 때문입니다. 그러므로 [https://www.java.com/ko/download/faq/java_win64bit.xml www.java.com/ko/download/faq/java_win64bit.xml] 페이지에서 가장 추천하는 결과와는 아무런 관련이 없습니다. |
| | 145 | * 웹 브라우저용 Java 플러그인에 집중하는 [https://www.java.com/ko/download www.java.com/ko/download] 같은 페이지는 피하세요. 이는 JOSM에 중요하지 **않습니다.** |
| | 146 | |
| | 147 | 더 많은 정보는[InstallNotes 설치 참고]와 [https://www.java.com/ko/download/help/troubleshoot_java.xml 문제 해결] 페이지를 참조하세요. |
| | 148 | 이 단락에서 ''Java''는 JOSM을 구동하기 위한 JVM(Java Virtual Machine, Java 가상 머신)이 포함된 JRE(Java Runtime Engine, Java 런타임 엔진)을 의미하며, JDK(Java Development Kit, Java 개발 도구)를 사용해 개발되었으면서 때때로 JNLP(Java Network Launch Protocol, Web Start나 Java 플러그인의 대체재와 같은 Java 네트워크 구동 프로토콜)로 구동되는 Java 프로그램을 의미하기도 합니다. |
| | 149 | |
| | 150 | ==== Java 검사 ====#Javatest |
| | 151 | [=#Troubleshootingjarfile] Java가 설치되었는데 JOSM이 시작하지 않을 경우 검사하세요(예시는 주로 MS Windows). |
| | 152 | 1. [/josm-tested.jar josm-tested.jar]를 바탕화면에 다운로드하세요. |
| | 153 | 1. 터미널 같은 명령 프롬프트를 여세요. |
| | 154 | 1. `cd %homepath%`⏎를 치고 나서 `cd Desktop`⏎을 치세요. |
| | 155 | 1. `java -version `⏎을 치세요. Java 버전과 관련된 세 줄이 나타나야 합니다. 만약 다른 게 나타났다면 Java가 적절히 설치되지 않은 것입니다. |
| | 156 | 1. `java -jar josm-tested.jar`⏎를 치세요. [wikitr:/Help/CommandLineOptions 명령 줄]에서 바로 JOSM이 실행되어야 합니다. |
| | 157 | 1. JOSM을 닫으세요. |
| | 158 | 1. `josm-tested.jar`⏎를 치세요. JOSM이 다시 시작한다면, Windows 탐색기가 jar 파일을 더블 클릭할 준비가 된 것입니다. |
| 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: |
| | 163 | Web Start로 JOSM을 구동하는 것은 jar 파일을 다운로드한 뒤 jar 파일을 실행하는 전통적 방식으로 구동하는 것보다 오류를 일으킬 더 많은 원인을 가지고 있습니다. |
| | 164 | 그렇기 때문에 [#JavaTest Java]를 먼저 검사한 후 아래에 설명된(또는 다른 곳에 설명된 [https://www.java.com/en/download/faq/java_webstart.xml Web Start 문제]) 검사를 해 주세요. |
| | 165 | |
| | 166 | ==== Web Start 검사 ====#Webstarttest |
| | 167 | 1. [/josm-tested.jar josm.jnlp]를 바탕화면에 다운로드하세요. |
| | 168 | 1. 명령 프롬프트를 열고 위처럼 바탕화면으로 이동하세요. |
| | 169 | 1. `javaws josm.jnlp`⏎를 입력하세요. 먼저 JOSM을 다운로드해야 하며, 보안 대화 상자를 띄운 후 JOSM이 켜져야 합니다. |
| | 170 | |
| | 171 | === 가상 머신 ===#Troubleshootingjvm |
| | 172 | |
| | 173 | ==== 메모리 초과 ==== |
| | 174 | |
| | 175 | 오늘날에는 수동으로 Java 메모리를 조정하는 일은 거의 필요하지 않습니다. 컴퓨터에서 사용 가능한 메모리의 용량이 커졌기 때문입니다. |
| | 176 | 잘못 지정한 값은 JOSM 성능을 떨어뜨릴 수 있습니다. |
| | 177 | |
| | 178 | 몇몇 작업에서 JOSM은 메모리를 많이 차지합니다. 한편으로는 더 많은 플러그인과 지물을 지원하도록 메모리 크기를 설정할 필요가 있을 수도 있습니다. 다른 한편으로는 Java 메모리 사용량을 제한해서 컴퓨터를 안정시킬 수 있습니다. |
| | 179 | 만약 필요하다면, [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html#BABHDABI Java 옵션] -Xmx…m(예를 들어 `-Xmx512m`이나 `-Xmx1536m`)을 설정하기 위해 [wikitr:Help/CommandLineOptions 명령 줄]을 사용하세요. |
| | 180 | 이전의 더 오래된 Java 프로그램은 `-Xmx=512m`이나 심지어 `-Xmx 512m`도 받아들였습니다. 오늘날 그러한 잘못된 인수는 오류 메시지를 출력합니다. |
| | 181 | |
| | 182 | |
| | 183 | ==== 가상 머신 선택 ====#VMselectiononWindowsx64 |
| | 184 | |
| | 185 | MS Windows의 현재 버전에서는 기본적으로 Java가 `C:\Program Files\Java\` 디렉토리에 주로 설치되어 있습니다. 추가 파일은 `C:\Program Files\Oracle\Java\`에 위치해 있습니다. PATH 환경 변수의 대상으로 `.\javapath\` 디렉토리가 있습니다. 이는 세 가상 머신 파일 `java.exe`, `javaw.exe`, `javaws.exe`의 기본 위치입니다. 이 파일들은 현재 Java 설치를 구성하는 상징적인 연결 고리입니다. |
| | 186 | |
| | 187 | 64비트 Windows의 더 오래된 버전에서는 때때로 32비트 모드 JRE가 추가로 설치됩니다. 또한 몇몇 브라우저는 제한된 기능만 탑재된 브라우저용 JVM을 가져옵니다. 이 경우에서 브라우저에서 Web Start는 브라우저용 JVM을 사용하고 사용자가 설치한 Java를 사용하지 않을 수 있습니다. |
| | 188 | |
| | 189 | {{{\Windows\SysWow64}}}에 다른 javawebstart가 없는지 확인하세요. Java 제어판은 다른 javawebstart를 감지하지 못하기 때문에 다른 javawebstart 파일을 안전하게 삭제할 수 있습니다. 각각(32비트/64비트) JRE의 최신 버전만 남겨 두고 지우세요. |
| | 190 | |
| | 191 | 바탕화면에 생성된 JNLP 바로가기와 Javawebstart 실행기의 구동을 위해, 확실하게 VM 옵션 앞에 공백이 없으면서 -J 접두사를 붙인 VM 파라미터를 전달하세요. 만약 32비트/64비트 버전을 둘 다 설치했고, 선호받는 64비트 VM을 선택하고 싶다면 "{{{-d64}}}" 옵션을 전달해야 합니다. 몇몇 Oracle 페이지는 "-D64"라는 잘못된 대문자 표기를 가리키고 있다는 점을 명심하세요! |
| | 192 | |
| | 193 | 바탕화면에 있는 바로가기를 위한 명령 줄의 예시 |
| 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 |
| | 201 | Microsoft Windows에서 josm-setup.exe를 사용해서 설치하는 것은 다음의 행동을 하는 것과 같습니다. |
| | 202 | * `josm-tested.jar`와 `josm.exe` 파일을 사용자가 선택한 디렉토리(기본 값은 `C:\Program Files (86)\JOSM\`)에 넣습니다. |
| | 203 | * josm.exe를 `*.osm`과 `*.gpx` 확장자를 가진 파일의 연결 프로그램으로 등록하도록 제안합니다. |
| | 204 | * JOSM 바로가기 아이콘을 바탕화면과 시작 메뉴에(현재는 바로가기가 관리자 전용 계정에 위치해 있으며 위치한 곳에서 복사할 수 있습니다, #11398) 추가하도록 제안합니다. |
| | 205 | * 플러그인 이미지 오프셋 데이터베이스와 회전 제한을 제공해야 하는지 물어봅니다. |
| | 206 | * 적절한 위치에 제거 파일을 추가합니다. |
| | 207 | |
| | 208 | 시작할 때, josm.exe는 자신의 디렉토리에서 jar 파일을 검색한 뒤, 명령어 `\path\to\javaw.exe -Xms128m -Xmx1024m -jar \path\to\josm-tested.jar`를 실행합니다. |
| | 209 | josm.exe는 ''포장지''처럼 행동하며, [wikitr:/USB_Stick 포터블] 파일입니다. |
| | 210 | |
| | 211 | josm.exe가 인수 `--l4j-debug`를 찾았을 때, josm.exe는 현재 디렉토리에(쓰기 가능하다면) 로그 파일 `launch4j.log`를 작성합니다. 몇몇 다른 [http://launch4j.sourceforge.net/docs.html#Runtime_options 옵션]을 덧붙여 사용할 수 있으며, 통상적인 모든 [wikitr:/Help/CommandLineOptions#Programarguments JOSM 프로그램 인수]들도 덧붙여 사용할 수 있습니다. |
| | 212 | |
| | 213 | 예시: |
| | 214 | {{{ |
| | 215 | #!sh |
| | 216 | # JOSM을 시작하는 동안 로그를 작성하고 OSM 데이터를 불러오기 |
| 234 | | 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. |
| 235 | | |
| 236 | | Open System Preferences and the 'Security & Privacy' options. Set 'Allow applications downloaded from:' to 'Anywhere'. |
| 237 | | |
| 238 | | 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. [[Image(SecurityPrivacy.png,align=right,float=left,width=300)]] |
| | 238 | 만약 "'JOSM.app'은 손상되었기 때문에 열 수 없습니다. 휴지통으로 옮겨야 합니다."라는 오류를 보았다면 임시로 Gatekeeper를 비활성화해야 합니다. |
| | 239 | |
| | 240 | 시스템 환경 설정을 열고 '보안&개인정보' 옵션을 여세요. '앱이 다음 위치에서 다운로드하도록 허락:'을 '모든 곳'으로 설정하세요. |
| | 241 | |
| | 242 | 만약 보안&개인정보 환경 설정에 버튼이 없다면 터미널 창을 여세요. 다음 명령어를 입력하면 버튼이 나타날 수 있습니다. [[Image(Download:SecurityPrivacy.png,align=right,float=left,width=300)]] |