تثبيت وتشغيل MongoDB

مقدمة: لماذا يُعد تثبيت MongoDB أمرًا مهمًا؟

يمرّ كل مطوّر Node.js يعمل مع Mongoose بلحظة محبِطة في النهاية: قاعدة البيانات لا تتصل، ويظهر خطأ مثل mongod: command not found.

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

1. ما هي MongoDB ولماذا تحتاج إليها؟

MongoDB هي قاعدة بيانات NoSQL شهيرة يستخدمها ملايين المطورين والشركات لبناء تطبيقات تحتاج إلى قابلية التوسّع، والسرعة، والمرونة. أدوات مثل Mongoose تسهّل العمل مع MongoDB في Node.js من خلال نمذجة البيانات باستخدام المخططات (Schemas).

ولكن قبل أن يتمكن تطبيقك من تخزين البيانات أو استرجاعها، يجب تثبيت MongoDB وتشغيلها على نظامك — أو استضافتها عن بُعد عبر مزوّد سحابي مثل MongoDB Atlas.

2. تثبيت MongoDB على Linux (Ubuntu / Debian)

يمكن لمستخدمي Linux تثبيت MongoDB بسهولة باستخدام مدير الحزم APT. اتبع الخطوات التالية:

# الخطوة 1: استيراد المفتاح العام
wget -qO - https://www.mongodb.org/static/pgp/server-7.0.asc | sudo apt-key add -

# الخطوة 2: إضافة المستودع
echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

# الخطوة 3: التحديث وتثبيت MongoDB
sudo apt update
sudo apt install -y mongodb-org

# الخطوة 4: تشغيل خدمة MongoDB
sudo systemctl start mongod
sudo systemctl enable mongod
        

بعد التثبيت، تأكد من أن MongoDB تعمل بشكل صحيح:

mongod --version

إذا ظهر رقم الإصدار، فهذا يعني أن MongoDB تم تثبيتها بنجاح.

3. تثبيت MongoDB على macOS

أسهل طريقة لتثبيت MongoDB على macOS هي باستخدام Homebrew:

# الخطوة 1: إضافة مستودع MongoDB إلى Homebrew
brew tap mongodb/brew

# الخطوة 2: تثبيت نسخة MongoDB Community
brew install mongodb-community@7.0

# الخطوة 3: تشغيل MongoDB
brew services start mongodb/brew/mongodb-community
        

بعد ذلك، تأكد من التثبيت عبر:

mongod --version

إذا ظهر رقم الإصدار، فهذا يعني أن MongoDB مُعدة بشكل صحيح. ويمكنك أيضًا تشغيلها يدويًا باستخدام:

mongod --config /usr/local/etc/mongod.conf

4. تثبيت MongoDB على Windows

على نظام Windows، توفر MongoDB ملف تثبيت بصيغة MSI لسهولة الإعداد:

1. قم بتحميل MongoDB Community Edition بصيغة MSI من الموقع الرسمي لـ MongoDB.
2. شغّل ملف التثبيت واختر خيار التثبيت الكامل (Complete).
3. تأكد من تفعيل خيار “Install MongoDB as a Service”.
4. بعد الانتهاء، شغّل MongoDB من نافذة الخدمات أو باستخدام PowerShell:

net start MongoDB

وللتأكد من أنها تعمل، افتح موجه الأوامر ونفّذ:

mongod --version

5. حل مشكلة “mongod: command not found”

إذا ظهر هذا الخطأ بعد التثبيت، فهذا يعني أن النظام لا يستطيع العثور على MongoDB ضمن متغير PATH. يمكن حل هذه المشكلة بإضافة مسار ملفات MongoDB التنفيذية يدويًا:

• على Linux: أضف السطر التالي إلى ~/.bashrc أو ~/.zshrc:

  export PATH=/usr/bin/mongodb/bin:$PATH

• على macOS (Homebrew):

  export PATH="/usr/local/opt/mongodb-community@7.0/bin:$PATH"

• على Windows: أضف مجلد bin الخاص بـ MongoDB إلى متغيرات البيئة (System Environment Variables).

أعد تشغيل الطرفية ثم اختبر الأمر مرة أخرى:

mongod --version

إذا نجح الأمر، فهذا يعني أن PATH تم إعداده بشكل صحيح.

6. تشغيل وإيقاف MongoDB

بعد التثبيت، يجب التأكد من تشغيل MongoDB عند بدء تشغيل النظام. إليك كيفية إدارتها:

• Linux: sudo systemctl start mongod أو sudo systemctl stop mongod
• macOS: brew services start mongodb-community
• Windows: net start MongoDB أو net stop MongoDB

للتحقق من أن MongoDB تعمل، استخدم:

mongo

إذا فُتح Mongo Shell بنجاح، فهذا يعني أن قاعدة البيانات تعمل بشكل سليم.

7. سيناريوهات واقعية للمطورين والأعمال

يواجه العديد من المطورين والشركات الناشئة مشاكل في إعداد MongoDB تؤدي إلى تعطيل الجداول الزمنية للمشاريع. على سبيل المثال:

• الحالة 1: فريق SaaS جديد كان يرى أخطاء “Mongoose connection timed out” باستمرار لأن MongoDB لم تكن تعمل. فحص سريع باستخدام systemctl status mongod كشف أنها توقفت بعد إعادة التشغيل.
• الحالة 2: مستقل يعمل عن بُعد وجد أن الأمر mongod غير معروف. الحل كان بسيطًا: إضافة مسار MongoDB إلى إعدادات الـ PATH.
• الحالة 3: مشروع تجارة إلكترونية يعمل محليًا داخل Docker لكنه فشل على الخادم، لأن المطور لم يقم بربط منفذ MongoDB بشكل صحيح. تثبيت MongoDB وتشغيلها يدويًا حل المشكلة.

تُظهر هذه الأمثلة كيف أن إتقان تثبيت MongoDB وإدارة تشغيلها يمكن أن يمنع تأخيرات مكلفة في بيئات الإنتاج.

8. قائمة سريعة لاستكشاف الأخطاء

• نفّذ mongod --version للتأكد من تثبيت MongoDB.
• إذا لم يتم العثور عليه، أضف مجلد bin الخاص بـ MongoDB إلى متغير PATH.
• تأكد من أن خدمة MongoDB تعمل باستخدام systemctl status mongod أو brew services list.
• راجع سجلات الأخطاء في /var/log/mongodb/mongod.log.
• تحقق من أن الجدار الناري لا يحظر المنفذ الافتراضي 27017.