انتقل إلى المحتوى الرئيسي

OmniSS7 - دليل المستخدم

OmniSS7 من خدمات شبكة Omnitouch هو مجموعة شاملة من إشارات SS7 التي توفر وظائف مرنة لعناصر الشبكة.

نظرة عامة على التوجيه

نظرة عامة على الوثائق​

تم تنظيم هذه الوثائق حسب دور عنصر الشبكة. اختر الدليل الذي يتناسب مع نشر النظام الخاص بك:

📚 أدلة التكوين​

  • دليل STP - تكوين نقطة نقل الإشارة

    • توجيه حركة مرور SS7 بين أقران الشبكة
    • توجيه رمز النقطة والعنوان العالمي
    • توازن الحمل وإخفاء الطوبولوجيا
    • استخدم هذا إذا كنت تقوم بتوجيه حركة مرور SS7 بين الشبكات

  • دليل عميل MAP - تكوين عميل MAP

    • الاتصال كعميل M3UA لإرسال طلبات MAP
    • استعلامات HLR، المصاد��ة، معلومات التوجيه
    • دعم بروتوكول MAP العام
    • استخدم هذا إذا كنت ترسل طلبات MAP إلى عناصر الشبكة

  • دليل مركز SMS - تكوين مركز SMS (SMSc)

    • توجيه وتسليم رسائل SMS
    • إدارة قائمة انتظار الرسائل المدعومة بقاعدة بيانات
    • تقارير التسليم والتفريغ التلقائي
    • استخدم هذا إذا كنت تدير مركز SMS

  • دليل HLR - تكوين سجل الموقع المنزلي

    • إدارة قاعدة بيانات المشتركين
    • توليد متجهات المصادقة
    • تحديثات الموقع ومعلومات التوجيه
    • استخدم هذا إذا كنت تدير HLR/HSS

  • دليل بوابة CAMEL - تكوين بوابة CAMEL

    • خدمات الشبكة الذكية (CAP/CAMEL)
    • التحكم في المكالمات في الوقت الحقيقي والفوترة
    • تكامل OCS للفوترة
    • منشئ الطلبات التفاعلي ومراقبة الجلسات
    • استخدم هذا إذا كنت تقدم خدمات IN أو فوترة في الوقت الحقيقي

🔧 الميزات الشائعة​

  • دليل الميزات الشائعة - المكونات المشتركة
    • نظرة عامة على واجهة المستخدم على الويب والتكوين
    • وثائق API
    • المراقبة والقياسات (Prometheus)
    • أفضل الممارسات واستكشاف الأخطاء وإصلاحها

📖 الوثائق المرجعية​

  • الملحق - المرجع الفني
    • مواصفات بروتوكول SS7
    • رموز عمليات MAP
    • تدفقات معاملات TCAP
    • ترميزات الأحرف والصيغ

البدء السريع​

1. نظرة عامة على النظام​

يمكن أن يعمل OmniSS7 في أوضاع مختلفة حسب متطلبات الشبكة الخاصة بك:

3. التكوين​

يمكن أن يعمل OmniSS7 في 5 أوضاع تشغيل مختلفة. يحتوي ملف التكوين config/runtime.exs على أمثلة كاملة وجاهزة للاستخدام.

لتبديل الأوضاع:

  1. افتح config/runtime.exs
  2. قم بإلغاء تعليق قسم التكوين المطلوب (STP، HLR، SMSc، أو CAMEL GW)
  3. قم بتعليق الأقسام الأخرى
  4. قم بتحديث عناوين IP وURLs الخاصة بـ API حسب الحاجة
  5. أعد تشغيل التطبيق

→ انظر أدلة الأوضاع المحددة أدناه للحصول على تعليمات التكوين الكاملة

أمثلة على التكوينات في runtime.exs:

وضع STP:

config :omniss7,
  map_client_enabled: true,
  hlr_mode_enabled: false,
  smsc_mode_enabled: false,
  camelgw_mode_enabled: false,
  map_client_m3ua: %{...}

وضع HLR:

config :omniss7,
  map_client_enabled: false,
  hlr_mode_enabled: true,
  smsc_mode_enabled: false,
  camelgw_mode_enabled: false,
  hlr_api_base_url: "...",
  map_client_m3ua: %{...}

وضع SMSc:

config :omniss7,
  map_client_enabled: true,
  hlr_mode_enabled: false,
  smsc_mode_enabled: true,
  camelgw_mode_enabled: false,
  smsc_api_base_url: "...",
  auto_flush_enabled: true,
  map_client_m3ua: %{...}

وضع بوابة CAMEL:

config :omniss7,
  cap_client_enabled: true,
  camelgw_mode_enabled: true,
  ocs_enabled: true,
  ocs_url: "http://your-ocs-server/api/charging",
  cap_version: :v2,  # إصدار CAP: :v1، :v2، :v3، أو :v4
  cap_client_m3ua: %{...}

4. الوصول إلى واجهة المستخدم على الويب​

انتقل إلى http://localhost (أو اسم المضيف الذي قمت بتكوينه)

