.. _rdv_ssh:


Accessing Research DataVault via the SSH Gateways
==================================

Directories for data storage on RDV will be named according to the project name submitted as part of the purchase of space on RDV.

The full project name assigned at the time of purchase is:

.. code:: bash

    Recently created projects:
    rdv-<Project Name>-<Project ID>
    Example: rdv-biobank-sampledata-Q5jpzqn0PlM


All data stored under this project will have the group ownership changed to a group named according to the above full project name.

You are able to transfer data into your project space via the dedicated gateways and suitable client applications implementing the SSH protocol native to Unix/Linux/MacOSX/Windows machines, such as sftp and rsync:

.. code-block:: bash

    sftp <CRSID>@rdv.uis.cam.ac.uk

followed by sftp commands such as ls, cd and put; or

.. code-block:: bash

    rsync -av -h --progress LOCAL-DATA-DIR <CRSID>@rdv.uis.cam.ac.uk:rdv-<Project Name>-<Project ID>/

from a UNIX/Linux/MacOSX machine, or from a Windows machine with Cygwin (the username can generally be omitted if your local username is also your CRSID). 

Alternatively, you may :ref:`use a graphical client <rdv_gui>` to access RDV.

.. note:: You will be prompted for a MultiFactor TOTP code/token as part of logging in, if you haven't already setup this up then the steps required are set out here: `MultiFactor Authentication (MFA)  <https://docs.hpc.cam.ac.uk/hpc/user-guide/mfa.html>`_