Ko:JOSM/설치

From OpenStreetMap Wiki
< Ko:JOSM(Redirected from Ko:JOSM/Installation)
Jump to navigation Jump to search

JOSM 설치는 정말 간단합니다. 설치 절차가 거의 없습니다! 단지 jar 파일을 다운로드하여 실행하거나 웹 시작을 사용하십시오. 하지만 이러한 설치 절차는 잘 풀리지 않을 수도 있습니다. 이 문서는 시스템 요구 사항에 대한 자세한 내용, JOSM의 실행 방법, 가장 효과적인 설정 방법, 다양한 설치 문제 해결 방법에 대한 링크를 제공합니다.

이 절차를 끝냈다면, JOSM 사용을 위해 Ko:JOSM/Guide 문서를 참조하십시오.

요구 사항

  • Java 8 (Java 9 지원)
  • 512 MB 이상의 메모리
  • 1024×768 이상의 해상도
  • (권장) 2D 그래픽 가속을 지원하는 그래픽 카드

다운로드

JOSM은 JOSM 홈페이지에서 다운로드받을 수 있습니다.

"tested"와 "latest"

"tested"와 "latest" 사이의 선택은 최신 기능을 시험하는 것을 돕고 싶어 하는지에 달려 있습니다. "tested"는 JOSM의 안정적인 버전이며, 안정적인 개발 지점에 배치되었습니다. "latest"는 모든 최신 기능을 포함하지만 모든 최신 버그를 포함하는 버전입니다. "latest"로 작업하는 것은 프로젝트에 도움(버그 제보, 기능 추가 제안 등)이 됩니다. 현재는 플러그인 버전이 관리되는 방식 때문에 문제가 발생하지 않을 수도 있지만, "tested"는 모든 플러그인을 자동으로 설치·업데이트하는 경우 최신 버전의 플러그인을 불러오려 하며, 이러한 플러그인은 이후 버전의 JOSM이 필요하다는 불만을 표시할 수 있습니다. 그렇기 때문에 적절한 시점에 새 플러그인이 업데이트되길 희망해야 합니다.

보안 다운로드

여기에 있는 다운로드 링크는 기본적으로 JOSM의 웹사이트에 있는 SSL/HTTPS 보안 다운로드를 가리킵니다. 그렇기에 보안 다운로드를 위해 보통 다른 노력은 필요하지 않습니다. JOSM 웹사이트는 현재 “GlobalSign” CA가 발급한 보안 인증서를 사용하고 있습니다. 만약 CA를 믿지 못하겠다면, 외부 소스를 참조해서 fingerprint를 비교할 수 있습니다.

많은 Linux 배포판은 JOSM 패키지를 제공합니다. JOSM/Linux를 참조하십시오. Linux-distro를 사용하는 것은 바로 다운로드해서 사용 가능한 JOSM보다 더 버전이 오래됐을 수 있지만 HTTPS를 통해서 다운로드하는 것의 대안책이 될 수 있습니다. 이 방법은 사용하고 있는 배포판 패키지 관리 시스템으로 JOSM이 자동 업데이트된다는 이점이 있습니다.

참고로, 이 위키 문서를 보기 위해서 HTTPS로 전환하는 것이 좋습니다.

JOSM 시작

jar 파일을 Java 런타임으로 구동해야 합니다. 보통 GUI 운영체제(Windows, Mac OS X, 몇몇 Linux 배포판)에서는 josm.jar 파일을 더블클릭합니다. 만약 작동하지 않거나 몇 가지 옵션을 지정해야 한다면, Java 애플리케이션을 돌리는 방법을 보십시오.

JOSM은 많은 메모리를 필요로 할 수 있습니다. Java의 기본값에서 최댓값은 상당히 적은 편입니다. 사용 가능한 메모리를 늘리기 위해 옵션 -Xmx1024m를 설정하십시오.

2D 그래픽 가속 옵션(-Dsun.java2d.opengl=true)을 권장합니다. 작업을 사용하도록 설정할 때 상세한 피드백을 받으려면 -Dsun.java2d.opengl=True를 사용하십시오. 이때 T는 대문자여야 합니다.

플랫폼별 지침

JOSM은 Java 애플리케이션입니다. Java 애플리케이션은 Java 플랫폼을 구동시킬 수 있는 모든 환경에서 돌아가지만, 다양한 플랫폼과 운영 체제마다 특성이 있습니다. 구체적인 지침은 하위 문서 JOSM/Linux, JOSM/Mac, JOSM/Windows 참조.

USB에서 JOSM을 돌리는 방법은 JOSM/HOWTO/Run from flash disk with Java 참조.

JOSM 업데이트

JOSM은 자동으로 업데이트를 확인하고 시작 화면에서 업데이트를 알려줄 것입니다. 수동 확인을 위해서는 사용하는 JOSM이 버전이 몇인지 프로그램의 'About' 메뉴에서 찾습니다. The JOSM website indicates what the 'current' version is (current latest and current tested).

If you decide you want to upgrade, the steps are broadly speaking as follows. This only applies if you do not use the "Java Web Start" option (it will update automatically via Web Start).

  • Download the JOSM jar file again.
  • Find where your existing jar file was.
  • Delete it or rename the old jar file, and place the new one in its place.

However the exact approach you used to install JOSM may mean mean it's difficult to find the jar file, and there may be alternative (better) means of upgrading, e.g. using package managers, or re-installing from an installer. Please follow the relevant link in the section of above for platform specific instructions.

Troubleshooting

JOSM seems to start okay, but the window is blank

If you have the fancy, compiz/beryl graphics stuff enabled, then this may happen. The solution is simple, add the following line to the user profile:

export AWT_TOOLKIT="MToolkit"

or put this in the "Run Application" dialog:

compiz --replace && export AWT_TOOLKIT=MToolkit

This also happens under tiling window managers such as ratpoison and stumpwm with Java 6 VMs (no problem with IcedTea/Java 7). It seems like JOSM demands to adjust its geometry in a certain way and when it can't panics.

  • This workaround is not needed for OpenJDK 1.6 with StumpWM git as of 2009-02-28.

A workaround is either to launch JOSM under Xnest, or in a separate X server. To start ising Xnest:

Xnest :1 -ac -geometry 1280x1024
DISPLAY=:1 java -jar josm-latest.jar

You may also need a window manager, this example uses fluxbox:

Xnest :1 -ac -geometry 1280x1024
fluxbox -display :1
DISPLAY=:1 java -Xmx1024m -jar josm-custom.jar

Similarly, to launch under Xephyr (an alternative to Xnest):

Xephyr :1 -ac -screen 1280x1024
DISPLAY=:1 java -Xmx1024m -jar josm-latest.jar

One could also export the AWT_TOOLKIT variable above but that doesn't seem to work for certain things, e.g. the download dialog is zero-sized.

To use another instance of the X server (a dedicated $DISPLAY for JOSM):

X :1
fluxbox -display :1
DISPLAY=:1 java -Xmx1024m -jar josm-latest.jar

Now you can switch between displays using Ctrl+Alt+F7 and Ctrl+Alt+F8.


A workaround for many java+tiling window manager related problems is to:

  • If you are using openjdk6, add export _JAVA_AWT_WM_NONREPARENTING=1 in /etc/profile.d/openjdk6.sh.
  • If you are using jre7-openjdk, add export _JAVA_AWT_WM_NONREPARENTING=1 in /etc/profile.d/jre.sh.

See also