이클립스 서버이전할 때 설정부터 확인하는 방법

1회
이클립스 서버이전할 때 설정부터 확인하는 방법

얼마 전 이클립스에서 잘 실행되던 프로젝트를 새 서버로 옮겼는데, 첫 요청부터 오류가 난다는 연락을 받았다. 파일은 빠짐없이 복사돼 있었다. 문제는 새 서버의 자바 버전과 톰캣 설정이었다. 이클립스 서버이전은 프로젝트를 복사하는 작업과 실제 서비스 환경을 옮기는 작업을 나눠서 봐야 한다.

옮기기 전에 서버 구성을 적어둔다

먼저 기존 환경의 자바, 톰캣, 데이터베이스 버전과 애플리케이션이 사용하는 포트를 확인한다. 이클립스의 Servers 보기에서 서버에 연결된 프로젝트와 발행 설정도 본다. 프로젝트 속성의 Project Facets와 Runtimes에는 어떤 서버 환경을 대상으로 빌드하는지 표시된다. 이클립스 공식 문서에서도 서버 런타임을 서버 종류와 버전, 설치 경로, 경우에 따라 자바 실행 환경으로 구분한다. 새 장비에서 경로만 맞춘다고 같은 환경이 되는 건 아니다.

특히 톰캣 9에서 실행하던 애플리케이션을 톰캣 10으로 바로 옮길 때는 주의해야 한다. 사용하는 서블릿 API 계열이 달라 기존 코드나 라이브러리를 손봐야 할 수 있다. 이전과 동시에 버전을 올리면 장애 원인을 찾기 어려워진다. 특별한 이유가 없다면 첫 이전은 기존 버전에 맞추고, 업그레이드는 서비스가 안정된 뒤 별도 작업으로 잡는 편이 낫다.

환경 목록에는 서버에만 있는 파일도 넣는다. 데이터베이스 접속 정보, 환경 변수, 인증서와 개인키, 업로드 파일, 예약 작업, 로그 경로가 대표적이다. 소스 저장소에는 이런 값이 없을 수 있다. 이클립스에서 프로젝트가 정상적으로 열리는 것과 운영에 필요한 데이터가 모두 준비된 것은 별개다.

백업은 복구할 수 있는 형태로 만든다

이전 전 백업은 프로젝트 폴더 하나로 끝내지 않는다. 소스와 빌드 산출물, 데이터베이스, 사용자 업로드 파일, 서버 설정을 각각 챙긴다. 데이터베이스와 업로드 파일은 같은 시점의 상태여야 한다. 게시글은 백업됐는데 첨부파일은 그보다 한 시간 전 사본이라면 복구 후 깨진 파일이 생긴다. 쓰기가 계속 발생하는 서비스라면 짧은 점검 시간을 잡거나 데이터베이스의 일관된 백업 기능을 사용한다.

  • 기존 서버의 버전, 포트, 실행 계정, 배포 경로를 기록한다.
  • 데이터베이스 백업 파일을 만든 뒤 별도 위치에서 복원해 읽히는지 확인한다.
  • 업로드 파일과 설정 파일을 복사하고 파일 수와 용량을 대조한다.
  • 인증서, 비밀값, 예약 작업 목록을 별도로 확인한다.
  • 기존 서버를 언제까지 유지할지와 되돌리는 순서를 적어둔다.

백업 파일이 있다는 사실만으로 안심하기는 어렵다. 실제로 복원해 테이블 수와 주요 데이터가 맞는지 봐야 한다. 10분이면 복원되는 줄 알았던 데이터베이스가 한 시간 넘게 걸리면, 그 차이가 곧 서비스 중단 시간으로 이어진다. 이전 당일보다 며칠 앞서 한 번 복원해 보는 이유다.

광고

새 환경에서 프로젝트와 서버를 연결한다

새 장비에는 먼저 필요한 자바와 애플리케이션 서버를 설치한다. 그다음 이클립스에서 프로젝트를 가져오고, Preferences의 Server Runtime Environments에서 새 설치 경로를 등록한다. 프로젝트의 Project Facets에서 대상 런타임을 확인한 뒤 Servers 보기에 서버를 만들고 프로젝트를 추가한다. 이클립스 공식 문서에 따르면 Servers 보기의 Publish는 프로젝트 파일과 서버 설정을 실행 위치로 복사한다. 화면에 프로젝트가 보인다고 배포까지 끝난 것은 아니다.

빌드가 실패하면 누락된 라이브러리, 자바 버전, 프로젝트 인코딩부터 본다. 실행은 되는데 접속이 안 된다면 애플리케이션 로그를 먼저 확인하고, 이어서 포트가 열려 있는지와 방화벽 규칙을 본다. 데이터베이스 연결 오류라면 주소와 계정뿐 아니라 새 서버에서 데이터베이스까지 네트워크가 닿는지도 확인한다. 증상별로 순서를 정해두면 설정을 무작정 바꾸는 시간을 줄일 수 있다.

운영 서버에 이클립스를 직접 설치할 필요는 없는 경우가 많다. 이클립스는 개발과 검증에 쓰고, 검증된 빌드 결과물을 운영 서버에 배포하면 된다. 이때 이클립스의 로컬 실행 설정과 운영 서버 설정을 혼동하지 않아야 한다. 포트나 파일 저장 경로가 개발 PC 기준으로 남아 있으면 새 서버에서 다시 문제가 난다.

전환 직후에는 쓰기 동작까지 확인한다

새 서버를 먼저 내부에서 검사한다. 첫 화면만 보는 것으로는 부족하다. 로그인, 데이터 조회와 저장, 파일 업로드, 예약 작업, 외부 연동을 각각 확인한다. 요청 한 건이 성공해도 업로드 디렉터리 권한이 틀리면 실제 사용 중에 장애가 난다. 로그에는 오류뿐 아니라 응답 지연과 메모리 부족 징후가 없는지도 본다.

서비스 주소를 새 서버로 전환하기 전에는 접속 대상이 바뀌는 데 걸리는 시간을 고려한다. 전환 뒤에도 일부 이용자가 기존 서버에 붙을 수 있으므로 양쪽에서 동시에 글이 쓰이는 상황을 피해야 한다. 쓰기 중지 시간을 짧게 잡고 최종 데이터를 옮긴 뒤 전환하는 방식이 안전하다. 문제가 생겼을 때 되돌릴 기존 서버와 데이터 상태도 그때까지 보존한다.

작은 사이트라면 서버 사양을 올리는 것보다 이 순서에 시간을 쓰는 편이 효과적이다. 제가 겪은 이전 장애도 CPU가 모자라서보다 런타임 버전, 빠진 파일, 확인하지 않은 백업에서 더 자주 시작됐다. 이클립스에서 정상 실행됐다는 표시보다 새 서버에서 실제 데이터를 읽고 쓸 수 있다는 확인을 믿는다.

이클립스 서버이전할 때 설정부터 확인하는 방법 - 요약
광고

댓글 0

평가를 남기려면 로그인해 주세요.

모두 ID로 로그인

불러오는 중…