دليل عارض لوحة القيادة SKOOR
مقدمة
يغطي هذا الدليل تثبيت SKOOR Dashboard Viewer. بالنسبة لتثبيت SKOOR Engine أو Redhat، يرجى الرجوع إلى دليل تثبيت SKOOR Engine. للحصول على معلومات حول بنية مكونات Dashboard، يرجى زيارة صفحة المكونات في قسم البنية في هذا الدليل.
المتطلبات
يتوفر مستودع SKOOR RPM
الأجهزة
نظام 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"
}
المعلمة | الوصف |
|---|---|
| منفذ tcp الذي يمكن من خلاله الوصول إلى الخدمة محليًا بواسطة خادم الويب |
| يجب مشاركة هذا المفتاح بين مزود لوحة المعلومات وخدمة عارض لوحة المعلومات. هذا لأسباب أمنية، لذا يجب تغييره إلى قيمة فريدة. |
| اضبط هذه المعلمة على أي من القيم التالية: debug، info، warn، error |
| يمكن عرض لوحات المعلومات مع أو بدون تسجيل دخول المستخدم. يجب تعيين مستخدم وكلمة مرور للوحة المعلومات الافتراضية. يجب تكوين هذا باستخدام مستخدم SKOOR Engine للقراءة فقط. يرجى ملاحظة أنه يجب تكوين نفس المستخدم الافتراضي في جميع محركات SKOOR التي توفر البيانات لهذا العارض. |
| جنبًا إلى جنب مع 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. فيما يلي وصف موجز للخصائص المتاحة:
المعلمة | الوصف |
|---|---|
| حدد أحد المستويات التالية: debug، info، warn، error |
| خدمة الويب للحصول على البيانات منها |
| تحديد المستأجرين المختلفين إذا كان هناك أكثر من مستأجر واحد يغذي نفس عارض لوحة المعلومات. القيمة المعدة مسبقًا هي "default". لا يتطلب تسجيل الدخول إلى المستأجر "default" بادئة tenandId. يمكن تسجيل الدخول إلى المستأجرين الآخرين بإضافة "<tenantname>/" قبل اسم المستخدم |
| تُستخدم هذه المعلمة لتكوين مشاهد واحد أو أكثر باسم وعنوان URL و 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 (تسجيل الدخول) تسجيل الدخول باستخدام مستخدم مختلف، عادةً ما يكون مستخدمًا يسمح بعرض معلومات مميزة لا يجب أن تكون مرئية للمستخدم الافتراضي:
انقر فوق تسجيل الدخول وقدم بيانات الاعتماد، مع مستأجر مختلف اختياريًا قبل اسم تسجيل الدخول:
يجب أن تكون لوحات المعلومات الخاصة مرئية الآن.

