Zimbra 검색 인덱스 손상 해결 방법: 사서함 재인덱싱 방법

2026년 10월 6일 검토됨. Zimbra 검색에서 특정 사서함에 대해 불완전한 결과가 반환되고 사서함 로그에 인덱서 또는 Lucene 오류가 표시되는 경우, 일반적인 복구 방법은 해당 사서함의 검색 인덱스를 재구축하는 것입니다 zmprov rim account@example.com start. 이 명령은 사서함 콘텐츠에서 검색 가능한 인덱스 데이터를 다시 생성합니다. 이는 메시지 파일 누락, 데이터베이스 손상, 스토리지 볼륨 용량 부족 또는 서버 전체 검색 실패에 대한 복구 방법이 아닙니다.

성공 여부는 실제 결과로 판단하십시오. 재인덱싱 작업이 완료되고, 대상 검색에서 이전에 누락되었던 메시지가 반환되며, 새 메일이 검색 결과에 계속 표시되는지 확인해야 합니다. 명령을 시작하는 것만으로는 인덱스가 재구축되었다는 것을 보장할 수 없습니다. 작업이 비교적 한가한 시간에 계획하고, 인덱스 용량을 먼저 확인한 후, 범위를 확대하기 전에 영향을 받는 계정 하나에 대해서만 실행해 보십시오.

사서함 재색인이 적절한 해결책인 경우는 언제입니까?

손상되었거나 불완전한 인덱스는 일반적인 사서함 액세스는 작동하지만 검색에서 알려진 메시지가 누락되거나, 영향을 받는 사용자가 일관되지 않은 검색 결과를 보거나, /opt/zimbra/log/mailbox.log"인덱서를 열 수 없습니다"와 같은 메시지 또는 해당 계정에 대한 Lucene 예외가 보고되는 경우 문제의 원인으로 의심될 수 있습니다. Zimbra의 문제 해결 자료는 zmprov verifyIndex인덱스가 누락되었거나 열 수 없는 경우 진단 방법으로 zmprov rim ... start인덱스 복구 방법을 설명합니다.

먼저 문제의 범위를 파악하십시오. 한 명의 사용자만 영향을 받는 경우 해당 사서함을 조사하십시오. 동일한 메일 저장소를 사용하는 여러 사용자가 동일한 증상을 보이는 경우, 대규모 재인덱싱을 시작하기 전에 서버 상태, 저장 용량, 최근 업그레이드 및 로그를 확인하십시오. 대규모 재인덱싱은 상당한 디스크 I/O 및 CPU 사용량을 유발하여 다른 사용자의 검색 속도를 더욱 저하시킬 수 있습니다.

사용자가 로그인할 수 없거나, 폴더가 누락되었거나, 메시지 본문이나 첨부 파일이 열리지 않거나, 메일 저장소 데이터베이스에 오류가 발생하거나, 여러 계정에서 검색 서비스를 사용할 수 없는 경우, 인덱싱을 처음부터 다시 시작하는 것은 적절하지 않습니다. 이러한 문제는 데이터베이스, 블롭 저장소, 서비스 또는 인프라 문제일 수 있습니다. 모든 "검색" 관련 문제를 인덱스 손상으로 간주하기보다는 로그를 보존하고 해당 Zimbra 복구 절차 또는 지원 채널을 활용하십시오.

명령어를 실행하기 전에

• 대상 사서함을 확인하십시오. 별칭이 아닌 기본 계정 주소를 복사하십시오. 여러 메일 저장소를 사용하는 배포 환경에서는 어떤 사서함 서버가 해당 계정을 소유하고 있는지 확인하고, 구성 및 설치된 Zimbra 버전에 따라 명령을 실행하십시오.
• 사용 가능한 공간 확인: 실제 인덱스 볼륨의 여유 공간과 inode를 검사하십시오. 설치 환경에 따라 인덱스 데이터가 별도의 마운트 위치에 저장될 수 있으므로 기본 경로가 활성 위치라고 가정하지 마십시오. 인덱스 볼륨이 가득 차면 인덱싱 오류가 발생할 수 있습니다.
• 시스템 부하를 확인하십시오. 현재 메일 저장소 지연 시간, CPU 사용량 및 디스크 사용량을 기록하십시오. 재인덱싱은 특히 대용량 사서함의 경우 리소스 집약적 작업이므로 트래픽이 가장 많은 시간대를 피해 예약하십시오.
• 복구 가능성을 확보하십시오. 유지 보수 전에 정상 백업 프로세스가 제대로 수행되고 있는지, 그리고 최근에 백업이 완료되었는지 확인하십시오. 재인덱싱은 파생 검색 데이터를 재구성하기 위한 것이지만, 운영 메일에 대한 복구 작업을 수행하기 전에 백업을 확보하는 것이 중요합니다.
• 명령 지원 여부 확인: Zimbra의 CLI 구문 및 사용 가능한 옵션은 릴리스 버전에 따라 다를 수 있습니다. 특히 이전 릴리스 또는 사용자 지정 배포 버전을 사용하는 경우, 설치된 빌드에 대한 명령 도움말 및 설명서를 검토하십시오.

