.. _rds_cli:

Access via dedicated SSH Gateways
=================================

When connecting via the SSH gateways, directory names for data storage on RDS are visible using two formats, with older projects referencing the PI who purchased it and the name they submitted to the `storage portal <https://selfservice.uis.cam.ac.uk/>`_. While newer projects use the project name and a unique alphanumberic string. For more information on the differences, see the dedicated page :ref:`rds_permissions`.

.. code:: bash

    Recently created projects:
    rds-<Project Name>-<Project ID>
    Example: rds-biobank-sampledata-LWK1fGimSv0

    Older projects:
    rds-<PIs CRSID>-<Project Name>
    Example: rds-wjt27-myproject

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

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

.. code:: bash

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

    OR

    rsync -av -h --progress LOCAL-DATA-DIR <CRSID>@rds.uis.cam.ac.uk:rds-<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).

.. 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>`_