AWS Snowball User Guide
Transfer Data
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, you get a
confirmation message. This message means that you're authorized to access the Snowball for this job.
Now you can begin transferring data onto 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, destination paths to the Snowball must
start with the s3:// root directory identifier.
During data transfer, 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 destination buckets that were chosen
when this job was created. Data cannot be transferred directly into the root directory; it must instead go
into one of the bucket folders or into their subfolders.
To transfer data using the Snowball client, open a terminal or command prompt window on your
workstation and type the following command:
snowball cp [options] [path/to/data/source] s3://[path/to/data/destination]
Following is an example of the command to copy data using the client to the Snowball.
snowball cp --recursive /Logs/April s3://MyBucket/Logs
For more information on using the Snowball client tool, see Using the Snowball Client (p. 52). Use the
Snowball client commands to finish transferring your data into the Snowball. When you finish, it's time
to prepare the Snowball for its return trip.
Stop the AWS Snowball Client, and Power Off the Snowball
When you've finished transferring data on to the Snowball, prepare it for its return trip to AWS. To
prepare it, run the snowball stop command in the terminal of your workstation. Running this
command stops all communication to the Snowball from your workstation and performs local cleanup
operations in the background. When that command has finished, power off the Snowball by pressing the
power button above the E Ink display.
Disconnect the Appliance
Disconnect the Snowball cables. Secure the Snowball's cables into the cable caddie on the inside of the
Snowball back panel and seal the Snowball. When the return shipping label appears on the Snowball's E
Ink display, you're ready to drop it off with your region's carrier to be shipped back to AWS. To see who
your region's carrier is, see Shipping Carriers (p. 74).
Important
Don't delete your local copies of the transferred data until the import into Amazon S3 is
successful at the end of the process and you can verify the results of the data transfer.
Next:
Return the Appliance (p. 24)
23