.. _inicio_rapido:

=====================
Guia de Início Rápido
=====================

.. contents:: Índice
   :local:
   :depth: 2

|

------------------------
Bem-vinda/o ao GridUnesp
------------------------

Este guia irá ajudar a começar rapidamente no cluster.

1. Criar Conta
==============

1. Acesse: https://ncc.unesp.br/registration/
2. Preencha o formulário de cadastro
3. Aguarde aprovação (geralmente 1-2 dias úteis)
4. Você receberá um e-mail com suas credenciais

.. seealso::
   Detalhes completos: :ref:`cadastro`

2. Primeiro Acesso
==================

**Linux/Mac:**

.. code-block:: bash

   ssh seu_usuario@access.grid.unesp.br

**Windows:**

Use PuTTY ou WinSCP (consulte :ref:`acessando_o_cluster`)

**Verificação de Segurança:**

Na primeira conexão, verifique as impressões digitais das chaves SSH:

.. code-block:: text

   RSA:     SHA256:X3iCb13fWj7u2Tvp/MCCpn0brfSNS5Ie6ehm6lsvPSQ
   ECDSA:   SHA256:WVFokXOLnuH9+2e7xxRU2gp7XJqxwuE6H8bbUMqTCXo
   ED25519: SHA256:+HEvFMmo0EA6ipPMJSaj5+Q6IabebRN+nRD0nxdYrKQ

Digite ``yes`` para confirmar em caso de ter obtido correspondência com alguma dessas chaves.

3. Seu Primeiro Job
===================

**Crie um arquivo de teste:**

.. code-block:: bash

   cd ~
   nano primeiro_job.sh

**Conteúdo do arquivo:**

.. code-block:: bash
   :caption: Script de exemplo (primeiro_job.sh)

   #!/bin/bash
   #SBATCH -J teste
   #SBATCH -n 1
   #SBATCH -t 5:00
   
   # job-nanny requer INPUT e OUTPUT
   export INPUT=""
   export OUTPUT="resultado.txt"
   
   # Comando simples
   job-nanny bash -c "date > resultado.txt; echo 'Olá GridUnesp!' >> resultado.txt"

**Submeta o job:**

.. code-block:: bash

   sbatch primeiro_job.sh

**Verifique o status:**

.. code-block:: bash

   squeue -u $USER

**Veja o resultado:**

.. code-block:: bash

   cat resultado.txt
   cat slurm-*.out

4. Comandos Essenciais
======================

**Gerenciamento de Jobs:**

.. code-block:: bash

   sbatch script.sh          # Submeter job
   squeue -u $USER           # Ver seus jobs
   scancel JOBID             # Cancelar job
   scontrol show job JOBID   # Detalhes do job

**Módulos de Software:**

.. code-block:: bash

   module avail              # Listar módulos disponíveis
   module load nome          # Carregar módulo
   module list               # Ver módulos carregados
   module unload nome        # Descarregar módulo

**Transferência de Arquivos:**

.. code-block:: bash

   # Da sua máquina para GridUnesp
   scp arquivo.dat usuario@access.grid.unesp.br:~/
   
   # Do GridUnesp para sua máquina
   scp usuario@access.grid.unesp.br:~/resultado.dat ./

5. Recursos do Cluster
======================

**Nós com CPU:** 56 nós (node001-node056)

- 28 cores por nó (Intel Xeon E5-2680 v4)
- 128 GB RAM por nó

**Nó com GPU:** 1 nó (gpunode001)

- 48 CPU cores (AMD EPYC 9224)
- 4 NVIDIA L40S GPUs (48 GB cada)

**Storage:**

- ``/home/`` - Seu dirétorio home
- ``/tmp/`` - Rápido storage local (por nó)
- ``/store/`` - Espaço para grandes arquivos e compartilhado entre vários nós

**Network:**

- 40 Gbps entre os nós

6. Próximos Passos
==================

* :ref:`manual_do_usuario` - Manual completo
* :ref:`boas_praticas` - Melhores práticas
* :ref:`perguntas_frequentes` - Perguntas frequentes
* :ref:`solucao_problemas` - Solução de problemas

.. important::
   **NUNCA:**

   - Execute tarefas pesadas no servidor de acesso
   - Esqueça de definir ENTRADA e SAÍDA no job-nanny
   - Armazene dados somente no GridUnesp (não há sistema de backup!)
   
   **SEMPRE:**
   
   - Use o job-nanny para todas as tarefas
   - Mantenha backups de dados importantes externamente
   - Carregue os módulos necessários em seu script
   - Monitore sua fila de tarefas: ``squeue -u $USER``

**Precisa de ajuda?**

* Email: support.ncc@unesp.br 📧
* Inclua: ID do job, localização do script, mensagens de erro

**Boa sorte!** 🚀