# WinSCP

WinSCP (opens new window) is an open source data transfer client for Windows that work with commonly used transfer protocols including SFTP, S3 and SCP. If your host organization allows, you can use WinSCP for file transfers and synchronization of folders between your local machine and your lab machines.

Requirement

# Install

Download WinSCP from winscp.net (opens new window) and install the software. This may required administrator privileges.

# Configure

TIP

This section configures WinSCP to connect your local machine to your home machine. Additional configurations will be needed for connections to iaas and blue machines.

You will see the Login screen when you start WinSCP for the first time.

SSH Tunnel - Step 1

In this Session tab insert:

  • File protocol: SFTP
  • Host name: 10.5.5.12
  • Protocol: 22
  • User name: <your-username>
  • Password: <your-ssh-password>

Click Advanced and select Tunnel:

SSH Tunnel - Step 2

In the Tunnel tab insert:

  • Connect through SSH tunnel: Check
  • Host name: <your-lab-IP> (usually starts with 10.42.130-something)
  • Protocol: 22
  • User name: <your-username>
  • Password: <your-ssh-password>

Click Ok when completed.

Once you have confirmed the advanced settings you will get back to previous window. Hit Login.

SSH Tunnel - Step 4

With a little bit of luck, you should be able to see the files in your lab on the right side of your screen.

# Synchronize

Synchronization (opens new window) is an additional feature that provides advanced copying. For example, when only a subset of updated files or only a new files have to be copied a lot of time can be saved compared to normal copy in WinSCP, which transfers all of the files every time your transfer a folder.

When selected the folder to be synchronized this option can be found in Commands menu as Synchronize... (Ctrl+S).

Synchronization - Step 1

Synchronization allows multiple adjustments such as synchronization towards target, but also both ways. Whether one wants to synchronize deleted files or what comparison criteria one would like to use.

Synchronization - Step 2

Be careful!

Selecting Both or Local targets will download data from your lab to your local machine. It is your responsibility to only use this configuration for folders in your lab that contains non-sensitive data that you can keep on your local machine.

When confirmed, a file comparison is done by WinSCP, where one can choose files to be synchronized. Click Ok to confirm.

Synchronization - Step 3

You will get a confirmation status when your synchronization is completed.

Synchronization - Step 4