تنصيب حزمة كوها على أبونتو

من ويكيمكتبات الموسوعة الحرة في علم المكتبات والمعلومات والأرشيف.
اذهب إلى: تصفح، ابحث

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

طرق تنصيب كوها[عدل]

توجد 3 طرق لتنصيب نظام كوها :

  • باستخدام مستودعات git .
  • باستخدام الملفات المضغوطة ثم معالجتها tarbull .
  • باستخدام حزم Koha common ، وهي الطريقة الأسهل والمشروحة هنا .

تلميحات قبل البدء[عدل]

الأسطر التي تبدأ بالرموز $ أو # هي أسطر يجب تطبيقها على تيرمينال أبونتو " او موجه الأوامر كما يمسى في ويندوز" .

$ sudo su -
...
# echo "Hello world"

الأسطر التي تبدأ ب < ، يجب تطبيقها في سطر أوامر MySql .

> SHOW DATABASES;

تنصيب أبونتو[عدل]

حمل ونصب أبونتو من الموقع الرسمي :

إضافة مستودع كوها إلى أبونتو[عدل]

  • أفتح الترمينال . ابحث عنه في قائمة البرامج " ابحث كتابةً هناك عن termenal " أو استخدم الاختصار من الكيبورد لفتح مباشرة "Crtl+alt+t"
  • نفذ الأمر التالي لتحصل على صلاحيات فقط وضع كلمة مرور حساب المدير في أبونتو لديك :
$ sudo ls
  • هذا سيمنع الأمر التالي من أن يبدو " كأنه لا يعمل" حيث سيكون يطالبك بكلمة المرور تلك المهم نفذ الأمر التالي الآن:
$ wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

يوجد حالياً ثلاث مستودعات لكوها " وهذا يعتمد على رغبتك في أي اصدار تريد أن تستخدم " في تاريخ كتابة المقالة (2012-12-10 ) "المقصود هنا المقالة الإنجليزية" :

  • oldstable هو مستودع النسخة 3.8 ( آخر نسخة مستقرة قبل الحالية ) .
  • squeeze ، الإصدارة 3.10 المستقرة .
  • squeeze-dev الإصدارة 3.12 قيد التطوير .

عند صدور الإصدار 3.12 " في أيار مايو ، سيتغير الترتيب لتصير الأولى ل 3.10 ( المستقر القديم ) ، الثانية 3.12 المستقر الحالي ، والأخيرة ل 3.14 الغير مستقر قيد التطوير . بالتالي إن شئت تنصيب الإصدارة 3.8 فعليك بتنفيذ الأمر التالي لإضافة مستودعات الإصدارة القديمة المستقرة :

$ echo deb http://debian.koha-community.org/koha oldstable main | sudo tee /etc/apt/sources.list.d/koha.list

"وبالنتيجة الإصدار 3.10 " سيكون بإضافة المستودع التالي :

$ echo deb http://debian.koha-community.org/koha squeeze main | sudo tee /etc/apt/sources.list.d/koha.list
  • والإصدارة قيد التطوير بالأمر :
$ echo deb http://debian.koha-community.org/koha squeeze-dev main | sudo tee /etc/apt/sources.list.d/koha.list

'"هام جداً" لا تضف أكثر من مستودع أضف المستودع للاصدار الذي تريد فقط .'

تحديث أبونتو[عدل]

بعد إضافة المستودع المناسب لك نفذ الأوامر التالية لتحديث كل الحزم في أبونتو لديك :

$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get clean

ستُطالب بكلمة مرور أبونتو لتنفذ الأوامر كمستخدم مسؤول .

تنصيب حزمة كوها[عدل]

نفذ الأمر التالي لتنصيب حزمة كوها بكل بساطة :

$ sudo apt-get install koha-common

قبل عملية التنصيب من متصفح ويب[عدل]

لدينا بعض التكوينات التي نحتاج لضبطها وفق حاجتك .

التكوين الأولي[عدل]

لتمكن كوها من استخدام بروتوكول TCP ، بعد إنتهاء عملية التنصيب قم بتحرير الملف في المسار التالي :

/etc/koha/koha-sites.conf 

إذا كنتَ جديداً على ابونتو بامكانك دائماً استخدام المحرر النصي المرفق بالواجهة الرسومية لابونتو : باستخدام الأمر :

gedit /etc/koha/koha-sites.conf 

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


