كيفية إعداد تكامل Etherpad في BigBlueButton

يتم تكوين تكامل Etherpad في BigBlueButton من خلال مكون الملاحظات المشتركة على الخادم. في BigBlueButton 4.0 beta.4، يُعدّ Etherpad اختياريًا: قم بتثبيت bbb-padsالحزم bbb-etherpad، ثم اختر Etherpad لاجتماع واحد أو عيّنه كإعداد افتراضي على مستوى الخادم. في الإصدارات السابقة التي تكون فيها حزم Etherpad موجودة بالفعل، تتمثل المهمة الرئيسية في اختيار المحرر وإعادة تشغيل الخدمات المتأثرة.

تأكد أولاً من إصدار BigBlueButton لديك. توضح وثائق الإصدار 4.0 الحالي تغييرًا عن الإعداد الافتراضي السابق: BlockNote هو محرر الملاحظات المشتركة الافتراضي، بينما تُعد حزم Etherpad اختيارية. لذا، فإن اختيار Etherpad صراحةً يجنبك الاعتماد على إعداد افتراضي خاص بالإصدار. راجع ملاحظات الميزات الجديدة الرسمية لـ BigBlueButton 4.0 ومرجع واجهة برمجة تطبيقات BigBlueButton .

ما يفعله التكامل

يعرض BigBlueButton الملاحظات المشتركة داخل الاجتماع وينسق الوصول إلى لوحة الملاحظات. يوفر Etherpad محررًا تعاونيًا مباشرًا يُستخدم في هذا المجال. في التثبيت القياسي، تُثبّت مكونات Etherpad الخاصة بـ BigBlueButton على نفس الخادم؛ ولا تحتاج عادةً إلى إضافة عنوان URL عام منفصل لـ Etherpad أو لصق مفتاح API الخاص بـ Etherpad في واجهة الاجتماع.

يُغطي هذا الدليل إعداد الخادم المُجمّع والخيارات المدعومة على مستوى الاجتماع وعلى مستوى الخادم ككل. يتطلب نشر مجموعة خوادم أو خادم وكيل عكسي إعدادات إضافية لعنوان URL والمصدر؛ ولا تُغني هذه الإعدادات عن تثبيت مكونات Etherpad وتفعيلها.

1. تحقق من إصدار BigBlueButton والحزم المثبتة لديك

قم بتشغيل هذه الأوامر على جهاز BigBlueButton المضيف:

sudo bbb-conf --check
dpkg -l | grep -E 'bbb-(etherpad|pads|shared-notes-server)'

تساعد قائمة الحزم في التمييز بين عدم تثبيت Etherpad ومشكلة في اختيار الحزم. في نظام BigBlueButton 4.0 beta.4، تُشير الملاحظات الرسمية إلى bbb-shared-notes-serverBlockNote كحزمة افتراضية مطلوبة، bbb-etherpadبالإضافة bbb-padsإلى حزم اختيارية. قد تُظهر الإصدارات السابقة مزيجًا مختلفًا من الحزم، لذا يُرجى الرجوع إلى وثائق الإصدار المُثبّت فعليًا بدلًا من نسخ تعليمات الإصدار 4.0 إلى خادم أقدم.

2. قم بتثبيت حزم Etherpad عند الحاجة

في الإصدار التجريبي 4.0 من BigBlueButton، قم بتثبيت الحزم الاختيارية باستخدام APT:

sudo apt update
sudo apt install bbb-pads bbb-etherpad

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

بعد التثبيت، تأكد من ظهور كلا الحزمتين في قائمة الحزم. إذا كنت تُحدّث خادم إنتاج موجودًا، فاتبع إجراءات التحديث الرسمية للإصدار وحدّد موعدًا للصيانة؛ إذ يُعدّ تثبيت الحزم الاختيارية تغييرًا في الخادم، وليس إعدادًا للعميل.

3. تفعيل إيثر باد لاجتماع واحد

لاستخدام Etherpad في جلسة محددة مع ترك الإعدادات الافتراضية للخادم دون تغيير، قم بتعيين sharedNotesEditorالمعلمة إلى etherpadفي استدعاء واجهة برمجة تطبيقات BigBlueButton لهذا الاجتماع create:

sharedNotesEditor=etherpad

