주의 사항

서버 이전에 따른 라이선스 키 변경

매뉴얼웍스를 설치한 서버를 이전하면 서버 아이디 변경에 따라 라이선스 키를 교체해야 합니다. 다음을 주의합니다.

라이선스 키 재발급은 무상 유지 보수 기간에 있거나 유지 보수 계약을 맺은 고객에게만 적용하는 서비스입니다. 따라서 무상 유지 보수 기간이 지났고 유지 보수 계약을 맺지 않았다면 서버 이전에 따라 비용이 발생합니다.
서버 이전 후에 매뉴얼웍스를 시작한 후 새로운 서버 아이디를 확인해야 라이선스 키 발급이 가능합니다.

네트워크 연결 확인

만약 기본 데이터베이스가 아닌 오라클 등의 데이터베이스를 사용하고 있다면 새로운 서버에서도 데이터베이스에 연결할 수 있어야 합니다. 다음에 대해서 방화벽 등을 확인해야 합니다.

서버 이전하기

3RABBITZ_HOME은 매뉴얼웍스를 설치한 디렉터리를 지칭합니다.

매뉴얼웍스 복사하기

기존 서버와 새로운 서버의 운영 체제가 같다면 기존 서버에 있는 매뉴얼웍스를 새로운 서버에 복사합니다. 기존 서버와 새로운 서버의 운영 체제가 다르다면 새로운 서버에 매뉴얼웍스를 새로 설치해야 합니다.

운영체제가 같을 때

리눅스에서 리눅스(또는 유닉스), 윈도우에서 윈도우로 매뉴얼웍스를 옮긴다면 다음 순서로 작업합니다.

기존 매뉴얼웍스를 정지합니다.
기존 3RABBITZ_HOME 디렉터리를 새로운 서버에 모두 복사합니다.
- 같은 위치로 복사할 필요는 없습니다.

운영체제가 다를 때

리눅스에서 윈도우, 윈도우에서 리눅스로 매뉴얼웍스를 옮긴다면 다음 순서로 작업합니다.

새로운 서버에 해당 운영 체제에 맞는 매뉴얼웍스를 새로 설치합니다. 자세한 사항은 매뉴얼웍스 6.0 설치 가이드를 참고합니다.
새로 설치한 매뉴얼웍스를 정지합니다.
기존 매뉴얼웍스를 정지합니다.

기존 서버에서 다음 파일을 새로운 서버로 복사합니다. 3RABBITZ_HOME 디렉터리를 기준으로 같은 디렉터리에 복사합니다.

3RABBITZ_HOME/preference.properties
3RABBITZ_HOME/crawler.properties(해당 파일이 있다면)
3RABBITZ_HOME/tomcat/conf/logging.properties
3RABBITZ_HOME/tomcat/conf/server.xml
3RABBITZ_HOME/tomcat/conf/web.xml
3RABBITZ_HOME/web/WEB-INF/web.xml
3RABBITZ_HOME/web/WEB-INF/lib 디렉터리

데이터와 백업 디렉터리 복사하기

데이터 디렉터리와 백업 디렉터리 위치는 3RABBITZ_HOME/preference.properties 파일에서 확인합니다.

기존 서버와 새로운 서버의 운영 체제가 같고, 데이터와 백업 디렉터리 위치가 3RABBITZ_HOME 아래에 있다면 이 과정을 생략할 수 있습니다.

DB_DIR: 데이터 디렉터리 위치
BACKUP_DIR: 백업 디렉터리 위치

상대 경로의 시작 위치는 3RABBITZ_HOME/bin 디렉터리입니다.

기존 서버와 새로운 서버의 데이터와 백업 디렉터리 위치가 다르다면 새로운 서버의 3RABBITZ_HOME/preference.properties 파일에 이를 반영합니다.

리눅스(유닉스) 운영 체제에서는 매뉴얼웍스 실행하는 운영 체제 계정이 해당 데이터/백업 디렉터리에 쓰기 권한이 있는 지 확인합니다.

로그 파일 복사

로그 파일을 저장하는 기본 디렉터리 위치는 3RABBITZ_HOME/logs 디렉터리입니다. 이를 변경했다면 새로운 서버에도 반영합니다.

기존 서버와 새로운 서버의 운영 체제가 같고, 로그 파일 디렉터리 위치가 3RABBITZ_HOME 아래에 있다면 이 과정을 생략할 수 있습니다.

로그 파일을 저장하는 디렉터리 위치는 3RABBITZ_HOME/tomcat/conf/logging.properties 파일에서 확인합니다.
새로운 서버에 로그 파일을 저장하는 디렉터리가 없다면 새로 만듭니다.
리눅스(유닉스) 운영 체제에서는 매뉴얼웍스 실행하는 운영 체제 계정이 해당 로그 디렉터리에 쓰기 권한이 있는 지 확인합니다.

과거 로그를 확인해야 한다면 기존 서버 로그 파일을 새로운 서버 로그 디렉터리에 복사합니다.

HTTPS 인증서 파일 복사

별도 웹 서버가 아닌 매뉴얼웍스에서 HTTPS를 설정했다면 다음 파일을 참고해서 인증서 파일을 새로운 서버에 복사합니다.

3RABBITZ_HOME/tomcat/conf/server.xml

매뉴얼웍스 시작

새로운 서버에서 매뉴얼웍스를 시작합니다. 자세한 사항은 다음 가이드를 참고합니다.

라이선스 키 교체

새로운 서버에서 매뉴얼웍스를 시작하면 기존 라이선스 키가 적합하지 않아 메뉴와 문서 등이 보이지 않습니다. 새로운 서버에 맞는 라이선스 키로 교체합니다.

운영 체제가 달라 새로 설치를 했다면 라이선스 키를 교체할 필요가 없을 수도 있습니다.

새로운 서버에 옮긴 매뉴얼웍스의 서버 아이디를 확인합니다. “관리” 권한이 있는 사용자로 로그인하여 <환경 설정 | 라이선스> 메뉴에서 확인합니다.
새로운 라이선스 키를 발급 받습니다. 자세한 사항은 라이선스 키 발급 방법을 참고합니다.
라이선스 키를 바꿉니다. 자세한 사항은 라이선스 키 바꾸기를 참고합니다.

서버 옮기기