انتقل إلى المحتوى الرئيسي

دليل التثبيت (Linux)

يوفر هذا الدليل تعليمات مفصلة حول كيفية نشر وتشغيل MipMapEngine SDK على أنظمة Linux.

📋 متطلبات النظام​

التكوين الموصى به​

المكونالمتطلبات
نظام التشغيلUbuntu 22.04
المعالجIntel/AMD x86_64 8 أنوية أو أكثر
الذاكرة32 جيجابايت رام
بطاقة الرسوماتNVIDIA GPU (دعم CUDA)
برنامج تشغيل الرسوماتNVIDIA Driver >= 525.60.33
CUDACUDA 12.8
مساحة القرص1 تيرابايت مساحة متاحة

🚀 خطوات التثبيت​

الخطوة 1: فحص الأجهزة وبرامج التشغيل​

فحص معلومات GPU​

# التحقق من تثبيت NVIDIA GPU
lspci | grep -i nvidia

# التحقق من إصدار برنامج تشغيل NVIDIA
nvidia-smi

إذا لم تكن برامج التشغيل مثبتة أو كان الإصدار قديمًا جدًا:

# تثبيت برنامج تشغيل NVIDIA على Ubuntu
sudo apt update
sudo apt install nvidia-driver-***

الخطوة 2: تثبيت برنامج تشغيل Virbox​

Virbox هو أداة التشفير لـ SDK ويجب تثبيته.

# تثبيت أدوات مستخدم Virbox
https://lm.virbox.com/tools.html

الخطوة 3: تفعيل الترخيص​

# استخدم license_engine المقدم من SDK للتفعيل
./license_engine -bind YOUR-LICENSE-KEY

# الاستعلام عن حالة الترخيص
./license_engine -enum license_info.json
cat license_info.json

الخطوة 4: استخراج SDK​

# استخراج حزمة SDK
tar -xzvf MipMapEngine_SDK_Linux_v4.0.tar.gz

# عرض بنية الدليل
cd MipMapEngine_SDK
ls -la
# يجب أن يحتوي على:
# - bin/                # الملفات التنفيذية والمكتبات الديناميكية
# - gdal_data/          # ملفات بيانات GDAL
# - docs/               # دليل المستخدم
# - examples/           # أمثلة البرامج النصية

الخطوة 5: تكوين متغيرات البيئة​

# تعيين مسار SDK (استبدل بالمسار الفعلي)
export MIPMAP_SDK_PATH=/path/to/MipMapEngine_SDK

# تعيين مسار المكتبة
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH

# يُنصح بالإضافة إلى ~/.bashrc أو ~/.profile
echo 'export MIPMAP_SDK_PATH=/path/to/MipMapEngine_SDK' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc

الخطوة 6: فحص التبعيات​

# فحص تبعيات الملف التنفيذي
ldd $MIPMAP_SDK_PATH/lib/reconstruct_full_engine

# إذا كانت المكتبات مفقودة، قم بتثبيت حزم النظام
# Ubuntu
apt-get update && apt-get install -y libgl1-mesa-dev libgeos-dev libgomp1 liblcms2-2 libquadmath0 libjbig0 libdeflate0 libopenexr25 libproj22

الخطوة 7: التحقق من التثبيت​

إنشاء ملف تكوين اختبار test.json:

{
  "working_dir": "./test_output",
  "gdal_folder": "/path/to/MipMapEngine_SDK/gdal_data",
  "input_image_type": 1,
  "resolution_level": 3,
  "coordinate_system": {
    "type": 2,
    "epsg_code": 4326
  },
  "image_meta_data": [
    {
      "id": 1,
      "path": "/path/to/test/image1.jpg"
    },
    {
      "id": 2,
      "path": "/path/to/test/image2.jpg"
    }
  ]
}

تشغيل الاختبار:

# الدخول إلى دليل SDK
cd $MIPMAP_SDK_PATH/bin

# تشغيل إعادة البناء
./reconstruct_full_engine -reconstruct_type 0 -task_json test.json

# فحص المخرجات
ls -la ./test_output/

🔧 المشكلات الشائعة​

1. فقدان libmipmap_engine.so​

رسالة الخطأ:

error while loading shared libraries: libmipmap_engine.so: cannot open shared object file

الحل:

# تأكد من صحة مسار المكتبة
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH

2. أخطاء متعلقة بـ CUDA​

رسالة الخطأ:

CUDA error: no CUDA-capable device is detected

الحل:

# فحص برامج تشغيل GPU
nvidia-smi

# تحديث برامج التشغيل
sudo apt update
sudo apt upgrade nvidia-driver-*

4. تعارضات إصدار المكتبة​

قد تتعارض بعض مكتبات النظام مع المكتبات المقدمة من SDK:

# تحديد المكتبات المتعارضة
ldd -v $MIPMAP_SDK_PATH/bin/reconstruct_full_engine

# إزالة المكتبات المتعارضة مؤقتًا
mv $MIPMAP_SDK_PATH/libconflict.so $MIPMAP_SDK_PATH/libconflict.so.bak

# استخدام مكتبات النظام
# سيقوم النظام بالتحميل تلقائيًا من /usr/lib

الخطوات التالية​

نصيحة: قد يتطلب نشر Linux تعديلات بسبب اختلافات التوزيع والبيئة. يُنصح بالتحقق في بيئة اختبار قبل النشر في الإنتاج.