사서함 하나를 확인하고 복구하는 방법

1. 진단 검사가 가능한 경우 실행하십시오.

Zimbra 운영 체제 계정으로 Zimbra 문제 해결 지침에 나와 있는 진단 도구를 사용하여 문제가 있는 사서함을 테스트하십시오.

zmprov verifyIndex user@example.com

인덱스가 존재하지 않거나 세그먼트 파일을 찾을 수 없다는 응답은 인덱스 손상 진단을 뒷받침합니다. 설치된 버전에서 verifyIndex이를 인식하지 못하는 경우, 스크립트를 설치하거나 다른 서버에서 인덱스 파일을 복사하여 문제를 해결하지 마십시오. 버전별 Zimbra 설명서를 참조하여 사서함 로그와 영향을 받는 계정을 연관시켜 분석하십시오.

2. 사서함 재색인 시작

해당 Zimbra 서버에서 Zimbra 운영 체제 계정으로 전환한 다음 영향을 받는 단일 사서함에 대한 재구축을 시작하십시오.

su - zimbra
zmprov rim user@example.com start

일반적으로 해당 명령은 작업이 시작되었음을 보고합니다. 이는 제출을 확인하는 것이지 완료를 확인하는 것이 아닙니다. 검색이 직후에 완료되지 않았다는 이유만으로 작업을 반복해서 시작하지 마십시오. 먼저 작업 상태와 메일 저장소 로그를 확인하십시오.

3. 진행 상황 확인

동일한 계정과 서버 컨텍스트를 사용하여 재인덱싱 작업을 쿼리합니다.

zmprov rim user@example.com status

지속적으로 폴링하는 대신 적절한 간격으로 반복하십시오. 사용 중인 Zimbra 버전에 따라 응답을 읽으십시오. CLI는 작업 상태를 보고하고, mailbox.log계정별 진행 상황 또는 오류를 제공할 수 있습니다. 명령 실행 시 오류가 발생하거나, 작업이 완료되지 않거나, 로그에 디스크 공간 부족 또는 인덱스 기록기 오류가 표시되는 경우, 일시 중지하고 근본적인 문제를 해결한 후 다시 시도하십시오.

Zimbra의 명령 참조 목록에는 , , 및 작업이 reIndexMailbox포함되어 있습니다 . 사용 중인 릴리스에서 취소 기능이 지원되고 해당 작업이 서비스에 악영향을 미치는 경우, 사용하기 전에 로컬 구문을 확인하십시오. 지원되는 취소 절차를 대신하여 Java 프로세스를 종료하거나 인덱스 파일을 삭제하지 마십시오.startstatuscancel

수리가 제대로 되었는지 확인하는 방법

작업이 완료되면 해당 사용자의 웹 클라이언트에서 몇 가지 알려진 메시지를 사용하여 테스트합니다. 특정 발신자, 제목 및 날짜 범위를 검색하고 이전 메시지와 최근 메일을 모두 확인합니다. 메시지가 표시되어야 하는 폴더를 확인하고 사용자가 직접 열 수 있는 알려진 메시지와 결과를 비교합니다. 그런 다음 테스트 메시지를 보내거나 받고 정상적인 색인 생성 지연 후 검색 가능해지는지 확인합니다.

단 한 번의 성공적인 쿼리보다는 지속적인 개선을 목표로 하십시오. 실질적인 성공 기준은 다음과 같습니다.