DOMAIN=".framisdooby.org"  # غير هذا إلى دومين مؤسستك الرئيسي ، وأي تنصيب كوها فرعي في كوها كومون سيكون دومين فرعي لهذا الدومين . 
INTRAPORT="80"  #ضع هنا المنفذ الذي سيستخدم لعميل الموظفين يمكنك استخدام 80 ، " أو ان كنتَ معتاداً على 8080 " استخدمه  . 
INTRAPREFIX=""  # أي محارف ترغب بإضافتها إلى الدومين الفرعي قبل محارف اسم تنصيب كوها (بالنسبة لواجهة الموظفين)
INTRASUFFIX="-intra"  #أي محارف ترغب بإضافتها إلى الدومين الفرعي بعد محارف اسم تنصيب كوها  (بالنسبة لواجهة الموظفين)
DEFAULTSQL=""  # بشكل عام اتركها فارغة القيمة غير مطلوبة عادةً
OPACPORT="80"  # المنفذ الخاص بالأوباك بشكل إفتراضي هو 80 . 
OPACPREFIX=""  # أي محارف ترغب بإضافتها إلى الدومين الفرعي قبل محارف اسم تنصيب كوها (بالنسبة لواجهة الأوباك) اتركها فارغة إن شئت
OPACSUFFIX=""  # أي محارف ترغب بإضافتها إلى الدومين الفرعي بعد محارف اسم تنصيب كوها (بالنسبة لواجهة الأوباك) اتركها فارغة إن شئت
ZEBRA_MARC_FORMAT="marc21"  # حدد صيغة مارك التي ستكشف في زيبرا القيم المتاحة هي "marc21', 'normarc' و 'unimarc" 
ZEBRA_LANGUAGE="en"  # حدد الغة الأساسية لتكشيف زيبرا . القيم المتاحة حالياً "'en', 'fr' and 'nb' " إن شاء الله تضاف العربية قريباً...

قم بالحفظ ... ستحتاج الآن لتفعيل وحدة mod_rewrite في سيرفر أباتشي ، قم بذلك بتنفيذ الأمر التالي :

$ sudo a2enmod rewrite

البدء بإنشاء بدائل "تنصيبات كوها " Instance[عدل]

صراحة احترت في ترجمة كلمة Instance ، ولكنها بالنهاية إنشاء أكثر من كوها واحد ، من خلال كود مصدري واحد (تنصيب واحد). المهم سأعتمد كلمة بديل هنا . سنحتاج الآن لننشئ بديل كوها الأول . وقبل ذلك سنحتاج أن ننصب برنامج إدارة قواعد البيانات Mysql باستخدام الأمر التالي :

$ sudo apt-get install mysql-server 

كن حريصاً هنا بعد هذه العملية سيطلب منك اختيار كلمة مرور لمدير mysql ، فلا تنسها ولا تُخطئ بها، "مشكلة شائعة " .


لإنشاء بديل كوها باسم library ، نفذ الأمر التالي :

$ sudo koha-create --create-db library

استبدل كلمة Library ، بالبديل الذي ترغب به ، والمثال أعلاه سيمكنك من أن يكون دومين مكتبتك مباشرة بالشكل التالي : library.yourdomain.edu على سبيل المثال ، أي دومين فرعي من دومين المؤسسة الأم للمكتبة .

قضية أمنية تتعلق ب mysql[عدل]

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

تكوين سيرفر أباتشي[عدل]

ضبط المنافذ الأساسية[عدل]

نفذ الأمر التالي ليفتح لك محرر النصوص :

sudo gedit /etc/apache2/ports.conf

تأكد من أن المنافذ 80 " أو ان استخدمتَ في خطوة سابقة 8080 " تأكد من أنهم مفعلون . علامة # تفيد أن السطر هذا مجرد تعليق ، عليك أن تتأكد من أن أوامر الإنصات لهذه المنافذ لا تسبقها إشارة# ، وأن تتأكد أنك لم تعطِ أمرين إستماع أو إنصات . على سبيل المثال :

Listen 80
#Listen 8080

في المثال أعلاه الإنصات سيكون فقط للمنفذ 80 لأن المنفذ 8080 ، تم تعيينه كتعليق .طبعاً هذا يعتمد على حاجتك ، فإن اخترت ان يكون عميل الموظفين على المنفذ 8080 فعليك أن تلغي علامة التعليق هنا . وتأكد أيضاً أن المستضيف الإفتراضي " هذه كلها ترجمات حرفية لتقريب الصورة" أيضاً لم يتم تعيينه على أنه تعليق مثال :

