تثبيت كوليبري

انظر إلى سجل تغييرات كوليبري من هنا لمراجعة تغييرات محددة في كل إصدار من كوليبري. وثائق إصدارت كوليبري السابقة متوفرة هنا.

متطلبات الأجهزة

لتثبيت كوليبري على جهاز يعمل كخادم، تحقق من متطلبات الأجهزة أولاً، ومن ثم قم باتباع الإجراء الخاص بنظام التشغيل على جهازك.

Tip

ستجد في الأسفل نصائح عامة بشأن متطلبات الأجهزة لتشغيل كوليبري. لقراءة المزيد من المعلومات بشكل مفصل وإيجاد أمثلة عن إعدادات الأجهزة التي تم تطبيقها بواسطة مستخدمينا، قم بتحميل دليل أجهزة كوليبري كاملاً و أمثلة عن تهيئة الأجهزة لتشغيل كوليبري (مستند PDF).

أجهزة الخادم

المتطلبات الدنيا للأجهزة لتشغيل كوليبري كخادم:

  • ذاكرة الوصول العشوائي RAM ٥٠٠ ميغا بايت (وينصح بـ ١ جيغا بايت)
  • معالح بسرعة ٥٠٠ ميغا هرتز (وينصح بـ ١ جيغا هرتز)
  • تعتمد مساحة القرص الصلب على القنوات التعليمية التي تريد استيرادها من استوديو كوليبري أو من جهاز التخزين المحلي.

في حال كان لديك مرفق تعليمي يحتوي على أقل من ٣٠ حاسوب، يمكن لجهاز بسيط أن يعمل كخادم بشكل جيد، على سبيل المثال جهاز Raspberry Pi.

العملاء

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

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

نظام ويندوز

التوافق

  • الأنظمة المدعومة: ويندوز ٧ و ٨.١ و ١٠، مع متصفح إنترنت إكسبلورر إصدار ١١ ومابعد، متصفح كروم أو متصفح فايرفوكس
  • غير مدعوم: لا يمكن استخدام نظام ويندوز XP لتثبيت خادم كوليبري، لكن يمكن العمل به كجهاز عميل في حال كانت المتصفحات محدثة قدر الإمكان.

التثبيت

  1. قم بتحميل مثبت ويندوز لكوليبري إصدار 0.12.
  2. قم بالنقر بشكل مزدوج على ملف التحميل .exe.
  3. قم بتحديد لغة التثبيت.
  4. مثبت Python 3 مُضمّن، قم بتأكيد الثبيت ومن ثم الترقية للمتابعة.
  5. قم باتباع بقية التعليمات في معالج إعداد تثبيت كوليبري.
  6. حالما تنتهي من التثبيت، سيتم تشغيل كوليبري تلقائياً وفتحه في المستعرض الافتراضي على حاسوبك على الرابط http://127.0.0.1:8080. قد يأخذ ذلك بعض الوقت والصبر لإنهاء العملية بنجاح.
  7. تابع من خلال الإعداد الأولي للمرفق التعليمي الخاص بك.

Warning

سيطلب منك جدار الحماية الخاص بنظام ويندوز أن تسمح بعملية Python الضرورية لتشغيل كوليبري. قم بالنقر على السماح بالوصول للموافقة والمتابعة.

Windows security alert window that opens when Windows firewall needs your permission to allow the Python process, needed to run Kolibri, to be executed on your computer.

قم بالسماح لعملية Python الضرورية بتشغيل كوليبري.

إلغاء التثبيت

  1. قم بفتح لوحة تحكم ويندوز.
  2. قم بتحديد خيار البرامج والميزات.
  3. قم بتحديد كوليبري من قائمة البرامج.
  4. قم بالنقر على الزر إلغاء تثبيت/تغيير ثم اتبع التعليمات.

الترقية

