كيفية تثبيت مانتيس بوغ تراكر على نظام لينكس

مانتيس بوغ تراكر هو نظام تتبع أخطاء مفتوح المصدر وقائم على الويب وشائع الاستخدام. تم كتابته بلغة PHP ويستخدم قاعدة بيانات MySQL/MariaDB لتخزين البيانات. يعتبر مانتيس بوغ تراكر أداة رائعة للمطورين ومديري المشاريع لتتبع المشكلات، والأخطاء، والمهام في مشاريع تطوير البرامج. في هذا المقال، سنمر عبر الخطوات اللازمة لتثبيت مانتيس بوغ تراكر على نظام لينكس.

المتطلبات الأساسية

قبل أن نبدأ عملية التثبيت، يجب علينا التأكد من أن نظامنا يلبي المتطلبات الأساسية التالية:

1. خادم ويب: ستحتاج إلى خادم ويب مثبت على نظام لينكس الخاص بك. خادم Apache HTTP هو خيار شائع، وسنستخدمه في هذا الدليل.
2. PHP: تم كتابة مانتيس بوغ تراكر بلغة PHP، لذلك ستحتاج إلى تثبيت PHP على نظامك. نوصي باستخدام أحدث إصدار مستقر من PHP، والذي في وقت كتابة هذا المقال هو PHP 8.1.
3. خادم قاعدة بيانات: يتطلب مانتيس بوغ تراكر قاعدة بيانات MySQL أو MariaDB لتخزين بياناته. سنستخدم MariaDB في هذا الدليل.
4. إضافات PHP الإضافية: يتطلب مانتيس بوغ تراكر تثبيت وتمكين عدة إضافات PHP، بما في ذلك:
   • php-gd (لمعالجة الصور)
   • php-mbstring (لمعالجة السلاسل متعددة البايت)
   • php-curl (لوظائف عميل HTTP)

بمجرد التحقق من أن نظامك يلبي هذه المتطلبات الأساسية، يمكنك المضي قدمًا في عملية التثبيت.

الخطوة 1: تثبيت خادم Apache HTTP

إذا لم يكن لديك خادم Apache HTTP مثبتًا على نظام لينكس الخاص بك، فيمكنك تثبيته باستخدام مدير حزم التوزيعة الخاصة بك. على سبيل المثال، على أوبونتو/ديبيان، يمكنك استخدام الأمر التالي:

$ sudo apt-get install apache2

على CentOS/RHEL، يمكنك استخدام:

$ sudo yum install httpd

بعد تثبيت Apache، تأكد من بدء الخدمة وتمكينها لتبدأ تلقائيًا عند بدء تشغيل النظام:

$ sudo systemctl start apache2    # على أوبونتو/ديبيان و CentOS/RHEL
$ sudo systemctl enable apache2   # على أوبونتو/ديبيان و CentOS/RHEL

الخطوة 2: تثبيت MariaDB

بعد ذلك، نحتاج إلى تثبيت خادم قاعدة البيانات MariaDB. على أوبونتو/ديبيان، يمكنك استخدام الأمر التالي:

$ sudo apt-get install mariadb-server

على CentOS/RHEL، يمكنك استخدام:

$ sudo yum install mariadb-server

بعد تثبيت MariaDB، قم بتأمين التثبيت عن طريق تشغيل الأمر التالي واتباع التعليمات التي تظهر على الشاشة:

$ sudo mysql_secure_installation

الخطوة 3: تثبيت PHP والإضافات المطلوبة

يتطلب مانتيس بوغ تراكر PHP وعدة إضافات PHP إضافية. على أوبونتو/ديبيان، يمكنك تثبيت PHP والإضافات المطلوبة باستخدام الأمر التالي:

$ sudo apt-get install php php-gd php-mbstring php-curl

على CentOS/RHEL، يمكنك استخدام:

$ sudo yum install php php-gd php-mbstring php-curl

بعد تثبيت PHP والإضافات المطلوبة، أعد تشغيل خادم الويب Apache لضمان سريان التغييرات:

$ sudo systemctl restart apache2   # على أوبونتو/ديبيان
$ sudo systemctl restart httpd     # على CentOS/RHEL

الخطوة 4: تنزيل مانتيس بوغ تراكر

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

يمكنك تنزيل حزمة مانتيس بوغ تراكر من الموقع الرسمي باستخدام الأمر التالي:

$ wget https://sourceforge.net/projects/mantisbt/files/mantis-stable/2.26.2/mantisbt-2.26.2.tar.gz

بمجرد اكتمال التنزيل، قم بإستخراج الحزمة باستخدام الأمر التالي:

$ tar -xvzf mantisbt-2.26.2.tar.gz

سيؤدي هذا إلى إنشاء دليل جديد باسم mantisbt-2.26.2.

الخطوة 5: تكوين Apache لـ مانتيس بوغ تراكر

بعد ذلك، نحتاج إلى تكوين Apache لتشغيل تطبيق مانتيس بوغ تراكر. سنقوم بإنشاء ملف تكوين مضيف افتراضي جديد لـ مانتيس بوغ تراكر.

• أنشئ ملف تكوين جديدًا لـ مانتيس بوغ تراكر:

$ sudo nano /etc/apache2/sites-available/mantis.conf

• أضف المحتوى التالي إلى الملف، مع استبدال /path/to/mantis بالمسار الفعلي لدليل مانتيس بوغ تراكر المستخرج:

<VirtualHost *:80>
      ServerName mantis.example.com
      DocumentRoot /path/to/mantis
      <Directory /path/to/mantis>
         Options FollowSymLinks
         AllowOverride All
         Require all granted
      </Directory>
      ErrorLog ${APACHE_LOG_DIR}/mantis_error.log
      CustomLog ${APACHE_LOG_DIR}/mantis_access.log combined
</VirtualHost>

هذا التكوين يخبر Apache بتشغيل تطبيق مانتيس بوغ تراكر من الدليل المحدد وإنشاء مضيف افتراضي لـ mantis.example.com. يمكنك استبدال mantis.example.com بالنطاق أو عنوان IP الذي تريد استخدامه للوصول إلى مانتيس بوغ تراكر.

• احفظ الملف وأغلقه.
• فعّل تكوين المضيف الافتراضي الجديد:

$ sudo a2ensite mantis.conf

• قم بتعطيل تكوين المضيف الافتراضي الافتراضي لـ Apache (إذا لزم الأمر):

$ sudo a2dissite 000-default.conf

• أعد تشغيل Apache لتطبيق التغييرات:

$ sudo systemctl restart apache2

الخطوة 6: إنشاء قاعدة بيانات لـ مانتيس بوغ تراكر

يتطلب مانتيس بوغ تراكر قاعدة بيانات MySQL/MariaDB لتخزين بياناته. نحتاج إلى إنشاء قاعدة بيانات جديدة ومستخدم له الصلاحيات المناسبة لـ مانتيس بوغ تراكر.

• قم بتسجيل الدخول إلى مُفسِّر أوامر MariaDB:

$ sudo mysql -u root -p

أدخل كلمة مرور الجذر (root) عند مطالبتك بها.

• أنشئ قاعدة بيانات جديدة لـ مانتيس بوغ تراكر:

CREATE DATABASE mantisdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

• أنشئ مستخدمًا جديدًا وامنحه الصلاحيات على قاعدة البيانات الجديدة:

CREATE USER 'mantisuser'@'localhost' IDENTIFIED BY 'كلمة_مرور_قوية';
GRANT ALL PRIVILEGES ON mantisdb.* TO 'mantisuser'@'localhost';

استبدل كلمة_مرور_قوية بكلمة مرور قوية من اختيارك.

• قم بتحديث الصلاحيات لتطبيق التغييرات:

FLUSH PRIVILEGES;

• اخرج من مُفسِّر أوامر MariaDB:

EXIT;

الخطوة 7: تكوين مانتيس بوغ تراكر

الآن بعد أن قمنا بإعداد قاعدة البيانات، يمكننا المضي قدمًا في تكوين مانتيس بوغ تراكر.

• انتقل إلى دليل مانتيس بوغ تراكر:

$ cd /path/to/mantis

• انسخ ملف التكوين النموذجي:

$ cp config_defaults_inc.php.sample config_inc.php

• افتح ملف config_inc.php للتعديل:

$ nano config_inc.php

• ابحث عن الأسطر التالية في الملف وقم بتحديثها ببيانات اعتماد قاعدة البيانات الخاصة بك:

$g_database_type = 'mysqli';
$g_hostname      = 'localhost';
$g_db_username   = 'mantisuser';
$g_db_password   = 'كلمة_مرور_قوية';
$g_database_name = 'mantisdb';

استبدل كلمة_مرور_قوية بكلمة المرور التي حددتها لمستخدم mantisuser سابقًا.

• احفظ الملف وأغلقه.

الخطوة 8: تثبيت مانتيس بوغ تراكر

الآن بعد أن قمنا بتكوين قاعدة البيانات وتحديث ملف التكوين، يمكننا المضي قدمًا في تثبيت مانتيس بوغ تراكر.

