How To Resume Partially Transferred Files Over SSH Using Rsync
Picture this scenario. You’re copying some large files from one system to another over SSH using scp command. Suddenly the power is gone, the network connection is dropped and the copy process is terminated in midway. What would you do? Restart the copy process once the power is back online? Yes, It does work. However, the scp command doesn’t have resume option, so it will simply start copying the files from the beginning and overwrite the existing files. This is bit annoying and time-consuming task. This is where Rsync utility comes in handy! We can easily resume partially transferred files over SSH using Rsync. It helps you to resume the interrupted copy or download process where you left it off.
What is Rsync?
For those wondering, Rsync is a fast, versatile file copying utility that can be used to copy and transfer files or folders to and from remote and local systems. It offers a large number of options that control every aspect of its behavior and permit very flexible specification of the set of files to be copied. It is famous for its delta-transfer algorithm, which reduces the amount of data sent over the network by sending only the differences between the source files and the existing files in the destination. Rsync is widely used for backups and mirroring and as an improved copy command for everyday use.
Just like SCP, rsync will also copy files over SSH. In case you wanted to download or transfer large size files and folders over SSH, I recommend you to use rsync utility as described below.
Resume Partially Transferred Files Using Rsync
Please that the rsync utility should be installed on both sides (i.e. remote and local systems) in order to resume partially transferred files. Rsync is available in the official repositories of most Linux distributions, so you can install it using the distribution’s default package manager.
On Arch Linux and its variants, install Rsync using command:
$ sudo pacman -S rsync
On Debian, Ubuntu, Linux Mint:
$ sudo apt-get install rsync
$ sudo dnf install rsync
On RHEL, CentOS:
$ sudo yum install rsync
$ sudo zypper install rsync
Now let us see an example. I am going to copy Ubuntu 18.04 ISO from my local system to remote system with command:
$ scp ubuntu.iso [email protected]:/home/sk/
- sk is my remote system’s username
- 192.168.225.22 is the IP address of the remote machine.
- /home/sk/ is the remote destination.
Now, I terminated the copy process forcibly by pressing CTRL+C.
[email protected]'s password: ubuntu-16.04-desktop-amd64.iso 26% 372MB 26.2MB/s 00:39 ETA^c
As you see in the above output, I terminated the copy process when it reached 33%.
If I re-run the above command, it will simply overwrite the existing file. In other words, the copy process will not resume where I left it off.
In order to resume the copy process to copy the partially transferred ISO file, use rsync command as shown below.
$ rsync -P -rsh=ssh ubuntu.iso [email protected]:/home/sk/
[email protected]'s password: sending incremental file list ubuntu.iso 834.00M 100% 14.81MB/s 0:00:56 (xfr#1, to-chk=0/1)
See? Now, the copying process is resumed where we left it off earlier.
You can also use “–partial” instead of parameter “-P” like below.
$ rsync --partial -rsh=ssh ubuntu.iso [email protected]:/home/sk/
Here, the parameter “–partial” or “-P” tells the rsync command to keep the partial downloaded file and resume the process.
Check if the file is really copied or not to the remote system using command:
$ ssh [email protected] ls -lh [email protected]'s password: total 835M -rw-rw-r-- 1 sk sk 834M Jul 26 2019 ubuntu.iso
As you see in the above output, the file Ubuntu.iso is copied to the remote system and its size is 835MB.
Alternatively, we can use the following commands as well to resume partially transferred files over SSH.
$ rsync -avP ubuntu.iso [email protected]:/home/sk/
$ rsync -av --partial ubuntu.iso [email protected]:/home/sk/
That’s it. You know now how to resume the cancelled, interrupted, and partially downloaded files using rsync command. As you can see, it is not that difficult. If rsync is installed on both systems, we can easily resume the copy process as described above.