| ascp: Transferring from the Command Line with Ascp |
135
Overview of Checksum Configuration Options
asconfigurator
Option
ascp
Option
Description
file_checksum
--file-checksum=
type
Enable checksum reporting and specify the type of checksum to
calculate for transferred files.
any
- Allow the checksum format to be whichever format the client
requests. (Default in
aspera.conf
)
md5
- Calculate and report an MD5 checksum.
sha1
- Calculate and report a SHA-1 checksum.
sha256
- Calculate and report a SHA-256 checksum.
sha384
- Calculate and report a SHA-384 checksum.
sha512
- Calculate and report a SHA-512 checksum.
Note:
The default value for the
ascp
option is
none
, in which case the
reported checksum is the one configured on the server, if any.
file_manifest
--file_manifest=
output
The file manifest is a file that contains a list of content that was
transferred in a transfer session. The file name of the file manifest is
automatically generated from the transfer session ID.
When set to
none
, no file manifest is created. (Default)
When set to
text
, a text file is generated that lists all files in each
transfer session.
file_manifest_path
--file_manifest_path=
path
The location where manifest files are written. The location can be an
absolute path or a path relative to the transfer user's home directory. If
no path is specified (default), the file is generated under the destination
path at the receiver, and under the first source path at the sender.
Note:
File manifests can be stored only locally. Thus, if you are using
S3 or other non-local storage, you must specify a local manifest path.
Enabling checksum reporting by editing
aspera.conf
To enable checksum reporting, run the following command:
# asconfigurator -x "set_node_data;file_checksum,
checksum
"
To enable and configure the file manifest where checksum report data is stored, run the following commands:
# asconfigurator -x "set_node_data;file_manifest,text"
# asconfigurator -x "set_node_data;file_manifest_path,
filepath
"
These commands create lines in
aspera.conf
as shown in the following example, where checksum type is
md5
,
file manifest is enabled, and the path is
/tmp
.
<file_system>
...
<file_checksum>md5</file_checksum>
<file_manifest>text</file_manifest>
<file_manifest_path>/tmp</file_manifest_path>
...
</file_system>
