> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

  ```text theme={null}
  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`:

  ```yaml title="docker-compose excerpt" theme={null}
  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-with-an-nfs-filesystem)
</Accordion>

<Accordion title="تشغيل Overleaf على Windows أو macOS يؤدي إلى عدم بدء خدمة `mongo`">
  إذا كنت تشغّل Overleaf على Windows أو macOS، فقد تفشل خدمة `mongo` في إعادة التشغيل، مع ظهور الخطأ:

  ```text title="Example error" theme={null}
  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](https://github.com/docker-library/docs/blob/master/mongo/content.md#where-to-store-data)). لتخزين البيانات داخل وحدات تخزين Docker المركّبة داخل حاويتي MongoDB وRedis، أضف ما يلي إلى `config/docker-compose.override.yml` (أنشئ هذا الملف إذا لم يكن موجودًا بعد):

  ```yaml title="config/docker-compose.override.yml" theme={null}
  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](https://docs.overleaf.com/on-premises/support/troubleshooting#running-overleaf-on-windows-or-macos-results-in-the-mongoservice-not-starting)
</Accordion>

<Accordion title="الترقية إلى Redis 6.2 تؤدي إلى حلقة إعادة تشغيل">
  استخدم الأمر `docker logs redis` لعرض نسخة من السجلات.

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

  ```text title="Redis log example" theme={null}
  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://github.com/redis/redis/issues/12362)

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

<Accordion title="اتجاه غير صحيح لصور المعاينة/الصور المصغّرة في معرض القوالب">
  في بعض الأحيان، قد تُنشأ صور المعاينة/الصور المصغّرة التي يولّدها 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](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](https://docs.overleaf.com/on-premises/support/troubleshooting#incorrect-orientation-of-template-gallery-preview-thumbnail-images)
</Accordion>

<Accordion title="يُرجى التحقق من أنك فعّلت استدعاءات النظام. بالنسبة لـ pdflatex، يكون ذلك 'pdflatex -shell-escape'.">
  الأمر `\write18` معطّل افتراضيًا في Community Edition لأن جميع عمليات الترجمة تجري داخل حاوية `sharelatex` نفسها؛ وهذا هو الإعداد الافتراضي الأكثر أمانًا.

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

  ```perl title="latexmkrc" theme={null}
  $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](https://docs.overleaf.com/on-premises/support/troubleshooting#please-verify-that-you-have-enabled-system-calls.-for-pdflatex-this-is-pdflatex-shell-escape)
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.