كتيبات الأدوات
توفر كتيبات الأدوات أدوات تشغيلية لإدارة بنية OmniCore التحتية المنفذة. تقع هذه الكتيبات في دليل util_playbooks/ ويمكن تشغيلها بشكل مستقل لأداء مهام الصيانة واستكشاف الأخطاء الشائعة.
مرجع سريع
| كتيب الأدوات | الغرض |
|---|---|
health_check.yml | إنشاء تقرير شامل عن صحة جميع الخدمات |
restore_hss.yml | استعادة قاعدة بيانات HSS و/أو التكوين من النسخة الاحتياطية |
ip_plan_generator.yml | إنشاء وثائق الشبكة مع مخططات Mermaid |
get_ports.yml | تدقيق المنافذ المفتوحة والخدمات المستمعة عبر جميع المضيفين |
getLocalCapture.yml | استرجاع ملفات التقاط الحزم من المضيفين |
delete_local_user.yml | إزالة حساب مستخدم محلي من جميع المضيفين |
updateMtu.yml | تعيين MTU إلى 9000 (إطارات ضخمة) على واجهات الشبكة |
systemctl status.yml | التحقق من حالة الخدمة على مكونات EPC |
فحص الصحة
الملف: util_playbooks/health_check.yml
ينشئ تقرير صحة شامل بتنسيق HTML يغطي جميع خدمات OmniCore و OmniCall المنفذة.
ansible-playbook -i hosts/customer/host_files/production.yml util_playbooks/health_check.yml
الإخراج: /tmp/health_check_YYYY-MM-DD HH:MM:SS.html
المعلومات التي تم جمعها
| المكون | البيانات المجمعة |
|---|---|
| جميع الخدمات | حالة الخدمة، الإصدار، مدة التشغيل |
| OmniHSS | حالة قاعدة البيانات، اتصالات نظير Diameter |
| OmniDRA | اتصالات نظير Diameter والحالة |
| OmniTAS | المكالمات النشطة، الجلسات، التسجيلات، استخدام وحدة المعالجة المركزية |
| OCS | حالة تكرار KeyDB |
استعادة HSS
الملف: util_playbooks/restore_hss.yml
يستعيد OmniHSS من ملفات النسخ الاحتياطي. يدعم استعادة قاعدة البيانات فقط، أو التكوين فقط، أ�� كليهما.
ansible-playbook -i hosts/customer/host_files/production.yml util_playbooks/restore_hss.yml
تنسيقات ملفات النسخ الاحتياطي
| النوع | نمط اسم الملف | المحتويات |
|---|---|---|
| قاعدة البيانات | hss_dump_<hostname>_<timestamp>.sql | تفريغ MySQL لقاعدة بيانات omnihss |
| التكوين | hss_<hostname>_<timestamp>.tar.gz | أرشيف لمجلد /etc/omnihss |
مولد خطة IP
الملف: util_playbooks/ip_plan_generator.yml
ينشئ وثائق الشبكة من الجرد، بما في ذلك:
- تعيينات IP للمضيفين (NICs الأساسية والثانوية)
- نظرة عامة على شريحة الشبكة
- مخططات الاتصال بالواجهة (Diameter، GTP، PFCP، SIP، SS7)
ansible-playbook -i hosts/customer/host_files/production.yml util_playbooks/ip_plan_generator.yml
ملفات الإخراج
| الملف | التنسيق | الوصف |
|---|---|---|
/tmp/ip_plan_<customer>_<site>.md | Markdown | وثائق نصية |
/tmp/ip_plan_<customer>_<site>.html | HTML | مخطط تفاعلي مع طبقات قابلة للتصفية |
تدقيق المنافذ
الملف: util_playbooks/get_ports.yml
يدقق جميع المنافذ المستمعة عبر النشر وينشئ وثائق.
ansible-playbook -i hosts/customer/host_files/production.yml util_playbooks/get_ports.yml
ملفات الإخراج
| الملف | الوصف |
|---|---|
/tmp/all_ports.csv | CSV مع اسم المضيف، IP، البروتوكول، المنفذ، الخدمة |
./open_ports.rst | جدول reStructuredText لوثائق Sphinx |
البيانات المجمعة
| الحقل | الوصف |
|---|---|
| اسم المضيف | اسم المضيف في الجرد |
| IP | عنوان IP الخاص بـ ansible_host للمضيف |
| إصدار IP | IPv4 أو IPv6 |
| النقل | TCP أو UDP |
| المنفذ | رقم المنفذ المستمع |
| الخدمة | اسم العملية |
استرجاع الالتقاط المحلي
الملف: util_playbooks/getLocalCapture.yml
يسترجع أحدث ملفي التقاط حزم من كل مضيف من دليل /etc/localcapture.
ansible-playbook -i hosts/customer/host_files/production.yml util_playbooks/getLocalCapture.yml
الإخراج: ./localCapturePcaps/<hostname>/*.pcap
إدارة المستخدمين
الملف: util_playbooks/delete_local_user.yml
يزيل حساب مستخدم محلي من جميع المضيفين في الجرد.
ansible-playbook -i hosts/customer/host_files/production.yml util_playbooks/delete_local_user.yml
المطالبة: أدخل اسم المستخدم للحذف عند المطالبة.
تكوين MTU
الملف: util_playbooks/updateMtu.yml
يحدد MTU إلى 9000 (إطارات ضخمة) على واجهة ens160 عبر جميع المضيفين.
ansible-playbook -i hosts/customer/host_files/production.yml util_playbooks/updateMtu.yml
ملاحظة: هذا الكتيب محدد مسبقًا لواجهة ens160. قم بتعديل الكتيب إذا كانت بيئتك تستخدم أسماء واجهات مختلفة.
تشغيل كتيبات الأدوات
الصيغة الأساسية
ansible-playbook -i <inventory_file> util_playbooks/<playbook>.yml
الخيارات الشائعة
| الخيار | الوصف |
|---|---|
-i <inventory> | تحديد ملف الجرد |
--limit <hosts> | تقييد إلى مضيفين أو مجموعات محددة |
-v / -vv / -vvv | زيادة verbosity |
--check | تشغيل جاف (عرض ما سيتغير) |
--diff | عرض اختلافات الملفات |
أمثلة
# تشغيل فحص الصحة على الإنتاج
ansible-playbook -i hosts/acme/host_files/production.yml util_playbooks/health_check.yml
# استعادة HSS على مضيف محدد
ansible-playbook -i hosts/acme/host_files/production.yml util_playbooks/restore_hss.yml --limit hss01
# إنشاء خطة IP مع إخراج مفصل
ansible-playbook -i hosts/acme/host_files/production.yml util_playbooks/ip_plan_generator.yml -v