AWS Snowball User Guide
Transferring Data with the
Amazon S3 Adapter for Snowball
• Windows – C:/Users/<username>/.aws/snowball/logs/
• Mac – /Users/<username>/.aws/snowball/logs/
• Linux – /home/<username>/.aws/snowball/logs/
Logs are saved with the file name snowball_<year>_<month>_<date>_<hour>. The hour is based on
local system time for the workstation and uses a 24-hour clock.
Example Log Name
snowball_2016_03_28_10.log
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.
Important
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.
Transferring Data with the Amazon S3 Adapter for
Snowball
The Amazon S3 Adapter for Snowball is a programmatic tool that you can use to transfer data between
your on-premises data center and a Snowball. It replaces the functionality of the Snowball client. As
with the Snowball client, you need to download the adapter's executable file from the AWS Snowball
Tools Download page, install it, and run it from your computer workstation. When programmatically
transferring data to a Snowball, all data goes through the Amazon S3 Adapter for Snowball, without
exception.
We highly recommend that your workstation be a powerful computer. It should be able to meet high
demands in terms of processing, memory, and networking. For more information, see Workstation
Specifications (p. 93).
Downloading and Installing the Amazon S3 Adapter
for Snowball
You can download and install the Amazon S3 Adapter for Snowball from the AWS Snowball Tools
Download page. Once there, find the installation package for your operating system, and follow the
instructions to install the Amazon S3 Adapter for Snowball. Running the adapter from a terminal in your
workstation might require using a specific path, depending on your operating system.
To install the adapter, first download the snowball-adapter-operating_system.zip file from the AWS
Snowball Tools Download page. Unzip the file, and navigate the extracted folder. For the Mac and Linux
versions of the adapter, to make the snowball-adapter file executable, change the permissions on this
file within the bin directory with the following commands.
chmod +x snowball-adapter
To confirm the adapter was installed successfully
1. Open a terminal window on the workstation with the installed adapter.
2. Navigate to the directory where you installed the snowball-adapter-operating_system
subdirectory.
65