{"id":361,"date":"2014-06-02T08:00:18","date_gmt":"2014-06-02T08:00:18","guid":{"rendered":"http:\/\/www.rds.itservices.manchester.ac.uk\/?page_id=361"},"modified":"2026-02-11T16:46:09","modified_gmt":"2026-02-11T16:46:09","slug":"the-rds-ssh-service","status":"publish","type":"page","link":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/the-rds-ssh-service\/","title":{"rendered":"The RDS-SSH Service"},"content":{"rendered":"<h2>Overview<\/h2>\n<p>The RDS-SSH server allows you to see <em>both<\/em> types of storage offered by the Research Data Storage (RDS) Service, in one place.<\/p>\n<h3>Two Types of Storage<\/h3>\n<p>The Research Data Storage (RDS) Service offers <a href=\"\/rds\/user-faq\/types-of-available-storage\/\">two different types<\/a> of storage <em>shares<\/em> to researchers:<\/p>\n<ul class=\"gaplist\">\n<li>Most commonly, RDS <em>shares<\/em> are just like an IT Services P-drive, i.e., a MS Windows-style &#8220;SMB&#8221; <em>share<\/em> which is <strong>only<\/strong> accessible on a desktop PC or laptop.<\/li>\n<li>Linux-style &#8220;NFS&#8221; <em>shares<\/em> are also available but are <strong>only<\/strong> accessible on the central compute platforms (CSF, iCSF) for security reasons. If you have been given access to extra storage areas on the CSF, for example, then it will be an &#8220;NFS&#8221; share.\n<p>All users of the CSF \/ iCSF will have a <em>home directory<\/em> on those systems. This is also &#8220;NFS&#8221; storage.<\/li>\n<\/ul>\n<p>Some users require both types of storage and so it would be convenient to be able to see both types of storage <em>in the same place<\/em>. For example, to copy files between the desktop-accessible storage and the CSF\/iCSF-accessible storage. The RDS-SSH service makes this possible!<\/p>\n<p>When requesting a new storage allocation, please indicate which type of storage you need &#8211; SMB (for desktops\/laptops) or NFS (for use on the CSF\/iCSF). We will need this information from you before we can allocate storage. How to decide?<\/p>\n<ul>\n<li>If your know only want the storage for your laptop and, for example, your lab PCs, please request SMB storage.<\/li>\n<li>If you are a CSF\/iCSF user and want extra storage on those HPC platforms, please request NFS storage.<\/li>\n<li>If you use lab PCs and want to share data within your lab and then upload it to the CSF for processing, you might need 50\/50 allocation of SMB <strong>and<\/strong> NFS storage. Please indicate if this might match your situation.<\/li>\n<\/ul>\n<p>We can discuss further with you which type of storage best suits your requirements. But indicating your preference in your storage request will speed up the allocation of your storage.<\/p>\n<h3>What do I use the rds-ssh system for?<\/h3>\n<p>You can log in to the <em>rds-ssh<\/em> server and access your &#8220;CIFS&#8221; (desktop) research data storage and your &#8220;NFS&#8221; (CSF\/iCSF) research data storage at a Linux command-line. Copying files between the two types of storage on the rds-ssh server is fast.<\/p>\n<p>As noted above, the &#8220;NFS&#8221; (CSF\/iCSF) storage is usually only visible on the CSF\/iCSF, and it isn&#8217;t possible to <em>mount<\/em> that storage <em>directly<\/em> on your desktop PC \/ laptop. But there are 3rd-party applications that can be installed on Windows, Mac and Linux desktop\/laptops to mount this storage <em>via<\/em> the rds-ssh server.<\/p>\n<p>The rds-ssh server can also be used to upload \/ download large files to your &#8220;NFS&#8221; (CSF\/iCSF) storage. This keeps large file-transfers away from the CSF login node, which is used by many users for other tasks.<\/p>\n<p><strong>Please note<\/strong>: For off-campus access to the <em>rds-ssh<\/em> server please read our <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/restricted\/offcampus\/\">dedicated guide<\/a> (login required.)<\/p>\n<p>Please read on for how to obtain an account on the <em>rds-ssh server<\/em>, how to log in, and how to access your various storage <em>shares<\/em>.<\/p>\n<h2>Getting an Account and Accessing the Service<\/h2>\n<p>To obtain an account on RDS-SSH, please contact us via our <a href=\"https:\/\/manchester.service-now.com\/esc?id=sc_cat_item&#038;sys_id=ab56f2c01b36861002ea404cd34bcb4e\">Connect Portal Form<\/a> (select &#8220;Provide Access to Existing Storage&#8221; from the drop-down menu in the form and indicate in the text that you require an RDS-SSH account.<\/p>\n<p>Please tell us if you need a particular Research Data Storage <em>share<\/em> (i.e., storage area) made available on the rds-ssh server. Note that all CSF \/ iCSF <em>home<\/em> storage areas are already visible on the rds-ssh server (and when you log in you&#8217;ll be <em>in<\/em> you CSF home directory, if you have a CSF account).<\/p>\n<h3>Login Details<\/h3>\n<div class=\"note\">As of <strong>October 2020<\/strong> when logging in from off-campus you will first need to connect to the University VPN (GlobalProtect).<\/div>\n<p>Various methods of accessing the rds-ssh server are described below. In all cases you should use the following settings:<\/p>\n<ul>\n<li>Hostname: <code>rds-ssh.itservices.manchester.ac.uk<\/code><\/li>\n<li>Username: your central IT Services username<\/li>\n<li>Password: your central IT Services password<\/li>\n<\/ul>\n<h3>The University VPN and GlobalProtect<\/h3>\n<p>When accessing on-campus resources such as the RDS-SSH service from off-campus you must be signed in to the University VPN, which can be accessed using the Global Protect software.<\/p>\n<ul>\n<li>University <em>managed<\/em> laptops already have the GlobalProtect software installed. You can also download it and run it on your home PC\/laptop.<\/li>\n<li>If not already installed, please install the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/ourservices\/popular\/vpn\/\">IT Services VPN Software (GlobalProtect)<\/a> on your home PC\/laptop.<\/li>\n<\/ul>\n<h2>How can you access your files? SSH, SCP, SFTP, SSHFS and rsync-over-SSH<\/h2>\n<p>By connecting to the RDS-SSH service, you can access your RDS shares using various tools and commands, such as SCP, SFTP, SSHFS and\/or rsync-over-SSH and directly at the Linux command-line on the rds-ssh server\/. For details of each, see below.<\/p>\n<h2>What can you use RDS-SSH for?<\/h2>\n<dl>\n<dt>Securely Access NFS and CIFS Shares<\/dt>\n<dd>Securely access both Linux-style NFS <em>shares<\/em> and MS-Windows style CIFS <em>shares<\/em>, from on and off campus, from your MS Windows, Mac OS-X or Linux desktop\/laptop. We organise access to your <em>shares<\/em> on the <em>rds-ssh<\/em> server, you connect to it and can access the files in your <em>shares<\/em>.<\/dd>\n<dt>Copy Files Between Shares Efficiently<\/dt>\n<dd>Copying files from one share to another <em>within the datacentre network<\/em>, i.e., without the need for data to be transferred over the relatively slow campus network. So no more downloading to your desktop from one share only to upload to another (which can be very slow). Log in to the rds-ssh server and copy directly between the two shares, all within the fast network. See the <a href=\"\/rds\/user-faq\/copying-files-between-cifs-and-nfs-shares\/\">FAQ entry<\/a> for information on this particular operation.<\/dd>\n<dt>GUI-based Access to NFS (and CIFS) Shares<\/dt>\n<dd>NFS and CIFS shares can be seen as network drives in Windows Explorer, MacOSX Finder or Linux XFE browser. This allows familiar drag-n-drop file management from your desktop.<\/dd>\n<dt>Large-Scale Data Uploads\/Downloads<\/dt>\n<dd>Uploading or downloading large amounts of data to CSF\/iCSF\/DPSF filesystems \u2014 such large transfers <i>via<\/i> the CSF\/iCSF\/Redqueen\/Hydra login nodes is frowned upon as this slows down access to the login nodes for all users resulting in unhappy colleagues. The rds-ssh server is a dedicated box for exactly this type of transfer.<\/dd>\n<\/dl>\n<h2>Logging in &#8211; Simple SSH or SCP Access<\/h2>\n<p>You can log in to the <em>rds-ssh<\/em> server using an <em>ssh<\/em> app to perform file management commands directly on the server. For example, this allows you to copy files between different <em>shares<\/em> directly on the server using the fast data-centre network.<\/p>\n<p>You can transfer files to and from the <em>rds-ssh<\/em> server using a <em>scp<\/em> app (e.g., WinSCP on Windows or the <code>scp<\/code> command on linux). This is simple way of uploading files to your shares (e.g., to upload data ready for use on the CSF) or to transfer results back from your shares.<\/p>\n<p>Follow the instructions below on how to use these methods of accessing your files.<\/p>\n<div class=\"note\">As of <strong>October 2020<\/strong> when logging in from off-campus you will first need to connect to the University VPN (GlobalProtect). See <a href=\"#The_University_VPN_and_GlobalProtect\">The University VPN and GlobalProtect<\/a> for more information<\/div>\n<h3>Windows (Mobaxterm)<\/h3>\n<p>On Windows you can install MobaXTerm and\/or WinSCP to transfer files to\/from the rds-ssh server. Please follow the <a href=\"http:\/\/ri.itservices.manchester.ac.uk\/userdocs\/windows-users\/mobaxterm\/\"> CSF MobaXTerm instructions<\/a> and simply change any references to:<\/p>\n<pre>csf.itservices.manchester.ac.uk<\/pre>\n<p>to<\/p>\n<pre>rds-ssh.itservices.manchester.ac.uk<\/pre>\n<h4><b>Off-campus<\/b><\/h4>\n<p>If logging in from off-campus you will first need to be connected to the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/vpn\">University VPN (GlobalProtect)<\/a> &#8211; You may already connect to the University VPN in order to access your email.<\/p>\n<ul>\n<li>University <em>managed<\/em> laptops already have the GlobalProtect software installed. You can also download it and run it on your home PC\/laptop.<\/li>\n<li>If not already installed, please install the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/ourservices\/popular\/vpn\/\">IT Services VPN Software (GlobalProtect)<\/a> on your home PC\/laptop.<\/li>\n<li>This facility is provided by IT Services (not Research IT). Requests for help with the VPN and\/or GlobalProtect should be made to <a href=\"http:\/\/www.itservices.manchester.ac.uk\/help\/\">via the Support Portal<\/a>.<\/li>\n<\/ul>\n<h4><b>On-campus<\/b><\/h4>\n<p>If on-campus and not connected to the University VPN you will need to authenticate using your 2FA device.<\/p>\n<p>If you use the Duo mobile app as your 2FA device, Enter &#8216;1&#8217; at the prompt and press Enter. Once the push notification has been received via the Duo mobile app &#8216;Approve&#8217; the request in order to log on.<\/p>\n<pre>$ ssh <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk\r\nPassword:\r\nEnter a passcode or select one of the following options: \r\n\r\n1. Duo Push to +XX XXXX XXX555\r\n\r\nPasscode or option (1-1):1\r\n<\/pre>\n<p><strong>OR<\/strong><\/p>\n<p>If you use a Duo fob as your 2FA device, generate a passcode with the fob, type the passcode at the prompt and press Enter<\/p>\n<pre>$ ssh <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk\r\nPassword:\r\nDuo two-factor login for <em>username<\/em>\r\n\r\nPasscode: 123456\r\n<\/pre>\n<ul>\n<li>You may be asked if you wish to save your password (see image below):<br \/>\n<a href=\"http:\/\/ri.itservices.manchester.ac.uk\/wp-content\/uploads\/mobaxterm-save-pw-red.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-1680\" src=\"http:\/\/ri.itservices.manchester.ac.uk\/wp-content\/uploads\/mobaxterm-save-pw-red.png\" alt=\"Do not save passwords in MobaXTerm\" width=\"486\" height=\"203\" \/><\/a><br \/>\nWe <em>strongly<\/em> recommend you select <strong>No<\/strong> because saving passwords inside applications is a security risk. You tell MobaXterm to never save your passwords by ticking the box labelled &#8216;Do not show this message again&#8217;.<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>After logging on via Mobaxterm, users may be asked to enter an SSH-Browser password (see below), you will have to re-authenticate via 2FA<br \/>\n<a href=\"http:\/\/ri.itservices.manchester.ac.uk\/wp-content\/uploads\/Screenshot-from-2020-07-31-09-53-46.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-1680\" src=\"http:\/\/ri.itservices.manchester.ac.uk\/wp-content\/uploads\/Screenshot-from-2020-07-31-09-53-46.png\" alt=\"Mobaxterm SSH browser\" width=\"486\" height=\"203\" \/><\/a><\/p>\n<ul>\n<li>If you use the Duo mobile app as your 2FA device, Enter &#8216;1&#8217; at the prompt and press Enter. Once the push notification has been received via the Duo mobile app &#8216;Approve&#8217; the request in order to log on.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li>If you use a Duo fob as your 2FA device, generate a passcode with the fob, type the passcode at the prompt and select OK.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>Windows (WinSCP)<\/h3>\n<p>WinSCP is a graphical file transfer program which can be used to drag-n-drop files between your local desktop and the rds-ssh server. Please follow the <a href=\"http:\/\/ri.itservices.manchester.ac.uk\/csf\/getting-started-on-the-csf\/putty\/#Transferring_files_using_WinSCP\">CSF WinSCP instructions<\/a> and simply change any references to:<\/p>\n<pre>csf.itservices.manchester.ac.uk<\/pre>\n<p>to<\/p>\n<pre>rds-ssh.itservices.manchester.ac.uk<\/pre>\n<h4><b>Off-campus<\/b><\/h4>\n<p>If logging in from off-campus you will first need to be connected to the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/vpn\">University VPN (GlobalProtect)<\/a> &#8211; You may already connect to the University VPN in order to access your email.<\/p>\n<ul>\n<li>University <em>managed<\/em> laptops already have the GlobalProtect software installed. You can also download it and run it on your home PC\/laptop.<\/li>\n<li>If not already installed, please install the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/ourservices\/popular\/vpn\/\">IT Services VPN Software (GlobalProtect)<\/a> on your home PC\/laptop.<\/li>\n<li>This facility is provided by IT Services (not Research IT). Requests for help with the VPN and\/or GlobalProtect should be made to <a href=\"http:\/\/www.itservices.manchester.ac.uk\/help\/\">via the Support Portal<\/a>.<\/li>\n<\/ul>\n<h4><b>On-campus<\/b><\/h4>\n<p>If on-campus and not connected to the University VPN you will need to authenticate using your 2FA device.<\/p>\n<p>WinSCP will present a dialogue box similar (see image below)<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-922\" src=\"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-content\/uploads\/winscp-2fa-300x235.png\" alt=\"WinSCP 2FA Dialogue Box\" width=\"300\" height=\"235\" srcset=\"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-content\/uploads\/winscp-2fa-300x235.png 300w, https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-content\/uploads\/winscp-2fa.png 384w\" sizes=\"auto, (max-width: 300px) 100vw, 300px\" \/><br \/>\nIf you use the Duo mobile app as your 2FA device, Enter &#8216;1&#8217; at the prompt and press Enter. Once the push notification has been received via the Duo mobile app &#8216;Approve&#8217; the request in order to log on.<\/p>\n<p>If you use a Duo fob as your 2FA device, generate a passcode with the fob, type the passcode at the prompt and press Enter<\/p>\n<h3>Linux \/ MacOS<\/h3>\n<p>From a linux or MacOS desktop\/laptop SSH, SCP &amp; RSYNC can be done at the command-line. For example, to SSH in to the rds-ssh server use:<\/p>\n<pre>ssh <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk\r\n<\/pre>\n<p>Replace <code><em>username<\/em><\/code> with your central University username. Your password is your central IT Services password. You may then be presented with a 2FA stage.<\/p>\n<h4><b>Off-campus<\/b><\/h4>\n<p>If logging in from off-campus you will first need to be connected to the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/vpn\">University VPN (GlobalProtect)<\/a> &#8211; You may already connect to the University VPN in order to access your email.<\/p>\n<ul>\n<li>University <em>managed<\/em> laptops already have the GlobalProtect software installed. You can also download it and run it on your home PC\/laptop.<\/li>\n<li>If not already installed, please install the <a href=\"http:\/\/www.itservices.manchester.ac.uk\/ourservices\/popular\/vpn\/\">IT Services VPN Software (GlobalProtect)<\/a> on your home PC\/laptop.<\/li>\n<li>This facility is provided by IT Services (not Research IT). Requests for help with the VPN and\/or GlobalProtect should be made to <a href=\"http:\/\/www.itservices.manchester.ac.uk\/help\/\">via the Support Portal<\/a>.<\/li>\n<\/ul>\n<h4><b>On-campus<\/b><\/h4>\n<p>If on-campus and not connected to the University VPN you will need to authenticate using your 2FA device.<\/p>\n<p>If you use the Duo mobile app as your 2FA device, Enter &#8216;1&#8217; at the prompt and press Enter. Once the push notification has been received via the Duo mobile app &#8216;Approve&#8217; the request in order to log on.<\/p>\n<pre>$ ssh <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk\r\nPassword:\r\nEnter a passcode or select one of the following options: \r\n\r\n1. Duo Push to +XX XXXX XXX555\r\n\r\nPasscode or option (1-1):1\r\n<\/pre>\n<p><strong>OR<\/strong><\/p>\n<p>If you use a Duo fob as your 2FA device, generate a passcode with the fob, type the passcode at the prompt and press Enter<\/p>\n<pre>$ ssh <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk\r\nPassword:\r\nDuo two-factor login for <em>username<\/em>\r\n\r\nPasscode: 123456\r\n<\/pre>\n<p>You can then use linux command-line file management tools (such as <code>mv<\/code>, <code>cp<\/code>, <code>rm<\/code>, <code>mkdir<\/code> <code>rmdir<\/code>).<\/p>\n<p>We have also provided the <a href=\"\/rds\/user-faq\/copying-files-between-cifs-and-nfs-shares\/#gui\">graphical file manager, XFE,<\/a> on the rds-ssh server which will allow you to browse your files and to copy files between directories available on RDS-SSH. You cannot transfer files to your desktop with XFE.<\/p>\n<h2>SCP (or RSYNC)<\/h2>\n<p>SCP (or RSYNC) can be used from the linux or MacOS command-line (and MobaXterm command line) to transfer files between your local desktop\/laptop and the rds-ssh server. For example:<\/p>\n<pre># Example: transfer a file to the Isilon storage directory ~\/data\/experiment1 \r\n# (~ is shorthand for your home directory).\r\nscp my-local-file.txt <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk:~\/data\/experiment1\/\r\n\r\n# scp example transfer a file from your Isilon home directory to your local computer\r\n# (notice the . at the end - shorthand for 'current local directory')\r\nscp <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk:~\/run.log .\r\n\r\n# Example: transfer a file to the Isilon storage directory ~\/data\/experiment1 \r\n# (~ is shorthand for your home directory).\r\nrsync -avz my-local-file.txt <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk:~\/data\/experiment1\/\r\n\r\n# rsync example of transferring a file from your Isilon  home directory\r\n# (notice the . at the end - shorthand for 'current local directory')\r\nrsync -avz <em>username<\/em>@rds-ssh.itservices.manchester.ac.uk:~\/run.log .\r\n\r\n<\/pre>\n<h2>SFTP<\/h2>\n<div class=\"note\">\nAs of <strong>October 2020<\/strong> when logging in from off-campus you will first need to connect to the University VPN (GlobalProtect). See <a href=\"#The_University_VPN_and_GlobalProtect\">The University VPN and GlobalProtect<\/a> for more information<\/div>\n<p>SFTP (secure file transfer protocol) is another method of transferring files to and from the <em>rds-ssh<\/em> server. It seems to be less frequently used on systems nowadays as apps such as WinSCP, MobaXTerm and the <code>scp<\/code> command have become more popular. However, if you have an SFTP program (e.g., FileZilla or FireFTP) then <em>rds-ssh<\/em> will accept SFTP connections. Note that non-secure (i.e., ordinary FTP) connections are not possible. You application will ask for the host to connect to &#8211; simply use:<\/p>\n<pre>rds-ssh.itservices.manchester.ac.uk\r\n<\/pre>\n<p>and supply your central IT Services username and password when prompted.<\/p>\n<h2>Mapping your RDS (CIFS or) NFS Share on your Desktop\/Laptop via SSHFS<\/h2>\n<p>&nbsp;<\/p>\n<div class=\"note\">\nAs of <strong>October 2020<\/strong> when logging in from off-campus you will first need to connect to the University VPN (GlobalProtect). See <a href=\"#The_University_VPN_and_GlobalProtect\">The University VPN and GlobalProtect<\/a> for more information<\/div>\n<p>Use this method if you want an RDS share (e.g., your CSF\/iCSF\/Redqueen\/Hydra home directory) to appear as a network drive on your desktop\/laptop (in Windows or Linux\/MacOS).<\/p>\n<p>Note: Don&#8217;t be tempted to mount two different RDS shares (e.g., as drives E: and F:) and copy (or move) files from one to the other. This is slow because the files will be transfered <em>via<\/em> your desktop\/laptop which could involve either the slower campus network, wi-fi (usually quite slow) or home broadband (uploading can be <em>very<\/em> slow). If you want to copy\/move files between different RDS shares please see <a href=\"\/rds\/user-faq\/copying-files-between-cifs-and-nfs-shares\/\">this FAQ entry<\/a> for how to do it using only the fast network in the data-centre.<br \/>\n<a name=\"winsshfs\"><\/a><\/p>\n<h3>Using SSHFS from MS Windows<\/h3>\n<p>This will make your RDS share appear as a network drive in Windows, even if your RDS share is an NFS-share (normally only CIFS-shares can be mapped as network drives in Windows).<\/p>\n<p>Please see <a href=\"http:\/\/ri.itservices.manchester.ac.uk\/userdocs\/file-transfer\/#sshfs_on_windows\">our SSHFS On Windows<\/a> documentation for full details.<\/p>\n<h3>Using SSHFS on Linux<\/h3>\n<ol class=\"gaplist\">\n<li>Install the sshfs package\n<ul>\n<li>On a Debian or Ubuntu host, install the SSHFS client using the <em>apt-get<\/em> package manager:\n<pre>apt-get install sshfs\r\n<\/pre>\n<\/li>\n<li>On Fedora, RedHat, or derivatives, download and install the <code>fuse-sshfs<\/code> RPM from the EPEL repository:\n<pre># First add epel to your repos then do:\r\nyum install fuse-sshfs\r\n<\/pre>\n<\/li>\n<\/ul>\n<\/li>\n<li>Next, <strong>ensure any user of the linux host who wishes to use SSHFS is in the <code>fuse<\/code> group<\/strong>. For example, to add a user to the fuse group (you must have root privileges):\n<pre>usermod -a -G fuse <em>username<\/em>\r\n<\/pre>\n<p>The user should log out of the system and back in for this to take effect.<\/li>\n<\/ol>\n<p>Once SSHFS is installed and configured, as above, make a directory to use as a mount point:<\/p>\n<pre>mkdir my-rds-share\r\n<\/pre>\n<p>Next mount your share<\/p>\n<pre>sshfs  &#x6d;&#x70;&#x71;&#x72;&#x78;&#x79;&#x7a;&#x32;&#x40;&#x72;&#x64;&#115;&#45;&#115;&#115;&#104;&#46;&#105;tservi&#x63;&#x65;&#x73;&#x2e;&#x6d;&#x61;&#x6e;&#x63;&#x68;&#x65;&#x73;&#x74;&#101;&#114;&#46;&#97;&#99;&#46;&#117;k:\/mnt\/iusers01\/support\/mpqrxyz2 my-rds-share\r\n    # ...enter your IT Services password when prompted...\r\n    # ...if on-campus you will need to authenticate via duo ...\r\n<\/pre>\n<p><strong>On campus<\/strong><\/p>\n<pre>Enter a passcode or select one of the following options: \r\n\r\n1. Duo Push to +XX XXXX XXX555\r\n\r\nPasscode or option (1-1):1\r\n<\/pre>\n<p><strong>OR<\/strong><br \/>\nIf you use a Duo fob as your 2FA device, generate a passcode with the fob, type the passcode at the prompt and press Enter<\/p>\n<pre>Duo two-factor login for <em>username<\/em>\r\nPasscode: 123456\r\n<\/pre>\n<p>Once you no longer need your share mounted, unmount it like this:<\/p>\n<pre>fusermount -u my-rds-share\r\n<\/pre>\n<h4 id=\"sshfs-linux\">SSHFS Options on Linux<\/h4>\n<p>These are set within <code>\/etc\/fuse.conf<\/code>:<\/p>\n<dl>\n<dt>user_allow_other<\/dt>\n<dd>If this appears (uncommented), then users may specify the <code>allow_other<\/code> option when mounting a filesystem <em>via<\/em> SSHFS, e.g.,<\/p>\n<pre>sshfs -o allow_other mpqr&#120;&#121;&#122;&#50;&#64;&#114;&#100;&#x73;&#x2d;&#x73;&#x73;&#x68;&#x2e;&#x69;&#x74;&#x73;ervi&#99;&#101;&#115;&#46;&#109;&#97;&#110;&#x63;&#x68;&#x65;&#x73;&#x74;&#x65;&#x72;&#x2e;&#x61;c&#46;uk my-rds-share\r\n<\/pre>\n<p>which means that other users on your Linux host can access may access the filesystem.<\/dd>\n<\/dl>\n<h3>Using SSHFS from MacOS-X<\/h3>\n<p>You will need to download and install macFUSE then SSHFS from <a href=\"https:\/\/macfuse.io\/\">macfuse.io<\/a>. There are further <a href=\"https:\/\/github.com\/macfuse\/macfuse\/wiki\/Getting-Started\">installation notes for macFUSE<\/a> and <a href=\"https:\/\/github.com\/macfuse\/macfuse\/wiki\/File-Systems-%E2%80%90-SSHFS\">installation notes for SSHFS<\/a> on that site&#8217;s Wiki.<\/p>\n<p>Once the software is installed, you can then use SSHFS from a BASH command-line, <a href=\"#sshfs-linux\">exactly as above<\/a>, for Linux, to mount a RDS share on your Mac \u2014 once mounted the volume will appear as an icon on your desktop.<\/p>\n<p>To unmount the volume, simply right-click on the icon and select <em>Eject<\/em>.<\/p>\n<p><a name=\"ukbtools\"><\/a><\/p>\n<h2>UKBioBank \/ EGA Download Tools<\/h2>\n<p>A number of download tools from the UK BioBank and European Genome Archive (EGA) are available on the RDS-SSH servers. These are automatically in your <code>PATH<\/code> upon login &#8211; simply login and run the commands you would normally run. If the command requires a keyfile, ensure you have copied the key file to your home directory. For example:<\/p>\n<pre>ukbfetch -e123456 -d6789_1_0 -ak12345.key\r\n<\/pre>\n<p>The following UKBioBank download tools are installed &#8211; please do not download your own version, it may not work. You can simply run these commands at the prompt once you&#8217;ve logged in to <code>rds-ssh.itservices.manchester.ac.uk<\/code>:<\/p>\n<pre>ukbmd5        # Calculate size and MD5 of a file\r\nukbconv       # Convert unpacked UKB data to other formats\r\nukbunpack     # Unpack (decrypt and decompress) UKB data\r\nukbfetch      # The bulk data download tool\r\nukblink       # Download Returned-datasets and link between Applications\r\nukbgene       # Download approved genetic data. This tool supersedes a tool named gfetch.\r\n<\/pre>\n<p>For more information on how to run these commands, please see <a href=\"http:\/\/biobank.ndph.ox.ac.uk\/showcase\/download.cgi\">http:\/\/biobank.ndph.ox.ac.uk\/showcase\/download.cgi<\/a>. Follow the links for each tool &#8211; this will take you through to a description of the tool where you can also access the user-guide.<\/p>\n<p>Other download tools are also installed. The links below will take you to the instructions for each tool, provided by the authors of the software.<\/p>\n<ul class=\"gaplist\">\n<li><code>egaclient<\/code> (this will automatically load the <code>EgaDemoClient.jar<\/code> file) and <code>egacryptor<\/code> &#8211; <a href=\"https:\/\/ega-archive.org\/using-ega-download-client\">EgaDemoClient download client<\/a> (java downloader and file decrypter)<\/li>\n<li><code>ascp<\/code> (uses the default aspera keyfile) and <code>ascp_noid<\/code> (you should add the <code>-i <em>PRIVATE-KEY-FILE<\/em><\/code> flags) &#8211; <a href=\"https:\/\/www.ebi.ac.uk\/ega\/about\/ftp-aspera\">Aspera download client<\/a> (Linux command-line downloader)<\/li>\n<li><code>basemount<\/code> Illumina BaseSpace command-line tools &#8211; <a href=\"https:\/\/basemount.basespace.illumina.com\/\">Illumina Basemount<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Overview The RDS-SSH server allows you to see both types of storage offered by the Research Data Storage (RDS) Service, in one place. Two Types of Storage The Research Data Storage (RDS) Service offers two different types of storage shares to researchers: Most commonly, RDS shares are just like an IT Services P-drive, i.e., a MS Windows-style &#8220;SMB&#8221; share which is only accessible on a desktop PC or laptop. Linux-style &#8220;NFS&#8221; shares are also available.. <a href=\"https:\/\/ri.itservices.manchester.ac.uk\/rds\/the-rds-ssh-service\/\">Read more &raquo;<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-361","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-json\/wp\/v2\/pages\/361","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-json\/wp\/v2\/comments?post=361"}],"version-history":[{"count":25,"href":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-json\/wp\/v2\/pages\/361\/revisions"}],"predecessor-version":[{"id":1174,"href":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-json\/wp\/v2\/pages\/361\/revisions\/1174"}],"wp:attachment":[{"href":"https:\/\/ri.itservices.manchester.ac.uk\/rds\/wp-json\/wp\/v2\/media?parent=361"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}