The following section discuss the steps involved in transferring data. These steps involve getting your credentials, downloading and installing the Snowball client tool, and then transferring data from your data source into the Snowball using the Snowball client.
You can also transfer data programmatically with the S3 SDK Adapter for Snowball. For more information, see Transferring Data with the Amazon S3 Adapter for Snowball.
Get Your Credentials
Each AWS Snowball job has a set of credentials that you must get from the AWS Snowball Management Console or the job management API to authenticate your access to the Snowball. These credentials are an encrypted manifest file and an unlock code. The manifest file contains important information about the job and permissions associated with it. Without it, you won't be able to transfer data. The unlock code is used to decrypt the manifest. Without it, you won't be able to communicate with the Snowball.
You can only get your credentials after the Snowball appliance has been delivered to you.
To get your credentials by using the console
As a best practice, we recommend that you don't save a copy of the unlock code in the same location in the workstation as the manifest for that job. For more information, see Best Practices for AWS Snowball.
Sign in to the AWS Management Console and open the AWS Snowball Management Console at AWS Snowball Management Console.
In the AWS Snowball Management Console, search the table for the specific job to download the job manifest for, and then choose that job.
Expand that job's Job status pane, and select View job details
In the details pane that appears, expand Credentials. Make a note of the unlock code (including the hyphens), because you'll need to provide all 29 characters to transfer data. Choose Download manifest in the dialog box and follow the instructions to download the job manifest file to your computer. The name of your manifest file includes your Job ID.
Now that you have your credentials, you're ready to transfer data.
Install the Snowball Client
The Snowball client is one of the tools that you can use transfer 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 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
and the 29 character unlock code is
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
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
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]
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. 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 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
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.
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