يُدرج هذا المعامل ضمن تكامل جانب الخادم المسؤول عن إنشاء الاجتماع. يجب على التطبيق تضمينه في طلب الإنشاء المُوقّع قبل حساب مجموع التحقق من واجهة برمجة التطبيقات (API). تقبل واجهة برمجة تطبيقات BigBlueButton etherpadهذا blockNoteالخيار. راجع وثائق واجهة برمجة التطبيقات لمعرفة سلوك الإصدار المُثبّت لديك، حيث قد تختلف عمليات التحقق والقيم الافتراضية باختلاف الإصدار.

احتفظ بالمفتاح السري المشترك لـ BigBlueButton على الخادم. لا تكشف عنه في جافا سكريبت المتصفح، أو مصدر الصفحة، أو تطبيق الهاتف المحمول. أي شخص يحصل على المفتاح السري يمكنه إنشاء استدعاءات API موقعة باسم خادمك. إذا كنت تستخدم Greenlight أو أي واجهة أمامية أخرى للاجتماعات، فقم بضبط المعلمة من خلال الإعدادات المدعومة في تلك الواجهة بدلاً من تعديل عنوان URL للاجتماع في المتصفح.

4. اجعل Etherpad هو الإعداد الافتراضي على مستوى الخادم

إذا كان من المفترض أن يستخدم كل اجتماع برنامج Etherpad، فقم بتحرير ملف تجاوز الويب الخاص بـ BigBlueButton:

sudo nano /etc/bigbluebutton/bbb-web.properties

أضف هذا السطر مع الحفاظ على الإعدادات الأخرى في الملف:

sharedNotesEditor=etherpad

احفظ الملف وأعد تشغيل BigBlueButton:

sudo bbb-conf --restart

ينطبق هذا الإعداد على الاجتماعات التي لا تُحدد sharedNotesEditorقيمتها الخاصة. يمكن لمعامل إنشاء الاجتماع أن يجعل الاختيار واضحًا لجلسة معينة. توثق ملاحظات الإصدار 4.0 الرسمية هذه الخاصية نفسها لاختيار Etherpad بشكل عام، وتُحدد إعادة التشغيل باستخدامها bbb-conf --restart.

5. اختبر النتيجة في اجتماع جديد

استخدم اجتماعًا تجريبيًا جديدًا بعد إعادة التشغيل؛ فقد لا تعكس الغرفة الجارية بالفعل التغييرات الافتراضية. انضم كمدير ومشارك ثانٍ، وافتح الملاحظات المشتركة، وتأكد من أن كلا المستخدمين يستطيعان رؤية نفس الملاحظات وتعديلها. قم بإجراء تعديل تجريبي قصير من كل حساب، وانتظر حتى يتم تحديث عرض المشارك الآخر، وتحقق من النتيجة بعد إغلاق لوحة الملاحظات وإعادة فتحها.

إذا كنت تختبر اجتماعًا تم إنشاؤه عبر تكامل واجهة برمجة التطبيقات (API)، فراجع طلب الإنشاء الخاص بهذا التكامل وتأكد من تضمينه للمعامل المطلوب sharedNotesEditor=etherpad. ولإجراء اختبار افتراضي عام، أنشئ اجتماعًا دون تحديد هذا المعامل. هذا يفصل بين خيار مفقود على مستوى الاجتماع ومشكلة في إعدادات الخادم.

نشر وكيل المجموعة وعناوين URL الخارجية

عندما تصل المتصفحات إلى BigBlueButton عبر خادم وكيل مُجمّع أو اسم مضيف عام مختلف، يجب أن تتطابق عناوين URL الخاصة بالملاحظات المشتركة وأصول المتصفح مع تصميم الخادم الوكيل. يوثّق دليل خادم الوكيل المُجمّعpads.url الرسمي لـ BigBlueButton الإعدادات في /etc/bigbluebutton/bbb-html5.ymlملف وقائمة السماح لخادم الوكيل المُجمّع في ملف /etc/bigbluebutton/etherpad.json. يستخدم عنوان URL المثال /padمسارًا على مضيف الخادم الوكيل العام. اتبع هذا الدليل بالكامل لإعداد المجموعة، بما في ذلك متطلبات الأصل والخادم الوكيل؛ لا تنسخ سطر عنوان URL فقط إلى تثبيت خادم واحد غير ذي صلة.

