Zum Hauptinhalt springen

Installationsanleitung (Linux)

Diese Anleitung enthält detaillierte Anweisungen zur Bereitstellung und Ausführung des MipMapEngine SDK auf Linux-Systemen.

📋 Systemanforderungen​

Empfohlene Konfiguration​

KomponenteAnforderung
BetriebssystemUbuntu 22.04
CPUIntel/AMD x86_64 8 Kerne oder mehr
Speicher32 GB RAM
GPUNVIDIA GPU (CUDA-Unterstützung)
GrafiktreiberNVIDIA Driver >= 525.60.33
CUDACUDA 12.8
Festplattenspeicher1 TB verfügbarer Speicherplatz

🚀 Installationsschritte​

Schritt 1: Hardware und Treiber überprüfen​

GPU-Informationen überprüfen​

# Überprüfen, ob NVIDIA GPU installiert ist
lspci | grep -i nvidia

# NVIDIA-Treiberversion überprüfen
nvidia-smi

Wenn Treiber nicht installiert sind oder die Version zu niedrig ist:

# Ubuntu NVIDIA-Treiber installieren
sudo apt update
sudo apt install nvidia-driver-***

Schritt 2: Virbox-Treiber installieren​

Virbox ist das Verschlüsselungstool des SDK und muss installiert werden.

# Virbox-Benutzertools installieren
https://lm.virbox.com/tools.html

Schritt 3: Lizenz aktivieren​

# SDK-bereitgestellte license_engine zur Aktivierung verwenden
./license_engine -bind YOUR-LICENSE-KEY

# Lizenzstatus abfragen
./license_engine -enum license_info.json
cat license_info.json

Schritt 4: SDK extrahieren​

# SDK-Paket extrahieren
tar -xzvf MipMapEngine_SDK_Linux_v4.0.tar.gz

# Verzeichnisstruktur anzeigen
cd MipMapEngine_SDK
ls -la
# Sollte enthalten:
# - bin/                # Ausführbare Dateien und dynamische Bibliotheken
# - gdal_data/          # GDAL-Datendateien
# - docs/               # Benutzerhandbuch
# - examples/           # Beispielskripte

Schritt 5: Umgebungsvariablen konfigurieren​

# SDK-Pfad festlegen (durch tatsächlichen Pfad ersetzen)
export MIPMAP_SDK_PATH=/path/to/MipMapEngine_SDK

# Bibliothekspfad festlegen
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH

# Empfehlung: zu ~/.bashrc oder ~/.profile hinzufügen
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

Schritt 6: Abhängigkeiten überprüfen​

# Abhängigkeiten der ausführbaren Datei überprüfen
ldd $MIPMAP_SDK_PATH/lib/reconstruct_full_engine

# Wenn Bibliotheken fehlen, Systempakete installieren
# Ubuntu
apt-get update && apt-get install -y libgl1-mesa-dev libgeos-dev libgomp1 liblcms2-2 libquadmath0 libjbig0 libdeflate0 libopenexr25 libproj22

Schritt 7: Installation überprüfen​

Testkonfigurationsdatei test.json erstellen:

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

Test ausführen:

# SDK-Verzeichnis betreten
cd $MIPMAP_SDK_PATH/bin

# Rekonstruktion ausführen
./reconstruct_full_engine -reconstruct_type 0 -task_json test.json

# Ausgabe überprüfen
ls -la ./test_output/

🔧 Häufige Probleme​

1. Fehlende libmipmap_engine.so​

Fehlermeldung:

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

Lösung:

# Stellen Sie sicher, dass der Bibliothekspfad korrekt ist
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH

2. CUDA-bezogene Fehler​

Fehlermeldung:

CUDA error: no CUDA-capable device is detected

Lösung:

# GPU-Treiber überprüfen
nvidia-smi

# Treiber aktualisieren
sudo apt update
sudo apt upgrade nvidia-driver-*

4. Bibliotheksversions-Konflikte​

Einige Systembibliotheken können mit SDK-bereitgestellten Bibliotheken in Konflikt stehen:

# Konfliktbibliotheken identifizieren
ldd -v $MIPMAP_SDK_PATH/bin/reconstruct_full_engine

# Konfliktbibliotheken temporär entfernen
mv $MIPMAP_SDK_PATH/libconflict.so $MIPMAP_SDK_PATH/libconflict.so.bak

# Systembibliotheken verwenden
# System lädt automatisch aus /usr/lib

Nächste Schritte​

Tipp: Die Linux-Bereitstellung kann aufgrund von Distributions- und Umgebungsunterschieden Anpassungen erfordern. Es wird empfohlen, in einer Testumgebung zu verifizieren, bevor Sie in die Produktion gehen.