Dolibarr هو برنامج مفتوح المصدر شائع لتخطيط موارد المؤسسة (ERP) وإدارة علاقات العملاء (CRM) يمكن تثبيته على أنظمة Linux. يوفر مجموعة واسعة من الميزات لإدارة الأعمال، بما في ذلك المحاسبة والفوترة وإدارة المشاريع وإدارة المخزون وغير ذلك الكثير. في هذا الدليل الشامل، سنرشدك خطوة بخطوة من خلال عملية تثبيت Dolibarr على نظام Linux.
المتطلبات المسبقة
قبل البدء، تأكد من توفر المتطلبات المسبقة التالية:
- نظام تشغيل Linux: يمكن تثبيت Dolibarr على توزيعات Linux المختلفة، مثل Ubuntu و Debian و CentOS أو Fedora. في هذا الدليل، سنستخدم Ubuntu 20.04 LTS كمثال.
- خادم الويب: يتطلب Dolibarr خادم ويب للتشغيل، لذا ستحتاج إلى تثبيت Apache أو Nginx على نظام Linux الخاص بك.
- خادم قاعدة البيانات: يستخدم Dolibarr قاعدة بيانات لتخزين بياناته، لذا ستحتاج إلى تثبيت خادم قاعدة بيانات، مثل MySQL أو MariaDB.
- PHP: تم بناء Dolibarr باستخدام PHP، لذا ستحتاج إلى تثبيت PHP على نظامك.
الخطوة 1: تثبيت الحزم المطلوبة
تحديث فهرس الحزم:
$ sudo apt-get update
تثبيت خادم الويب Apache:
$ sudo apt-get install apache2 -y
تثبيت خادم قاعدة البيانات MariaDB:
$ sudo apt-get install mariadb-server mariadb-client -y
تثبيت PHP والوحدات الإضافية المطلوبة:
$ sudo apt-get install php libapache2-mod-php php-mysql php-gd php-curl php-zip php-mbstring php-xml php-intl -y
إعادة تشغيل Apache:
$ sudo systemctl restart apache2
الخطوة 2: تأمين قاعدة البيانات MariaDB
تشغيل سكريبت التثبيت الآمن لـ MySQL:
$ sudo mysql_secure_installation
سيطالبك هذا السكريبت بتعيين كلمة مرور جذر لقاعدة بيانات MariaDB، كما سيقوم بإزالة بعض الإعدادات الافتراضية غير الآمنة.
تسجيل الدخول إلى وحدة التحكم في MariaDB:
$ sudo mysql -u root -p
أدخل كلمة المرور الجذر التي قمت بتعيينها في الخطوة السابقة.
إنشاء قاعدة البيانات والمستخدم Dolibarr:
CREATE DATABASE dolibarr;
CREATE USER 'dolibarr'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON dolibarr.* TO 'dolibarr'@'localhost';
FLUSH PRIVILEGES;
EXIT;
استبدل 'your_password'
بكلمة مرور قوية وفريدة للمستخدم Dolibarr.
الخطوة 3: تنزيل واستخراج Dolibarr
تنزيل إصدار Dolibarr الأحدث:
$ wget https://github.com/Dolibarr/dolibarr/archive/refs/tags/19.0.0.tar.gz
سيقوم هذا بتنزيل أحدث إصدار مستقر من Dolibarr (19.0.0 في هذا المثال).
استخراج الأرشيف المنزل:
$ sudo tar -xzf 19.0.0.tar.gz -C /var/www/html/
سيقوم هذا باستخراج ملفات Dolibarr إلى دليل /var/www/html/
.
إعادة تسمية الدليل المستخرج:
$ sudo mv /var/www/html/dolibarr-19.0.0 /var/www/html/dolibarr
سيقوم هذا بإعادة تسمية الدلير المستخرج إلى dolibarr
، مما سيجعل الوصول إلى تثبيت Dolibarr أسهل.
تعيين الأذونات الصحيحة:
$ sudo chown -R www-data:www-data /var/www/html/dolibarr
$ sudo chmod -R 755 /var/www/html/dolibarr
تقوم هذه الأوامر بتعيين الملكية والأذونات الصحيحة لدليل وملفات Dolibarr.
الخطوة 4: تكوين خادم الويب Apache
إنشاء ملف تكوين المضيف الافتراضي:
$ sudo nano /etc/apache2/sites-available/dolibarr.conf
أضف المحتوى التالي إلى الملف:
<VirtualHost *:80>
ServerName dolibarr.example.com
DocumentRoot /var/www/html/dolibarr/htdocs
<Directory /var/www/html/dolibarr/htdocs>
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/dolibarr-error.log
CustomLog ${APACHE_LOG_DIR}/dolibarr-access.log combined
</VirtualHost>
استبدل dolibarr.example.com
باسم النطاق الذي تريده.
تمكين المضيف الافتراضي:
$ sudo a2ensite dolibarr.conf
إعادة تشغيل Apache:
$ sudo systemctl restart apache2
الخطوة 5: إكمال تثبيت Dolibarr
فتح صفحة تثبيت Dolibarr:
في متصفح الويب الخاص بك، انتقل إلى http://dolibarr.example.com/install/
. استبدل dolibarr.example.com
باسم النطاق أو عنوان IP الفعلي الخاص بك.
اتبع معالج تثبيت Dolibarr:
- على الصفحة الأولى، انقر فوق “Start” لبدء عملية التثبيت.
- على صفحة التكوين، أدخل تفاصيل اتصال قاعدة البيانات:
- اسم قاعدة البيانات:
dolibarr
- مستخدم قاعدة البيانات:
dolibarr
- كلمة مرور قاعدة البيانات: كلمة المرور التي قمت بتعيينها سابقًا
- اسم قاعدة البيانات:
- قم بإنشاء حساب مستخدم Dolibarr super-user وانقر فوق “Next Step” للمتابعة.
- راجع ملخص التثبيت وانقر فوق “Next Step” لإكمال التثبيت.
تأمين التثبيت:
لمنع الوصول غير المصرح به إلى تثبيت Dolibarr، قم بإنشاء ملف قفل التثبيت:
$ sudo touch /var/www/html/dolibarr/documents/install.lock
سيمنع هذا الملف أي شخص من الوصول إلى معالج التثبيت مرة أخرى.
تهانينا! لقد نجحت في تثبيت Dolibarr ERP/CRM على نظام Linux الخاص بك. يمكنك الآن تسجيل الدخول إلى واجهة ويب Dolibarr باستخدام حساب المستخدم super-user الذي قمت بإنشائه أثناء عملية التثبيت.
تحديث Dolibarr
لتحديث Dolibarr إلى إصدار أحدث، اتبع هذه الخطوات:
نسخ احتياطي لبيانات Dolibarr الخاصة بك:
قبل التحديث، من الضروري إنشاء نسخة احتياطية من بيانات Dolibarr الخاصة بك، بما في ذلك قاعدة البيانات وأي تكوينات أو ملفات مخصصة.
تنزيل إصدار Dolibarr الأحدث:
$ wget https://github.com/Dolibarr/dolibarr/archive/refs/tags/19.0.1.tar.gz
استبدل رقم الإصدار بأحدث إصدار مستقر.
استخراج الأرشيف المنزل:
$ sudo tar -xzf 19.0.1.tar.gz -C /var/www/html/
إعادة تسمية الدلير المستخرج:
$ sudo mv /var/www/html/dolibarr-19.0.1 /var/www/html/dolibarr
تعيين الأذونات الصحيحة:
$ sudo chown -R www-data:www-data /var/www/html/dolibarr
$ sudo chmod -R 755 /var/www/html/dolibarr
مسح التخزين المؤقت والسجلات:
$ sudo rm -rf /var/www/html/dolibarr/documents/cache/*
$ sudo rm -rf /var/www/html/dolibarr/documents/logs/*
إعادة تشغيل Apache:
$ sudo systemctl restart apache2
هذا هو! تم تحديث تثبيت Dolibarr الخاص بك إلى أحدث إصدار. تذكر اختبار تثبيت Dolibarr المحدث بشكل شامل قبل وضعه في الإنتاج.
استكشاف الأخطاء وإصلاحها
إذا واجهت أي مشاكل أثناء التثبيت أو استخدام Dolibarr، فإليك بعض خطوات استكشاف الأخطاء وإصلاحها الشائعة التي يمكنك تجربتها:
التحقق من سجلات أخطاء Apache:
$ sudo tail -n 50 /var/log/apache2/error.log
سيعرض لك هذا آخر 50 سطرًا من سجل أخطاء Apache، والتي قد توفر تلميحات حول المشكلة التي تواجهها.
التحقق من سجلات Dolibarr:
$ sudo tail -n 50 /var/www/html/dolibarr/documents/logs/dolibarr.log
قد يحتوي ملف سجل Dolibarr على معلومات أكثر تحديدًا حول أي أخطاء أو مشاكل تواجهها.
التحقق من اتصال قاعدة البيانات:
$ sudo mysql -u dolibarr -p
قم بتسجيل الدخول إلى وحدة التحكم في MariaDB وتأكد من إعداد قاعدة البيانات والمستخدم Dolibarr بشكل صحيح.
التحقق من ملف تكوين Dolibarr:
$ sudo nano /var/www/html/dolibarr/htdocs/conf/conf.php
تحقق من أن تفاصيل اتصال قاعدة البيانات في ملف تكوين Dolibarr صحيحة.
طلب الدعم من المجتمع:
إذا لم تتمكن من حل المشكلة بنفسك، فكر في طلب المساعدة من مجتمع Dolibarr. يمكنك نشر سؤالك على منتديات Dolibarr أو الاتصال بفريق تطوير Dolibarr للحصول على المساعدة.
من خلال اتباع الخطوات الموضحة في هذا الدليل وحل أي مشاكل تنشأ،