- Fair-policy transfer
Fair-policy transfer with maximum rate 100 Mbps and minimum at 1 Mbps,
without encryption, transfer all files in \local-dir\files
to
10.0.0.2:
# ascp -T --policy=fair -l 100m -m 1m /local-dir/files root@10.0.0.2:/remote-dir
- Fixed-policy transfer
Fixed-policy transfer with target rate 100 Mbps, without encryption, transfer
all files in \local-dir\files to 10.0.0.2:
# ascp -T -l 100m /local-dir/files root@10.0.0.2:/remote-dir
- Specify UDP port for transfer
Perform a transfer with UDP port
42000:
# ascp -l 100m -O 42000 /local-dir/files user@10.0.0.2:/remote-dir
- Public key authentication
Transfer with public key authentication using key file
<home
dir>/.ssh/aspera_user_1-key
local-dir/files:
$ ascp -T -l 10m -i ~/.ssh/aspera_user_1-key local-dir/files root@10.0.0.2:/remote-dir
- Username or filepath contains a space
Enclose the target in double-quotes when spaces are present in the username
and remote
path:
# ascp -l 100m local-dir/files "User Name@10.0.0.2:/remote directory"
- Content is specified in a file pair list
Specify source content to
transfer to various destinations in a file pair list. Source content is
specified using the full file or directory path. Destination directories are
specified relative to the transfer user's docroot, which is specified as a
"." at the end of the ascp command. For example, the
following is a simple file pair list, filepairlist.txt
that lists two source folders, folder1 and
folder2, with two destinations,
tmp1 and
tmp2:
/tmp/folder1
tmp1
/tmp/folder2
tmp2
# ascp --user=user_1 --host=10.0.0.2 --mode=send --file-pair-list=/tmp/filepairlist.txt .
This
command and file pair list create the following directories within the
transfer user's docroot on the
destination:
/tmp1/folder1
/tmp2/folder2
- Network shared location transfer
Send files to a network shares location
\\1.2.3.4\nw-share-dir, through the computer
10.0.0.2:
# ascp local-dir/files root@10.0.0.2:"//1.2.3.4/nw-share-dir/"
- Parallel transfer on a multicore system
Use parallel transfer on a dual-core
system, together transferring at the rate 200Mbps, using UDP ports 33001 and
33002. Two commands are executed in different Terminal
windows:
# ascp -C 1:2 -O 33001 -l 100m /file root@10.0.0.2:/remote-dir &
# ascp -C 2:2 -O 33002 -l 100m /file root@10.0.0.2:/remote-dir
- Upload with content protection
Upload the file space\file to the server 10.0.0.2 with
password protection (password:
secRet):
$ export ASPERA_SCP_FILEPASS=secRet; ascp -l 10m --file-crypt=encrypt local-dir/file root@10.0.0.2:/remote-dir/
- Download with content protection and decryption
Download from the server 10.0.0.2 and decrypt while
transferring:
$ export ASPERA_SCP_FILEPASS=secRet; ascp -l 10m --file-crypt=decrypt root@10.0.0.2:/remote-dir /local-dir
- Decrypt a downloaded, encrypted file
If the password-protected file
file1 is downloaded on the local computer without
decrypting, decrypt file1.aspera-env (the name of the
downloaded/encrypted version of file1) to
file1:
$ export ASPERA_SCP_FILEPASS=secRet; /opt/aspera/bin/asunprotect -o file1 file1.aspera-env
- Download through Aspera forward proxy with proxy authentication
User Pat transfers the file /data/file1
to /Pat_data/ on 10.0.0.2, through the proxy server at
10.0.0.7 with the transfer user aspera_proxy and transfer user
password pa33w0rd. After running the command, Pat is prompted for
the ascp
password.
# ascp --proxy dnat://aspera_proxy:pa33w0rd@10.0.0.7 /data/file1 Pat@10.0.0.2:/Pat_data/
For information on the syntax, see .