بعد تغيير إعدادات المجموعة، اتبع خطوات إعادة التشغيل والتحقق الخاصة بإصدار BigBlueButton المُثبّت. إذا تم تحميل Etherpad على اسم المضيف المباشر للخادم ولكنه فشل عند المرور عبر الوكيل، فتحقق من مسار الوكيل واسم المضيف وشهادة TLS وسياسة مصدر المتصفح قبل تغيير اختيار المحرر. يجب أن يدعم الوكيل العكسي أيضًا الاتصالات اللازمة لواجهة التحرير المباشر في Etherpad.

استكشاف الأخطاء وإصلاحها في حالات الأعطال الشائعة

  • تُفتح الملاحظات المشتركة في BlockNote. تأكد من أن الاجتماع المستخدم sharedNotesEditor=etherpadموجود sharedNotesEditor=etherpadفي /etc/bigbluebutton/bbb-web.propertiesالإعدادات الافتراضية العامة. في الإصدار 4.0 beta.4، تحقق من تثبيت الحزمتين الاختياريتين.
  • لوحة الملاحظات مفقودة أو لا يتم تحميلها. شغّل البرنامج sudo bbb-conf --check، وراجع حالة الحزمة، وافحص سجلات خدمة BigBlueButton وEtherpad بحثًا عن أخطاء بدء التشغيل أو الاتصال. تأكد من أن المتصفح يستخدم اسم المضيف المقصود وبروتوكول HTTPS الآمن.
  • يستطيع أحد المشاركين التعديل بينما لا يستطيع الآخر. اختبر ذلك بإنشاء اجتماع جديد واستخدام حسابات من متصفحات مختلفة. تأكد من انضمام كلا المستخدمين إلى نفس الاجتماع، ومن عدم وجود خادم وكيل أو طبقة مصادقة تحظر جلسة Etherpad أو حركة مرور WebSocket.
  • لن تظهر التغييرات بعد تعديل الإعدادات. أنشئ اجتماعًا جديدًا بعد إعادة التشغيل. تحقق أيضًا مما إذا كان مُنشئ الاجتماع يُمرر قيمة مُحرر صريحة تتجاوز القيمة الافتراضية للخادم.
  • يعمل البرنامج مباشرةً، لكنه يفشل عند استخدامه عبر خادم وكيل. قارن عنوان URL الخاص بالملاحظات العامة، ومسار الخادم الوكيل، وإعدادات TLS، والمصدر المسموح به، وتكوين المجموعة مع دليل خادم الوكيل الرسمي للمجموعة. تجنب قواعد الخادم الوكيل العامة التي تكشف خدمات داخلية غير ذات صلة.

الفحوصات التشغيلية والأمنية

حافظ على تحديثات BigBlueButton وحزم Etherpad ونظام التشغيل على مسارات التحديث المدعومة. قيّد الوصول إلى أسرار واجهة برمجة التطبيقات الإدارية على التعليمات البرمجية الموثوقة من جانب الخادم، واستخدم بروتوكول HTTPS لنقاط نهاية الاجتماعات العامة والملاحظات، واعرض فقط المسارات المطلوبة لنشرك. إذا كانت خدمتك تسجل الاجتماعات، فاختبر كيفية التعامل مع الملاحظات المشتركة في التسجيلات وبعد انتهاء الاجتماعات؛ إذ قد يعتمد سلوك التسجيل على إصدار BigBlueButton وإعدادات التسجيل.

يكتمل الإعداد عندما يختار اجتماع جديد المحرر المطلوب، ويتمكن عدة مشاركين من التعاون، ولا تُظهر سجلات وحدة تحكم المتصفح وسجلات الخادم أي أعطال في الاتصال، وتبقى النتيجة ثابتة بعد إعادة فتح لوحة الملاحظات. بالنسبة لنشر الإصدار التجريبي 4.0، يتمثل التغيير الرئيسي في ضرورة تثبيت Etherpad كمكون اختياري وتحديده صراحةً. بالنسبة للإصدارات الأخرى، يُرجى التحقق من سلوك الحزمة وواجهة برمجة التطبيقات (API) وفقًا لوثائق ذلك الإصدار قبل إجراء أي تغييرات على خادم الإنتاج.

اترك تعليقاً

أفضل 10 أدوات مسح Ping للعثور على الأجهزة على شبكتك

أفضل 10 أدوات مسح Ping للعثور على الأجهزة على شبكتك

