Documentação

O acesso ao Cluster Boi Voador está disponível apenas dentro da rede da UFPE, por meio do endereço IP 150.161.151.122. Caso você esteja fora da rede da universidade, a única forma permitida de conexão é via VPN da UFPE. Se ainda não possui acesso à VPN, clique aqui para consultar o procedimento necessário. É importante destacar que o uso do cluster requer conhecimentos básicos de comandos de terminal, pois sua infraestrutura opera sobre o Linux Server 22.04 LTS. Para facilitar sua familiarização, preparamos um guia com os comandos essenciais, que você pode acessar neste link. material com os principáis comandos.

Solicitação de Cadastro

Para utilizar o Cluster Boi Voador, é necessário solicitar um cadastro de usuário. A solicitação deve ser feita por meio do preenchimento do Formulário de Solicitação de Acesso (FSA), onde o pesquisador deve informar:

  • Nome completo, vínculo institucional e e-mail acadêmico.
  • Nome do projeto de pesquisa e descrição resumida.
  • Recursos computacionais esperados (CPU, memória, tempo de execução).
  • Nome e contato do orientador (se aplicável).
  • Após a análise e aprovação do pedido pela equipe do cluster, o usuário receberá suas credenciais de acesso e orientações iniciais.

Política de cadastro

  • O acesso é exclusivo para pesquisas acadêmicas e científicas da UFPE.
  • O uso indevido do cluster pode resultar na suspensão da conta.
  • O usuário deve manter suas credenciais seguras e não compartilhá-las com terceiros.

Como acessar

Acesso via Rede Interna
Usuários conectados à rede da UFPE podem acessar o cluster diretamente pelo endereço IP:

ssh usuario@150.161.151.122

Acesso Remoto via VPN
Para conexões fora da rede da UFPE, é obrigatório utilizar a VPN da UFPE. O processo de solicitação e configuração pode ser encontrado neste link.
Uma vez conectado à VPN, o acesso ao cluster pode ser feito via SSH da mesma forma:

ssh usuario@150.161.151.122

Política de acesso

  • O acesso via SSH deve ser feito apenas de máquinas confiáveis.
  • A VPN é obrigatória para usuários externos à rede UFPE.
  • Qualquer atividade suspeita pode resultar no bloqueio do acesso.

Comandos e Submissão de Jobs

O Cluster Boi Voador opera sobre Linux Server 22.04 LTS e utiliza o Slurm como gerenciador de filas de jobs. Para operar no ambiente do cluster, é fundamental conhecer comandos básicos de terminal e submissão de jobs.

Principais Comandos para Navegação

  • Listar arquivos e diretórios: ls -lh
  • Mudar de diretório: cd nome_do_diretorio
  • Criar diretório: mkdir nome_do_diretorioq
  • Copiar arquivos: cp origem destino
  • Transferir arquivos local ↔ cluster: Do seu computador para o cluster:
scp arquivo.txt usuario@150.161.151.122:/home/usuario/
  • Do cluster para seu computador
scp usuario@150.161.151.122:/home/usuario/arquivo.txt .

Submissão de Jobs no Slurm

Para executar tarefas no cluster, os usuários devem submeter jobs ao Slurm. Um exemplo básico de script para submissão (meu_job.slurm):

#!/bin/bash
#SBATCH --job-name=meu_teste
#SBATCH --output=saida.txt
#SBATCH --error=erro.txt
#SBATCH --time=01:00:00
#SBATCH --mem=4GB
#SBATCH --ntasks=1

echo "Iniciando processamento..."
python meu_script.py
echo "Processo finalizado!"

Submeter o job:

sbatch meu_job.slurm

Verificar status dos jobs:

squeue -u usuario

Cancelar um job em execução:

scancel ID_DO_JOB

Política de Execução de Jobs

  • Usuários devem utilizar os recursos de forma consciente para evitar sobrecarga.
  • Jobs com tempos excessivos podem ser interrompidos pelos administradores.
  • Prioridades de execução são definidas pelo próprio Slurm. E, também, com base em critérios institucionais e técnicos.

Gerenciamento de Pacotes e Bibliotecas

O Boi Voador utiliza o Spack como gerenciador de pacotes, além da instalação, gestão e configuração de software pelos administradores do sistema e principalmente pelos própios usuários. Ele é particularmente útil em ambientes HPC, pois permite que cada usuário instalem e gerenciem diferentes versões e configurações do mesmo software.

Para listar os pacotes instalado utilize o comando

spack find

Para carregar o python versão 3.11.9 utilize

spack load python@3.11.9

Extração de Artefatos, Arquivos e Dados de Grande Volume

Usuários que precisam transferir grandes volumes de dados devem utilizar métodos eficientes para minimizar impacto no desempenho do cluster.

Transferência de Arquivos Grandes

Para arquivos acima de 1GB, recomenda-se o uso do rsync, que permite transferências mais seguras e retomáveis:

Solicitação de Extração Presencial (para volumes acima de 5 TB)

Para arquivos muito grandes, pode ser inviável transferir via rede. Nesse caso, será necessário um agendamento para extração presencial dos dados, utilizando dispositivos de armazenamento externo.

Usuários que necessitam extrair arquivos maiores que 5 TB devem seguir os passos abaixo:

Dados para Solicitação

O usuário deve fornecer as seguintes informações:

  • Nome Completo
  • E-mail e Telefone
  • Nome do Arquivo ou Diretório
  • Caminho Completo no Cluster (path): /caminho/completo/do/arquivo
  • Tamanho Aproximado do Arquivo: _______ TB
  • Tipo de Mídia de Destino
  • Capacidade e Formatação da Mídia ext4 ou NTFS
  • Data e Hora de entregar a mídia