• 사서함 재색인 상태가 오류 없이 완료 상태에 도달했습니다.
• 이전에는 누락되었던 알려진 메시지가 예상 검색 결과에 나타납니다.
• 새로운 메일이 계속해서 검색 색인에 추가되고 있습니다.
• 색인 용량은 충분한 여유 공간을 유지하고 있으며 다른 사서함도 정상적으로 작동합니다.

명령 실행이 완료되었지만 특정 메시지가 표시되지 않는 경우, 해당 메시지가 여전히 존재하고 열 수 있는지 확인하십시오. 사용자의 검색어, 날짜 필터, 폴더 범위 또는 클라이언트 측 캐시가 문제의 원인인지 점검하십시오. 인덱스를 재구축하더라도 삭제되었거나, 전달되지 않았거나, 기본 저장소에서 손실된 메시지는 복원할 수 없습니다.

문제 해결 경로를 변경해야 하는 시점

재구축 작업이 반복적으로 실패하는 경우, 먼저 로그에 기록된 오류를 해결하십시오. 사용 가능한 디스크 공간과 inode를 확인하고, 메일 저장소 또는 데이터베이스 관련 오류가 있는지 점검하며, 사서함이 올바른 서버에서 처리되고 있는지 확인하십시오. 계정에서 메시지 콘텐츠에 액세스할 수 없거나 다른 사서함에서도 동일한 문제가 발생하는 경우, 재인덱싱 작업을 반복하지 말고 저장소, 데이터베이스 또는 서버 수준의 원인을 조사하십시오.

데이터를 수동으로 삭제하는 것은 /opt/zimbra/index일상적인 작업으로 삼지 마십시오. Zimbra의 공개 위키에는 수동 인덱스 파일 삭제 절차가 나와 있지만, 해당 페이지는 작업 진행 중으로 표시되어 있으며 이전 릴리스 버전에 맞춰져 있습니다. 수동 삭제는 지원되는 계정 수준 재인덱싱 명령보다 오류 발생 가능성이 높으므로, 정확한 사서함 경로, 검증된 백업 및 유지 관리 계획이 있는 경우, 최신 릴리스별 공급업체 지침에 따라서만 고려해야 합니다.

사서함 재색인 기능의 한계

인덱싱 재구축은 검색 메타데이터를 재개발하는 작업이며, MySQL 또는 MariaDB 테이블을 복구하거나, 누락된 Blob을 복원하거나, 손상된 파일 시스템을 수정하거나, 디스크 용량 부족을 해소하거나, 서버 전체의 검색 장애를 해결하는 작업은 아닙니다. 또한 사서함 크기와 서버 부하가 증가할수록 재구축 시간이 길어집니다. 인덱싱이 실행되는 동안 검색이 일시적으로 불완전할 수 있으며, 작업 중 전반적인 성능이 저하될 수 있습니다.

문제의 원인이 특정 계정의 검색 인덱스에 있는 것으로 의심될 경우, 먼저 내장된 사서함 수준의 인덱스 재구축 기능을 사용하십시오. 알려진 메시지와 후속 메일을 사용하여 결과를 평가하십시오. 인덱스 재구축이 완료되지 않거나 데이터 자체가 손상된 경우, 인덱스를 광범위하게 삭제하는 대신 관련 스토리지 또는 데이터베이스 복구 절차로 전환하십시오.

공식 참고 자료

• Zimbra zmprov 명령 참조 — reIndexMailbox명령 및 해당 동작 구문을 나열합니다. 또한 이 페이지는 릴리스별 세부 정보를 확인하려면 관리자 가이드를 참조하도록 안내합니다.
• Zimbra에서 사서함 인덱스가 손상된 경우 문제 해결 예시를 보여줍니다 verifyIndex. 계정 수준의 인덱스 재구축 명령을 사용하는 방법을 설명합니다. 이 페이지는 현재 개발 중이므로 설치된 버전에 적용 가능한지 확인하십시오.
• Zimbra 위키의 인덱스 데이터 삭제 및 상태 확인 절차는 아직 작업 중인 이전 문서이므로, 참고 자료로만 활용하고 현재 운영 중인 시스템에서 파일을 삭제하는 이유로 삼지 마십시오.