Zextras Backup 또는 imapsync를 사용하여 Zimbra 사서함을 새 서버로 마이그레이션하는 방법

Zimbra에서 Zimbra로 완벽하게 데이터를 이전하려면 이메일 외의 사서함 데이터도 필요한 경우 Zextras Backup에서 지원하는 마이그레이션 워크플로를 사용하십시오. 두 서버 모두 IMAP을 통해 계정을 노출하고 메시지, 폴더 및 플래그만 마이그레이션하려는 경우에는 imapsync를 사용하십시오. Zextras는 기존의 Zextras 마이그레이션 도구는 더 이상 사용할 수 없다고 밝혔습니다. Zextras의 Zimbra 마이그레이션 가이드에서는 관리자에게 Zextras Backup을 사용하도록 안내합니다. imapsync는 IMAP 사서함을 복사하는 별도의 명령줄 옵션이며, 캘린더, 연락처, 공유 폴더 또는 계정 설정과 같은 데이터를 마이그레이션하는 Zimbra 인식 마이그레이션을 대체하는 것은 아닙니다.

이러한 차이점 때문에 새 서버에서 프로비저닝 및 테스트해야 하는 범위가 결정됩니다. MX 레코드를 변경하거나 사용자가 대상 서버에서 작업하기 전에 원본 및 대상 서버 버전, 라이선스, 인증, 스토리지, 그리고 보존해야 하는 정확한 데이터를 확인해야 합니다.

2026년 10월 6일 문서 확인 완료. 공식 imapsync 사이트에는 2.314 버전이 등록되어 있습니다. Zextras의 마이그레이션 관련 문서에서는 기존 마이그레이션 도구를 사용할 수 없으며 Zextras 백업 방법을 안내합니다. Zextras 페이지 및 예제는 버전에 따라 다를 수 있으므로 실제 운영 환경에서 사용하기 전에 설치된 Zextras 및 Zimbra 버전에 맞춰 유효성을 검사하십시오.

1. 필요한 데이터에 맞는 경로를 선택하세요.

Zextras에서 발행한 Zimbra 마이그레이션 가이드에는 백업 워크플로를 통해 마이그레이션할 수 있는 항목으로 이메일 및 폴더, 연락처, 캘린더, 작업, 공유 폴더, 환경 설정, 서명, ID, 그리고 일부 도메인 또는 서비스 등급 데이터가 나열되어 있습니다. 또한 서버 구성, LDAP 구성, MTA 또는 프록시 구성, 사용자 지정 브랜딩은 마이그레이션되지 않는다고 명시되어 있습니다. 정확한 마이그레이션 가능 항목은 제품 버전 및 설정에 따라 달라지므로, 해당 목록은 마이그레이션 범위 확인용으로만 활용하고 최신 문서에서 필요한 각 항목을 확인하십시오.

Imapsync는 IMAP을 통해 작동합니다. 사서함 폴더와 메시지를 복사하고 대상에서 지원하는 메시지 플래그를 동기화할 수 있습니다. 하지만 Zimbra 서버의 LDAP 디렉터리, 계정 기본 설정, 캘린더, 주소록, 공유 리소스 또는 서버 구성은 전송하지 않습니다. 이러한 항목이 중요한 경우, 다른 지원되는 내보내기/가져오기 방법을 사용하거나 Zextras를 활용하십시오.

이전 Zextras 마이그레이션 도구를 기반으로 새 계획을 세우지 마십시오. Zextras 마이그레이션 가이드에 따르면 해당 도구는 더 이상 사용할 수 없습니다. 또한, 최신 Zimbra imapsync FAQ 와 대조하여 확인하지 않고 보관된 Zimbra 페이지에서 더 이상 사용되지 않는 IMAP 관련 조언을 복사하지 마십시오 . 해당 FAQ에서는 이전 Zimbra imapsync 가이드가 더 이상 유효하지 않다고 명시적으로 경고하고 있습니다.

2. 데이터를 복사하기 전에 두 서버를 모두 준비하십시오.

