Kopano 검색 엔진 Python 서비스 충돌 문제 해결

검색 인덱스가 아닌 크래시 로그부터 확인하세요. 기존 Kopano Core 서버에서 검색 엔진은 kopano-search서비스입니다. Debian 소스 패키지에서는 이 세대를 python-kopano 기반의 프로세스 기반 인덱서라고 설명합니다. 이 인덱서는 서버에 연결하여 kopano-server스토어별 검색 인덱스를 유지 관리하고, 선택적으로 첨부 파일 구문 분석 도구를 호출할 수 있습니다. Kopano Search 소스 패키지를 검토해 보세요 . Python 모듈 누락, 서버-소켓 불일치, 권한 또는 디스크 공간 문제, 첨부 파일 구문 분석 오류 등 각기 다른 문제가 다양한 증상을 유발할 수 있습니다. 오류를 파악하기 전에 전체 인덱스를 재시작하거나 삭제하면 유용한 증거가 가려지고 더 많은 작업이 발생할 수 있습니다.

이 가이드는 기존 Kopano kopano-search데몬을 실행하는 설치 환경(이전 Kopano Core 패키지 포함)에 대해 설명합니다. 현재 이 서비스에 대해 제공되는 Kopano 문서는 Kopano Core 8.0 버전을 기준으로 작성되었으며, Ubuntu의 아카이브된 man 페이지는 8.7과 같은 이전 패키지 빌드를 다루고 있습니다. 버전별 명령을 적용하기 전에 설치된 Kopano 버전과 해당 설명서를 확인하십시오. Kopano 클라우드 또는 컨테이너 배포 환경에서는 서비스 이름과 관리 절차가 다를 수 있습니다.

무엇을 변경하기 전에 무엇을 확인해야 할까요?

Kopano 로그 및 설정을 읽으려면 셸 액세스 권한이 필요합니다. 설정을 편집하거나 인덱스 파일을 변경하기 전에 패키지 버전을 기록하고 관련 설정을 백업하십시오. 다른 서버에서 인덱스 경로를 복사하지 마십시오. 기본 경로와 구성된 경로는 패키지 버전에 따라 다릅니다. Kopano 관리자 설명서에는 /etc/kopano/search.cfg스토어별 인덱스 파일, 서비스 소켓 및 첨부 파일 구문 분석에 대한 설명이 있으며, 서비스가 실행 중인 동안 인덱스 파일을 변경하지 않도록 경고합니다. 이러한 설정에 대한 자세한 내용은 Kopano의 검색 구성 섹션을 참조하십시오.

1. kopano-search가 실제로 충돌하는지 확인하십시오.

systemd를 사용하는 시스템에서는 유닛과 최근 로그 항목을 확인하십시오.

sudo systemctl status kopano-search --no-pager
sudo journalctl -u kopano-search -b -n 100 --no-pager

반복적인 시작 시도, 종료 코드, Python 트레이스백 또는 특정 최종 예외를 확인하십시오. 트레이스백의 마지막 줄은 프로세스를 중지시킨 오류 이름을 알려주기 때문에 첫 번째 줄보다 더 유용한 경우가 많습니다. 설치 환경에서 이전 SysV 초기화 스크립트를 사용하는 경우, sudo service kopano-search status구성된 로그 파일이나 시스템 로그를 확인하고 검사하십시오. 서비스는 설정에 따라 파일 또는 syslog에 로그를 기록할 수 있으므로 search.cfg, 로그가 비어 있다고 해서 오류가 발생하지 않았다는 것을 의미하지는 않습니다.

재시작하기 전에 관련 로그 라인을 저장해 두세요. 서비스가 종료된 후 systemd가 다시 시작하는 경우, 모든 시도가 동일한 단계에서 실패하는지 아니면 특정 이벤트로 인해 충돌이 발생했는지 알아야 합니다.

2. 검색 서비스가 코파노 서버에 접속할 수 있는지 확인하십시오.

검색 데몬은 올바른 Kopano 서버 소켓에 연결해야 합니다. 두 서비스를 모두 확인하고 구성된 소켓 값을 비교하십시오.

