> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gorelo Agent لا يتم تثبيته

> استكشف أخطاء تثبيت Gorelo Agent باستخدام فحص المتطلبات المسبقة في PowerShell، وقائمة أنظمة التشغيل المدعومة، والإصلاحات الشائعة لنقاط نهاية Windows وmacOS.

في بعض الأحيان، قد تواجه مشكلات في تثبيت Gorelo Agent. إليك بعض الأشياء التي ينبغي مراعاتها.

## أنظمة التشغيل المدعومة

يدعم Gorelo فقط أنظمة التشغيل المدعومة حاليًا من المورّد نفسه (Microsoft/Apple).

* [**<u>https://endoflife.date/windows</u>**](https://endoflife.date/windows)
* [**<u>https://endoflife.date/windows-server</u>**](https://endoflife.date/windows-server)
* [**<u>https://endoflife.date/macos</u>**](https://endoflife.date/macos)

## فحص المتطلبات المسبقة عبر PowerShell

يوفر Gorelo فحصًا بسيطًا للمتطلبات المسبقة عبر PowerShell يمكنك تشغيله.

1. افتح نافذة PowerShell مرتفعة الصلاحيات على الكمبيوتر الذي يواجه مشكلات في الوكيل.
2. الصق الأمر التالي واضغط **Enter**:

```text theme={null}
Invoke-Expression (Invoke-WebRequest -Uri "https://gist.githubusercontent.com/mikelgorelo/e5bcac91d2fddd165a2fd56a675ebb3a/raw/dd21bcf13480e366a569ae06fa43b9f3c57fa5d8/gorelo-check.ps1" -UseBasicParsing).Content
```

3. اعمل على حل أي إخفاقات، كما هو موضح أدناه، وتأكد من استمرار ذلك عبر جلسات PowerShell وعمليات إعادة التشغيل.

| الفحص                                   | **❌ رسالة الفشل**                                                                                                                                                                                                                                                                                                                                | **✅ استكشاف الأخطاء وإصلاحها**                                                                                                                                                                                                                                                                |
| :-------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **فحص إصدار PowerShell**                | `FAIL: PowerShell version X.X is below the required version 5.1`                                                                                                                                                                                                                                                                                 | <ul><li>قم بتنزيل وتثبيت Windows Management Framework 5.1 من Microsoft</li><li>لنظام Windows 10/11، استخدم Windows Update لتحديث PowerShell</li><li>تحقق من التثبيت باستخدام `$PSVersionTable.PSVersion`</li></ul>                                                                            |
| **فحص مساحة محرك أقراص النظام**         | <ul><li>`FAIL: Free space is less than 300 MB (Current: X MB)`</li><li>`FAIL: Unable to get drive info`</li><li>`FAIL: Unable to get System Drive`</li></ul>                                                                                                                                                                                     | <ul><li>قم بتشغيل Disk Cleanup لتحرير المساحة</li><li>ابحث عن الملفات الكبيرة غير الضرورية وأزلها</li><li>تحقق من أن محرك أقراص النظام يمكن الوصول إليه ومثبت بشكل صحيح</li><li>تحقق من سلامة القرص باستخدام `chkdsk /f`</li></ul>                                                            |
| **فحص بنية المعالج**                    | `FAIL: Non-64-bit processor architecture detected: X`                                                                                                                                                                                                                                                                                            | <ul><li>تحقق من أن النظام يفي بمتطلبات 64 بت</li><li>تحقق مما إذا كنت تشغّل Windows بنسخة 32 بت على عتاد قادر على 64 بت</li></ul> ARM64 مدعوم، على سبيل المثال Snapdragon                                                                                                                     |
| **فحص أذونات السجل**                    | `FAIL: Registry read/write permission check. Error: [specific error]`                                                                                                                                                                                                                                                                            | <ul><li>شغّل النص البرمجي كمسؤول</li><li>تحقق من الأذونات على HKLM:\SOFTWARE\Gorelo</li><li>تحقق من أن مكافحة الفيروسات لا تحظر الوصول إلى السجل</li><li>استخدم RegEdit للتحقق من إمكانية الوصول إلى مفتاح السجل</li></ul>                                                                    |
| **فحوصات إمكانية الوصول إلى عنوان URL** | `FAIL: URL check for [Description] ([URL]). Error: [specific error] `                                                                                                                                                                                                                                                                            | <ul><li>تحقق من الاتصال بالإنترنت</li><li>تحقق من حل DNS (`nslookup` للنطاق)</li><li>تحقق من إعدادات جدار الحماية</li><li>تحقق من إعدادات الوكيل إن وجدت</li></ul>                                                                                                                            |
| **فحص أذونات سجل الأحداث**              | `FAIL: Event log read/write permission check. Error: [specific error]`                                                                                                                                                                                                                                                                           | <ul><li>شغّل النص البرمجي كمسؤول</li><li>تحقق من أن خدمة Event Log قيد التشغيل (`Get-Service EventLog`)</li><li>تحقق من الأذونات على سجل أحداث Application</li><li>تحقق من وظيفة Event Viewer يدويًا</li></ul>                                                                                |
| **فحص متغير البيئة**                    | <ul><li>`FAIL: The PATH environment variable contains 'system32' but not 'System32\WindowsPowerShell\v1.0'`</li><li>`FAIL: The PATH environment variable contains 'System32\WindowsPowerShell\v1.0' but not 'system32'`</li><li>`FAIL: The PATH environment variable does not contain 'system32' or 'System32\WindowsPowerShell\v1.0'`</li></ul> | <ul><li>تحقق من متغير System PATH في System Properties</li><li>تحقق من بنية دليل Windows</li><li>أصلح/استعد System PATH إذا تم تعديله</li><li>قارن مع متغير PATH على نظام يعمل بشكل صحيح</li></ul>                                                                                            |
| **فحص مزامنة الوقت**                    | `FAIL: Time mismatch detected! [time details]`                                                                                                                                                                                                                                                                                                   | <ul><li>تحقق من أن خدمة Windows Time قيد التشغيل</li><li>فرض مزامنة الوقت: `w32tm /resync`</li><li>تحقق من إعدادات المنطقة الزمنية</li><li>تحقق من الاتصال بالشبكة بـ [**time.windows.com**](http://time.windows.com)</li><li>قم بتكوين المزامنة التلقائية للوقت في إعدادات Windows</li></ul> |

## السجلات

يسجل Gorelo كل شيء في:

```text theme={null}
%programfiles%\Gorelo\LogFiles\ 
```

أثناء تقدم التثبيت، يقوم المثبّت بإنشاء مجلدات إضافية في كل مرحلة مع ملفات سجل بداخلها:

**InstallerHandler** > **Installer** > **Shell > Agent**

لا تتردد في التحقق من السجلات التالية -- هذا هو المكان الذي تظهر فيه أكثر المشكلات شيوعًا:

```text theme={null}
%programfiles%\Gorelo\LogFiles\Installer\diagnostics**.log
```

```text theme={null}
%programfiles%\Gorelo\LogFiles\Agent\diagnostics**.log
```

إذا طلب دعم Gorelo ملفات السجل، أرسل مجلد **LogFiles** بالكامل في صورة ملف .zip.

## ما زلت تواجه مشكلات؟

إذا كنت لا تزال تواجه مشكلات في التثبيت بعد حل جميع الإخفاقات في **Gorelo Agent Check**، فاتصل بدعم Gorelo مباشرةً. استخدم محادثة الدعم عبر أيقونة "?" في القائمة السفلية اليسرى.