هيكل النظام​

مصفوفة الميزات​

الميزةوضع STPعميل MAPوضع SMScوضع HLRبوابة CAMEL
توجيه ��مز النقطة✅❌❌❌❌
توجيه العنوان العالمي✅❌❌❌❌
إعادة كتابة SSN✅❌❌❌❌
دعم متعدد الأقران✅✅✅✅✅
طلبات MAP (إرسال)❌✅✅✅❌
استجابات MAP (استلام)❌✅✅✅❌
إدارة قائمة انتظار SMS❌❌✅❌❌
تفريغ SMS التلقائي❌❌✅❌❌
قاعدة بيانات المشتركين❌❌❌✅❌
متجهات المصادقة❌❌❌✅❌
تحديثات الموقع❌❌❌✅❌
دعم CAP/CAMEL❌❌❌❌✅
الفوترة في الوقت الحقيقي❌❌❌❌✅
التحكم في المكالمات (خدمات IN)❌❌❌❌✅
واجهة المستخدم على الويب✅✅✅✅✅
REST API✅✅✅✅✅
قياسات Prometheus✅✅✅✅✅

العمليات الشائعة​

الوصول إلى واجهة المستخدم على الويب​

  • URL: http://localhost (أو اسم ا��مضيف الذي قمت بتكوينه)
  • واجهة API Swagger: http://localhost/swagger
  • القياسات: http://localhost/metrics

المراقبة​

# تحقق من حالة نظير M3UA
curl http://localhost/api/m3ua-status

# عرض قياسات Prometheus
curl http://localhost/metrics

# تحقق من صحة التطبيق
curl http://localhost/api/health

السجلات​

# تكوين مستوى السجل في config/runtime.exs
config :logger,
  level: :debug  # الخيارات: :debug، :info، :warning، :error

القدرات الرئيسية​

  • دعم كامل لبروتوكول MAP - عمليات MAP المرحلة 2/3
  • دعم بروتوكول CAP/CAMEL - CAP v1/v2/v3/v4 لخدمات الشبكة الذكية
  • إشارات M3UA/SCTP - نقل SS7 القائم على IP
  • الفوترة في الوقت الحقيقي - تكامل OCS للفوترة المدفوعة مسبقًا/المتأخرة
  • قائمة انتظار الرسائل في الوقت الحقيقي - تسليم SMS المدعوم بقاعدة بيانات
  • منشئ الطلبات التفاعلي - واجهة ويب لاختبار CAMEL/CAP
  • مراقبة الجلسات - تتبع جلسات المكالمات CAMEL في الوقت الحقيقي
  • وث��ئق API تفاعلية - واجهة Swagger للاختبار
  • قياسات Prometheus - رؤية كاملة
  • تكوين متعدد الأدوار - STP، عميل MAP، SMSc، HLR، بوابة CAMEL

نظرة عامة على مجموعة البروتوكولات​

أمثلة حالات الاستخدام​

بوابة الشبكة (STP)​

توجيه حركة مرور SS7 بين شبكات الهاتف المحمول المختلفة

  • ربط شبكات المشغلين
  • بوابة SS7 الدولية
  • توازن الحمل عبر HLRs
  • ترجمة العنوان العالمي
  • NAT لـ SCCP (إعادة استخدام العنوان العالمي الذكي)
  • → دليل STP

مركز SMS (SMSc)​

تسليم رسائل SMS إلى المشتركين في الهاتف المحمول

  • تسليم MT-SMS
  • نشأة MO-SMS
  • توجيه SMS المنزلي
  • إخفاء IMSI
  • جدار حماية SMS
  • إدارة قائمة انتظار الرسائل
  • تقارير التسليم
  • متكامل مع OmniMessage للتعامل مع جميع SMS MAP
  • → دليل مركز SMS

عميل MAP​

التفاعل مع أي عناصر شبكة عبر MAP باستخدام واجهة API RESTful بسيطة

  • PRN / SRI / ATI / إلخ
  • بناء تطبيقات SS7/MAP الخاصة بك باستخدام واجهات API RESTful
  • بوابات USSD
  • طلبات متجهات المصادقة
  • استعلامات IMSI/MSISDN
  • استعلامات معلومات التوجيه
  • → دليل عميل MAP

قاعدة بيانات المشتركين (HLR)​

إدارة بيانات المشتركين والمصادقة

  • تحديثات الموقع
  • توليد المصادقة
  • توفير معلومات التوجيه
  • يتكامل بالكامل مع OmniHSS
  • → دليل HLR

منصة الشبكة الذكية (بوابة CAMEL)​

التحكم في المكالمات والفوترة في الوقت الحقيقي لمشغلي الاتصالات

  • فوترة المكالمات المدفوعة مسبقًا/المتأخرة
  • التحكم في المكالمات (الاتصال، الإنهاء، التوجيه)
  • إدارة الجلسات وتوليد CDR
  • منشئ الطلبات التفاعلي للاختبار
  • → دليل بوابة CAMEL

الدعم والموارد​

الوثائق​

أدلة تكوين النواة:

التكامل والمرجع: