매뉴얼웍스 6.0에서 자바 25 사용을 권장합니다

매뉴얼웍스 7.0 버전은 2026년 1월 초 릴리스 예정이며, 이 버전부터 자바 25 이상을 기준으로 지원합니다. 이에 따라 매뉴얼웍스 6.0을 운영 중인 고객도 미리 자바 25로 업그레이드하는 것을 권장합니다.

매뉴얼웍스 6.0은 자바 8, 11, 17, 21, 25 같은 LTS(Long Term Support) 버전을 지원합니다. 따라서 지금 바로 매뉴얼웍스 7.0으로 업그레이드하지 않더라도, 현재 운영 중인 6.0 환경에서 먼저 자바 25를 적용해 볼 수 있습니다.

자바 업그레이드는 운영 환경에 영향을 줄 수 있는 작업입니다. 그래서 제품 버전 업그레이드와 자바 업그레이드를 한 번에 진행하기보다, 매뉴얼웍스 6.0을 사용하는 동안 자바 25 전환을 먼저 검토하는 편이 안정적입니다.

왜 자바 25로 미리 전환해야 하나요?

매뉴얼웍스 7.0 전환을 준비할 수 있습니다

매뉴얼웍스 7.0은 자바 25 이상을 기준으로 지원합니다. 6.0 버전에서 미리 자바 25로 운영해 두면, 나중에 7.0으로 업그레이드할 때 확인해야 할 변수가 줄어듭니다.

제품 업그레이드와 자바 업그레이드를 동시에 진행하면 문제가 발생했을 때 원인을 나누어 보기 어렵습니다. 반대로 자바 25 전환을 먼저 끝내 두면, 7.0 업그레이드 시에는 제품 변경 사항에 더 집중할 수 있습니다.

성능과 운영 안정성을 함께 기대할 수 있습니다

자바 25는 이전 LTS 버전보다 개선된 성능과 최신 런타임 기능을 제공합니다. 매뉴얼웍스도 자바 25를 기준으로 더 안정적인 테스트와 개선을 이어갈 수 있습니다.

운영 환경마다 체감 성능은 다를 수 있지만, 장기적으로는 오래된 자바 버전을 유지하는 것보다 최신 LTS 버전으로 전환하는 편이 운영과 유지보수에 유리합니다.

이미 많은 고객이 더 높은 버전에서 운영 중입니다

이미 자바 25 환경에서 매뉴얼웍스를 운영하는 많은 고객이 있습니다. 실제 운영 환경에서 검증된 사례가 쌓이고 있는 만큼, 자바 25로의 전환은 충분히 안심하고 진행할 수 있습니다.

자바 버전 전환이 부담스럽게 느껴진다면, 이미 더 높은 버전에서 문제없이 사용하고 있는 고객들이 있다는 점을 참고해 주세요.

매뉴얼웍스 6.0에서 먼저 확인할 사항

자바 25 전환은 매뉴얼웍스 제품을 변경하는 작업이 아니라, 매뉴얼웍스를 실행하는 자바 버전을 바꾸는 작업입니다. 문제가 생기면 매뉴얼웍스 실행 설정을 이전 자바로 되돌리면 됩니다.

어떤 자바를 설치해야 하나요?

오라클 자바를 사용할 수 있는 환경이라면 오라클 자바를 사용하는 것을 권장합니다.

오라클 자바를 사용하기 어렵다면 OpenJDK 배포판인 Eclipse Temurin을 사용하는 것을 권장합니다. OpenJDK 자체도 사용할 수 있지만, openjdk.org에서 제공하는 빌드는 마이너 버전 업데이트를 계속 제공하지 않습니다. 따라서 운영 환경에서는 Eclipse Temurin처럼 지속적인 업데이트를 제공하는 배포판을 선택하는 것이 좋습니다.

전환 작업을 시작하기 전에 다음 항목을 사전에 확인합니다.

현재 매뉴얼웍스를 실행하고 있는 자바 버전을 확인합니다.
매뉴얼웍스 실행에 사용하는 JAVA_HOME 또는 서비스 설정의 위치를 파악합니다. 문제가 생겼을 때 이전 자바로 되돌릴 수 있도록 기존 설정을 백업해 둡니다.
외부 데이터베이스를 사용한다면 데이터베이스 드라이버가 자바 25를 지원하는지 확인합니다.

H2 데이터베이스를 사용하는 환경에서는 자바 11 이상이 필요합니다. 매뉴얼웍스 6.0.14 버전부터는 H2를 사용하므로, 오래된 자바 8 환경을 유지하고 있다면 자바 업그레이드를 반드시 검토해야 합니다.

권장 전환 순서

자바 25 전환은 다음 순서로 진행하는 것을 권장합니다.

운영 서버에 자바 25를 설치합니다. 오라클 자바를 사용할 수 있다면 오라클 자바를, 그렇지 않다면 Eclipse Temurin을 사용합니다.
매뉴얼웍스 실행에 사용하는 JAVA_HOME 또는 서비스 설정을 자바 25로 변경합니다.
매뉴얼웍스를 시작합니다.
로그인, 문서 조회, 문서 편집, 파일 업로드, 검색 같은 주요 기능을 확인합니다.
운영 반영 후 로그를 확인합니다.
문제가 생기면 매뉴얼웍스 실행 설정을 이전 자바로 되돌립니다.

운영 환경에 따라 서비스 등록 방식이나 데이터베이스 연결 방식이 다를 수 있습니다.

마무리

매뉴얼웍스 6.0은 자바 25 전환을 미리 준비할 수 있는 버전입니다. 2026년 1월 초 예정인 매뉴얼웍스 7.0 릴리스 전에 자바 25로 운영 환경을 정리하면 업그레이드 시점의 부담을 줄일 수 있습니다.

매뉴얼웍스 7.0으로 더 자연스럽게 전환하려면, 6.0을 운영하는 지금부터 자바 25 적용을 검토해 주세요.

자바 25 버전으로 업데이트하세요.