دليل تثبيت AwaniOS ولوحة تحكم Console Dashboard

نظام AwaniOS هو نظام تشغيل سحابي مخصص للإنتاج مصمم للبنية التحتية فائقة التقارب (Hyper-Converged Infrastructure)، وإدارة الأجهزة الافتراضية (VM)، والشبكات المحددة بالبرمجيات (SDN). ويوفر معالج تثبيت تفاعلياً بواجهة نصية (TUI) ولوحة تحكم شاملة (os-tui) للمراقبة اللحظية للعقد، وتكويين الشبكات، وإدارة المفاتيح الافتراضية Open vSwitch (OVS)، وإدارة النظام.

---

1. تثبيت النظام

1.1 الإقلاع والتهيئة

• الإقلاع: أدخل وسائط تثبيت AwaniOS ISO في الخادم المادي (Bare Metal) أو الجهاز الافتراضي واعمل إقلاع للنظام. ستشاهد تسلسل إقلاع النواة وتهيئة برنامج التثبيت المباشر [00:10].
• شاشة الترحيب: عند الانتهاء، يبدأ معالج تثبيت AwaniOS التفاعلي.
• تحذير: سيعمل تثبيت AwaniOS على تهيئة ومسح جميع البيانات الموجودة على قرص الهدف المحدد. اضغط على ENTER للموافقة والمتابعة [00:27].

1.2 تهيئة القرص والشبكة

• تحديد القرص الهدف: اختر وحدة التخزين المادية الهدف (مثل /dev/sda أو /dev/vda). استخدم مفاتيح الأسهم للتنقل و ENTER للتحديد [00:34].
  • تخطيط التخزين: يقوم برنامج التثبيت بإنشاء جدول GPT محاذى يتضمن قسم إقلاع BIOS / EFI System Partition، وقسم إقلاع (/boot)، ومجموعة أحجام LVM (awan-vg) تحتوي على الأحجام المنطقية root و swap و home مع مساحة احتياطية 32MB GPT في النهاية.
• تحديد واجهة الشبكة الرئيسية: اختر بطاقة الشبكة المادية النشطة (NIC) لإدارة العقدة (مثل enp1s0 أو eth0) [00:41].
• تحديد وضع الشبكة:
  • DHCP (تلقائي): يتلقى عنوان IP والعبوابة وخوادم DNS تلقائياً من خادم DHCP للشبكة [00:47].
  • Static (يدوي): يتطلب إدخال عنوان IP ثابت بتدوين CIDR (مثل 192.168.1.100/24)، والعبوابة الافتراضية (مثل 192.168.1.1)، وخوادم أسماء DNS (مثل 1.1.1.1, 8.8.8.8).

1.3 هوية النظام وبيانات الاعتماد

• اسم المضيف (Hostname): أدخل اسم مضيف فريد للعقدة (مثل awanios-node-01).
• كلمة مرور النظام: أدخل كلمة مرور آمنة لحساب المسؤول (awanio).
• تأكيد كلمة المرور: أعد كتابة كلمة المرور للتحقق. اضغط على Tab للتنقل بين الحقول و ENTER للإرسال [00:54].

1.4 تنفيذ التثبيت وإعادة الإقلاع

• ملخص التهيئة: راجع مخطط التقسيم، وتهيئات LVM، ومعلمات الشبكة [01:21].
• التنفيذ: اضغط على ENTER لبدء عملية تثبيت Curtin الآلية. يقوم النظام بتهيئة الأقسام واستخراج صورة نظام الملفات وتثبيت برامج إقلاع GRUB [01:32].
• إعادة الإقلاع: عند الانتهاء، اضغط على ENTER لإعادة إقلاع العقدة وإزالة وسائط التثبيت [01:52].

---

2. لوحة تحكم Console Dashboard (os-tui)

بعد إقلاع عقدة AwaniOS المثبتة، يعرض النظام لوحة تحكم Console Dashboard لـ AwaniOS على tty1.

