مرجع واجهة سطر الأوامر لـ Cockpit

واجهة سطر الأوامر لـ Cockpit (cockpit-cli) هي أداة نظام تُستخدم لتهيئة مخططات قاعدة البيانات، وإدارة حسابات المستخدمين الإداريين، وتسجيل مضيفي المحاكي الافتراضي، وإجراء التشخيصات مباشرةً على خادم Cockpit.

---

1. أوامر إعداد النظام ودورة حياته

تهيئة مخطط قاعدة البيانات (init)

• الوصف: يُعِدّ مخطط قاعدة البيانات عن طريق إنشاء الجداول والعلاقات والمعاملات الافتراضية المطلوبة. كما يطلب إنشاء حساب المسؤول الجذر الأولي.
• مثال:

  cockpit-cli init --config /etc/cockpit/cockpit.conf

تشغيل بوابة Cockpit (run)

• الوصف: يُشغِّل عملية خدمة Cockpit المركزية.
• مثال:

  cockpit-cli run --config /etc/cockpit/cockpit.conf

---

2. إدارة حسابات المستخدمين

إنشاء حساب مستخدم (user create)

• الوصف: يُنشئ حساب مستخدم محلياً دون الاستعانة بلوحة التحكم على الويب.
• مثال:

  cockpit-cli user create --username "admin" --email "admin@corp.awan.io" --role "super-admin"

إعادة تعيين كلمة مرور الحساب (user reset-password)

• الوصف: يضبط كلمة مرور جديدة للمستخدم المحدد، ويفتح الحساب في حال كان معلّقاً بسبب إخفاقات المصادقة.
• مثال:

  cockpit-cli user reset-password --username "admin" --password "newsecurepassword"

---

3. إدارة مضيفي المحاكي الافتراضي

سرد المضيفين المسجّلين (host list)

• الوصف: يستعلم عن قاعدة البيانات المشتركة ويعرض جميع مضيفي المحاكي الافتراضي المسجّلين وحالة تشغيلهم الراهنة.
• مثال:

  cockpit-cli host list

تسجيل عقدة المحاكي الافتراضي (host add)

• الوصف: يُضيف مضيفاً مادياً جديداً من نوع Vapor إلى قاعدة بيانات مخزون Cockpit.
• مثال:

  cockpit-cli host add --hostname "vapor-node-01.corp.awan.io" --ip "192.168.122.203" --token "VaporAPITokenString"

---

4. التشخيصات واستكشاف الأخطاء وإصلاحها

الاستعلام عن حالة الكتلة (cluster status)

• الوصف: يتحقق من اتصال قاعدة البيانات، ويفحص حالة إصدار المخطط، ويُبلّغ عن أعداد الاتصالات النشطة.
• مثال:

  cockpit-cli cluster status

الاستعلام عن أقفال الإشارة (locks list)

• الوصف: يسرد أقفال الإشارة النشطة في قاعدة البيانات ويُشير إلى نسخة Cockpit المسؤولة عن إدارة كل مضيف للمحاكي الافتراضي.
• مثال:

  cockpit-cli locks list