> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/ar/aldam/troubleshooting.md).

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

{% hint style="info" %}
إذا كنت تستخدم إصدارًا أقدم، فيُرجى استخدام `sharelatex` بدلًا من `Overleaf` في أسماء المسارات.
{% endhint %}

<details>

<summary>تشغيل Overleaf مع نظام ملفات NFS</summary>

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

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

```
EBUSY: المورد مشغول أو مقفل، unlink '/var/lib/overleaf/data/compiles/62f3d57bef7cf9005c364e75-62f3d57bef7cf9005c364e7a/.nfs573663533034825247625441'
```

وبوجه خاص، نوصي بعدم استخدام أنظمة ملفات مدعومة بـ NFS للبيانات المؤقتة، مثل الأدلة المستخدمة لبيانات التجميع. نوصي باستخدام قرص scratch محلي، ويفضل SSD محليًا، للأدلة التالية.

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

{% code title="مقتطف docker-compose" %}

```yaml
services:
  sharelatex:
    البيئة:
      SANDBOXED_COMPILES_HOST_DIR: /scratch/compiles/
    الأحجام:
      - 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
```

{% endcode %}

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

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

</details>

<details>

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

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

{% code title="مثال على خطأ" %}

```
فشل بدء تشغيل WiredTiger تحت أي نسخة توافق.
السبب: 1: العملية غير مسموح بها
```

{% endcode %}

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

{% code title="config/docker-compose.override.yml" %}

```yaml
الأحجام:
  mongo-data:
  redis-data:

services:
  mongo:
    الأحجام:
      - mongo-data:/data/db

  redis:
    الأحجام:
      - redis-data:/data
```

{% endcode %}

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

</details>

<details>

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

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

إذا رأيت السطر `خطأ فادح: لا يمكن تهيئة مهام الخلفية`، فسيبدو الإخراج الكامل شيئًا مثل هذا:

{% code title="مثال على سجل Redis" %}

```
1:M 11 Feb 2024 15:19:22.609 # تم تهيئة الخادم
1:M 11 Feb 2024 15:19:22.609 # خطأ فادح: لا يمكن تهيئة مهام الخلفية.
1:C 11 Feb 2024 15:19:26.055 # oO0OoO0OoO0Oo Redis قيد البدء oO0OoO0OoO0Oo
```

{% endcode %}

قد يكون هذا مرتبطًا بإصدار 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>

</details>

<details>

<summary>الاتجاه غير الصحيح لصور المعاينة/الصور المصغرة لمعرض القوالب</summary>

في بعض الأحيان، يمكن أن تُنشأ صور المعاينة/الصور المصغرة التي ينشئها 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>

</details>

<details>

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

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

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

{% code title="latexmkrc" %}

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

{% endcode %}

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

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/ar/aldam/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.