لترقية كوليبري، قم باتباع الخطوات التالية.

  1. قم بتحميل الإصدار الجديد من كوليبري مثبت ويندوز.
  2. قم بالنقر بشكل مزدوج على ملف التحميل .exe.
  3. اتبع التعليمات التي تظهر في نافذة معالج التثبيت.
  4. حالما تنتهي من الترقية، سيتم تشغيل كوليبري تلقائياً وفتحه في المتصفح الافتراضي على حاسوبك.
  5. باشر باستكشاف المزايا الجديدة والمطورة في كوليبري!

نظام Debian/Ubuntu

التوافق

نظام Debian/Ubuntu إصدار 16.04 وما بعد - أي إصدار لم يتم رفع الدعم عنه

التثبيت من مخزن PPA

قم باستخدام الأوامر التالية في المحطة الطرفية لإضافة PPA وتثبيت كوليبري:

sudo apt-get install software-properties-common python-software-properties
sudo add-apt-repository ppa:learningequality/kolibri
sudo apt-get update
sudo apt-get install kolibri

تثبيت من ملف .deb

إن مزايا تحميل ملف .deb هي قابلية النقل: يمكنك نسخ الملف من جهاز إلى آخر ومن ثم تثبيت كوليبري دون الحاجة لاتصال بالإنترنت.

  1. قم بتحميل أحدث إصدار .deb مثبت لكوليبري إصدار 0.12، أو قم بنسخه إلى محرك الأقراص المحلي الخاص بك.

  2. قم بتشغيل هذا الأمر من الموقع الذي قمت فيه بتنزيل ملف DEB عليه:

    sudo dpkg -i kolibri-installer-filename.deb
    
  3. قم بانتظار انتهاء التثبيت ومن ثم قم بتشغيل هذا الأمر لبدء كوليبري:

    kolibri start
    

    Note

    في حال اخترت تثبيت كوليبري كخدمة نظام، لن تحتاج لتشغيله بشكل يدوي.

  4. عندما ينتهي الأمر، افتح المتصفح الافتراضي على الرابط http://127.0.0.1:8080 وتابع مع الإعداد الأولي للمرفق التعليمي الخاص بك.

إلغاء التثبيت

  • قم بفتح البرامج على نظام Ubuntu وحدد موقع كوليبري، ومن ثم قم بالضغط على إزالة.
  • أو من خلال سطر الأوامر: sudo apt-get remove kolibri.

الترقية

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

لترقية كوليبري على جهاز يعمل بنظام Debian غير متصل بالإنترنت، قم بجلب ملف .deb المحدث ومن ثم تابع نفس الخطوات كما في تثبيت من ملف .deb.

تغيير مالك خدمة نظام كوليبري

إن خدمة النظام هي البرنامج النصي المسؤول عن تشغيل كوليبري في الخلفية عندما يتم تشغيل نظامك على أساس توزيعات Debian.

قد تحتاج إلى تغيير خدمة النظام كي تعمل بأذونات حساب مستخدم مختلف. في الإصدارات الأقدم من v0.10، كان حساب مستخدم kolibri هو مالك خدمة النظام، بينما في إصدار v0.10 وما يليه، فإن حساب مستخدمي سطح المكتب هو صاحب الأفضلية، بحيث يمكن لكوليبري الوصول إلى وحدة تخزين USB المحلية.

لتغيير مالك خدمة النظام، تحتاج إلى تغيير تكوين خدمة النظام: قم بنقل مجلد بيانات .kolibri (والتي تحتوي على القنوات، قواعد البيانات إلخ)، ومن ثم تحديد أذونات المالك للمستخدم الجديد. قم باتباع الخطوات التالية.

# Stop Kolibri
sudo systemctl stop kolibri
# Move data to your desktop user:
sudo mv /var/kolibri/.kolibri /home/$USER/.kolibri
# Change ownership
sudo chown -R $USER /home/$USER/.kolibri
# Change the username configuration
sudo sh -c 'sudo echo -n $USER > /etc/kolibri/username'
# Start Kolibri again
sudo systemctl start kolibri

