دليل عارض لوحة القيادة SKOOR

مقدمة

يغطي هذا الدليل تثبيت SKOOR Dashboard Viewer. بالنسبة لتثبيت SKOOR Engine أو Redhat، يرجى الرجوع إلى دليل تثبيت SKOOR Engine. للحصول على معلومات حول بنية مكونات Dashboard، يرجى زيارة صفحة المكونات في قسم البنية في هذا الدليل.

المتطلبات

الأجهزة

نظام Dashboard Viewer

تعمل خدمة Viewer على جهاز صغير. يكفي وجود ذاكرة وصول عشوائي (RAM) سعة 2 جيجابايت ووحدتي معالج (CPU).

نظام Dashboard Provider

عادةً ما يتم تثبيت خدمة مزود لوحة التحكم على جهاز خادم SKOOR Engine. إذا كان حجم هذا الجهاز كبيرًا بما يكفي، فمن المفترض أن يعمل هذا المكون بشكل جيد على نفس النظام. أيضًا، في معظم الحالات، يكون مكون Dashboards مثبتًا بالفعل وله نفس المتطلبات الأساسية.

البرمجيات

نظام عارض لوحة المعلومات

يتطلب عارض لوحة التحكم خادم apache httpd مع mod_ssl. يرجى تثبيت ملفات RPM ذات الصلة من المستودعات وتشغيل الخادم:

$ sudo yum install httpd mod_ssl
$ sudo /sbin/service httpd start

قم بتكوين httpd لبدء التشغيل أثناء تشغيل النظام:

$ sudo systemctl enable httpd

قم بتكوين firewalld:

$ sudo firewall-cmd --add-port=443/tcp --permanent
$ sudo firewall-cmd --reload

قبل تثبيت مكونات SKOOR، يجب تعطيل SELINUX:

# vi /etc/selinux/config
SELINUX=permissive

# setenforce 0
#
# sestatus
...
Current mode:                 permissive
...

أخيرًا، يحتاج عارض لوحة المعلومات إلى مزود لوحة معلومات يزوده بالبيانات من خدمة الويب SKOOR.

نظام مزود لوحة المعلومات

يجب تثبيت مكونات SKOOR التالية على النظام الذي سيتم تثبيت مزود لوحة التحكم عليه:

وبالطبع، يجب أن يتوفر مثيل لمحرك SKOOR.

التثبيت

نظام Dashboard Viewer

قم بالتثبيت من مستودع SKOOR RPM باستخدام yum:

sudo yum install eranger-nodejs eranger-dashboard-viewer-service eranger-doc

لتكوين عارض لوحة المعلومات، افتح الملف /etc/opt/eranger/eranger-dashboard-viewer-service.json.

مثال:

{
  "port": 8092,
  "presharedKey": "1234567890",
  "logLevel": "debug",
  "defaultUsername": "dashboard-user",
  "defaultPassword": "dashboard-user"
}


المعلمة

الوصف

port

منفذ tcp الذي يمكن من خلاله الوصول إلى الخدمة محليًا بواسطة خادم الويب

presharedKey

يجب مشاركة هذا المفتاح بين مزود لوحة المعلومات وخدمة عارض لوحة المعلومات. هذا لأسباب أمنية، لذا يجب تغييره إلى قيمة فريدة.

logLevel

اضبط هذه المعلمة على أي من القيم التالية: debug، info، warn، error

defaultUsername

يمكن عرض لوحات المعلومات مع أو بدون تسجيل دخول المستخدم. يجب تعيين مستخدم وكلمة مرور للوحة المعلومات الافتراضية. يجب تكوين هذا باستخدام مستخدم SKOOR Engine للقراءة فقط.

يرجى ملاحظة أنه يجب تكوين نفس المستخدم الافتراضي في جميع محركات SKOOR التي توفر البيانات لهذا العارض.

defaultPassword

جنبًا إلى جنب مع defaultUsername، تُستخدم كلمة المرور هذه لمصادقة المستخدم الذي تم تكوينه باستخدام defaultUsername


تحقق من حالة عارض لوحة المعلومات عن طريق طلب عنوان URL التالي باستخدام متصفح:

https://<اسم خادم العارض>/skoor-dashboard-viewer-service/status

يجب أن تبدو النتيجة كما يلي:

{"status":"ok"}