2.1 المصادقة والأمان

سجل الدخول باستخدام اسم المستخدم awanio وكلمة مرور النظام التي تم ضبطها أثناء التثبيت. يتم التحقق من عمليات المصادقة مقابل بيانات الاعتماد الظلية لنظام Linux عبر PAM (unix_chkpwd).

2.2 تخطيط لوحة التحكم والتنقل

تنقسم لوحة التحكم إلى ثلاثة أجزاء رئيسية:

1. شريط العنوان (في الأعلى): يعرض اسم مضيف العقدة، والمستخدم النشط (awanio)، وحالة الاتصال.
2. الشريط الجانبي (على اليسار): قائمة رأسية تعرض جميع علامات التبويب الرئيسية للإدارة مع أرقام الاختصارات (1 إلى 6).
3. لوحة المحتوى الرئيسية (في الوسط/اليمين): منطقة تفاعلية لعرض الإحصائيات وتنفيذ مهام التهيئة.

اختصارات المفاتيح العامة

المفتاح	الإجراء
1 – 6	الانتقال مباشرة إلى علامة تبويب محددة (1: Overview, 2: Networks, 3: Storages, 4: Services, 5: Terminal, 6: Power)
Tab / Shift+Tab	التنقل للأمام / للخلف بين علامات التبويب
h / l أو ← / →	التنقل بين علامات التبويب يساراً / يميناً
j / k أو ↓ / ↑	التنقل في القوائم وعناصر القائمة
n	فتح معالج إدارة بطاقات الشبكة المادية Physical NIC (من علامة تبويب Networks)
m	فتح معالج إدارة المفاتيح الافتراضية Virtual Switch (VS) (من علامة تبويب Networks)
u	فتح نافذة منبثقة لمحدث Console TUI Updater
q	الخروج من Console TUI إلى موجه تسجيل الدخول

---

3. وحدات لوحة التحكم بالتفصيل

3.1 علامة تبويب نظرة عامة على النظام ([1])

توفر علامة التبويب System Overview مراقبة لحظية لحالة المضيف المادي:

• معلومات النظام: اسم المضيف، إصدار توزيعة نظام التشغيل، إصدار نواة Linux Kernel، ومدة التشغيل (Uptime).
• موارد العتاد: بنية المعالج (CPU)، عدد أنوية CPU، متوسط الحمل (1m, 5m, 15m)، وإجمالي/المستخدم من الذاكرة.
• أشرطة استخدام الموارد: أشرطة تقدم ديناميكية توضح نسب استهلاك CPU والذاكرة الحية.
• زر الإجراء السريع [u]: اختصار لإطلاق النافذة المنبثقة لـ TUI Updater.

---

3.2 إدارة الشبكات والواجهات ([2])

اضغط على 2 لفتح علامة تبويب Networks. يعرض هذا القسم واجهات الشبكة المادية، وجسور Open vSwitch (OVS)، والمنافذ الافتراضية (vPorts).

3.2.1 إدارة بطاقات الشبكة المادية Physical NIC ([n])

اضغط على n في علامة تبويب Networks لتهيئية بطاقات واجهة الشبكة المادية:

1. تحديد الواجهة المادية: اختر واجهة نشطة (مثل enp1s0, eth0).
2. اختيار وضع التهيئة:
   • وضع DHCP: يعيد تهيئة Netplan للحصول التلقائي على عنوان IPv4/IPv6 (dhcp4: true).
   • وضع Static IP: يعيد تهيئة Netplan مع معلمات شبكة ثابتة مخصصة:
     • عنوان IP مع CIDR: أدخل عنوان IP مع قناع الشبكة بتدوين CIDR (مثل 192.168.1.10/24). ملاحظة: بادئة CIDR مطلوبة.
     • العبوابة: بوابة توجيه IPv4 الافتراضية (مثل 192.168.1.1).
     • خوادم أسماء DNS: عناوين محلل DNS مفصولة بفواصل (مثل 1.1.1.1, 8.8.8.8).
3. تبديل الحالة والتنظيف:
   • تغيير حالة الواجهة إلى UP أو DOWN.
   • مسح تعيينات عناوين IP الحالية.
4. المزامنة التلقائية لـ DNS والتحليل:
   • عند تطبيق Netplan لاعدادات DNS الثابتة الجديدة، يقوم AwaniOS تلقائياً بتمكين systemd-resolved ومزامنة خوادم الأسماء إلى /etc/resolv.conf لضمان عمل تحليل أسماء النطاقات عبر جميع تطبيقات النظام.

---

3.2.2 إدارة المفاتيح الافتراضية (VS) والمنافذ الافتراضية vPort ([m])

يدمج AwaniOS نظام Open vSwitch (OVS) للشبكات المحددة بالبرمجيات عالية الأداء. اضغط على m في علامة تبويب Networks للوصول إلى معالج Virtual Switch.

أ. إدارة جسور VS

• إنشاء جسر VS:
  • اسم الجسر: أدخل اسم جسر مخصص (مثل br-ex, br-int).
  • وضع الفشل (Fail Mode): اختر standalone (تحويل L2 الافتراضي) أو secure (يتطلب وحدة تحكم SDN).
  • STP / RSTP: تبديل بروتوكول الشجرة الممتدة Spanning Tree Protocol (STP) أو Rapid Spanning Tree Protocol (RSTP) لمنع الحلقات.
• حذف جسر VS: يزيل جسر OVS ويفصل الواجهات المرتبطة بأمان.

ب. إدارة المنافذ الافتراضية (vPorts)

• إضافة منفذ نظام (Trunk/Physical NIC):
  • ربط بطاقة NIC مادية (مثل eth1) كمنفذ نظام ربط صاعد (uplink) بجسر OVS.
  • يتم تجريد عنوان IP الخاص ببطاقة NIC المادية في Netplan وتسليمه إلى مسار OVS.
• إضافة منفذ vPort داخلي:
  • إنشاء منافذ OVS vPorts داخلية (مثل mgmt0, storage0) لشبكات المضيف أو خدمات مزود الافتراضية (hypervisor).
  • تعيين وسم 802.1Q VLAN (من 1 إلى 4094) لتجزئة الشبكة.
  • تعيين عناوين IP ثابتة مباشرة للمنفذ الداخلي vPort.
• وسوم الخدمات (Service Tags): تعيين أدوار خدمات AwaniOS المتخصصة لمنافذ vPorts لتوجيه حركة مرور العنقود تلقائياً:
  • management — إدارة العقدة الرئيسية ومستوى التحكم بالواجهة البرمجية (API control plane).
  • storage — حركة مرور شبكة تخزين Ceph / SAN.
  • migration — حركة مرور ترحيل الأجهزة الافتراضية المباشرة (Live VM migration).
  • backup — النسخ الاحتياطي للبيانات وتكرار اللقطات (snapshots).
  • replication — تكرار كتل التخزين.
  • shared-heartbeat — نصاب العنقود وإشارة نبضات القلب لـ HA.
• استعادة الإقلاع المستمرة (awanios-ovs-ports.service): يتم حفظ منافذ OVS الداخلية ووسوم الخدمات المجهزة عبر os-tui تلقائياً في /etc/awanios/ovs-internal-ports.conf وإعادة تطبيقها عند الإقلاع قبل تهيئة الشبكة.

---

3.3 علامة تبويب إدارة التخزين ([3])

اضغط على 3 لفتح علامة تبويب Storages:

