> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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
الخدمات:
  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
```

{% 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
volumes:
  mongo-data:
  redis-data:

الخدمات:
  mongo:
    volumes:
      - mongo-data:/data/db

  redis:
    volumes:
      - 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` الأمر لإخراج نسخة من السجلات.

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

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

```
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
```

{% 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://ayakaleaf-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.