Window GUI tools
GUI Tools
We recommend using the free MobaXterm application for file-transfers to/from the CSF and also for your day-to-day command-line access to it. Hence this tool provides everything you need to use the CSF! You may also want to use the free WinSCP tool which is an easy-to-use file-transfer app.
MobaXterm File Transfers
For help with downloading, installing and logging in to the CSF using MobaXterm please see our logging in guide.
Once you have logged in your can drag-n-drop files to your CSF home-directory using the file-browser in the MobaXterm window. By default it will show the contents of your CSF home directory. Alternatively you can use the upload and download buttons. See the image below.
Accessing your Scratch area in MobaXterm
The MobaXterm file-browser will show a list of sub-directories (folders) in your CSF home area. You might expect your scratch folder to appear here. However, MobaXterm displays this using a file icon further down the list (the list is sorted alphabetically). Hence the scratch area is accessible by scrolling down the list and clicking on the scratch file icon.
Alternatively, type the full path to your scratch area in to the file-browser location, using:
/scratch/username
where username is your CSF username.
The image below shows these two methods of accessing your scratch area.
Command-line file transfers
If you are familiar with the Linux / Mac command-line tools such as rsync, you can use these in MobaXterm to transfer files. Simply start a “Local Terminal” in MobaXterm (to give you the familiar black window) but do not log in to the CSF. Instead, you remain on your local machine.
You can then navigate using the command-line to a local folder. For example:
# Navigate to a folder on your laptop's C drive in the MobaXterm local session cd /drives/C/work/data/
The rsync command can be used to transfer files. Please note: you CANNOT use the Linux short-hand character ~ to mean your “CSF home directory”. This is because rsync in MobaXterm incorrect expands this to be your local MobaXterm home directory – i.e. it expands the ~ before you are logged in to the CSF.
rsync -av *.dat username@csf3.itservices.manchester.ac.uk:/scratch/username/data/
# #
# # Replace username with your own.
# # DO NOT use the ~/scratch shortcut.
# # It fails in MobaXterm. Use:
# # /scratch/username/
#
# Replace username with your own
The above example will transfer all files ending in .dat from your local C:\work\data\ folder to a folder named data in your CSF scratch area.
WinSCP
The free WinSCP tool allows files to be transferred to and from the CSF using a drag-n-drop interface. It may already be installed if using a campus cluster PC. You can also download and install for free on your own computer. The instructions below assume you have an installed version on the PC you are using.
We’ll set up a CSF session in WinSCP so that you only need to type the settings in once:
- Start the WinSCP program from the Start menu.
- You only need to do steps 2 & 3 the first time you start WinSCP on this PC. If you’ve already done the following step, jump to Step 4. Otherwise fill in the details as shown below:
- Host name: csf3.itservices.manchester.ac.uk
- User name: your University IT username
- Password: your University IT password
Then hit Save
- To save the above settings, give the session a name (any name will do, here we use
CSF3) and hit OK
- Now we can log in to the CSF in WinSCP. We’ll do this step every time we wish to transfer files to the CSF. Highlight the CSF session and hit Login.
- Enter your password when asked.
- When first logging in you may be asked to accept a new host key. It is safe to do so:
- You can now drag-n-drop files between the two systems. Your local PC is on the left, the CSF on the right (click on image to enlarge).
