.. _acessando_o_cluster:

Acessando o Cluster
===================

O GridUnesp roda o sistema operacional `Linux <https://www.linux.org/threads/introduction-to-linux.4105/>`_, permitindo assim que seus usuários acessem remotamente por meio de uma conexão segura `SSH <https://rockcontent.com/br/blog/ssh/>`_. Esta conexão segura pode ser criada por meio de uma janela terminal de um sistema baseado em Linux/Unix (ex: `Macintosh OSX <https://pt.wikipedia.org/wiki/MacOS>`_, `Ubuntu <https://ubuntu.com/>`_, `FreeBSD <https://www.freebsd.org/>`_ etc.).

Entretanto, para acesso via Microsfot Windows é necessário a instalação de um software adicional para estabelecer a conexão segura.

.. attention::
   O SERVIDOR **access2.grid.unesp.br** NÃO DEVE SER USADO PARA EXECUTAR SIMULAÇÕES. ELE SERVE APENAS COMO LOCAL DE ACESSO À CONTA DO USUÁRIO PARA PREPARAR O AMBIENTE E ENVIAR AS SIMULAÇÕES PARA SEREM EXECUTADAS NOS NÓS DE PROCESSAMENTO.


Acessando de uma máquina com Linux/Unix/MacOS
---------------------------------------------

Para acessar o cluster do GridUnesp, caso tenha um computador baseada em Unix (Linux, Mac), basta abrir um terminal e digitar

.. code-block:: bash

   $ ssh username@access.grid.unesp.br

em que **username** é o login de usuário que foi escolhido no processo de cadastro em :ref:`cadastro_de_novos_usuarios`.

.. warning::
   Alguns usuários mais antigos talvez ainda tentem fazer login pelo servidor

      **access.grid.unesp.br**

   Contudo, este servidor foi desligago permanentemente. Agora, o acesso ao cluster é através do servidor

      **access2.grid.unesp.br**


Accessando de uma máquina com Microsoft Windows
-----------------------------------------------

Já no caso em que o computador do usuário possua sistema Windows, o acesso ao GridUnesp com conexão segura *SSH* pode ser feito através de softwares como o `PuTTY <https://www.chiark.greenend.org.uk/~sgtatham/putty/>`_ ou o `WinSCP <https://winscp.net/eng/download.php>`_. Após a instalação, o usuário deverá realizar a configuração de acesso.


Configuração do PuTTY
+++++++++++++++++++++

Abaixo está uma imagem do programa PuTTY. O usuário deve informar, ao menos

* **Host Name**: access2.grid.unesp.br
* **Port**: 22

.. image:: Figures/putty.png

Daí, ao clicar em *Open*, vai aparecer um terminal solicitando para informar o login e a senha de usuário.

.. _configuracao_do_winscp:

Configuração do WinSCP
++++++++++++++++++++++

Abaixo está uma imagem do programa WinSCP. O usuário deve informar, ao menos

* **File protocol**: SCP
* **Host name**: access2.grid.unesp.br
* **Port**: 22
* **User name**: aqui informar o login de accesso ao GridUnesp
* **Password**: informar a senha de acesso ao GridUnesp

.. image:: Figures/winscp.png

Ao clicar em login, deverá abrir uma janela em que, de um lado, aparecerão as pastas e arquivos do seu computador pessoal e, do outro, seu ambiente no `/home/` do GridUnesp. É possível transferir arquivos de um lado para o outro simplesmente clicando e arrastando.

No alto da janela deverá aparecer um ícone quadrado preto que é o terminal. Clicando nele, o terminal deverá ser aberto pare que o usuário possa dar os comandos necessários para processar as simulações.


.. _confirmacao_de_seguranca:

Confirmação de segurança
------------------------

Ao acessar o servidor **access2.grid.unesp.br** pela primeira vez, seu client de conexão segura irá perguntar se você o reconhece como uma máquina confiável. Você deve verificar se a chave é igual à exibida abaixo e confirmar, digitando **yes**:

.. parsed-literal::
   The authenticity of host 'access2.grid.unesp.br (200.145.46.48)' can't be established.
   RSA key fingerprint is SHA256:+HEvFMmo0EA6ipPMJSaj5+Q6IabebRN+nRD0nxdYrKQ.
   Are you sure you want to continue connecting (yes/no)?

Caso o usuário esteja há algum tempo sem fazer login no cluster do GridUnesp, poderá aparecer uma mensagem de erro semelhante a:

.. parsed-literal::
   @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
   @       WARNING: POSSIBLE DNS SPOOFING DETECTED!          @
   @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
   The ECDSA host key for access2.grid.unesp.br has changed,
   and the key for the corresponding IP address 200.145.46.48
   is unknown. This could either mean that
   DNS SPOOFING is happening or the IP address for the host
   and its host key have changed at the same time.
   @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
   @    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
   @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
   IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
   Someone could be eavesdropping on you right now (man-in-the-middle attack)!
   It is also possible that a host key has just been changed.
   The fingerprint for the ECDSA key sent by the remote host is
   SHA256:+HEvFMmo0EA6ipPMJSaj5+Q6IabebRN+nRD0nxdYrKQ.
   Please contact your system administrator.
   Add correct host key in /home/username/.ssh/known_hosts to get rid of this message.
   Offending ECDSA key in /home/username/.ssh/known_hosts:13
     remove with:
     ssh-keygen -f "/home/username/.ssh/known_hosts" -R "access2.grid.unesp.br"
   ECDSA host key for access2.grid.unesp.br has changed and you have requested strict checking.
   Host key verification failed.

Se o usuário está usando um computador Linux, bastar dar o seguinte comando:

.. code-block:: bash

   $ ssh-keygen -f "/home/username/.ssh/known_hosts" -R "access2.grid.unesp.br"

Estando o usuário utilizando um computador Mac, o comando é:

.. code-block:: bash

   $ ssh-keygen -f "/Users/username/.ssh/known_hosts" -R "access2.grid.unesp.br"

.. warning::
   Note aque, aqui, **username** é o login do computador pessoal do usuário, e não o login de acesso ao GridUnesp.

Finalmente, basta tentar acessar o cluster novamente, mas agora com o login do GridUnesp.