قارن بين 10 أدوات مسح الشبكة المحلية (Ping) لاكتشاف الشبكات المحلية بسرعة، وإجراء مسح شامل للأنظمة الأساسية المختلفة، وإدارة عناوين IP. تعرّف على ما يمكن أن يكشفه لك المسح وما لا يمكنه كشفه.

أفضل 6 أدوات لإدارة الشبكة لتتبع الأداء

أفضل 6 أدوات لإدارة الشبكة لتتبع الأداء

قارن بين ست أدوات لإدارة الشبكة لمراقبة الأداء، بما في ذلك تغطية SNMP، ورسم الخرائط، والتنبيهات، ونماذج النشر، والمفاضلات المتعلقة بالتكلفة.

أفضل برامج تحليل شبكة الواي فاي لأنظمة ويندوز، وiOS، وأندرويد

أفضل برامج تحليل شبكة الواي فاي لأنظمة ويندوز، وiOS، وأندرويد

قارن بين أفضل برامج تحليل شبكة Wi-Fi لأنظمة Windows و iPhone و Android، بما في ذلك أدوات ازدحام القنوات وتغطية الإشارة والخرائط الحرارية واستكشاف أخطاء الشبكة وإصلاحها.

مراقبة الاتصال: 7 أدوات مجانية ومفتوحة المصدر لمراقبة توافر الشبكة

مراقبة الاتصال: 7 أدوات مجانية ومفتوحة المصدر لمراقبة توافر الشبكة

قارن بين سبعة برامج مراقبة زمن الاستجابة المجانية والمفتوحة المصدر، بدءًا من مجموعات الشبكة الكاملة وحتى مجسات زمن الاستجابة المركزة، واختر البرنامج المناسب من حيث التوافر وفقدان الحزم والسجل.

جودة الخدمة في الشبكات: ما هي جودة الخدمة وكيف تعمل

جودة الخدمة في الشبكات: ما هي جودة الخدمة وكيف تعمل

تعرف على معنى جودة الخدمة في الشبكات، وكيف تحدد علامات DSCP وقوائم انتظار حركة المرور أولويات تطبيقات الصوت والفيديو والأعمال، وما لا تستطيع جودة الخدمة إصلاحه.

أفضل الممارسات لمراقبة الشبكات: ما الذي يجب تتبعه وما هي الأدوات التي يجب استخدامها

أفضل الممارسات لمراقبة الشبكات: ما الذي يجب تتبعه وما هي الأدوات التي يجب استخدامها

قم ببناء نظام مراقبة شبكة عملي مع تغطية واضحة للأجهزة، ومقاييس أداء مفيدة، وتنبيهات قابلة للتنفيذ، ومقارنة بين SolarWinds NPM وPRTG وOpManager.

أفضل برامج خادم SFTP لنقل الملفات بشكل آمن

أفضل برامج خادم SFTP لنقل الملفات بشكل آمن

قارن بين برامج خوادم SFTP الموثوقة لأنظمة ويندوز ولينكس، بما في ذلك OpenSSH وBitvise وSolarWinds وSFTPGo. اعثر على الخيار الأمثل الذي يلبي احتياجاتك الأمنية واحتياجات نقل الملفات.

أفضل 7 أدوات لإدارة عناوين IP لفرق الشبكات

أفضل 7 أدوات لإدارة عناوين IP لفرق الشبكات

قارن بين سبع أدوات لإدارة عناوين IP لاكتشاف الشبكات الفرعية، وتنسيق DNS وDHCP، وجرد الشبكة، وIPAM مفتوح المصدر.

أفضل 10 أدوات لفحص الشبكات لاكتشاف الأجهزة وعناوين IP

أفضل 10 أدوات لفحص الشبكات لاكتشاف الأجهزة وعناوين IP

قارن بين أدوات فحص الشبكة لاكتشاف الأجهزة بسرعة، وعمليات فحص IP عبر الأنظمة الأساسية، وإدارة عناوين IP للمؤسسات، مع إرشادات حول مطابقة كل خيار مع شبكتك.

كيفية استخدام Nmap لتتبع المسار وقراءة مسار الشبكة

كيفية استخدام Nmap لتتبع المسار وقراءة مسار الشبكة

استخدم خيار --traceroute في Nmap لرسم خرائط القفزات إلى مضيف مصرح به، وفهم مخرجات القفزة وRTT، واستكشاف الأخطاء وإصلاحها في الاستجابات المفقودة دون الإفراط في المسح.