Menu
AWS Snowball
User Guide

Transferring Data with the Amazon S3 Adapter for Snowball

The S3 SDK 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 S3 SDK 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.

Downloading and Installing the Amazon S3 Adapter for Snowball

You can download and install the S3 SDK 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 S3 SDK 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, you'll need to 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.

  3. Navigate to snowball-adapter-operating_system/bin.

  4. Type the following command to confirm that the adapter was installed correctly: ./snowball-adapter --help.

    If the adapter was successfully installed, you'll see its usage information display in the terminal.

Installing the adapter also adds the snowball subdirectory to your .aws directory. Within this snowball directory, you'll find the logs and config subdirectories. Their contents are as follows:

  • The logs directory is where you'll find the log files for your data transfers to the Snowball through the S3 SDK Adapter for Snowball.

  • The config directory contains two files:

    • The snowball-adapter-logging.config file contains the configuration settings for the log files written to the ~/.aws/snowball/logs directory.

    • The snowball-adapter.config file contains the configuration settings for the adapter itself.

Note

The .aws directory is located at ~/.aws in Linux, OS X, or Unix, or at C:\User\USERNAME\.aws on Windows.