Pular para o conteúdo principal

Guia de Instalação (Linux)

Este guia fornece instruções detalhadas sobre como implantar e executar o MipMapEngine SDK em sistemas Linux.

📋 Requisitos do Sistema​

Configuração Recomendada​

ComponenteRequisito
Sistema OperacionalUbuntu 22.04
CPUIntel/AMD x86_64 8 núcleos ou mais
Memória32 GB RAM
GPUNVIDIA GPU (suporte CUDA)
Driver GráficoNVIDIA Driver >= 525.60.33
CUDACUDA 12.8
Espaço em Disco1 TB de espaço disponível

🚀 Etapas de Instalação​

Etapa 1: Verificar Hardware e Drivers​

Verificar Informações da GPU​

# Verificar se NVIDIA GPU está instalada
lspci | grep -i nvidia

# Verificar versão do driver NVIDIA
nvidia-smi

Se os drivers não estiverem instalados ou a versão for muito baixa:

# Ubuntu instalar driver NVIDIA
sudo apt update
sudo apt install nvidia-driver-***

Etapa 2: Instalar Driver Virbox​

Virbox é a ferramenta de criptografia do SDK e deve ser instalada.

# Instalar ferramentas de usuário Virbox
https://lm.virbox.com/tools.html

Etapa 3: Ativar Licença​

# Usar license_engine fornecido pelo SDK para ativar
./license_engine -bind YOUR-LICENSE-KEY

# Consultar status da licença
./license_engine -enum license_info.json
cat license_info.json

Etapa 4: Extrair SDK​

# Extrair pacote SDK
tar -xzvf MipMapEngine_SDK_Linux_v4.0.tar.gz

# Visualizar estrutura do diretório
cd MipMapEngine_SDK
ls -la
# Deve conter:
# - bin/                # Executáveis e bibliotecas dinâmicas
# - gdal_data/          # Arquivos de dados GDAL
# - docs/               # Manual do usuário
# - examples/           # Scripts de exemplo

Etapa 5: Configurar Variáveis de Ambiente​

# Definir caminho do SDK (substituir pelo caminho real)
export MIPMAP_SDK_PATH=/path/to/MipMapEngine_SDK

# Definir caminho da biblioteca
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH

# Recomenda-se adicionar a ~/.bashrc ou ~/.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

Etapa 6: Verificar Dependências​

# Verificar dependências do executável
ldd $MIPMAP_SDK_PATH/lib/reconstruct_full_engine

# Se bibliotecas estiverem faltando, instalar pacotes do sistema
# Ubuntu
apt-get update && apt-get install -y libgl1-mesa-dev libgeos-dev libgomp1 liblcms2-2 libquadmath0 libjbig0 libdeflate0 libopenexr25 libproj22

Etapa 7: Verificar Instalação​

Criar arquivo de configuração de teste 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"
    }
  ]
}

Executar teste:

# Entrar no diretório SDK
cd $MIPMAP_SDK_PATH/bin

# Executar reconstrução
./reconstruct_full_engine -reconstruct_type 0 -task_json test.json

# Verificar saída
ls -la ./test_output/

🔧 Problemas Comuns​

1. libmipmap_engine.so ausente​

Mensagem de erro:

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

Solução:

# Garantir que o caminho da biblioteca esteja correto
export LD_LIBRARY_PATH=$MIPMAP_SDK_PATH/bin:$LD_LIBRARY_PATH

2. Erros relacionados ao CUDA​

Mensagem de erro:

CUDA error: no CUDA-capable device is detected

Solução:

# Verificar drivers GPU
nvidia-smi

# Atualizar drivers
sudo apt update
sudo apt upgrade nvidia-driver-*

4. Conflitos de Versão de Biblioteca​

Algumas bibliotecas do sistema podem entrar em conflito com as bibliotecas fornecidas pelo SDK:

# Identificar bibliotecas conflitantes
ldd -v $MIPMAP_SDK_PATH/bin/reconstruct_full_engine

# Remover temporariamente bibliotecas conflitantes
mv $MIPMAP_SDK_PATH/libconflict.so $MIPMAP_SDK_PATH/libconflict.so.bak

# Usar bibliotecas do sistema
# O sistema carregará automaticamente de /usr/lib

Próximas Etapas​

Dica: A implantação no Linux pode exigir ajustes devido a diferenças de distribuição e ambiente. É recomendado verificar em um ambiente de teste antes de implantar em produção.