대상 서버를 프로비저닝하기 전에 도메인, 계정, 별칭, 할당량, 사서함 크기, 사용자 암호 또는 재설정 계획, 공유 폴더, 일정, 연락처, 배포 목록, 보존 요구 사항 및 사용자가 의존하는 서버 기능 등 필요한 항목을 모두 포함하는 인벤토리를 작성하십시오. 각 단계에서 새 메일을 수신하는 호스트를 식별하십시오. 이 인벤토리를 마이그레이션 후 점검 목록으로 활용하십시오.

• 플랫폼 지원을 확인하십시오. 대상 시스템이 설치 및 작동 중이며 마이그레이션 경로에서 지원되는 Zimbra/Zextras 조합을 사용하고 있는지 확인하십시오. Zextras Backup의 경우, 공급업체의 Zimbra 워크플로는 Zextras Backup 대상과 Zextras Backup 또는 Zimbra Suite Plus가 실행되는 소스가 필요합니다. 해당 기능을 사용하기 전에 공급업체에 사용 권한을 확인하십시오.
• 용량을 확인하십시오. 대상의 실제 메일 저장소, 스테이징된 소스 백업 또는 내보내기, 그리고 대상 백업을 위한 공간을 예상하십시오. Zextras 마이그레이션 가이드에서는 대상에 이 세 가지 모두를 위한 공간이 필요할 수 있으므로 사용자의 보이는 사서함 총량만으로 크기를 결정하지 말라고 경고합니다.
• 복원 작업을 백업하고 테스트하십시오. 원본의 복구 가능한 백업본을 별도로 보관하십시오. Zextras 마이그레이션의 경우, 설치된 버전의 검사 및 백업 절차를 따르십시오. imapsync의 경우, 대상에 테스트 사서함을 먼저 사용하십시오. imapsync 튜토리얼에서는 대상을 수정하는 동안 원본을 읽는다는 점을 강조합니다.
• 연결 및 인증을 테스트하십시오. 관리자 또는 테스트 사용자가 의도된 보안 연결을 사용하여 두 IMAP 엔드포인트 모두에 액세스할 수 있는지 확인하십시오. 단순히 이전 가이드에 나와 있다는 이유로 평문 인증을 활성화하지 마십시오. 사용 중인 Zimbra 버전에 맞는 TLS/SSL 및 인증 설정을 사용하십시오.
• DNS 및 메일 흐름을 계획하십시오. MX 레코드가 변경될 경우, DNS 제공업체에서 허용하는 경우 미리 TTL 값을 낮추고, 전환 기간 동안 기존 서버를 유지하여 지연되거나 캐시된 메일 전송을 모니터링하고 조정할 수 있도록 하십시오.

3. Zimbra를 지원하는 마이그레이션을 위해 Zextras Backup을 사용하십시오.

이 경로는 Zimbra 시스템 간에 마이그레이션을 진행하고 IMAP 메일 이상의 기능을 필요로 하는 관리자를 위해 설계되었습니다. 하지만 모든 시스템에 적용 가능한 단일 명령은 아닙니다. 소스 및 대상 제품 버전, 백업 경로 구성, 권한, 스토리지, 마이그레이션 순서 등이 모두 중요합니다. Zextras 가이드에서는 zimbra명시적으로 다른 권한이 부여되지 않는 한 CLI 명령은 사용자 권한으로 실행해야 한다고 안내하고 있습니다.

원본 백업을 생성하고 전송합니다.

설치된 버전에 맞는 최신 Zextras Backup 가이드를 따르세요. Zextras Zimbra 사용법은 소스 무결성 검사와 심층 SmartScan으로 시작합니다. 아래는 예시 명령입니다. 실행하기 전에 명령 구문과 필요한 유지 관리 단계를 버전에 맞게 확인하세요.

zxsuite backup doSmartScan start deep true

