استكشاف الأخطاء وإصلاحها

إذا كنت تستخدم إصدارًا أقدم، فيُرجى استخدام sharelatex بدلًا من overleaf في أسماء المسارات.

تشغيل Overleaf مع نظام ملفات NFS

تركيب نظام ملفات NFS داخل حاوية Overleaf ممكن تقنيًا، لكنه غير موصى به وقد يؤدي إلى أنواع مختلفة من أخطاء الأداء.

من الأخطاء الشائعة التي تظهر أثناء الترجمة:

EBUSY: resource busy or locked, unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'

ننصح بشكل خاص بعدم استخدام أنظمة ملفات مدعومة بـ NFS للبيانات المؤقتة، مثل المجلدات المستخدمة لبيانات الترجمة. نوصي باستخدام قرص مؤقت محلي (scratch disk)، ويُفضَّل أن يكون SSD محليًا للمجلدات التالية.

بالنسبة للإعدادات القائمة على docker-compose، نقترح ببساطة تجاوز التركيب (bind-mount) من NFS، مما يتجنب تغيير المسارات في التطبيق. فيما يلي مقتطف من تكوين docker-compose يستخدم قرصًا مؤقتًا مركّبًا على /scratch:

docker-compose excerpt

services:
  sharelatex:
    environment:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    volumes:
      - nfs:/var/lib/overleaf/data
      - /scratch/cache/:/var/lib/overleaf/data/cache
      - /scratch/compiles/:/var/lib/overleaf/data/compiles
      - /scratch/output/:/var/lib/overleaf/data/output
      - /scratch/tmp/:/var/lib/overleaf/tmp

لا حاجة إلى ترحيل أي ملفات موجودة من NFS إلى موقعها الجديد بعد التحديث. يمكن لمترجم LaTeX إعادة إنشاء جميع الملفات عند تشغيل ترجمة كاملة مرة أخرى.

لمزيد من التفاصيل راجع: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem

تشغيل Overleaf على Windows أو macOS يؤدي إلى عدم بدء خدمة mongo

إذا كنت تشغّل Overleaf على Windows أو macOS، فقد تفشل خدمة mongo في إعادة التشغيل، مع ظهور الخطأ:

Example error

Failed to start up WiredTiger under any compatibility version.
Reason: 1: Operation not permitted

لتجنب هذا الخطأ، يجب تخزين البيانات في وحدة تخزين (volume) بدلًا من مجلد مركّب (bind mount) (راجع وثائق صورة mongo لمزيد من التفاصيل: https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data). لتخزين البيانات داخل وحدات تخزين Docker المركّبة داخل حاويتي MongoDB وRedis، أضف ما يلي إلى config/docker-compose.override.yml (أنشئ هذا الملف إذا لم يكن موجودًا بعد):

config/docker-compose.override.yml

volumes:
  mongo-data:
  redis-data:

services:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - redis-data:/data

لمزيد من المعلومات راجع: https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting

الترقية إلى Redis 6.2 تؤدي إلى حلقة إعادة تشغيل

استخدم الأمر docker logs redis لعرض نسخة من السجلات.

إذا رأيت السطر Fatal: Can't initialize Background Jobs، فستبدو المخرجات الكاملة مشابهة لما يلي:

Redis log example

1:M 11 Feb 2024 15:19:22.609 # Server initialized
1:M 11 Feb 2024 15:19:22.609 # Fatal: Can't initialize Background Jobs.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo

قد يكون ذلك مرتبطًا بإصدار Docker المستخدم حاليًا. يُفترض أن يؤدي التحديث إلى إصدار >= 20.10.10 إلى حل هذه المشكلة.

لمزيد من المعلومات، راجع المشكلة المسجّلة في مشروع Redis الأصلي: https://github.com/redis/redis/issues/12362

المرجع: https://docs.overleaf.com/on-premises/support/troubleshooting#upgrading-to-redis-6.2-results-in-a-restart-loop

اتجاه غير صحيح لصور المعاينة/الصور المصغّرة في معرض القوالب

في بعض الأحيان، قد تُنشأ صور المعاينة/الصور المصغّرة التي يولّدها Server Pro باتجاه خاطئ، وتتطلب تدخلًا يدويًا لتصحيحها. تُخزَّن هذه الصور في /var/lib/overleaf/data/template_files/ (>= 5.0.3) و/var/lib/sharelatex/data/template_files/ (في الإصدارات الأقدم).

نوصي بأخذ نسخة احتياطية من هذا المجلد قبل إجراء أي تغييرات.

ستحتاج إلى اتباع الخطوات أدناه لكل قالب متأثر:

ابحث عن معرّف القالب: انتقل إلى معرض القوالب في نسختك (/templates/all)، وافتح قالبًا متأثرًا، وانسخ المعرّف من عنوان URL (على سبيل المثال: https://your-instance-url/templates/6645d346c224815e9460a695). شغّل أمر التصحيح: شغّل الأمر التالي من مضيف Docker (استبدل معرّف القالب بالمعرّف الذي نسخته وعدّل المسار إذا لزم الأمر): docker exec sharelatex /bin/bash -c “mogrify -rotate 90 /var/lib/overleaf/data/template_files/6645d346c224815e9460a695_*{thumbnail,preview}”

المرجع: https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images

يُرجى التحقق من أنك فعّلت استدعاءات النظام. بالنسبة لـ pdflatex، يكون ذلك 'pdflatex -shell-escape'.

الأمر \write18 معطّل افتراضيًا في Community Edition لأن جميع عمليات الترجمة تجري داخل حاوية sharelatex نفسها؛ وهذا هو الإعداد الافتراضي الأكثر أمانًا.

إذا كنت ترغب في تفعيله لـ pdflatex، فأنشئ ملف latexmkrc في جذر مشروعك بالمحتوى التالي:

latexmkrc

$pdflatex = 'pdflatex --shell-escape';

ثم حاول إعادة الترجمة.

المرجع: https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape