AWS Snowball User Guide
Troubleshooting Client Problems
Object Name Bucket Name Path Plus
Bucket Name
Key Length
ugPYlxVg/
evpcQEJLT/
rSwZc
$MlVVf/
$hwefVISRqwepB
$/BiiD/PPF
$twRAjrD/
fIMp/0NY
If a key's length is larger than 933 bytes, you see the following error message when you try to copy the
object to a Snowball:
Failed to copy the following file: <Name of object with a keylength over 933 bytes>
PARENT_NOT_FOUND:
If you receive this error message, you can resolve the issue by reducing the object's key length.
• If you're using Linux and you can't upload files with UTF-8 characters to a Snowball, it might be
because your Linux workstation doesn't recognize UTF-8 character encoding. You can correct this
issue by installing the locales package on your Linux workstation and configuring it to use one
of the UTF-8 locales like en_US.UTF-8. You can configure the locales package by exporting the
environment variable LC_ALL, for example: export LC_ALL=en_US.UTF-8
• If you encounter unexpected errors during data transfer to the Snowball, we want to hear about
it. Make a copy of your logs and include them along with a brief description of the issues that
you encountered in a message to AWS Support. For more information about logs, see Snowball
Logs (p. 64).
Troubleshooting Client Problems
The following can help you troubleshoot issues with the Snowball client.
• If you're having trouble using the Snowball client, type the command snowball help for a list of all
available actions for that tool.
• Although you can run multiple instances of the Snowball client at the same time, each instance of
the client requires up to 7 GB of dedicated RAM for memory-intensive tasks, such as performing the
snowball cp command. If your workstation runs out of memory as it runs the Snowball client, you
see a Java OutOfMemoryError exception returned in the terminal window. You can resolve this issue
by freeing up resources on the workstation or increasing the amount of memory for your workstation,
and then performing your Snowball client task again.
• If you encounter issues while transferring data to a Snowball using the client on a PC running
Microsoft Windows Server, it might be due to the Data Deduplication feature in Windows. If you have
the Data Deduplication feature turned on, we recommend that you use the Amazon S3 Adapter for
Snowball with the AWS CLI to transfer data instead. For more information, see Transferring Data with
the Amazon S3 Adapter for Snowball (p. 65).
Troubleshooting Snowball Client Validation Problems
When you transfer data, the copy operation first performs a precheck on the metadata for each file to
copy. If any of the following attributes are true about a file's metadata, then the copy operation stops
before it transfers any files:
99
To Next Page
Loading...