AWS Snowball User Guide
Using the Snowball Client
Syntax for Copying a Directory
• Copying a directory to a new destination with or without a trailing slash – Specify the source path
and the destination path.
snowball cp -r /tmp/dir1 s3://bucket-name/dir2/
snowball cp -r /tmp/dir1 s3://bucket-name/dir2
The preceding examples both do the same thing. They both create the new directory dir2 and
recursively copy the contents of dir1 to it.
• Copying a directory to a destination directory that already exists – Only the unique contents from
the source directory make it into the destination directory, unless the snowball cp command is used
with the -f option to force the entire destination directory to be overwritten.
snowball cp -r /tmp/dir3 s3://bucket-name/dir4/
In the preceding example, only the unique contents from the source directory make it into the
destination directory, dir4.
snowball cp -r -f /tmp/dir3 s3://bucket-name/dir4/
In the preceding example, the destination directory dir4 is overwritten with the contents in the source
dir3 directory.
• Copying a directory to a destination file that already exists – This operation fails, unless you use
the snowball cp command with the -f option. In this case, the operation succeeds, because the
destination file is overwritten with a copy of the source directory of the same name.
snowball cp -r -f /tmp/dir5 s3://bucket-name/dir6
In the preceding example, dir6 on the Snowball is actually a file. Usually this command fails in this
case, because the source dir5 is a directory. However, because the -f is used, the file dir6 is forcibly
overwritten as a directory with the contents from the source dir5.
• Copying a directory to a bucket on a Snowball – Specify the bucket name in the destination path.
snowball cp -r /tmp/dir7 s3://bucket-name/
Note
If dir7 already exists in s3://bucket-name when this command is executed, the command
copies over the unique content from the source directory into the destination directory. You
can force the destination dir7 to be overwritten by the source dir7 by using the snowball cp
command with the -f option.
Snowball Logs
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:
64
To Next Page
Loading...