wasabi ball transfer appliance

20
Wasabi Ball Transfer Appliance Getting Started Guide Version: 2020-11-24 Revision: C

Upload: others

Post on 26-May-2022

3 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide

Version: 2020-11-24Revision: C

Page 2: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C ii

Copyright

Notice Information in this guide is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this guide may be reproduced or transmitted in any form by means electronic or mechanical, for any purpose, without express written permission of Wasabi Technologies LLC.

Trademarks WASABI and the WASABI Logo are trademarks of Wasabi Technologies LLC and may not be used without permission of Wasabi Technologies. All other names are used for identification purposes only and are trade-marks or registered trademarks of their respective companies.

Copyright © 2021by Wasabi Technologies111 Huntington Avenue

Boston, MA 02199United States

All Rights Reserved

Visit us at https://wasabi.com

Page 3: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C iii

Contents

PrefaceAbout This Guide ...............................................................................................................................................................................................vConventions .........................................................................................................................................................................................................vTechnical Support ........................................................................................................................................................................................... vi

1 Powering Up and Shutting DownPowering Up....................................................................................................................................................................................................1-1Shutting Down: Preferred Method ........................................................................................................................................................ 1-3Shutting Down: Forced Method..............................................................................................................................................................1-3Using the ReadyNAS Local Admin Page .............................................................................................................................................. 1-3

2 Getting StartedProvisioning ....................................................................................................................................................................................................2-1IP Address ........................................................................................................................................................................................................ 2-3Supported File Systems.............................................................................................................................................................................. 2-4Mounting the Wasabi Ball Transfer Appliance ................................................................................................................................2-4

Page 4: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C iv

3 Transferring DataTransferring Data to the Wasabi Ball Transfer Appliance .......................................................................................................... 3-1Preparing Your S3 Client for Uploads to the Wasabi Ball Appliance...................................................................................... 3-1Transferring Data from the Wasabi Ball Transfer Appliance ....................................................................................................3-4Encrypting Data .............................................................................................................................................................................................3-4

Page 5: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C v

Preface

About This Guide This quick start guide is designed to provide instructions on how to use the Wasabi Ball Transfer Appliance (referred to as the Appliance) for use cases involved in moving data from customer storage environments to Wasabi Hot Cloud Storage.

Conventions This document uses the following typographical conventions:

Convention Description

IMPORTANT Stresses the importance of the information presented.

NOTE Calls attention to additional information or an explanation.

Bold Text Used to indicate specific text that you need to enter (key in) or a button that you need to click.

Italics Text Used to indicate titles of books or sections within this document, and for general emphasis.

Page 6: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C vi

Technical Support The Wasabi web site has the latest product information. Use this resource to review product information, download software updates, contact technical support, access the Wasabi knowledge base, or provide feed-back on Wasabi documentation and online help:

www.wasabi.com

Use this email address to contact a Wasabi Customer Support representative:

[email protected]

Page 7: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C vii

Page 8: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 1-1

1 Powering Up and Shutting Down

The Wasabi Ball Transfer Appliance lets you move large datasets to Wasabi Hot Cloud Storage quickly, conve-niently, and cost-effectively. The Appliance is a Netgear NAS storage device with numerous disks in a RAID 0 array. It securely stores up to 100 TB of data.

Powering Up When you connect the Wasabi Ball Transfer Appliance to a power supply (or the system recovers from a power outage) and the power switch is in the On position, the system returns to its last state:

If the system was powered on, the system automatically powers on again when the power supply is con-nected or power is restored.

If the system was powered off, the system remains off when the power supply is connected or power is restored. In this case, press the power button on the front panel of the system to power on the sys-tem. (Refer to the following example.)

Page 9: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 1-2

Wasabi Ball DriveBays

1. Drive bay door

2. Disk tray release latch

3. Recessed disk tray handle lock

4. USB 3.0 port

5. Disk tray handle

6. Power button

7. Disk LED

8. Drive bays

Page 10: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 1-3

Shutting Down:Preferred Method

You can gracefully shut down your system by using the power button or the ReadyNAS local admin page. For information about using the ReadyNAS local admin page, see the ReadyNAS OS 6 Software Manual, which is available at https://netgear.com/support/product/ReadyNAS_OS_6

Shutting Down Using the Power Button If the Status Screen is NOT Lit

1 Press the power button on the front panel of the system. The status screen will display.

2 Press the power button a second time. Instructions for graceful shutdown will display on the status screen.

3 Press the power button a third time. The system will shut down gracefully.

Shutting Down Using the Power Button If the Status Screen is Lit

1 Press the power button on the front panel of the system. Instructions for graceful shutdown will display on the status screen.

2 Press the power button again. The system will shut down gracefully.

Shutting Down:Forced Method

Perform a forced shutdown only if the storage system is not responding. To perform a forced shutdown:

Press and hold the power button on the front panel of the system for five seconds.

