AWS Snowball User Guide
Transfer Data
Now that you have your credentials, you're ready to use the Snowball client to transfer data.
Install the AWS Snowball Client
The Snowball client is one of the tools that you can use to manage the flow of data from your on-
premises data source to the Snowball. You can download the Snowball client for your operating system
from AWS Snowball Tools Download page.
Use the AWS Snowball Client
In this step, you'll run the Snowball client from the workstation first to authenticate your access to the
Snowball for this job, and then to transfer data.
To authenticate your access to the Snowball, open a terminal or command prompt window on your
workstation and type the following command:
snowball start -i [Snowball IP Address] -m [Path/to/manifest/file] -u [29
character unlock code]
Following is an example of the command to configure the Snowball client.
snowball start -i 192.0.2.0 -m /Downloads/JID2EXAMPLE-0c40-49a7-9f53-916aEXAMPLE81-
manifest.bin -u 12345-abcde-12345-ABCDE-12345
In this example, the IP address for the Snowball is 192.0.2.0, the job manifest file that you downloaded is
JID2EXAMPLE-0c40-49a7-9f53-916aEXAMPLE81-manifest.bin, and the 29-character unlock code
is 12345-abcde-12345-ABCDE-12345.
When you've entered the preceding command with the right variables for your job part, you get a
confirmation message. This message means that you're authorized to access the Snowball for this job. If
you perform the snowball ls command, you'll notice that there is at least one folder at the root level
of the Snowball. This folder and any others at this level have the same names as the source S3 buckets
that were chosen when this job was created.
Now you can begin transferring data from the Snowball. Similarly to how Linux allows you to copy files
and folders with the copy (or cp) command, the Snowball client also uses a cp command. As in Linux,
when you use the copy command you'll provide the values of two paths in your command. One path
represents the source location of the data to be copied, and the second path represents the destination
where the data will be pasted. When you're transferring data, source paths from the Snowball must start
with the s3:// root directory identifier.
Following is an example of the command to copy data using the client from the Snowball
snowball cp --recursive s3://MyBucket/Logs /Logs/April
Use the Snowball client commands to finish transferring your data from the Snowball. For more
information on using the Snowball client, see Using the Snowball Client (p. 52).
Disconnect the AWS Snowball Appliance
When you've finished transferring data from the Snowball, prepare it for its return trip to AWS. First,
disconnect the Snowball cables. Secure the Snowball's cables into the cable caddie on the inside of the
Snowball back panel, and then seal the Snowball.
When the return shipping label appears on the Snowball's E Ink display, it's ready to be returned.
Next:
31