sudo systemctl status kopano-server --no-pager
sudo grep -E '^(server_socket|search_socket|search_enabled)[[:space:]]*='   /etc/kopano/server.cfg /etc/kopano/search.cfg

사용되는 키 세트는 릴리스 버전에 따라 다를 수 있습니다. 기존 코어 구성에서는 search_enabled = yes전체 텍스트 검색을 활성화하는 데 사용되며 server.cfg, search_socket서버가 검색 서비스에 연결할 위치를 지정합니다. 검색 서비스 server_socket설정은 Kopano 서버를 가리킵니다. 설정 불일치, 소켓 누락 또는 서버 중지 시 검색 충돌처럼 보이는 연결 오류가 발생할 수 있습니다. 검색 소켓을 사용할 수 없는 동안 서버는 직접 데이터베이스 검색으로 전환할 수 있지만, 검색 서비스가 정상화될 때까지 전체 텍스트 인덱싱은 복원되지 않습니다.

3. Kopano 빌드에 맞는 Python 패키지를 선택합니다.

kopano-searchKopano의 Python 바인딩과 네이티브 MAPI 구성 요소를 사용합니다. ImportError부분 업그레이드, 저장소 변경 또는 수동 Python 패키지 설치 후 공유 라이브러리 누락 또는 모듈 로드 오류가 발생할 수 있습니다. 설치된 패키지와 패키지 실행 파일에서 사용하는 인터프리터를 기록해 두십시오.

dpkg-query -W 'kopano-search' 'python*kopano*' 'python*mapi*' 2>/dev/null
p=$(command -v kopano-search) && head -n 1 "$p"

두 번째 명령어는 kopano-search현재 셸의 경로에 해당 파일이 있는 경우에만 유용합니다. 이 정보를 실제로 사용하는 Kopano 패키지 세트의 저장소 및 설치 지침과 비교하십시오. 서버가 RPM, 컨테이너 또는 벤더 어플라이언스로 관리되는 경우 위의 Debian 명령어 대신 해당 플랫폼의 패키지 도구를 사용하십시오.

Kopano 서버 패키지를 복구할 때 시스템 Python을 직접 실행하지 마십시오 sudo pip install. Python-MAPI에는 네이티브 구성 요소가 포함되어 있으며, 관련 없는 Python 패키지와 혼합하여 사용하면 인터프리터가 호환되지 않는 모듈을 찾을 수 있습니다. 동일한 신뢰할 수 있는 저장소에서 해당 Kopano 패키지를 복원하거나 다시 설치한 다음 서비스를 다시 시작하고 로그를 다시 확인하십시오. 운영 체제가 여러 버전으로 업그레이드된 경우, 패키지 재설치를 시도하기 전에 Kopano 저장소가 해당 OS/Python 조합을 지원하는지 확인하십시오.

4. 권한, 여유 공간 및 첨부 파일 구문 분석 기능을 확인하십시오.

구성된 index_path, log_file, tmp_path, 및 첨부 파일 파서 설정을 읽어보세요 /etc/kopano/search.cfg. 파일 시스템에 여유 공간이 있고 서비스 계정이 구성에서 예상하는 위치에 쓰기 권한이 있는지 확인하세요. 예를 들면 다음과 같습니다.

df -h /var/lib/kopano /var/log
sudo namei -l /var/lib/kopano/search

예제 인덱스 디렉터리를 사용자 구성의 값으로 교체하십시오. "권한 거부됨", "공간 부족" 또는 임시 파일 생성 실패와 같은 오류는 일반적인 Python 충돌보다는 스토리지 액세스 문제와 관련이 있습니다. 서버의 패키지 기본값에 따라 의도한 소유자와 권한을 복원하십시오. /var/lib/kopano다른 서비스에서 해당 디렉터리를 사용하는지 확인하지 않고 모든 디렉터리의 소유권을 재귀적으로 변경하지 마십시오.