The LEDs will blink quickly and simultaneously to warn that power will be cut off forcibly. Then, the system will shut down.

Using theReadyNAS Local

Admin Page

For information about using the ReadyNAS local admin page, see the ReadyNAS OS 6 Software Manual, which is available at https://netgear.com/support/product/ReadyNAS_OS_6

Page 11: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 2-1

2 Getting Started

Provisioning The Wasabi Ball Transfer Appliance has four ports in total:

Two 1 GbE LAN (management) ports

These 1 GbE ports also can be used as data ports for the customer who has only a 1 GbE network.

Two 10 GbE LAN (data) ports

Refer to the figure on the next page for a rear view of the Appliance. It is recommended but not required to use a different port for management versus data transfer.

Page 12: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 2-2

Rear Panel ReadyNAS628X

1. Exhaust fan

2. Power cable socket

3. Power switch

4. Kensington lock

5. eSATA port

6. USB 3.0 ports

7. 1 GbE LAN ports with LED status indicators

8. 10 GbE LAN ports with LED status indicators

9. Reset button

10. Micro USB console connector (marked as UART)

Page 13: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 2-3

IP Address By default, the Appliance is configured for DHCP. If you connect the two ports (one 1 GbE for management and one 10 GbE for data transfer) into the DHCP-capable network, both should acquire an IP address from different subnets. The IP address should be displayed on the front LED display. If the display is blank, press the power button behind the front door to turn on the Appliance.

Wasabi configures the second IP interface (LAN2) as a static 192.168.100.100 address for users who are not running DHCP on the management network. Use LAN1 (1 GbE) for DHCP. Or, use LAN2 (1 GbE) for the static IP 192.168.100.100.

To use a static IP, you can cross-connect to the Appliance on LAN2, use the default credentials to ssh into the Appliance, and make changes as needed.

Host: 192.168.100.100

Username: root

Password: Wasabi123!

Once in the Appliance, you can use ifconfig to assign it a static IP.

The following command will set the IP address to the eth2 10G interface.ifconfig eth2 10.1.1.1 netmask 255.255.255.0

NOTE: The IP address configured using this method is not persistent on a reboot. You can use the Netgear UI to configure a Static IP as well which stays persistent on a reboot. Log in to the NetGear UI:

User: admin

Password: Wasabi123!

Proceed to the Network tab to configure a static IP address on the appropriate interface.

wasabi$ ssh root@Ip_Address

[email protected]'s password:

Welcome to ReadyNASOS 6.10.0

Last login: Tue May 7 11:02:11 2019 from 10.6.140.8

root@wasabiball34:~# ifconfig eth2 10.1.1.1 netmask 255.255.255.0

root@wasabiball34:~# ifconfig eth2

Page 14: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 2-4

eth2 Link encap:Ethernet HWaddr b0:b9:8a:44:2c:f2

inet addr:10.1.1.1 Bcast:10.1.1.255 Mask:255.255.255.0

UP BROADCAST MULTICAST MTU:1500 Metric:1

RX packets:0 errors:0 dropped:0 overruns:0 frame:0

TX packets:0 errors:0 dropped:0 overruns:0 carrier:0

collisions:0 txqueuelen:1000

RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)

Supported FileSystems

The Wasabi Ball Transfer Appliance supports the following file system interfaces:

AFP (Apple File Protocol) DLNA (Digital Living Network Alliance) FTP (File Transfer Protocol) HTTP (Hypertext Transfer Protocol) NFS (Network File Service) Rsync SMB (Server Message Block)

Mounting theWasabi Ball Transfer

Appliance

Wasabi Ball supports both NFS and S3 applications for uploading objects to the Wasabi Ball. The mount point needed to write data is:

/Volume1/wasabi

Be sure to mount using one of the 10G interfaces, if available.

If you use an S3 application, the mount point needed to write data is:

/Volume1/wasabi-S3

Mounting for NFSUploads

You can add directories under /Volume1/wasabi. For example:mkdir /Volume1/wasabi/mystuff

All data copied to this directory will be uploaded to your account in the specified bucket.

Page 15: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 2-5

Mounting for S3Uploads

You should upload the data set to /Volume1/wasabi-s3. For example:mkdir /Volume1/wasabi-s3/mystuff

All data copied to this directory will be uploaded to your account in the specified bucket.

The Wasabi Ball supports either a NFS file upload to the Appliance or a S3 file upload to the device. You must use one OR the other.

You should consult with the appropriate transfer method to determine the correct procedure to choose for the upload.

It is important to understand that if your local storage is on a S3 supported platform and you want to main-tain the Metadata on those files, it is highly recommended to continue to use the same method to the Wasabi Ball.

If you simply copy the data assets from a NFS Volume or SMB Share, that data set will be uploaded from the Wasabi Ball to your account as S3 Objects.

Page 16: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 3-1

3 Transferring Data

Transferring Data tothe Wasabi Ball

Transfer Appliance