NameVirtualHost *:80
#NameVirtualHost *:8080

نفس المثال السابق ، إذا كنتَ حددت 8080 للموظفين " وهو الأسهل لمن ينصب في جهاز تجريبي" فعليك أن تلغي عنه علامة التعليق# .

عطّل أو حرر الموقع الإفتراضي لأباتشي[عدل]

سأشرح هنا فقط تعطيل الموقع الإفتراضي ، وذلك من خلال الأمر التالي :

$ sudo a2dissite 000-default

إن كنتَ في مؤسسة والموقع الأول الافتراضي مهم لك فراجع المقالة الأصلية لم اترجم هذا الجزء بعد كاملاً .

تمكين الموقع ، والوحدات في أباتشي[عدل]

نفذ الأوامر التالية بالترتيب :

$ sudo a2enmod rewrite
$ sudo a2enmod deflate
$ sudo a2ensite library
$ sudo /etc/init.d/apache2 restart

طبعاً استبدل كلمة library باسم البديل " إن كنتَ استخدمتَ غيرها " .

التعديل على ملفات الإستضافة[عدل]

نفذ الأمر التالي :

$ sudo gedit /etc/hosts

سيفتح لك محرر النصوص الملف المسمى hosts ، حرره بما يناسبك ، 127.0.0.1 ، هو أي بي أي جهاز بشكل محلي " بدون أي تواصل شبكي " .  :

127.0.0.1
127.0.1.1

إن كنتَ تود ربطه بدومين معين فضع الأي بي الخاص بجهازك على انترنت وبعده الدومين الخاص بك على سبيل المثال :

127.0.0.1		library.yourdomain.edu

في الحالة الثانية سيكون IP جهازك على الانترنت من 127.0.0.1 وفي سطر جديد ، ويمكن إضافة IP الشبكة المحلية الخاصة بك إن شئت مشاركته على نطاق ضيق " داخل المنزل " أو أي شبكة محلية محدودة النطاق .

إستكمال التنصيب من المتصفح من معالج التنصيب في ويب[عدل]

الآن بإمكانك الوصول عبر الخيارات التي حددتها سابقاً "IP " أو دومين معين إلى كوها ، على سبيل المثال هنا 127.0.0.1 . لتبدأ بعملية التنصيب واختيار حاجاتك .

  • سيطالبك هنا باسم مستخدم وكلمة مرور لكوها ، اسم المستخدم هو koh + _ + اسم البديل الخاص بك ، يعني في حالتنا هو : Koha_library ،
  • كلمة المرور بإمكانك الوصول لها من خلال إستعراض نهاية الملف الموجود في المسار التالي :
/etc/koha/sites/library/koha-conf.xml

حيث أن library ، هي اسم البديل الخاص بك . ولكن لا تعذب نفسك بتلك الطريقة ونفذ الأمر التالي لتحصل على كلمة المرور مباشرةً :D :

sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/library/koha-conf.xml

الخطوة 1 من معالج التنصيب في ويب[عدل]

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

الخطوة 2 من معالج التنصيب في ويب[عدل]

سيتأكد من إعدادات قاعدة البيانات ، أنقر التالي .

الخطوة 3 من معالج التنصيب في ويب[عدل]

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

الإعدادات الأساسية لمكتبتك مع كوها[عدل]

من الجيد بعد تنصيب كوها ، أن تضيف مكتبتك ، من المزيد ، الإدارة ، من المعاملات الأساسية ، اختر المكتبات والمجموعات ، وأضف مكتبتك هناك .

عملية الترقية للإصدارات الأحدث[عدل]

ببساطة نفذ الأوامر التالية :

$ sudo apt-get update
$ sudo apt-get upgrade

سيتم تحديث كل حزم أبونتو لديك ، بما فيها حزمة كوها ، بآخر اصدار . وفي بعض الحالات قد تحتاج لتنفيذ الأمر التالي لتفعل ذلك :

$ sudo apt-get dist-upgrade

إزالة كوها[عدل]

استعرض البدائل التي لديك :

$ koha-list

إحذفها واحدة تلو الأخرى

$ sudo koha-remove {instance}

ثم أحذف حزمة كوها :

$ sudo apt-get remove koha-common