Guia Simples: Como Instalar o ORCA com Apptainer

Guia Simples: Como Instalar o ORCA com Apptainer

O que estamos fazendo? Vamos criar uma "caixa virtual" (um contêiner) que tem o programa ORCA e todas as suas dependências já instaladas. Isso garante que ele funcione em qualquer computador, sem bagunçar o seu sistema.

Pré-requisitos

Antes de começar, garanta que você tenha:

  • Apptainer instalado: O programa que constrói e gerencia nossos contêineres.
  • Conta no Fórum ORCA: O ORCA é gratuito, mas exige um cadastro no fórum oficial para fazer o download.
  • O arquivo do ORCA baixado: Após o cadastro, baixe o arquivo para Linux. Ele terá um nome longo, como orca_6_1_0_linux_x86-64_shared_openmpi418_avx2.tar.xz.

Passo a Passo Detalhado

Passo 1: Prepare sua Área de Trabalho

Vamos criar uma pasta específica para este projeto para manter tudo organizado. Abra seu terminal e digite os seguintes comandos, um de cada vez:

mkdir orca-container
cd orca-container

Agora, todo o nosso trabalho será feito dentro desta pasta orca-container.

Passo 2: Crie a "Receita" do Contêiner

Precisamos de um arquivo que ensine o Apptainer a montar nosso contêiner. Este arquivo é a "receita" e o chamaremos de orca.def.

Crie o arquivo com o comando:

nano orca.def

Agora, copie e cole todo o texto abaixo para dentro do editor nano que se abriu:

Bootstrap: docker
From: ubuntu:22.04

%files
    # Esta linha copia o arquivo do ORCA do seu PC para dentro do contêiner.
    orca_6_1_0_linux_x86-64_shared_openmpi418_avx2.tar.xz /opt/orca/

%post
    # Instala ferramentas básicas dentro do contêiner.
    apt-get update && apt-get install -y --no-install-recommends tar xz-utils
    
    # Entra na pasta /opt/orca e extrai o arquivo do programa.
    cd /opt/orca && \
    tar -xf orca_6_1_0_linux_x86-64_shared_openmpi418_avx2.tar.xz && \
    rm orca_6_1_0_linux_x86-64_shared_openmpi418_avx2.tar.xz

%environment
    # "Ensina" o contêiner onde encontrar o executável do ORCA.
    export PATH="/opt/orca/orca_6_1_0_linux_x86-64_shared_openmpi418_avx2:$PATH"
    export LD_LIBRARY_PATH="/opt/orca/orca_6_1_0_linux_x86-64_shared_openmpi418_avx2:$LD_LIBRARY_PATH"

%runscript
    # Mensagem que aparece ao rodar o contêiner.
    echo "Contêiner ORCA pronto para uso!"
    exec "$@"

Depois de colar, salve e feche o arquivo: Pressione Ctrl+X, depois Y, e por fim Enter.

Atenção! Se o nome do seu arquivo do ORCA for diferente, você precisa atualizar o nome no arquivo orca.def exatamente como ele é.

Passo 3: Junte os "Ingredientes"

Mova o arquivo do ORCA que você baixou (geralmente da pasta Downloads) para a pasta orca-container que criamos.

# Ajuste '~/Downloads' se o seu arquivo estiver em outro lugar
mv ~/Downloads/orca_6_1_0_linux_x86-64_shared_openmpi418_avx2.tar.xz .

Para ter certeza de que tudo está no lugar certo, liste os arquivos:

ls -lh

Você deve ver os dois arquivos na lista: orca.def e orca_6_1_0_...tar.xz.

Passo 4: Construa o Contêiner!

Agora que a receita e os ingredientes estão prontos, vamos construir o contêiner. Este comando precisa de permissões de administrador (sudo) e pode demorar alguns minutos.

sudo apptainer build orca.sif orca.def

Ao final, você terá um novo arquivo chamado orca.sif. Esta é a sua "caixa virtual" com o ORCA pronto para usar!

Passo 5: Teste a Instalação

Vamos fazer um cálculo de teste para garantir que tudo funcionou.

1. Crie o arquivo de input para o teste:

nano test.inp

Copie e cole o cálculo simples de uma molécula de água abaixo:

! B3LYP 6-31G*

* xyz 0 1
 O 0.00000 0.00000 0.11730
 H 0.00000 0.75720 -0.46920
 H 0.00000 -0.75720 -0.46920
*

Salve e saia (Ctrl+X, Y, Enter).

2. Execute o cálculo:

apptainer exec orca.sif orca test.inp > test.out

É normal não aparecer nada na tela. O símbolo > envia toda a saída para o arquivo test.out.

3. Verifique o resultado:

A melhor forma de saber se um cálculo do ORCA deu certo é procurar pela mensagem de sucesso no final do arquivo de saída.

grep "ORCA TERMINATED NORMALLY" test.out
Sucesso! Se o terminal mostrar a mensagem ****ORCA TERMINATED NORMALLY****, parabéns! Você instalou e executou o ORCA com sucesso!

Como Usar no Dia a Dia

Seu contêiner orca.sif é portátil. Você pode levá-lo para qualquer computador com Apptainer. Para rodar um novo cálculo, basta seguir o padrão:

apptainer exec orca.sif orca SEU_ARQUIVO_DE_INPUT.inp > SEU_ARQUIVO_DE_SAIDA.out

Comentários

Postar um comentário