Note

قم باستبدال $USER من الأوامر في الاعلى باسم المستخدم الذي ترغب أن يكون المالك الجديد لخدمة نظام كوليبري.

Raspberry Pi

هناك عدة أنواع من أنظمة التشغيل لجهاز Raspberry Pi. هذا الدليل مخصص ومختبر على Raspbian، الخيار الاكثر شعبيةً بين أنظمة التشغيل، والمبرمج استناداً على نظام Debian. للحصول على نظام Raspbian وتثبيته، قم بالرجوع إلى التوثيق الرسمي.

تم إعداد كوليبري للعمل على إصدار Raspberry Pi Model 3 وما بعده.

Warning

هذه الخطوات تتطلب اتصالاً بالإنترنت أثناء التثبيت. بعد إكمال التثبيت، من الممكن أن تكرر الأمر بنفس الصورة من أجل التثبيت دون إتصال بالانترنت.

التثبيت

  1. نحتاج لترقية مكتبة python3-cffi، والتي انتهت صلاحيتها على نظام Raspbian. قم بترقيتها كما يلي:

    sudo apt install libffi-dev python3-pip python3-pkg-resources dirmngr
    sudo pip3 install pip setuptools --upgrade
    sudo pip3 install cffi --upgrade
    
  2. قم بإضافة حزمة Ubuntu PPA الخاصة بنا باتباع التعليمات الخاصة التالية:

    sudo su -c 'echo "deb http://ppa.launchpad.net/learningequality/kolibri/ubuntu xenial main" > /etc/apt/sources.list.d/learningequality-ubuntu-kolibri-xenial.list'
    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys DC5BAA93F9E4AE4F0411F97C74F88ADB3194DD81
    sudo apt update
    sudo apt install kolibri
    

    عند طرح الأسئلة أثناء عملية التثبيت، يُنصح أن تستخدم مستخدم pi الافتراضي لتشغيل كوليبري حيث أنه يمتلك خاصية الوصول إلى وحدات تخزين USB.

  3. عندما ينتهي الأمر، افتح المتصفح الافتراضي على الرابط http://127.0.0.1:8080 وتابع مع الإعداد الأولي للمرفق التعليمي الخاص بك.

Note

المشاكل التالية هي مشاكل شائعة جداً على جهاز Raspberry Pi:

  • توقيت النظام غير مضبوط بشكل صحيح ولا يعاد تعيينه عند انقطاع التيار الكهربائي. يسبب ذلك أخطاءً أثناء تنزيل البرنامج. على سبيل المثال، لن تنجح عمليات التحقق من صحة شهادات SSL للمصادر المتاحة عبر الإنترنت. تأكد من ضبط المنطقة الزمنية المناسبة لديك في /etc/timezone ومن أن الساعة مضبوطة بشكل صحيح من خلال تشغيل الأمر sudo ntpd -gq.

  • غالبا ما تكون مساحة التخزين قليلة. في حال كنت تملك مصدر تخزين إضافي من نوع USB، يمكنك استخدام أمر kolibri manage movedirectory أو إنشاء روابطك المرمزة للوصول إلى مجلد بيانات موجود في مكان آخر.

    باستخدام أمر الإدارة المدمج:

    # Stop kolibri
    sudo systemctl kolibri stop
    # Move the data
    kolibri manage movedirectory /path/to/your/external_drive
    # Start kolibri
    sudo systemctl kolibri start
    
  • عمليات I/O بطيئة: يعني ذلك أن الصعوبات المعتادة على Raspberry Pi هي نقل الملفات من/ إلى بطاقة ذاكرة من نوع MicroSD أو وحدة تخزين USB متصلة. بمجرد تشغيل كوليبري، لن يكون ذلك أمراً صعباً، إنما ستواجه ذلك أثناء نسخ المحتويات الأولية بحجم أكثر من جيغا بايت. سيقوم قارئ بطاقة SD ومنافذ USB بالحد من السرعة من50 إلى 80 ميغابايت/ ثانية. من خلال تجربتنا، ليس مهماً إن كنت تستخدم قارئ بطاقة SD رئيسي أو بعض وسائط USB المتصلة الخاصة بك، حيث أن كلا منهما من حيث المبدأ يصل إلى نفس السرعة القصوى. ومع ذلك، قد تجد اختلافات كبيرة في سرعات بطاقات SD المفردة.

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