원본 데이터를 내보낸 후, 필요한 백업 데이터를 대상 시스템의 스테이징 디렉터리로 전송합니다. Zextras는 rsync전송 방법 중 하나로 원본 시스템이 활성화된 상태에서 전송을 반복하는 것을 권장합니다. 이렇게 하면 이후 전송에서는 변경된 데이터만 이동됩니다. 대상 시스템의 스테이징 경로는 Zimbra 사용자가 읽을 수 있어야 하며, 대상 시스템의 활성 Zextras Backup 경로와 혼동해서는 안 됩니다. 전송 채널을 보호하고 각 전송 과정을 로그로 기록하십시오.

목적지에서의 프로비저닝 및 복원

Zextras 문서에는 사서함 내용을 건너뛰고 도메인, 서비스 클래스 및 계정을 생성하는 프로비저닝 전용 가져오기 기능이 설명되어 있습니다. 이는 설정 단계이며 완전한 메일 복원은 아닙니다.

zxsuite backup doExternalRestore /path/for/data/ provisioning_only TRUE

프로비저닝 후, 대상 서버에서 테스트를 통해 선택한 동시 접속 설정으로 전체 외부 복원을 실행하십시오. Zextras는 concurrent_accounts매개변수를 제공하며, 모든 서버에 하나의 수치가 적합하다고 가정하기보다는 성능 테스트를 권장합니다. 마이그레이션 기간 동안 발생한 변경 사항을 수집하기 위해 필요에 따라 원본 백업 전송 및 적절한 증분 복원을 반복하십시오. 사용자 및 메일 흐름이 확인될 때까지 원본 서버를 계속 사용할 수 있도록 유지하십시오.

공급업체는 단계별 복원과 단일 복원 방식을 설명하며, 복원 순서는 전환 계획에 따라 달라질 수 있습니다. 서로 다른 버전의 명령어를 혼합하여 사용하지 말고, 설치된 릴리스에 맞는 복원 절차를 따르십시오. 복원이 진행되는 동안 가져온 백업 데이터나 맵 파일을 편집하거나 삭제하지 마십시오.

4. 범위가 IMAP 메일인 경우 imapsync를 사용하십시오.

Imapsync는 소스 및 대상 사서함 모두 IMAP을 통해 접근 가능하고 Zimbra 전용 마이그레이션 제품을 설치하지 않고 메시지와 폴더를 복사하려는 경우에 유용합니다. Linux, Windows 및 macOS에서 사용할 수 있습니다. 아래 예제에서는 실제 서버 이름이나 자격 증명이 아닌 자리 표시자를 사용했습니다. 암호는 보호된 스크립트 또는 기타 승인된 암호 처리 방법을 사용하여 저장하고, 티켓, 공유 셸 기록 또는 문서에 절대 게시하지 마십시오.

먼저 소스 사서함 하나와 테스트 대상 사서함 하나를 준비합니다. 대상 사서함에 쓰기 작업을 하지 않고 로그인 테스트 및 폴더 매핑 검사를 위해 사전 실행(dry run)을 수행합니다. Imapsync의 공식 튜토리얼에서는 초기 폴더 매핑 검사를 위한 다음과 같은 옵션을 보여줍니다.

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap --justfolders --dry

조직의 보안 자격 증명 워크플로를 사용하여 자리 표시자를 바꾸십시오. 소스와 대상이 의도한 호스트인지, 두 로그인 모두 성공했는지, 보낸 편지함, 임시 보관함, 휴지통과 같은 폴더가 올바른 대상 이름으로 매핑되는지 확인하십시오. 매핑이 잘못된 경우 메시지를 복사하기 전에 수정하십시오.

테스트가 올바르게 완료되면 해당 항목을 제거하고 --justfolders실제 --dry사서함 복사를 수행하십시오. --automap제안된 매핑이 폴더 이름에 맞는 경우에만 해당 항목을 유지하십시오.

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap

사용자가 많은 경우, 테스트된 명령을 제어된 스크립트를 통해 각 사서함에 대해 실행하십시오. 플랫폼별 구문 및 옵션에 대한 공식 imapsync 튜토리얼 과 모범 사례를--delete1 검토하십시오. 의도적으로 해당 측에서 삭제를 원하고 결과를 임시 저장소에서 테스트한 경우 가 --delete2아니라면, `--delete` 또는 `--replace`와 같은 파괴적인 플래그는 사용하지 마십시오. 마이그레이션 복사본은 소스 메일이나 대상 전용 데이터를 예기치 않게 삭제해서는 안 됩니다.