• الأقراص المادية: عرض أجهزة الكتل المكتشفة، وطرازات الأقراص، والأرقام التسلسلية، والسعات الإجمالية، وجداول الأقسام (/dev/sda, /dev/nvme0n1).
• مجموعات أحجام LVM Volume Groups: فحص مقاييس مجمع تخزين awan-vg والأجزاء المخصصة والمساحة الخالية.
• الأحجام المنطقية Logical Volumes: مراقبة نقاط التجميع، وأنواع أنظمة الملفات (ext4, xfs)، والأحجام الإجمالية، ونسب الاستخدام لـ / و /home و swap.

---

3.4 علامة تبويب خدمات Systemd ([4])

اضغط على 4 لعرض خدمات النظام النشطة والخلفية (vapor, libvirtd, openvswitch-switch, systemd-networkd, systemd-resolved, ceph):

• التصفية والبحث: اضغط على / لفتح مربع البحث المباشر وكتابة أسماء الخدمات.
• حالة الخدمة: عرض حالة التحميل (load state)، والحالة النشطة (active/inactive)، والحالة الفرعية (running/exited).
• إجراءات التحكم بالخدمة:
  • حدد خدمة واضغط على ENTER لعرض سجلات وحدة التفاصيل.
  • عناصر التحكم بالإجراءات السريعة: Start (بدء)، Stop (إيقاف)، Restart (إعادة تشغيل)، Enable (تمكين)، Disable (تعطيل).
• تحديث القائمة: اضغط على R لإعادة تحميل حالات الخدمات.

---

3.5 الطرفية المدمجة ([5])

اضغط على 5 لفتح غلاف الطرفية الزائفة المدمجة:

• يطلق جلسة Bash غلاف تفاعلية مباشرة داخل واجهة لوحة التحكم تحت حساب المستخدم awanio.
• يدعم أوامر الطرفية القياسية، وصلاحيات sudo ومحررات النصوص (vim, nano)، وأدوات CLI (awctl, kubectl, virsh, ovs-vsctl, ceph).
• اضغط على ctrl+d أو اكتب exit لإغلاق جلسة الغلاف والعودة إلى قائمة TUI.

---

3.6 إدارة الطاقة ([6])

اضغط على 6 لفتح علامة تبويب إدارة الطاقة للعقدة:

• إعادة إقلاع العقدة: إعادة إقلاع نظام التشغيل بأمان (systemctl reboot).
• إيقاف تشغيل العقدة: إيقاف جميع الأجهزة الافتراضية بأمان، وإلغاء تجميع أنظمة الملفات، وإيقاف تشغيل العتاد (systemctl poweroff).
• يتطلب خطوة تأكيد لمنع إيقاف التشغيل العرضي.

---

4. تحديثات Console TUI

يتميز AwaniOS بإمكانيات التحديث الذاتي المدمجة للوحة تحكم وحدة التحكم.

4.1 مُحدث TUI داخل التطبيق (مفتاح u)

1. اضغط على u من أي علامة تبويب في لوحة التحكم (أو انقر على [u] Update TUI في Overview).
2. يستعلم TUI من https://storage.awan.io/assets/tui-version.json ويقارن بيانات الإصدار المتاحة على الإنترنت مع BuildID المحلي.
3. إذا كان التحديث متاحاً، اضغط على [Enter] للبدء:
   • تنزيل أحدث ملف تنفيذي مترجم لـ os-tui.
   • إنشاء نسخة احتياطية للاستعادة (/usr/local/bin/os-tui.bak).
   • استبدال /usr/local/bin/os-tui بشكل ذري.
   • إعادة تشغيل جلسة TUI تلقائياً (getty@tty1.service) خلال ثانية واحدة دون إعادة تشغيل نظام التشغيل المضيف.

4.2 التحديث اليدوي عبر سطر الأوامر

بدلاً من ذلك، يمكن لمديري النظام تحديث لوحة التحكم من طرفية SSH عن بُعد أو جلسة غلاف:

curl -sSL https://storage.awan.io/assets/awanios-tui-update.sh | sudo bash