بافتراض أن عارض لوحة التحكم يجب أن يكون قابلاً للوصول من خلال اسم المجال الكامل المخصص له، على سبيل المثال hostname.domain.com. قم بتكوين إعادة التوجيه مباشرة إلى الصفحة الرئيسية لعارض لوحة التحكم، عن طريق إضافة الأسطر التالية إلى ملف تكوين apache ssl /etc/httpd/conf.d/ssl.conf (في الكتلة <VirtualHost *:443> الموجودة):

<VirtualHost *:443> #find this existing block in your ssl configuration file and add the lines below

    # Rewrite only / without anything else to /skoor-dashboard-viewer/
    RewriteEngine On
    RewriteRule ^/$ https://%{SERVER_NAME}/skoor-dashboard-viewer/ [R,L]

لكي يعمل هذا التكوين، يجب أن يكون دليل DocumentRoot موجودًا. قم بإنشائه، ثم أعد تشغيل خادم الويب باستخدام الأوامر التالية:

$ sudo mkdir -p /srv/eranger/html
$ sudo systemctl restart httpd

نظام مزود لوحة التحكم

قم بتثبيت حزمة nodejs و dashboard-viewer-provider:

$ sudo yum install eranger-dashboard-viewer-provider

قم بتكوين موفر Dashboard Viewer عن طريق تعديل الملف /etc/opt/eranger/eranger-dashboard-viewer-provider.json. فيما يلي وصف موجز للخصائص المتاحة:

المعلمة

الوصف

logLevel

حدد أحد المستويات التالية: debug، info، warn، error

webserviceUrl

خدمة الويب للحصول على البيانات منها

tenantId

تحديد المستأجرين المختلفين إذا كان هناك أكثر من مستأجر واحد يغذي نفس عارض لوحة المعلومات. القيمة المعدة مسبقًا هي "default". لا يتطلب تسجيل الدخول إلى المستأجر "default" بادئة tenandId. يمكن تسجيل الدخول إلى المستأجرين الآخرين بإضافة "<tenantname>/" قبل اسم المستخدم

viewerServices

تُستخدم هذه المعلمة لتكوين مشاهد واحد أو أكثر باسم وعنوان URL و presharedKey.

  • يجب أن تكون المعلمة presharedKey متطابقة على جميع المزودين الذين يغذون نفس خدمة المشاهد

  • يمكن أن تشير المعلمة url مباشرة إلى خدمة المزود إذا كان المشاهد مثبتًا على المضيف المحلي:

    "url": "http://localhost:8092"
  • إذا كان العارض مثبتًا في DMZ، يجب أن يشير url إلى المنفذ 443 الذي يخدمه apache httpd:

    "url": "https://<viewer server name or ip>/skoor-dashboard-viewer-service"

presharedKey

يجب مشاركة هذا المفتاح بين مزود لوحة التحكم وخدمة عارض لوحة التحكم. هذا لأسباب أمنية، لذا يجب تغييره إلى قيمة فريدة.

 مثال:
 

{
  "logLevel": "debug",
  "webserviceUrl": "http://localhost:8090",
  "authUrl": "http://localhost:8094",
  "tenantId": "default",
  "viewerServices": {
    "dashboard-viewer": {
      "url": "https://<viewer server name or ip>/skoor-dashboard-viewer-service",
      "presharedKey": "1234567890"
    }
  }
}


أعد تشغيل خدمة المزود الآن:

sudo systemctl restart eranger-dashboard-viewer-provider.service

تحديث

قم بتحديث أي حزمة SKOOR باستخدام yum update:

$ sudo yum update eranger-dashboards-*.rpm

اختبار الدخان

افتح عنوان URL https://<اسم خادم العارض>/skoor-dashboard-viewer في متصفح الويب. يجب أن تظهر لوحة التحكم المرئية للمستخدم الافتراضي المُعد دون الحاجة إلى تسجيل الدخول أولاً. إذا كان ذلك متاحًا، يمكن التبديل إلى مستأجر مختلف عن طريق إضافة معلمة URL tenantId إلى عنوان URL: https://<اسم خادم العارض>/skoor-dashboard-viewer?tenantId=someTenant

في قائمة المستخدم، يتيح رابط Log In (تسجيل الدخول) تسجيل الدخول باستخدام مستخدم مختلف، عادةً ما يكون مستخدمًا يسمح بعرض معلومات مميزة لا يجب أن تكون مرئية للمستخدم الافتراضي:

image-20250729-134255.png

انقر فوق تسجيل الدخول وقدم بيانات الاعتماد، مع مستأجر مختلف اختياريًا قبل اسم تسجيل الدخول:

image-20250729-134727.png

يجب أن تكون لوحات المعلومات الخاصة مرئية الآن.