Once the Appliance is mounted, the transfer process can begin. All data should be transferred to the mount point:

/Volume1/wasabi

For transfer using the S3 application, the data should be transferred to:

/Volume1/wasabi-s3

Any data added to the mount point will be added to the single specified bucket, preserving the folder hierar-chy.

Preparing Your S3Client for Uploads to

the Wasabi BallAppliance

The default bucket on the Wasabi Ball is:

/Volume/wasabi-s3

Users can create buckets under that prefix. Wasabi automatically strips the prefix /Volume/wasabi-s3 from the Object ID.

Example:

/Volume/wasabi-s3/mybucket

Page 17: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 3-2

Wasabi BallCredentials

The Wasabi Ball appliance ships with its own set of S3 credentials. The access/secret key is required in the S3 client configuration to communicate with the Wasabi Ball Appliance.

You can obtain the required Access key and Secret key using the following procedure:

ssh root@WB_IP_Address

password Wasabi123!

cd /etc/default

cat minio

Capture the Access key and Secret key as shown in the result. For example:

MINIO_ACCESS_KEY=KIs81POL1LOls8LlvWPc

MINIO_SECRET_KEY=/dsP/dZa/qP9zGImTtYv4KX63WSL798T9b8xBWl8

Wasabi BallConnectionParameters

In order to authenticate and connect to the Wasabi Ball to upload your data from your S3 source to the Wasabi Ball, you need to enter the correct destination address for the S3 target.

NOTE: The default S3 server configuration is:

HTTPPort 9000

If you need to use HTTPs and/or port 80, note the following:

The correct destination address, by default requires you to specify the UDP Port as shown below.

S3 Target/Destination address:

http://WB_IP_Address:9000

Configure the provided WB Access key/Secret key credentials and connect.

Additional Wasabi BallConfiguration

Parameters

Enabling HTTPS (443) on the Wasabi Ball Appliance

Complete the following procedure to enable HTTPS (443) on the Wasabi Ball Appliance. This will allow port 443 (a common default port required for some S3 applications) to be used.

Page 18: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 3-3

1 ssh into the device, as described above.

2 Run enable_tls.sh on the Target Wasabi Ball ssh shell:

/usr/local/bin# enable_tls.sh

3 systemctl stop apache2.

4 Add the following line to the /etc/default/minio file:

MINIO_OPTS="--address :443"

5 systemctl restart minio.

6 If the Wasabi Ball is rebooted, you need to repeat Steps 2 and 4.

7 Run systemctl restart minio.

Wasabi Ball can now be used with HTTPs on port 9000.

When the HTTPs option is enabled, the S3 client needs to be configured to "disable the SSL certificate check."

Disabling HTTPS (443) on the Wasabi Ball Appliance

Complete the following procedure to disable HTTPS (443) on the Wasabi Ball Appliance:

1 ssh into the WB linux shell.

2 Delete the files /root/.minio/certs/public.crt and /root/.minio/certs/private.key

3 Restart the minio server "systemctl restart minio"

Page 19: Wasabi Ball Transfer Appliance

Wasabi Ball Transfer Appliance Getting Started Guide, Version 2020-11-24, Revision C 3-4

Transferring Datafrom the Wasabi Ball

Transfer Appliance

Once the Appliance arrives at Wasabi’s data center, Wasabi will begin the transfer process to get your files into your account. To achieve this, Wasabi will need to be able to access your account via an Access key. Using the Wasabi Console, create a sub-user account for Wasabi to access your account with read/write per-missions for the specific bucket(s) to which you would like Wasabi to integrate the transferred files.

Click here for detailed instructions as to how to create a sub-user account and provision access.

Wasabi Ball S3 ServerCredentials

If you plan to use an S3 application to upload data to the Wasabi Ball, you will need to use the Wasabi Ball S3 Server Key Set for your S3 application to authenticate to the Wasabi Ball S3 server. The Wasabi Ball S3 Server Keys are emailed to you upon ordering a Wasabi Ball for the transfer device.

Encrypting Data You can opt to encode data with AES 256-bit volume-based encryption before sending it to Wasabi.

Wasabi will send you an encryption key via email or on a USB drive. If the key is sent via email, copy it to a USB drive.

Insert the USB drive in Wasabi Ball and back up your data.

Page 20: Wasabi Ball Transfer Appliance

About This Guide

This guide provides a quick overview of basic Wasabi features with procedures for new and prospective users.

Content Information in this guide is subject to change without notice. Companies, names, and data used in examples herein are fictitious unless otherwise noted. No part of this guide may be reproduced or transmitted in any form by means electronic or mechanical, for any purpose, without express written permission of Wasabi Technologies.

Technical Support The Wasabi web site has the latest product information. Use this resource to review product information, download software updates, contact technical support, access the Wasabi knowledge base, or provide feed-back on Wasabi documentation and online help:

https://wasabi.com/help

Use this email address to contact a Wasabi Customer Support representative:

[email protected]