• افتح متصفحك الويب وانتقل إلى عنوان URL التالي، مع استبدال mantis.example.com بالنطاق أو عنوان IP الذي قمت بتكوينه سابقًا:

http://mantis.example.com/admin/install.php

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

الخطوة 9: تكوين مانتيس بوغ تراكر (اختياري)

بعد الانتهاء من التثبيت، قد ترغب في تكوين مانتيس بوغ تراكر ليناسب احتياجاتك. فيما يلي بعض خيارات التكوين الشائعة:

• إشعارات البريد الإلكتروني: يمكن لـ مانتيس بوغ تراكر إرسال إشعارات بالبريد الإلكتروني لأحداث مختلفة، مثل المشكلات الجديدة والتحديثات والتعليقات. لتكوين إعدادات البريد الإلكتروني، انتقل إلى لوحة التحكم الإدارية وتصفح إلى “إدارة” > “تكوين” > “إشعارات البريد الإلكتروني”.
• إدارة المستخدمين: يمكنك إنشاء وإدارة حسابات المستخدمين وتعيين أدوار المستخدمين والتحكم في أذونات الوصول. انتقل إلى “إدارة” > “إدارة المستخدمين” في لوحة التحكم الإدارية.
• إدارة المشاريع: يتيح لك مانتيس بوغ تراكر إنشاء وإدارة مشاريع متعددة. يمكنك تكوين إعدادات المشروع، وتعيين المستخدمين للمشاريع، وتخصيص سير العمل الخاصة بالمشروع. انتقل إلى “إدارة” > “إدارة المشاريع” في لوحة التحكم الإدارية.
• تكوين سير العمل: يوفر مانتيس بوغ تراكر نظام سير عمل مرنًا يسمح لك بتحديد حالات المشكلات، والأولويات، والحلول المخصصة. يمكنك تخصيص هذه الإعدادات عن طريق الانتقال إلى “إدارة” > “إدارة التكوين” > “سير العمل”.
• التخصيص: يوفر مانتيس بوغ تراكر خيارات تخصيص متنوعة، مثل السمات والإضافات والترجمات اللغوية. يمكنك استكشاف هذه الخيارات من خلال التنقل إلى الأقسام المعنية في لوحة التحكم الإدارية.

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

الخطوة 10: تأمين مانتيس بوغ تراكر

بعد تثبيت وتكوين مانتيس بوغ تراكر، من المهم اتخاذ خطوات لتأمين تثبيتك. فيما يلي بعض تدابير الأمان الموصى بها:

1. التحديث بانتظام: احرص على تحديث مانتيس بوغ تراكر، وPHP، والمكونات الأخرى بأحدث التصحيحات الأمنية والتحديثات.
2. تكوين أذونات الوصول: قيّد الوصول إلى دليل تثبيت مانتيس بوغ تراكر وملفات التكوين الحساسة من خلال تعيين الأذونات بشكل صحيح.
3. تمكين HTTPS: قم بتكوين Apache لتشغيل مانتيس بوغ تراكر عبر HTTPS لتشفير الاتصالات بين الخادم والعملاء.
4. تطبيق المصادقة: فكر في تطبيق تدابير مصادقة إضافية، مثل المصادقة الثنائية أو الدمج مع نظام مصادقة موحد مثل LDAP أو Active Directory.
5. حصر الوصول إلى لوحة التحكم الإدارية: قيِّد الوصول إلى لوحة تحكم مانتيس بوغ تراكر الإدارية للمستخدمين المصرح لهم فقط.
6. مراقبة السجلات: راقب سجلات Apache و مانتيس بوغ تراكر بانتظام للكشف عن أي نشاط مشبوه أو أخطاء.
7. النسخ الاحتياطي للبيانات: ضع استراتيجية نسخ احتياطي منتظمة لقاعدة بيانات مانتيس بوغ تراكر وملفات التكوين لضمان استرداد البيانات في حالة حدوث أي مشكلات.
8. تعطيل الميزات غير المستخدمة: قم بتعطيل أي ميزات أو إضافات غير مستخدمة في مانتيس بوغ تراكر للحد من سطح الهجوم.
9. اتباع أفضل الممارسات: التزم بأفضل ممارسات الأمان المعترف بها في الصناعة، مثل استخدام كلمات مرور قوية، وتقييد أذونات النظام، والحفاظ على تحديث البرامج.

من خلال اتباع هذه التدابير الأمنية، يمكنك المساعدة في حماية تثبيت مانتيس بوغ تراكر والحفاظ على سرية وسلامة وتوافر بيانات تتبع الأخطاء الخاصة بك.

خلاصة

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

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

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