5. 최종 델타 동기화를 실행하고 메일 흐름을 전환합니다.

두 가지 방법 모두 초기 동기화는 사용자가 작업을 계속하는 동안 시간이 걸릴 수 있습니다. 전환 시점에 맞춰 최종 동기화를 예약하세요. imapsync를 사용하는 경우, 동일하게 검증된 명령을 다시 실행합니다. 이 도구는 증분 동기화를 위해 설계되었으며 일반적으로 이미 동기화된 메시지는 건너뜁니다. 가능한 경우 최종 동기화 과정에서 원본 사서함을 변경하지 마세요. 사용자가 이미 두 서버를 모두 사용하고 있었다면, 서로 다른 변경 사항은 별도로 해결해야 합니다. imapsync는 양방향 병합 도구가 아닙니다.

Zextras Backup의 경우, 버전별 단계별 가져오기 절차를 따르고 필요한 백업 전송/복원 단계를 반복하여 이전 단계 이후 변경 사항을 반영하십시오. 프로비저닝만으로 메일, 캘린더 또는 연락처가 가져와졌다고 가정하지 마십시오. 이 과정은 사서함 내용을 건너뛰고 계정 구조만 생성합니다.

수신측에서 메일을 수신할 준비가 되면 DNS 및 프록시 설정에 따라 MX 레코드와 관련 웹메일 레코드를 변경하십시오. 기존 서버는 계속 가동하고 DNS 캐시가 만료되고 지연된 메일이 도착할 때까지 두 시스템을 모두 모니터링하십시오. 문서화된 유지 관리 기간을 설정하고 각 단계에서 사용자가 기존 서버 또는 새 서버에 로그인해야 하는지 여부를 명확히 전달하십시오.

6. 기존 서버를 폐기하기 전에 새 서버를 확인하십시오.

규모가 작거나 큰 메일함, 최근 메일함, 오래된 메일함 등 대표적인 메일함들을 대상으로 테스트를 진행합니다. 폴더 목록과 메시지 수를 비교하고, 첨부 파일이 있는 메시지를 열어보고, 읽음/읽지 않음 상태 및 플래그 지정 상태를 확인하고, 보낸 메일이 지정된 폴더에 나타나는지 확인합니다. 대상 메일함으로 메일을 보내고 받은 메일함에서 메일을 받은 후, 공용 MX 레코드 조회 및 서버 로그를 통해 예상 호스트로 메일이 배달되었는지 확인합니다.

Zextras 마이그레이션을 진행하는 경우, 캘린더, 연락처, 작업, 공유 폴더, ID, 서명, 사용자 기본 설정, 그리고 범위에 포함된 모든 도메인 또는 서비스 등급 설정을 개별적으로 테스트하십시오. Zextras 문서에는 공유 폴더 일관성 검사 방법이 나와 있습니다 zxsuite backup doCheckShares. 해당 복구 절차는 필요한 경우에만 사용하고, 설치된 릴리스에서 지원하는 경우에만 사용하십시오. 사용자 액세스 및 암호 동작을 다시 확인하십시오.

이해관계자들이 결과를 승인하고 보존 기간이 만료될 때까지 원본 서버와 복구 가능한 백업을 유지하십시오. 대상 서버에서 로그인이 가능하다고 해서 기존 호스트를 취소하지 마십시오. 메일 라우팅, 사용자 액세스, 메일 이외의 데이터 및 롤백 기록이 모두 확인된 후에만 프로젝트를 종료하십시오.

출처

• Zextras: Zextras Backup을 사용하여 Zimbra 서버를 마이그레이션하는 방법
• Zextras Suite Backup 설명서
• 공식 imapsync 사이트 및 릴리스 정보
• 공식 imapsync 튜토리얼
• 공식 imapsync Zimbra FAQ
• 공식 imapsync 모범 사례