Ana içeriğe geç

Kurulum Kılavuzu (Linux)

Bu kılavuz, Linux sistemlerinde MipMapEngine SDK'nın nasıl dağıtılacağı ve çalıştırılacağı hakkında ayrıntılı talimatlar sağlar.

📋 Sistem Gereksinimleri​

Önerilen Yapılandırma​

BileşenGereksinim
İşletim SistemiUbuntu 22.04
CPUIntel/AMD x86_64 8 çekirdek veya daha fazla
Bellek32 GB RAM
GPUNVIDIA GPU (CUDA desteği)
Grafik SürücüsüNVIDIA Driver >= 525.60.33
CUDACUDA 12.8
Disk Alanı1 TB kullanılabilir alan

🚀 Kurulum Adımları​

Adım 1: Donanım ve Sürücüleri Kontrol Edin​

GPU Bilgilerini Kontrol Edin​

# NVIDIA GPU'nun kurulu olup olmadığını kontrol edin
lspci | grep -i nvidia

# NVIDIA sürücü sürümünü kontrol edin
nvidia-smi

Sürücüler kurulu değilse veya sürüm çok düşükse:

# Ubuntu NVIDIA sürücüsünü kurun
sudo apt update
sudo apt install nvidia-driver-***

Adım 2: Virbox Sürücüsünü Kurun​

Virbox, SDK'nın şifreleme aracıdır ve kurulması gerekir.

# Virbox kullanıcı araçlarını kurun
https://lm.virbox.com/tools.html

Adım 3: Lisansı Etkinleştirin​

# Etkinleştirmek için SDK tarafından sağlanan license_engine'i kullanın
./license_engine -bind YOUR-LICENSE-KEY

# Lisans durumunu sorgulayın
./license_engine -enum license_info.json
cat license_info.json

Adım 4: SDK'yı Çıkarın​

# SDK paketini çıkarın
tar -xzvf MipMapEngine_SDK_Linux_v4.0.tar.gz

# Dizin yapısını görüntüleyin
cd MipMapEngine_SDK
ls -la
# Şunları içermelidir:
# - bin/                # Yürütülebilir dosyalar ve dinamik kütüphaneler
# - gdal_data/          # GDAL veri dosyaları
# - docs/               # Kullanıcı kılavuzu
# - examples/           # Örnek betikler

Adım 5: Ortam Değişkenlerini Yapılandırın​

# SDK yolunu ayarlayın (gerçek yol ile değiştirin)
export MIPMAP_SDK_PATH=/path/to/MipMapEngine_SDK

# Kütüphane yolunu ayarlayın
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH

# ~/.bashrc veya ~/.profile'a eklenmesi önerilir
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

Adım 6: Bağımlılıkları Kontrol Edin​

# Yürütülebilir dosya bağımlılıklarını kontrol edin
ldd $MIPMAP_SDK_PATH/lib/reconstruct_full_engine

# Kütüphaneler eksikse, sistem paketlerini kurun
# Ubuntu
apt-get update && apt-get install -y libgl1-mesa-dev libgeos-dev libgomp1 liblcms2-2 libquadmath0 libjbig0 libdeflate0 libopenexr25 libproj22

Adım 7: Kurulumu Doğrulayın​

Test yapılandırma dosyası test.json oluşturun:

{
  "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"
    }
  ]
}

Testi çalıştırın:

# SDK dizinine girin
cd $MIPMAP_SDK_PATH/bin

# Yeniden yapılandırmayı çalıştırın
./reconstruct_full_engine -reconstruct_type 0 -task_json test.json

# Çıktıyı kontrol edin
ls -la ./test_output/

🔧 Yaygın Sorunlar​

1. Eksik libmipmap_engine.so​

Hata mesajı:

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

Çözüm:

# Kütüphane yolunun doğru olduğundan emin olun
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH

2. CUDA ile İlgili Hatalar​

Hata mesajı:

CUDA error: no CUDA-capable device is detected

Çözüm:

# GPU sürücülerini kontrol edin
nvidia-smi

# Sürücüleri güncelleyin
sudo apt update
sudo apt upgrade nvidia-driver-*

4. Kütüphane Sürüm Çakışmaları​

Bazı sistem kütüphaneleri SDK tarafından sağlanan kütüphanelerle çakışabilir:

# Çakışan kütüphaneleri tanımlayın
ldd -v $MIPMAP_SDK_PATH/bin/reconstruct_full_engine

# Çakışan kütüphaneleri geçici olarak kaldırın
mv $MIPMAP_SDK_PATH/libconflict.so $MIPMAP_SDK_PATH/libconflict.so.bak

# Sistem kütüphanelerini kullanın
# Sistem otomatik olarak /usr/lib'den yükleyecektir

Sonraki Adımlar​

İpucu: Linux dağıtımı, dağıtım ve ortam farklılıkları nedeniyle ayarlamalar gerektirebilir. Üretime dağıtmadan önce test ortamında doğrulamanız önerilir.