إلغاء التثبيت

من خلال سطر الأوامر: sudo apt-get remove kolibri.

الترقية

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

أنظمة لينوكس/ MacOS الأخرى

التوافق

  • نظام تشغيل MacOS ١٠,٦ وما بعد، كافة المتصفحات مدعومة
  • لينوكس: أي نظام تشغيل يحتوي بايثون ٢,٧، كافة المتصفحات مدعومة

التثبيت

لتثبيت كوليبري على توزيعات لينكس المختلفة عن Debian، إوأيضاً MacOS، يمكنك استخدام تثبيت عام من خلال الأمر pip install، أو قم باتباع هذه الخطوات لتشغيل كوليبري مع حزمة PEX.

  1. قم بتحميل مثبت PEX لكوليبري إصدار 0.12.

  2. تأكد من فتح المحطة الطرفية حيث قمت بتحميل ملف PEX. على سبيل المثال، إذا قمت بحفظه في مجلد التحميلات، اكتب ذلك عند فتح المحطة الطرفية، ثم اضغط مفتاح الإدخال Enter:

    cd Downloads
    
  3. قم بكتابة الأوامر التالية (اضغط مفتاح الإدخال Enter بعد كل مرة).

    chmod +x kolibri-installer-filename.pex
    ./kolibri-installer-filename.pex start
    

    Note

    تأكد من استبدال kolibri-installer-filename.pex بنفس اسم الملف الذي قمت بتنزيله في كل من الأمرين. على سبيل المثال، في حال كان اسم الملف الذي تم تنزيله هو kolibri-v0.12.0.pex، فاكتب ذلك بدلاً من kolibri-installer-filename.pex.

  4. عندما ينتهي الأمر، افتح المتصفح الافتراضي على الرابط http://127.0.0.1:8080 وتابع مع الإعداد الأولي للمرفق التعليمي الخاص بك.

Warning

تذكر أن حزمة PEX تتيح لك تشغيل كوليبري على نظامك فقط عندما تكون العملية نشطة في نافذة المحطة الطرفية. في حال كانت تلك العملية متوقفة (سواء بالضغط على Ctrl + C، إغلاق المحطة الطرفية، أو إعادة تشغيل نظامك)، ستحتاج إلى تكرار الخطوات أعلاه لبدء كوليبري مجدداً. حسابات المستخدم، الصفوف الدراسية، والمجموعات التي أنشأتها، إضافة إلى القنوات التعليمية التي حملتها، ستكون جميعها متاحة في كل مرة تعيد بها تشغيل كوليبري.

إلغاء التثبيت

  1. قم بحذف ملف PEX.
  2. قم بحذف مجلد ./kolibri في دليل المستخدم الرئيسي الخاص بك في حال كنت ترغب بإزالة كافة ملفات كوليبري والقنوات التعليمية التي استوردتها.

الترقية

لترقية كوليبري، قم باتباع الخطوات التالية.

  1. قم بتحميل الإصدار الجديد من مثبت PEX الخاص بكوليبري.
  2. قم ببدء تشغيل كوليبري أثناء التثبيت الأول.
  3. باشر باستكشاف المزايا الجديدة والمطورة في كوليبري!

حزمة Python pip

يمكنك تثبيت كوليبري كحزمة أساسية من PyPi (تعمل على أنظمة Mac وويندوز ولينوكس) وذلك باستخدام هذا الأمر:

pip install kolibri

الإعداد الأولي

للقيام بالإعداد الأولى لمرفق كوليبري التعليمي الخاص بك مابعد التثبيت، قم باتباع الخطوات التالية.

Note

ليس عليك سوى القيام بالإعداد الأولي مرة واحدة فقط، وهي المرة الأولى التي تبدأ فيها تشغيل كوليبري ما بعد التثبيت. يمكنك تغيير كافة الإعدادات لاحقاً، باستثناء نوع واسم المرفق التعليمي.

  1. قم بتحديد لغة كوليبري الافتراضية.

    Step 1 of 7 with language options.

    قم بتحديد لغة كوليبري الافتراضية.

    Warning

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

  2. اسم المرفق التعليمي ونوعه. "المرفق التعليمي" هو الموقع الذي تقوم فيه بتثبيت كوليبري، كالمدرسة أو مركز التدريب أو حتى منزلك.

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

    تتطلب المرفقات التعليمية الرسمية وغير الرسمية اسماً بينما لا تتطلب المرفقات التعليمية الشخصية ذلك.

    Step 2 of 7 where you need to choose a type of facility.

    قم باختيار نوع المرفق التعليمي.

  3. دخول الزائر.

    Step 3 of 7 where you can allow guests to access Kolibri content without the need to create an account.

    قم بتحديد إمكانية وصول الزوار إلى محتوى كوليبري دون الحاجة إلى إنشاء حساب.

  4. إنشاء حساب مستخدم.

    Step 4 of 7 where you can permit anyone to create a user account for themselves, or if user accounts must be created by Kolibri admins.

    قم بتحديد ما إذا كان يمكن لأي شخص إنشاء حساب مستخدم بنفسه، أو إذا كان يجب إنشاء حسابات المستخدمين بواسطة مشرفي كوليبري.

  5. يقوم تمكين كلمات المرور للمتعلمين. بتبسيط تسجيل الدخول دون أن يتطلب ذلك كلمة المرور، مما يتيح وصولاً أسهل للمتعلمين الأصغر عمراً.

    Step 5 of 7 where you can select if learners must type in their passwords to sign-in to Kolibri, or use just their username.

    قم بتحديد ما إذا كان يجب على المتعلمين كتابة كلمات المرور الخاصة بهم لتسجيل الدخول إلى كوليبري.

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

    Step 6 of 7 is where you select the username and password for the facility super admin.

    قم بتحديد اسم المستخدم وكلمة المرور للمشرف المتميز المسؤول عن المرفق التعليمي.

    Tip

    تأكد من حفظ بيانات أوراق اعتماد المشرف المتميز في مكان آمن!

  7. استخدام البيانات والخصوصية - مسؤوليات المسؤول. عند قيامك بإنشاء مرفق تعليمي في كوليبري، وخاصة في سياقات رسمية، يجب أن تأخذ في الاعتبار قوانين وأنظمة الخصوصية ذات الصلة. بصفتك مشرفاً متميزاً أو أي شخص تقوم بتفويضه، ستكون مسؤولاً عن حماية وإدارة حسابات المستخدمين والمعلومات الشخصية المخزنة على الجهاز. قم بمراجعة استخدام البيانات وبيان الخصوصية قبل الانتهاء من إعداد المرفق التعليمي.

    Step 7 of 7 requires you to review the super admin responsibilities regarding the data usage and privacy.

    قم بمراجعة مسؤوليات المشرف المتميز بما يخص استخدام البيانات والخصوصية.

حالما تنتهي من الإعداد الأولى، قم بالمتابعة إلى استيراد بعض المحتوى، و إنشاء مستخدمين (في حال اخترتَ إعداد مرفق تعليمي مدار من قبل المشرف). تحقق من كيفية تهيئة الحواسيب الأخرى في شبكة الاتصال للوصول إلى كوليبري.