تمت المراجعة في 6 أكتوبر 2026. إذا أظهر بحث Zimbra نتائج غير مكتملة لصندوق بريد واحد، وكان سجل صندوق البريد يشير إلى خطأ في الفهرسة أو Lucene، فإن الحل المعتاد هو إعادة بناء فهرس البحث الخاص بهذا الصندوق باستخدام الأمر ` zmprov rim account@example.com start. يعيد هذا الأمر إنشاء بيانات الفهرس القابلة للبحث من محتوى صندوق البريد؛ وهو ليس حلاً لملفات الرسائل المفقودة، أو تلف قاعدة البيانات، أو امتلاء وحدة التخزين، أو فشل البحث على مستوى الخادم.
يُقاس نجاح العملية بالنتيجة الفعلية: اكتمال عملية إعادة الفهرسة، وظهور الرسائل المفقودة سابقًا في نتائج البحث المستهدفة، واستمرار ظهور البريد الجديد في نتائج البحث. بدء تشغيل الأمر ليس دليلًا على إعادة بناء الفهرس. لذا، يُنصح بتنفيذ العملية خلال فترة هدوء، والتحقق من حجم الفهرس أولًا، وتشغيلها على حساب واحد متأثر قبل توسيع نطاقها.
متى يكون إعادة فهرسة صندوق البريد هو الحل الأمثل؟
يُعدّ الفهرس التالف أو غير المكتمل سببًا محتملاً للمشكلة عندما يعمل الوصول العادي إلى صندوق البريد ولكن عمليات البحث لا تُظهر الرسائل المعروفة، أو عندما يرى المستخدم المتأثر نتائج بحث غير متناسقة، أو /opt/zimbra/log/mailbox.logعندما يُبلغ عن رسائل مثل "فشل فتح المُفهرس" أو استثناء Lucene لهذا الحساب. تُوثّق مواد استكشاف الأخطاء وإصلاحها في Zimbra zmprov verifyIndexتشخيصًا للفهرس المفقود أو الذي لا يمكن فتحه، وتُستخدم zmprov rim ... startلإعادة إنشائه.
حدد نطاق المشكلة أولاً. إذا كان مستخدم واحد فقط متأثرًا، فافحص صندوق بريده. أما إذا كان العديد من المستخدمين على نفس مخزن البريد يعانون من نفس المشكلة، فتحقق من سلامة الخادم، وسعة التخزين، والتحديثات الأخيرة، والسجلات قبل البدء بعمليات إعادة بناء متعددة. قد يؤدي إجراء عدد كبير من عمليات إعادة الفهرسة إلى استهلاك كبير لموارد الإدخال/الإخراج للقرص ووحدة المعالجة المركزية، مما قد يزيد من بطء البحث لدى المستخدمين الآخرين.
إعادة فهرسة الملفات ليست الخيار الأمثل في الحالات التالية: عندما يتعذر على المستخدمين تسجيل الدخول، أو عند فقدان المجلدات، أو عند فشل فتح نصوص الرسائل أو المرفقات، أو عند وجود أخطاء في قاعدة بيانات البريد، أو عند عدم توفر خدمة البحث لعدة حسابات. قد تشير هذه العلامات إلى مشاكل في قاعدة البيانات، أو مخزن البيانات الثنائية، أو الخدمة، أو البنية التحتية. لذا، يُنصح بالاحتفاظ بسجلات النظام واستخدام إجراءات استعادة Zimbra المناسبة أو التواصل مع قناة الدعم بدلاً من اعتبار كل شكوى متعلقة بالبحث تلفًا في الفهرس.
قبل تشغيل الأمر
- تأكد من صندوق البريد المستهدف: انسخ عنوان الحساب الأساسي، وليس اسمًا مستعارًا. في حالة نشر عدة مخازن بريد، تحقق من خادم البريد الذي يمتلك الحساب، ثم نفّذ الأمر وفقًا لبنية الشبكة وإصدار Zimbra المُثبّت لديك.
- تحقق من المساحة المتاحة: افحص المساحة الحرة وعدد العقد (inodes) على وحدة تخزين الفهرس الفعلية. قد تضع بعض عمليات التثبيت بيانات الفهرس على وحدة تخزين منفصلة؛ لا تفترض أن المسار الافتراضي هو الموقع النشط. قد تتسبب وحدة تخزين الفهرس الممتلئة في حدوث أعطال في الفهرسة.
- تحقق من حمل النظام: لاحظ زمن استجابة مخزن البريد الحالي، ونشاط وحدة المعالجة المركزية، ونشاط القرص. إعادة فهرسة البريد عملية تستهلك موارد كثيرة، خاصةً بالنسبة لصناديق البريد الكبيرة، لذا يُنصح بجدولتها بعيدًا عن أوقات ذروة حركة البيانات.
- حماية إمكانية الاستعادة: تأكد من سلامة عملية النسخ الاحتياطي وحداثتها قبل إجراء أي صيانة. تهدف إعادة الفهرسة إلى استعادة بيانات البحث المشتقة، ولكن يبقى إجراء النسخ الاحتياطي ضروريًا قبل أي عملية إصلاح على بريد الإنتاج.
- تحقق من دعم الأوامر: قد يختلف بناء جملة واجهة سطر الأوامر (CLI) الخاصة بـ Zimbra والخيارات المتاحة باختلاف الإصدار. راجع تعليمات الأوامر والوثائق الخاصة بالإصدار المُثبّت تحديدًا، خاصةً إذا كنت تستخدم إصدارًا قديمًا أو بيئة نشر مُخصصة.
كيفية التحقق من صندوق بريد واحد وإعادة بنائه
1. قم بإجراء فحص تشخيصي، إن وجد
بصفتك مستخدمًا لحساب نظام التشغيل Zimbra، اختبر صندوق البريد المشتبه به باستخدام التشخيص الموضح في إرشادات استكشاف الأخطاء وإصلاحها الخاصة بـ Zimbra:
zmprov verifyIndex user@example.com
يشير الرد الذي يفيد بعدم وجود الفهرس أو عدم العثور على ملف المقطع إلى وجود تلف في الفهرس. إذا كان إصدار Zimbra المُثبّت لديك لا يتعرف على هذا الملف verifyIndex، فلا تقم بتثبيت البرامج النصية أو نسخ ملفات الفهرس من خادم آخر كحل بديل. استخدم وثائق Zimbra الخاصة بإصدارك وقارن سجل علبة البريد بالحساب المتأثر.
2. ابدأ عملية إعادة فهرسة صندوق البريد
على خادم Zimbra المناسب، انتقل إلى حساب نظام تشغيل Zimbra وابدأ عملية إعادة بناء صندوق البريد المتأثر الوحيد:
su - zimbra
zmprov rim user@example.com start
يُشير الأمر عادةً إلى بدء المهمة، وهذا يُؤكد إرسالها، وليس اكتمالها. لا تُشغّل مهامًا مُتكررة لمجرد أن البحث لم يكتمل مُباشرةً بعد ذلك؛ تحقق أولًا من حالة المهمة وسجلات مخزن البريد.
3. تحقق من التقدم
استعلم عن مهمة إعادة الفهرسة باستخدام نفس الحساب وسياق الخادم:
zmprov rim user@example.com status
كرر العملية على فترات زمنية معقولة بدلاً من الاستقصاء المستمر. اقرأ الاستجابة وفقًا لإصدار Zimbra الخاص بك: يعرض سطر الأوامر حالة المهمة، بينما mailbox.logيمكن أن يوفر معلومات حول تقدم الحساب أو الأخطاء. إذا أبلغ الأمر عن خطأ، أو لم تكتمل المهمة أبدًا، أو أظهرت السجلات أعطالًا في مساحة القرص أو كتابة الفهرس، فتوقف مؤقتًا وحل المشكلة الأساسية قبل المحاولة مرة أخرى.
تتضمن قائمة أوامر Zimbra المرجعية إجراءات reIndexMailboxمثل startو statusو cancel. إذا كان إصدارك يدعم الإلغاء وكانت المهمة تُلحق ضررًا بالخدمة، فتأكد من صحة الصيغة المحلية قبل استخدامها. لا تقم بإنهاء عمليات Java أو حذف ملفات الفهرس كبديل لإجراء الإلغاء المدعوم.
كيفية التأكد من نجاح عملية الإصلاح
بعد إتمام المهمة، اختبرها من خلال متصفح الويب الخاص بالمستخدم المتأثر باستخدام بعض الرسائل المعروفة. ابحث عن مُرسِل مميز، وموضوع رسالة، ونطاق تاريخ محدد؛ تحقق من الرسائل القديمة والحديثة. افحص المجلدات التي من المفترض أن تظهر فيها الرسائل وقارن النتيجة برسالة معروفة يمكن للمستخدم فتحها مباشرةً. ثم أرسل أو استقبل رسالة اختبار وتأكد من إمكانية البحث عنها بعد فترة الفهرسة المعتادة.
ابحث عن تحسن مستمر بدلاً من مجرد استعلام ناجح واحد. معايير النجاح العملية هي:
- تصل حالة إعادة فهرسة صندوق البريد إلى حالتها المكتملة دون حدوث أخطاء متكررة.
- تظهر الرسائل المعروفة التي كانت مفقودة سابقاً في عمليات البحث المتوقعة.
- تستمر الرسائل الجديدة في الظهور في فهرس البحث.
- يحتفظ مجلد الفهرس بسعة تخزين كافية، وتبقى صناديق البريد الأخرى مستجيبة.
إذا أبلغ الأمر عن اكتماله ولكن بقيت بعض الرسائل مفقودة، فتحقق من وجود هذه الرسائل وإمكانية فتحها. راجع ما إذا كانت مصطلحات بحث المستخدم، أو عوامل تصفية التاريخ، أو نطاق المجلد، أو ذاكرة التخزين المؤقت على جانب العميل هي سبب هذا الاختلاف. لا يمكن للفهرس المُعاد بناؤه استعادة الرسائل التي حُذفت، أو لم تُسلّم أبدًا، أو فُقدت من المخزن الأساسي.
متى يجب تغيير مسار استكشاف الأخطاء وإصلاحها
إذا فشلت عملية إعادة بناء قاعدة البيانات بشكل متكرر، فابدأ بمعالجة الخطأ المذكور في سجلات النظام. تأكد من توفر مساحة القرص وعدد العقد (inodes)، وابحث عن أخطاء أوسع نطاقًا في مخزن البريد أو قاعدة البيانات، وتأكد من معالجة صندوق البريد على الخادم الصحيح. إذا تعذر على الحساب الوصول إلى محتوى الرسائل، أو إذا ظهرت المشكلة نفسها في صناديق بريد أخرى، فتوقف عن إعادة فهرسة قاعدة البيانات، وابحث عن سبب المشكلة على مستوى المخزن أو قاعدة البيانات أو الخادم.
تجنب حذف /opt/zimbra/indexالبيانات يدويًا كخطوة روتينية. تتضمن صفحة ويكي Zimbra العامة إجراءً لحذف ملفات الفهرس يدويًا، ولكن هذه الصفحة لا تزال قيد التطوير ومرتبطة بإصدارات قديمة. يُعد الحذف اليدوي أكثر عرضة للأخطاء من أمر إعادة الفهرسة المدعوم على مستوى الحساب، ولا يُنصح به إلا وفقًا لإرشادات المورّد الحالية الخاصة بالإصدار، مع تحديد مسار صندوق البريد بدقة، ووجود نسخ احتياطية موثقة، وخطة صيانة.
حدود إعادة فهرسة صناديق البريد
تُعيد عملية إعادة الفهرسة بناء بيانات البحث الوصفية؛ لكنها لا تُصلح جداول MySQL أو MariaDB، ولا تستعيد الكائنات الثنائية الكبيرة المفقودة، ولا تُصلح نظام ملفات تالفًا، ولا تُحرر قرصًا ممتلئًا، ولا تُعالج انقطاع البحث على مستوى الخادم. كما أنها تستغرق وقتًا أطول مع ازدياد حجم صندوق البريد وحمل الخادم. قد يكون البحث غير مكتمل مؤقتًا أثناء تشغيل الفهرسة، وقد ينخفض الأداء العام أثناء هذه العملية.
استخدم إعادة فهرسة البريد المدمجة أولاً عندما تشير الأدلة إلى فهرس بحث حساب واحد. قِس النتيجة باستخدام الرسائل المعروفة ورسائل المتابعة. إذا تعذّر إكمال إعادة الفهرسة أو كانت البيانات نفسها تالفة، فانتقل إلى إجراء استعادة التخزين أو قاعدة البيانات المناسب بدلاً من اللجوء إلى حذف الفهرس بشكل شامل.
المراجع الرسمية