This guide is for the Snowball (50 TB or 80 TB of storage space). If you are looking for documentation for the Snowball Edge, see the AWS Snowball Edge Developer Guide.
Following, you can find information about
snowball cp command options and also syntax guidelines for using this command. You use this command to transfer data from your workstation to a Snowball.
|-b, --batch||String. Significantly improves the transfer performance for small files by batching them into larger
|--checksum||On and set to false by default. Calculates a checksum for any source and destination files with the same name, and then compares the checksums. This command option is used when a copy operation is resumed. Using this option adds computational overhead during your copy operation. When this option isn't used, a faster comparison of just file names and dates occurs when you resume as copy operation.|
|-f, --force||On and set to false by default. This command option has two uses: [See the AWS documentation website for more details] The preceding use cases are not mutually exclusive. We recommend that you use
|-h, --help||On and set to false by default. Displays the usage information for the
|--noBatch||String. Disables automatic batching of small files. If you're copying a directory, and you use this option, you must also use the
|-r, --recursive||On and set to false by default. Recursively traverses directories during the
|-s, --stopOnError||On and set to false by default. Stops the
--batch option for the Snowball client's copy command is not supported for HDFS data transfers. If you must transfer a large number of small files from an HDFS cluster, we recommend that you find a method of collecting them into larger archive files, and then transferring those. However, these archives are what is imported into Amazon S3. If you want the files in their original state, take them out of the archives after importing the archives.
When you transfer data between your on-premises data centers and a Snowball, the Snowball client automatically generates a plaintext log and saves it to your workstation. If you encounter unexpected errors during data transfer to the Snowball, make a copy of the associated log files. Include them along with a brief description of the issues that you encountered in a message to AWS Support.
Logs are saved in the following locations, based on your workstation's operating system:
- Windows – C:\Users\\.aws\snowball\logs\
- Mac – /Users//.aws/snowball/logs/
- Linux – /home//.aws/snowball/logs/
Logs are saved with the file name snowball____. The hour is based on local system time for the workstation and uses a 24-hour clock.
Example Log Name
Each log has a maximum file size of 5 MB. When a log reaches that size, a new file is generated, and the log is continued in the new file. If additional logs start within the same hour as the old log, then the name of the first log is appended with
.1 and the second log is appended with
.2, and so on.
Logs are saved in plaintext format and contain file name and path information for the files that you transfer. To protect this potentially sensitive information, we strongly suggest that you delete these logs once the job that the logs are associated with enters the completed status.