Fix Kopano Search Engine Python Service Crashing

Start with the crash log, not the search index. On a classic Kopano Core server, the search engine is the kopano-search service. The Debian source package describes this generation as a process-based indexer built on python-kopano. It connects to kopano-server, maintains per-store search indexes, and can optionally call attachment-parsing tools. Review the Kopano Search source package. A missing Python module, a server-socket mismatch, a permissions or disk-space problem, or a failing attachment parser can each cause different symptoms. Restarting or deleting the whole index before identifying the failure can hide useful evidence and create more work.

This guide covers installations that run the classic kopano-search daemon, including older Kopano Core packages. The Kopano documentation currently available for this service is versioned for Kopano Core 8.0, while Ubuntu’s archived man pages cover older package builds such as 8.7. Confirm your installed Kopano release and its local manual before applying version-specific commands. Kopano Cloud or container deployments may use different service names and management procedures.

What should you check before changing anything?

You need shell access with permission to read Kopano logs and configuration. Before editing configuration or touching index files, record the package version and make a backup of the relevant config. Do not copy an index path from another server: the default and configured paths differ across package versions. The Kopano administrator manual describes /etc/kopano/search.cfg, per-store index files, the service socket, and attachment parsing; it also warns against changing index files while the service is running. Kopano’s Search configuration section is the primary reference for those settings.

1. Confirm that kopano-search is actually crashing

On a system using systemd, inspect the unit and recent log entries:

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

Look for repeated start attempts, an exit code, a Python traceback, or a specific final exception. The final line of a traceback is often more useful than the first line because it names the error that stopped the process. If your installation uses the older SysV init scripts, check with sudo service kopano-search status and inspect the configured log file or system log instead. The service may log to a file or syslog depending on search.cfg, so an empty journal does not prove that no error occurred.

再起動する前に、関連するログ行を保存してください。サービスが終了し、systemdが再度起動する場合、すべての試行が同じ段階で失敗したのか、それとも1つのイベントがクラッシュを引き起こしたのかを知る必要があります。

2. 検索サービスがKopanoサーバーに接続できるかどうかを確認します。

検索デーモンは、正しい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

存在するキーの正確なセットはリリースによって異なる場合があります。従来の Core 構成では、search_enabled = yesで全文検索を有効にしますserver.cfg。search_socketは、サーバーが検索サービスに接続する場所を指定します。検索サービスのserver_socket設定は、Kopano サーバーを指します。 の不一致、ソケットの欠落、またはサーバーの停止により、検索クラッシュのように見える接続エラーが発生する可能性があります。サーバーは、検索ソケットが利用できない間、直接データベース検索にフォールバックできますが、検索サービスが正常になるまで全文インデックスは復元されません。

3. PythonパッケージをKopanoビルドに合わせる

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"

2番目のコマンドは、kopano-search現在のシェルのパスに が存在する場合にのみ有効です。これらの詳細を、実際に使用するKopanoパッケージセットのリポジトリとインストール手順と比較してください。サーバーがRPM、コンテナ、またはベンダーのアプライアンスで管理されている場合は、上記のDebianコマンドではなく、そのプラットフォームのパッケージツールを使用してください。

パッケージ化された Kopano サーバーを修復するために、システム Python を実行しないでくださいsudo pip install。Python-MAPI にはネイティブ コンポーネントが含まれており、これらを無関係な Python パッケージと混在させると、インタープリタが互換性のないモジュールを検出する可能性があります。同じ信頼できるリポジトリから、対応する Kopano パッケージを復元または再インストールしてから、サービスを再起動し、ログを再確認してください。マシンがオペレーティングシステムのリリース間でアップグレードされている場合は、パッケージの再インストールを試みる前に、Kopano リポジトリがその OS/Python の組み合わせをサポートしていることを確認してください。

4. 権限、空き容量、添付ファイルの解析を確認する

で設定されているindex_path、log_file、tmp_path、および attachment-parser の設定を読み取ります/etc/kopano/search.cfg。ファイルシステムに空き容量があり、サービス アカウントが構成で想定されている場所に書き込みできることを確認します。例:

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

例のインデックス ディレクトリを、ご自身の設定の値に置き換えてください。「権限が拒否されました」、「空き容量がありません」、または一時ファイルの作成に失敗したなどのエラーは、一般的な Python のクラッシュではなく、ストレージへのアクセスに関する問題を示しています。サーバーのドキュメントに記載されているパッケージのデフォルト値を使用して、意図した所有者と権限を復元してください。/var/lib/kopano他のサービスがそれを使用しているかどうかを確認せずに、すべてのディレクトリの所有権を再帰的に変更しないでください。

トレースバックやタイミングから添付ファイルの抽出が原因と思われる場合は、パーサーデータベースとそれが呼び出す外部ユーティリティを調べてください。Kopano のマニュアルには、添付ファイルの内容は設定済みのスクリプトによってテキストに変換され、添付ファイルのサイズ、メモリ、CPU の制限を設定できることが説明されています。診断として、一時的に を設定しindex_attachments = yes、サービスを再起動して、クラッシュが停止するかどうかを確認できます。これにより、添付ファイルの内容内の検索は無効になりますが、メッセージ本文のインデックス作成は無効になりません。障害が解消された場合は、添付ファイルのインデックス作成を再度有効にする前に、特定のパーサーまたは依存関係を修復してください。index_attachment_parserindex_attachments = no

5. ログがインデックスの破損を示している場合は、影響を受けたストアインデックスのみを再構築します。

インデックスの再構築は、サービスが正常に起動するものの、特定のストアのインデックスを開いたり更新したりする際に繰り返し失敗する場合、またはKopanoのログでその特定のインデックスが破損していると識別された場合に適切な対処法です。Pythonのインポートエラー、ソケットの不一致、ディスク容量不足などに対する最初の解決策ではありません。

Kopano の管理者マニュアルには、kopano-search個々のストアのインデックス ファイルを削除する前に停止するように記載されています。また、インデックス ディレクトリ内の状態ファイルについても説明されているため、ルーチン修復としてディレクトリ全体やすべてのユーザー インデックスを削除しないでください。まず、関連するインデックス ファイルをバックアップし、ユーザーまたはストアの ID とパスを確認してください。ローカルでそのオプションが文書化されている場合はman kopano-search、--reindexパッケージでサポートされている構文を使用して 1 つのストアを再構築してください。オプションの形式は、アーカイブされたビルドによって異なります。たとえば、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 リリースを対象としているため、すべての現在のデプロイメントが同じサービスマネージャまたはオプション構文を使用していると想定するのではなく、パッケージ独自のマニュアルと併せて使用してください。