오류 추적 또는 타이밍 분석에서 첨부 파일 추출과 관련된 문제가 발견되면, 파서 데이터베이스와 파서가 호출하는 외부 유틸리티를 index_attachments = yes점검하십시오 . Kopano 설명서에 따르면 첨부 파일 내용은 구성된 스크립트를 통해 텍스트로 변환되며, 첨부 파일 크기, 메모리 및 CPU 사용량 제한을 설정할 수 있습니다. 진단 목적으로, 첨부 파일 내용 검색을 일시적으로 비활성화하고 서비스를 재시작하여 오류가 해결되는지 확인할 수 있습니다. 이 방법은 메시지 본문 인덱싱은 비활성화하지 않습니다. 오류가 사라지면 첨부 파일 인덱싱을 다시 활성화하기 전에 특정 파서 또는 종속성을 복구하십시오.index_attachment_parserindex_attachments = no

5. 로그에 인덱스 손상이 표시된 경우 해당 스토어 인덱스만 재구축합니다.

인덱싱 재작업은 서비스가 정상적으로 시작되지만 특정 스토어의 인덱스를 열거나 업데이트하는 동안 반복적으로 실패하거나, Kopano 로그에서 해당 인덱스가 손상된 것으로 확인될 때 적절한 해결책입니다. 하지만 파이썬 임포트 오류, 소켓 불일치 또는 디스크 용량 부족과 같은 문제에 대한 첫 번째 해결책은 아닙니다.

Kopano 관리자 설명서에는 kopano-search개별 스토어의 인덱스 파일을 삭제하기 전에 작업을 중단하라고 나와 있습니다. 또한 인덱스 디렉터리에 상태 파일이 있으므로 일반적인 복구 작업으로 전체 디렉터리나 모든 사용자 인덱스를 삭제하지 말라고 안내합니다. 먼저 관련 인덱스 파일을 백업하고 사용자 또는 스토어의 ID와 경로를 확인하십시오. 로컬 man kopano-search문서 에 해당 --reindex옵션이 설명되어 있다면, 패키지에서 지원하는 구문을 사용하여 하나의 스토어를 재구축하는 것이 좋습니다. 옵션 형식은 아카이브된 빌드마다 다를 수 있습니다. 예를 들어 Ubuntu Focal 설명서에는 특정 스토어를 대상으로 하는 인덱스 재구축 옵션이 설명되어 있으며, 데몬이 이미 실행 중이어야 한다고 명시되어 있습니다.

대규모 재구축 작업은 디스크 및 CPU 리소스를 많이 소모할 수 있으며, 인덱싱이 완료될 때까지 검색 결과가 불완전할 수 있습니다. 어떤 저장소 파일이 영향을 받는지 확실하지 않은 경우, 파일을 삭제하기 전에 작업을 중지하고 서비스 로그, 패키지 버전 및 구성 정보를 수집하여 index_pathKopano 관리자 또는 지원 채널에 문의하십시오.

6. 재시작하고 결과를 확인하십시오.

문제의 원인을 해결한 후에는 검색 서비스만 다시 시작하십시오.

sudo systemctl restart kopano-search
sudo systemctl status kopano-search --no-pager
sudo journalctl -u kopano-search -b -n 50 --no-pager

SysV 설치의 경우 해당 패키지에 설명된 서비스 명령을 사용하십시오. 프로세스가 활성 상태로 유지되고, 동일한 트레이스백이 더 이상 반복되지 않으며, 초기 인덱싱 후 검색 소켓이 나타나는지 확인하십시오. Kopano는 초기 인덱스가 구축될 때까지 소켓이 생성되지 않을 수 있다고 언급합니다. 일반 메일 검색을 테스트하고, 첨부 파일 인덱싱이 활성화된 경우 파서 복구가 완료된 후에만 알려진 첨부 파일을 테스트하십시오.

빠른 진단 가이드

가장 확실한 해결 방법은 로그에 기록된 오류를 수정하는 것입니다. Python 임포트 실패의 경우 패키지 환경을 복구하고, 연결 실패의 경우 올바른 소켓을 복원하고, 접근 및 추출 오류의 경우 특정 경로 또는 파서를 수정하고, 인덱스 데이터 손상이 의심될 때만 인덱스를 다시 생성하십시오. 제공되는 Kopano 설명서는 이전 Core 릴리스를 다루고 있으므로, 모든 최신 배포 환경에서 동일한 서비스 관리자 또는 옵션 구문을 사용한다고 가정하지 말고 패키지 자체 설명서와 함께 참조하십시오.