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

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

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

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

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

​
السجلات

يسجل Gorelo كل شيء في: 
%programfiles%\Gorelo\LogFiles\
أثناء تقدم التثبيت، يقوم المثبّت بإنشاء مجلدات إضافية في كل مرحلة مع ملفات سجل بداخلها: InstallerHandler > Installer > Shell > Agent لا تتردد في التحقق من السجلات التالية — هذا هو المكان الذي تظهر فيه أكثر المشكلات شيوعًا: 
%programfiles%\Gorelo\LogFiles\Installer\diagnostics**.log

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

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

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