AWS Snowball - Using the Amazon S3 Adapter for Snowball

To Next Page

To Previous Page

AWS Snowball User Guide

Using the Amazon S3 Adapter for Snowball

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

4. Type the following command to conﬁrm that the adapter was installed correctly: ./snowball-

adapter --help.

If the adapter was successfully installed, its usage information appears in the terminal.

Installing the adapter also adds the snowball subdirectory to your .aws directory. Within this snowball

directory, you can ﬁnd the logs and conﬁg subdirectories. Their contents are as follows:

• The logs directory is where you ﬁnd the log ﬁles for your data transfers to the Snowball through the

Amazon S3 Adapter for Snowball.

• The conﬁg directory contains two ﬁles:

• The snowball-adapter-logging.conﬁg ﬁle contains the conﬁguration settings for the log ﬁles written

to the ~/.aws/snowball/logs directory.

• The snowball-adapter.conﬁg ﬁle contains the conﬁguration 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.

Using the Amazon S3 Adapter for Snowball

Following, you can ﬁnd an overview of the Amazon S3 Adapter for Snowball, which allows you to

programmatically transfer data between your on-premises data center and the Snowball using Amazon

S3 REST API actions. This Amazon S3 REST API support is limited to a subset of actions, meaning that

you can use the subset of supported Amazon S3 AWS CLI commands or one of the AWS SDKs to transfer

data.

If your solution uses the AWS SDK for Java version 1.11.0 or newer, you must use the following

S3ClientOptions:

• disableChunkedEncoding() – Indicates that chunked encoding is not supported with the adapter.

• setPathStyleAccess(true) – Conﬁgures the adapter to use path-style access for all requests.

For more information, see Class S3ClientOptions.Builder in the Amazon AppStream SDK for Java.

Topics

• Starting the Amazon S3 Adapter for Snowball (p. 66)

• Getting the Status of a Snowball Using the Adapter (p. 67)

• Unsupported Amazon S3 Features for Snowball (p. 68)

• Options for the Amazon S3 Adapter for Snowball (p. 68)

• Using the Adapter with Amazon S3 Commands for the AWS CLI (p. 70)

• Supported REST API Actions (p. 71)

Starting the Amazon S3 Adapter for Snowball

To use the Amazon S3 Adapter for Snowball, start it in a terminal on your workstation and leave it

running while transferring data.

Note

Because the computer workstation from which or to which you make the data transfer

is considered to be the bottleneck for transferring data, we highly recommend that