Usando Módulos de Ambiente em Clusters de HPC¶

O Environment Modules (Módulos de Ambiente) é um pacote que permite modificar dinamicamente o ambiente de um usuário Linux por meio do uso de modulefiles. Esses arquivos contêm informações necessárias para configurar o ambiente, tornando pacotes de software acessíveis sob demanda. Eles são especialmente úteis para gerenciar diferentes versões de pacotes de software.

Este guia ajudará você a entender os conceitos básicos do uso dos Módulos de Ambiente em nossos clusters, incluindo como carregar, descarregar e pesquisar por módulos.

Introdução aos Módulos de Ambiente¶

Em sistemas de HPC como o OGBON, os Módulos de Ambiente são usados para modificar as variáveis de ambiente do Linux, como PATH, MANPATH e LD_LIBRARY_PATH. Essas variáveis ajudam o sistema a localizar e configurar pacotes de software.

Módulos podem ser carregados e descarregados dinamicamente para gerenciar várias versões de pacotes de software ou associá-los a versões específicas de compiladores ou bibliotecas.

Comandos Básicos¶

Verificar Módulos Disponíveis¶

Para ver uma lista de módulos disponíveis, execute:

module avail

Carregar um Módulo¶

Para carregar um módulo, use o seguinte comando:

module load <nome do módulo>

Descarregar um Módulo¶

Para descarregar um módulo, digite:

module unload <nome do módulo>

Descarregar Todos os Módulos¶

Para descarregar todos os módulos de uma vez, execute:

module purge

Listar Módulos Carregados¶

Para ver uma lista dos módulos atualmente carregados, use:

module list

Trabalhando com Módulos¶

Nesta seção, você aprenderá como encontrar, carregar e descarregar módulos.

Encontrar Módulos¶

Listar Todos os Módulos Disponíveis¶

Para listar todos os módulos disponíveis, execute:

module avail

Pesquisar por Módulos¶

Para pesquisar módulos ou extensões específicas, use avail. Por exemplo, para encontrar e listar todos os módulos da versão 3 do Python, execute:

module avail python/3

Obter Ajuda sobre um Módulo¶

Para acessar uma breve descrição de um módulo, digite:

module help <nome do módulo>/versão

Se você não conseguir encontrar um pacote de software necessário, entre em contato conosco com uma solicitação de instalação de software ou consulte nossos guias de instalação para instalá-lo por conta própria.

Carregar e Descarregar Módulos¶

Carregar Módulos¶

Para carregar um módulo e suas dependências, use o comando module load. Para batch jobs, adicione o(s) comando(s) module load ao seu script de envio.

Por exemplo, para carregar as versões 3.22.1 do CMake e 11.2.0 do GCC, execute:

module load cmake/3.22.1 gcc/11.2.0

Para ver os módulos carregados, execute module list.

Descarregar Módulos¶

Para descarregar um módulo específico que você carregou anteriormente:

module unload gcc/11.2.0

Ou descarregue todos os módulos de uma vez com:

module purge

Leitura Adicional¶

Para obter mais informações sobre o uso dos Módulos de Ambiente, consulte a documentação no cluster executando:

man module

Melhores Práticas e Solução de Problemas¶

Aqui estão algumas melhores práticas e dicas de solução de problemas para ajudá-lo a trabalhar efetivamente com os Módulos de Ambiente:

• Sempre use a versão apropriada de um módulo, pois diferentes versões podem ter dependências e recursos diferentes.

• Certifique-se de descarregar módulos conflitantes antes de carregar novos. Por exemplo, descarregue uma versão mais antiga de um compilador antes de carregar uma versão mais recente.

• Se encontrar problemas ao carregar um módulo, verifique a documentação de ajuda do módulo usando module help <nome do módulo> para obter orientações sobre o uso adequado.

• Em caso de erros ou conflitos, descarregue todos os módulos usando module purge e comece novamente carregando os módulos necessários na ordem correta.