The following are examples of initiating FASP file transfers using the
ascp command:
- 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
/Documents and
Settings/aspera_user_1/.ssh/aspera_user_1:
> ascp -T -l 10m -i "/Documents and Settings/aspera_user_1/.ssh/aspera_user_1" 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"
- 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):
> set 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:
> set 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:
> set ASPERA_SCP_FILEPASS=secRet&& 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/
Test transfers using faux://
For information on the syntax, see Testing and Optimizing Transfer Performance.
- Transfer random data (no source storage required)
Transfer 20 GB of random data as user root to file
newfile in the directory
/remote-dir on
10.0.0.2:
>ascp --mode=send --user=root --host=10.0.0.2 faux:///newfile?20g /remote-dir
- Transfer a file but do not save results to disk (no destination storage
required)
Transfer the file /tmp/sample as user
root to 10.0.0.2, but do not save results to
disk:
>ascp --mode=send --user=root --host=10.0.0.2 /temp/sample faux://
- Transfer random data and do not save result to disk (no source or destination storage
required)
Transfer 10 MB of random data from 10.0.0.2 as user root and
do not save result to
disk:
>ascp --mode=send --user=root --host=10.0.0.2 faux:///dummy?10m faux://