

AWS Snowball Edge is no longer available to new customers. New customers should explore [AWS DataSync](https://aws.amazon.com/datasync/) for online transfers, [AWS Data Transfer Terminal](https://aws.amazon.com/data-transfer-terminal/) for secure physical transfers, or AWS Partner solutions. For edge computing, explore [AWS Outposts](https://aws.amazon.com/outposts/). 

# Set up Amazon S3 compatible storage on Snowball Edge with AWS OpsHub
<a name="s3-edge-snow-opshub"></a>

The Amazon S3 compatible storage on Snowball Edge service is not active by default. To start the service on a device or cluster, you must create two virtual network interfaces (VNICs) on each device to attach to the `s3control` and `s3api` endpoints.

**Topics**
+ [Amazon S3 compatible storage on Snowball Edge prerequisites for AWS OpsHub](#s3-edge-snow-opshub-prereqs)
+ [Using the Amazon S3 compatible storage on Snowball Edge simple setup option in AWS OpsHub](#s3-edge-snow-opshub-simple-setup)
+ [Using the Amazon S3 compatible storage on Snowball Edge advanced setup option using AWS OpsHub](#s3-edge-snow-opshub-advanced-setup)
+ [Configuring Amazon S3 compatible storage on Snowball Edge to autostart using AWS OpsHub](#autostart-s3compatible)
+ [Creating a bucket in Amazon S3 compatible storage on Snowball Edge using AWS OpsHub](#s3compatible-create-bucket)
+ [Upload files and folders to Amazon S3 compatible storage on Snowball Edge buckets using AWS OpsHub](#s3compatible-upload-files)
+ [Remove files and folders from Amazon S3 compatible storage on Snowball Edge buckets with AWS OpsHub with AWS OpsHub](#s3compatible-remove-files)
+ [Delete buckets from Amazon S3 compatible storage on Snowball Edge](#s3compatible-delete-bucket)

## Amazon S3 compatible storage on Snowball Edge prerequisites for AWS OpsHub
<a name="s3-edge-snow-opshub-prereqs"></a>

Before you can set up your device or cluster using AWS OpsHub, do the following:
+ Power on your Snowball Edge device and connect it to your network.
+ On your local machine, download and install the latest version of [AWS OpsHub](https://docs.aws.amazon.com/snowball/latest/developer-guide/download-opshub.html). Connect to the device or cluster to unlock it with a manifest file. For more information, see [unlocking a device](https://docs.aws.amazon.com/snowball/latest/developer-guide/connect-unlock-device.html).

## Using the Amazon S3 compatible storage on Snowball Edge simple setup option in AWS OpsHub
<a name="s3-edge-snow-opshub-simple-setup"></a>

Use the simple setup option if your network uses DHCP. With this option, the VNICs are created automatically on each device when you start the service.

1. Log in to AWS OpsHub, then choose **Manage Storage**.

   This takes you to the Amazon S3 compatible storage on Snowball Edge landing page.

1. For **Start service setup type**, choose **Simple**.

1. Choose **Start service**.
**Note**  
This takes a few minutes to complete and depends on the number of devices you're using.

   After the service starts, the Service state is active, and there are endpoints.   
![\[The Amazon S3 compatible storage on Snowball Edge resources screen, showing a service state of Active and its active endpoints.\]](http://docs.aws.amazon.com/snowball/latest/developer-guide/images/s3-snow/s3-snow-active-service.png)

## Using the Amazon S3 compatible storage on Snowball Edge advanced setup option using AWS OpsHub
<a name="s3-edge-snow-opshub-advanced-setup"></a>

Use the advanced setup option if your network uses static IP addresses or if you want to reuse existing VNIs. With this option, you create VNICs for each device manually.

1. Log in to AWS OpsHub, then choose **Manage Storage**.

   This takes you to the Amazon S3 compatible storage on Snowball Edge landing page.

1. For **Start service setup type**, choose **Advanced**.

1. Select the devices that you need to create VNICs for.

   For clusters, you need a minimum quorum of devices to start the Amazon S3 compatible storage on Snowball Edge service. The quorum is two for a three-node cluster.
**Note**  
For the initial start of the service in a cluster setup, you must have all devices in the cluster configured and available for the service to start. For subsequent starts, you can use a subset of the devices if you meet quorum, but the service will start in a degraded state.

1. For each device, choose an existing VNIC or select **Create VNI**. 

   Each device needs a VNIC for the **S3 endpoint** for object operations and another for the **S3Control endpoint** for bucket operations.

1. If you're creating a VNIC, choose a physical network interface and enter the status IP address and subnet mask, then choose **Create virtual network interface**.

1. After you create your VNICS, choose **Start service**.
**Note**  
This takes a few minutes to complete and depends on the number of devices you're using.

   After the service starts, the Service state is active, and there are endpoints.

## Configuring Amazon S3 compatible storage on Snowball Edge to autostart using AWS OpsHub
<a name="autostart-s3compatible"></a>

1. Log in to AWS OpsHub, then choose **Manage Storage**.

   This takes you to the Amazon S3 compatible storage on Snowball Edge landing page.

1. In **Amazon S3 compatible storage on Snow resources**, choose **Enable service auto-start**. The system configures the service to automatically start in the future.  
![\[Amazon S3 compatible storage on Snow resources area with Enable service auto-start at top right.\]](http://docs.aws.amazon.com/snowball/latest/developer-guide/images/opshub-autostart-s3compatible-console.png)

## Creating a bucket in Amazon S3 compatible storage on Snowball Edge using AWS OpsHub
<a name="s3compatible-create-bucket"></a>

Use the AWS OpsHub interface to create an Amazon S3 bucket on your Snowball Edge device.

1. Open AWS OpsHub.

1. In **Manage storage**, choose **Get started**. The **Amazon S3 compatible storage on Snow** page appears.

1. In **Buckets**, choose **Create bucket**. The **Create bucket** screen appears.  
![\[Create bucket page.\]](http://docs.aws.amazon.com/snowball/latest/developer-guide/images/opshub-create-bucket-s3compatible-console.png)

1. In **Bucket name**, enter a name for the bucket.
**Note**  
Bucket names must be unique within your Snowball device or cluster and must not contain spaces or uppercase letters.

1. Choose **Create bucket**. The system creates the bucket and it appears in **Buckets** in the **Amazon S3 compatible storage on Snow** page.

## Upload files and folders to Amazon S3 compatible storage on Snowball Edge buckets using AWS OpsHub
<a name="s3compatible-upload-files"></a>

Use the AWS OpsHub interface to upload files and folders to Amazon S3 compatible storage on Snowball Edge buckets. Files and folders may be uploaded separately or together.

1. Open AWS OpsHub

1. In **Manage storage**, in **Buckets**, choose a bucket in which to upload files. The page for that bucket appears.

1. In the bucket page, choose **Upload files**. The **Upload** page appears.  
![\[Upload page with drag-and-drop area surrounded with a dashed, blue line.\]](http://docs.aws.amazon.com/snowball/latest/developer-guide/images/opshub-upload-s3compatible-console.png)

1. Upload files or folders by dragging them from an operating system file manager to the AWS OpsHub window or do the following:

   1. Select **Add files** or **Add folders**.

   1. Select one or more files or folders to upload. Select **Open**.

   The system uploads the selected files and folders to the bucket on the device. After the upload is complete, the names of the files and folders appear in the **Files and folders** list.

## Remove files and folders from Amazon S3 compatible storage on Snowball Edge buckets with AWS OpsHub with AWS OpsHub
<a name="s3compatible-remove-files"></a>

Use the AWS OpsHub interface to remove and permanently delete files and folders from buckets on the Snowball Edge device.

1. Open AWS OpsHub.

1. In **Manage storage**, in **Buckets**, select the name of a bucket from which to delete files and folders. The page for that bucket appears.

1. In **Files and folders** select the check boxes of the files and folders to permanently delete.

1. Select **Remove**. The system removes the files or folders from the bucket on the device.

## Delete buckets from Amazon S3 compatible storage on Snowball Edge
<a name="s3compatible-delete-bucket"></a>

Before you can delete a bucket from a device, the bucket must be empty. Either remove files and folders from the bucket or use the empty bucket tool. To remove files and folders, see [Remove files and folders from Amazon S3 compatible storage on Snowball Edge buckets with AWS OpsHub with AWS OpsHub](#s3compatible-remove-files).

**To use the empty bucket tool**

1. Open AWS OpsHub.

1. In **Manage storage**, in **Buckets**, select the radio button of the bucket to empty.

1. Select **Empty**. The **Empty bucket** page appears.  
![\[Empty bucket page with warning that emptying a bucket cannot be undone.\]](http://docs.aws.amazon.com/snowball/latest/developer-guide/images/opshub-empty-bucket-s3compatible-console.png)

1. In the text box in the **Empty bucket** page, type **permanently delete**.

1. Select **Empty**. The system empties the bucket.

**To delete an empty bucket**

1. In **Manage storage**, in **Buckets**, select the radio button of the bucket to delete.

1. Select **Delete**. The **Delete bucket** page appears.  
![\[Delete bucket page showing text box for bucket name and delete button.\]](http://docs.aws.amazon.com/snowball/latest/developer-guide/images/opshub-delete-bucket-s3compatible-console.png)

1. In the text box in the **Delete bucket** page, type the name of the bucket.

1. Select **Delete**. The system deletes the bucket from the device.