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

فشل الخادم في بدء التشغيل

إذا حاولت تشغيل التطبيق ولكنك واجهت رسالة خطأ:

• Address/Port Already in Use (العنوان/المنفذ قيد الاستخدام بالفعل): تأكد من عدم وجود تطبيق آخر يستخدم المنفذ 7080 (الافتراضي). استخدم العلم --listen للتشغيل على منفذ مختلف.

  kudashai --listen :8080

• Permission Denied (رفض الإذن): في بعض أنظمة التشغيل (خاصة عند محاولة الربط بالمنافذ التي تقل عن 1024 أو التي تتضمن التشفير)، قد تحتاج إلى وصول المسؤول / Root، أو قد تحتاج إلى تعديل وضع تنفيذ الملف.

  chmod +x kudashai
  ./kudashai

عدم اتصال وضع المنصة (Platform Mode)

إذا لم تكن قادراً على تفعيل وضع المنصة عبر Kudashai Studio، تحقق مما يلي:

• مفتاح تطبيق غير صالح (Invalid App Key): تأكد من إدخال مفتاح التطبيق (App Key) الصحيح (مفتاح الرخصة) من بوابة مؤسسات AwanIO. إذا كانت صلاحية مفتاحك قد انتهت أو تم إلغاؤها، تواصل مع المسؤول أو فريق دعم AwanIO.
• الاتصال بالشبكة (Network Connectivity): يجري Kudashai Studio مصافحة تلقائية (handshake) مع الواجهة الخلفية لـ AwanIO لتزويد قاعدة البيانات الخاصة بك. تأكد من أن جهازك يتمتع بإمكانية الوصول إلى الإنترنت الصادر وغير محظور بواسطة جدار حماية أو وكيل (proxy).
• انتهاء مهلة المصافحة (Handshake Timeout): إذا استغرقت عملية المصافحة وقتاً طويلاً أو فشلت بصمت، تحقق من سجلات التطبيق لبحث أخطاء الاتصال. أعد تشغيل تطبيق Kudashai وأعد محاولة التفعيل.
• عدم ظهور البيانات بعد التفعيل: إذا نجحت المصافحة ولم تظهر بيانات العنقود، تحقق من السجلات. يحاول النظام تشغيل الترحيل التلقائي عند تفعيل وضع المنصة لأول مرة.

مشكلات بيانات الاعتماد عند نقل البيانات (الوضع المستقل - Standalone)

في الوضع المستقل (Standalone)، يتم تخزين بيانات اعتماد العناقيد محلياً وتشفيرها بأمان باستخدام مفتاح سر (مفتاح تشفير) يتم إنشاؤه تلقائياً بواسطة النظام على جهازك.

• إذا قمت بنقل ملفات بيانات تطبيق Kudashai إلى جهاز كمبيوتر آخر دون تضمين ملف مفتاح التشفير الأصلي، فإن Kudashai على الكمبيوتر الجديد لن يكون قادراً على قراءة بيانات اعتماد العناقيد.
• الحل: تأكد من النسخ الاحتياطي وترحيل مجلد تهيئة Kudashai الافتراضي بالكامل، وليس جزءاً من البيانات فقط.

المساعدة في استكشاف الأخطاء وإصلاحها بواسطة الذكاء الاصطناعي

إذا اكتشف Kudashai وجود Pod أو خدمة K8s في حالة خطأ (مثل ImagePullBackOff, CrashLoopBackOff)، يمكنك استخدام زر "Ask AI" المدمج في واجهة Kudashai. سيحلل وكيل الذكاء الاصطناعي الداخلي السجلات والمقاييس الأخيرة لتشخيص المشكلة والمساعدة في حلها، بل وحتى اقتراح خيارات تهيئة جديدة.