Unlocking the Snow Family device - Amazon Snowcone User Guide
Troubleshooting unlocking a Snow Family device
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Unlocking the Snow Family device

This section describes unlocking the Snow Family device using the Snowball Edge CLI. To unlock the device using Amazon OpsHub, a graphical user interface (GUI) tool for Snow Family devices, see Unlocking a device.

Before using a Snow Family device device to transfer data or perform edge compute tasks, you need to unlock the device. When unlocking the device, you authenticate your ability to access it by providing two forms of credentials: a 29-digit unlock code and a manifest file. After you unlock the device, you can further configure the device, move data to or from it, set up and use Amazon EC2-compatible instances, and more.

Before unlocking a device, the device must be plugged in to power and network, turned on, and an IP address assigned. See Amazon Snowcone Device Specifications. You will need the following information about the Snow Family device:

To unlock a standalone device with the Snowball Edge client

  1. Find the IP address for the Snowcone on the LCD display of the device. Make a note of that IP address.

  2. Use the unlock-device command to authenticate your access to the Snow Family device with the IP address of the Snow Family device and your credentials, as follows.

    
  snowballEdge unlock-device --endpoint https://ip-address-of-device --manifest-file /Path/to/manifest/file.bin --unlock-code 29-character-unlock-code

    The device indicates it was unlocked successfully with the following message.

    
Your Snowball Edge device is unlocking. You may determine the unlock state of your device using the describe-device command. Your Snowball Edge device will be available for use when it is in the UNLOCKED state.

    If the command returns connection refused, see Troubleshooting unlocking a Snow Family device.

    Example of unlock-device command

    In this example, the IP address for the device is 192.0.2.0, the manifest file name is JID2EXAMPLE-0c40-49a7-9f53-916aEXAMPLE81-manifest.bin, and the 29-character unlock code is 12345-abcde-12345-ABCDE-12345.

    
  snowballEdge unlock-device --endpoint https://192.0.2.0 --manifest-file /Downloads/JID2EXAMPLE-0c40-49a7-9f53-916aEXAMPLE81-manifest.bin /
    --unlock-code 12345-abcde-12345-ABCDE-12345

Troubleshooting unlocking a Snow Family device

If the unlock-device command returns connection refused, you may have mistyped the command syntax or the configuration of your computer or network may be preventing the command from reaching the Snow device. Take these actions to resolve the situation:

  1. Ensure the command was entered correctly.

    1. Use the LCD screen on the device to verify the IP addressed used in the command is correct.

    2. Ensure that the path to the manifest file used in the command is correct, including the file name.

    3. Use the Amazon Snow Family Management Console to verify the unlock code used in the command is correct.

  2. Ensure the computer you are using is on the same network and subnet as the Snow device.

  3. Ensure the computer you are using and the network are configured to allow access to the Snow device. Use the ping command for your operating system to determine if the computer can reach the Snow device over the network. Check the configurations of antivirus software, firewall configuration, virtual private network (VPN), or other configurations of your computer and network.

Now you can begin using the Snow Family device.