.. _boas_praticas:

=============
Boas Práticas
=============

.. contents:: Nesta seção:
   :local:
   :depth: 2

Esta seção reúne recomendações essenciais para o uso responsável e eficiente dos recursos do GridUnesp. Seguir estas práticas contribui para o bom funcionamento do cluster para todos os usuários.

Compartilhamento de Acesso
==========================

.. warning::
   **Nunca compartilhe sua senha com terceiros.**

Por medida de segurança, sua conta é pessoal e intransferível. Membros do mesmo projeto, orientadores ou até mesmo a equipe do GridUnesp **não devem** ter acesso à sua senha.

**Riscos do compartilhamento:**

- Exclusão acidental de arquivos (não é possível desfazer)
- Modificação não autorizada de dados
- Submissão de jobs em seu nome
- Comprometimento da segurança do cluster

**Como colaborar com segurança:**

Caso precise compartilhar arquivos com outros usuários, utilize permissões de acesso:

.. code-block:: bash
   :caption: Ajustando permissões para colaboração

   # Dar permissão de leitura para o grupo
   chmod g+r arquivo_compartilhado.dat

   # Dar permissão de leitura/execução para diretório
   chmod g+rx diretorio_compartilhado/

   # Remover permissões para outros (padrão seguro)
   chmod o-rwx diretorio_compartilhado/

.. tip::
   Para colaboração em projetos, consulte seu coordenador sobre a criação de diretórios de grupo com permissões adequadas.

Solicitação de Suporte
======================

Antes de solicitar suporte, consulte a seção :ref:`perguntas_frequentes` - a maioria das dúvidas já foi respondida.

**Ao enviar e-mail para ``support.ncc@unesp.br``, inclua:**

1. **Descrição clara do problema**
2. **Localização do script de submissão** (caminho completo: ``/home/$USER/caminho/para/arquivo/script.sh``)
3. **Localização dos arquivos de input** (se aplicável)
4. **Arquivos de log** (slurm-JOBID.out)
5. **Comando usado para submeter o job**
6. **Número(s) do(s) job(s) em questão** (se houver)

.. important::
   Quanto mais informações você fornecer, mais rápida e precisa será a resposta da equipe de suporte.

.. _manutencao_dos_dados:

Manutenção dos Dados
====================

Política de Backup
------------------

.. danger::
   **O GridUnesp NÃO possui sistema de backup automático.**

Em caso de falha irrecuperável do sistema de armazenamento, **todos os dados serão perdidos sem possibilidade de recuperação**.

**Recomendações:**

1. Transfira resultados importantes para seu computador local
2. Mantenha cópias em pelo menos dois locais diferentes
3. Não utilize o cluster como única cópia de dados críticos
4. Mantenha no cluster apenas arquivos necessários para processamento

Gerenciamento de Espaço em Disco
--------------------------------

Como os recursos são compartilhados, o acúmulo desnecessário de dados prejudica todos os usuários.

**Verifique seu uso de espaço:**

.. code-block:: bash
   :caption: Analisando ocupação em /home/

   du -scm $HOME/$USER/* | sort -nr | head -20

**Limpeza em /home/:**

.. code-block:: bash
   :caption: Removendo arquivos desnecessários

   # Remover arquivos específicos
   rm slurm-*.out programa_obsoleto

   # Remover diretórios (cuidado!)
   rm -rf resultados_antigos/ testes_temporarios/

.. attention::
   **Partição /store/**

   Jobs que utilizam múltiplos nós ou têm as variáveis ``SHARED_FS="true"`` ou ``LARGE_FILES="true"`` escrevem em ``/store/``. Esta partição também requer limpeza periódica:

   .. code-block:: bash
      :caption: Verificando espaço em /store/

      du -scm /store/$USER/* | sort -nr | head -20

      # Remover diretórios de jobs antigos
      rm -rf /store/$USER/2835861 /store/$USER/2835862

      # OU remover tudo (apenas se tiver certeza!)
      # rm -rf /store/$USER/*

.. danger::
   Quando o armazenamento atinge 100% de uso, **todo o sistema fica comprometido**, afetando jobs de todos os usuários.

Processamento no Servidor Access
================================

.. important::
   **O servidor access.grid.unesp.br NÃO deve ser usado para processamento de jobs.**

Funções do servidor **access**:

- Ponto de acesso à sua conta
- Preparação de scripts e arquivos
- Submissão de jobs com ``sbatch``
- Tarefas leves de pré/pós-processamento (rápidas e com pouca memória)

**Exceções permitidas:**

- Edição de arquivos pequenos
- Compilações rápidas
- Organização de diretórios
- Testes muito breves

.. danger::
   A equipe do GridUnesp monitora o uso do servidor **access**. Processamentos pesados serão **imediatamente cancelados** para não prejudicar os demais usuários.

Resumo de Boas Práticas
=======================

✅ **Sempre:**

- Use ``sbatch`` para submeter jobs aos nós de processamento
- Mantenha backups de dados importantes
- Limpe arquivos temporários regularmente
- Inclua informações completas ao solicitar suporte

❌ **Nunca:**

- Compartilhe sua senha
- Processe jobs no servidor **access**
- Utilize o cluster como único local de armazenamento
- Acumule dados desnecessários

.. seealso::

   - :ref:`informacao_sobre_o_storage` - Detalhes sobre partições
   - :ref:`processando_simulacoes` - Como submeter jobs corretamente
   - :ref:`parametros_do_job_nanny` - Configurações para /store/ e /tmp/