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

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

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

فحص المتطلبات المسبقة

يوفر Gorelo فحصًا للمتطلبات المسبقة لنظامي Windows وmacOS. يتأكد الفحص من أن الجهاز يستوفي المتطلبات ويمكنه الوصول إلى خدمات Gorelo، وينتهي بنتيجة واضحة PASS أو FAIL. يطلب منك كلا النصين البرمجيين اختيار منطقة Gorelo الخاصة بك: USW (غرب الولايات المتحدة) أو AUE (شرق أستراليا). ثم يفحصان خوادم Gorelo وIoT Hub ومصدر التنزيل المطابق لتلك المنطقة. عند تشغيل نص برمجي بشكل تفاعلي، يطلب منك اختيار منطقة. لتخطي هذا الطلب، مثلًا عند التشغيل دون تدخل، اضبط متغير البيئة GORELO_REGION على USW أو AUE مسبقًا.
  1. افتح نافذة PowerShell مرتفعة الصلاحيات على الكمبيوتر الذي يواجه مشكلات في الوكيل.
  2. انسخ النص البرمجي أدناه بالكامل، والصقه في النافذة، واضغط Enter:
gorelo-check-windows.ps1
  1. اختر منطقتك (USW أو AUE) عند المطالبة.
  2. حُلّ أي إخفاقات باستخدام الجدول أدناه، وتأكد من استمرار إصلاحاتك عبر جلسات PowerShell وعمليات إعادة التشغيل.
يفحص النص البرمجي أيضًا حل DNS لـ IoT Hub الخاص بالمنطقة (gorelo.azure-devices.net لـ USW، وgorelo-aue.azure-devices.net لـ AUE). إذا تعذّر حل IoT Hub، يعرض النص البرمجي تحذيرًا وليس فشلًا. لا يمنع التحذير فحص المثبّت من النجاح، لكن قد يفشل الوكيل في الاتصال بعد التثبيت، لذا يستحق الأمر الإصلاح.

الوكيل مثبّت لكن الأصل يظهر غير متصل

تأتي حالة الاتصال أو عدم الاتصال للأصل في Gorelo من Gorelo Agent. أما Gorelo Connect فهو مكوّن منفصل للتحكم عن بُعد. يمكن أن يعمل Gorelo Connect، ويمكنك بدء جلسات عن بُعد، بينما يتعذّر على Gorelo Agent الوصول إلى سحابة Gorelo. راجع Gorelo Agent مقابل Gorelo Connect. إذا كان Gorelo Agent مثبّتًا لكن الأصل يظهر غير متصل في قائمة الأصول:
  1. شغّل فحص المتطلبات المسبقة على الجهاز المتأثر.
  2. راجع فحوصات عناوين URL لخوادم البوابة وAPI والمحور الخاصة بـ Gorelo. يعني الفشل أن إعدادًا في جدار الحماية أو الوكيل (proxy) أو DNS يحظر Gorelo Agent.
  3. راجع تحذير DNS الخاص بـ IoT Hub. قد يفشل Gorelo Agent في الاتصال إذا تعذّر على الجهاز حل gorelo.azure-devices.net (USW) أو gorelo-aue.azure-devices.net (AUE)، حتى عندما تعمل حركة الإنترنت الأخرى وGorelo Connect.
  4. راجع فحص مزامنة الوقت. أصلح أي عدم تطابق في الوقت.
  5. تحقق من سجل Gorelo Agent بحثًا عن أخطاء الاتصال. راجع السجلات لمعرفة موقع سجل الوكيل على Windows وmacOS.

السجلات

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

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

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