Secure Copy (“SCP”) provides a secure means of copying files to and from NetStorage using SSH for authentication and security. It is, however, limited to file transfers and cannot be used for other management tasks. Because of this limitation, you may want to use the SSH File Transfer Protocol (SFTP), which has largely superseded SCP and is a more capable SSH-based tool.
- SSH keys. You need to apply a secure SSH key to an upload account.
- Domain name prefix. Prepend your domain name prefix to the upload domain.
- Upload domain.
<Domain name prefix>.scp.upload.akamai.com
- Username. All secure connections use
sshacsas the username.
Example domain: This example uses an example domain name prefix of
nsmediadocs and the
scp.upload.akamai.com upload domain to give a fully-qualified upload domain of:
You should meet these requirements when using Secure Copy.
- OpenSSH version 6.7 (or later) - For multi-threading and higher window sizes. See additional information on OpenSSH.
- High Performance Network Patches (Recommended) - These patches are applied to remove a networking bottleneck that exists in the base OpenSSH code. Additional details are available via an FAQ.
- Is the client CPU maxing out? This is unlikely if you are using a wide-area network, but if it does happen, you can use the multi-threaded AES-CTR cipher if that meets your security needs.
When using SCP to interact with a NetStorage storage group, these limitations apply:
- Wild Card Notation (Globbing) is not supported
Values displayed in “< >” represent variables and you should replace them with the actual options.
scp [-1234BCpqrv] [-c <cipher>] [-F <ssh_config>] [-i <identity_file>] [-l <limit>] [-o <ssh_option>] [-P <port>] [-S <program>][[user@]host1:] file1[...] [[user@]host2:]file72
These examples show you how to connect with SCP and issue basic commands.
This example uses the OpenSSH SCP client from a command line. It uses an example domain name prefix of
nsmediadocs and the
scp.upload.akamai.com upload domain.
scp -i <private key> email@example.com
This example sends the local
movie.mp4 file to the remote
scp -i <private key> C:\local_folder\movie.mp4 firstname.lastname@example.org:/movies # Response output movie.mp4 100% 40KB 40.4KB/s 00:00
This example recursively sends content from the local
C:\local_folder\ directory to the remote
/movies directory, automatically creating subdirectories as needed.
scp -i <private key> -r C:\local_folder\ email@example.com:/movies # Response output .dotfile 100% 0 0.0KB/s 00:00 example.txt 100% 15KB 14.9KB/s 00:00 movie.mp4 100% 40KB 40.4KB/s 00:00 subtitle.srt 100% 5029 4.9KB/s 00:00
This section covers the available SecureCopy (SCP) commands supported by NetStorage. NetStorage supports the normal command set for SCP (except where noted) in this table:
|Use SSH protocol 1|
Note: NetStorage does not support SSH protocol 1 -- This command is not supported for use.
|Use SSH protocol 2|
|Use only IPv4 addresses|
|Use only IPv6 addresses|
|Use batch mode|
|Specify the |
|Designate a substitute per-user SSH configuration file (i.e., define it as the |
|If applicable, include this option and set the “<identity_file>” variable as the complete path to, and file name of the private SSH key file.|
|Include this command and set the |
|Send the specified |
|Connect to |
|Save the original file’s modification/access times, and modes|
|Turn off the progress meter|
|Specify the |
|Display the operation’s execution step by step|
NetStorage allows the use of common SCP clients. Complete details on referenced SCP clients and components — including how to apply the “private key” file for an applicable SSH key — can be found at their respective links.
- OpenSSH SCP. http://www.openssh.org/manual.html
- PuTTY and PSCP. http://www.chiark.greenend.org.uk/~sgtatham/putty/
Any client not listed as supported should be considered unsupported. Third-party clients may include features not supported by NetStorage.
- WinSCP. This client is unsupported for use with the SCP protocol, but can be used as a client with the SFTP protocol. See Use SSH File Transfer Protocol (SFTP) for detailed instructions.
Usage instructions aren't provided for these third-party components. It is assumed that you are familiar with their use. Use an unsupported client at your own risk.
Updated 10 months ago