Note:
- This tutorial requires access to Oracle Cloud. To sign up for a free account, see Get started with Oracle Cloud Infrastructure Free Tier.
- It uses example values for Oracle Cloud Infrastructure credentials, tenancy, and compartments. When completing your lab, substitute these values with ones specific to your cloud environment.
Utilize File Browsing Clients with Oracle Roving Edge Infrastructure Object Storage
Introduction
Oracle Roving Edge Infrastructure enables customers to distribute their cloud workloads beyond their Oracle Cloud Infrastructure tenancy to deliver cloud services and run application workloads at retail, satellite, and other edge locations. As a result, customers can process data faster and closer to their users and at the points of data ingestion to generate timely insights from their data.
Oracle Roving Edge Infrastructure Object Storage can be used as a central data repository for edge projects and users. During a military exercise, many participants didn’t have experience using object storage tools such as REST APIs or the Oracle Cloud Infrastructure Command Line Interface (OCI CLI). They were experts in military strategy, and not familiar with cloud storage or cloud APIs. Not everyone is familiar with object storage API’s and prefer interfaces that emulate their desktop or laptop experience.
Supported S3 compatible API’s on Oracle Roving Edge Infrastructure Object Storage enables customers to utilize file browsing clients with familiar interfaces such as WinSCP and CyberDuck. These clients provide users a way to access Roving Edge Infrastructure Object Storage in a way that looks similar to local drives and folders on their laptop.
Audience
Oracle Roving Edge Infrastructure administrators and users.
Objective
Setup a file browsing client to connect to Oracle Roving Edge Infrastructure Object Storage.
Prerequisites
Take the following steps on your Oracle Roving Edge Infrastructure node before working with the WinSCP and CyberDuck clients:
-
Have access to the Oracle Roving Edge Infrastructure node WebUI.
-
Ensure the user has proper Roving Edge Infrastructure Object Storage permissions. If you need help with this, see Object Storage Permissions for Oracle Roving Edge Infrastructure, Common Policies and Policy Reference.
-
Create a customer secret key which consists an access key and secret key pair.
Create a customer secret key in Oracle Roving Edge Infrastructure WebUI:
A Customer Secret Key is an Oracle-provided key for using the Amazon S3 compatible API with Oracle Roving Edge Infrastructure Object Storage. The key consists of a secret key/access key pair.
Note: The secret key is always an Oracle-generated string. you can’t change it to a string of your choice.
-
Login to the Oracle Roving Edge Infrastructure WebUI and navigate to your user settings.
-
Scroll down, notice on the left there will be a link for Customer Secret Keys, click the link, then click the Generate Secret Key.
-
Copy the generated Secret Access key, you will not be able to retrieve the secret key after closing this window.
-
Copy the Access Key ID, it will be used for configuring the file browsing tools.
-
Have the Oracle Roving Edge Infrastructure node host name and IP address ready to configure the client connection to the Oracle Roving Edge Infrastructure Object Storage.
-
Have both the Customer Access Key ID and Customer Secret Access Key ready to configure the client connection to the Oracle Roving Edge Infrastructure Object Storage.
For demonstration purposes, I created a bucket on the Oracle Roving Edge Infrastructure Object Storage called easy-browsing and uploaded a couple of photo files and a text file that displays,
test file
. -
Configure and Use WinSCP on Windows
Task 1: Install WinSCP
-
Download WinSCP, see WinSCP website.
-
Follow the installation directions on the website to install on your desktop or laptop.
Task 2: Configure WinSCP to Connect to Oracle Roving Edge Infrastructure Object Storage
Start the WinSCP application, you will be prompted for a Login to create a new connection, select Amazon S3 from the drop-down menu, enter the Oracle Roving Edge Infrastructure node hostname (or IP address), port 8019, the Customer Access Key ID, and Customer Secret Access Key, click Login.
Explore the WinSCP Interface
WinSCP is an open source free client that provides file transfer between the local Windows host and remote systems such as Oracle Roving Edge Infrastructure Object Storage. The GUI gives users a familiar interface to interact with object storage in a similar was they would local drives and folders.
-
Once logged in, you can see the Oracle Roving Edge Object Storage buckets, click the bucket you wish to explore. In this example, we will explore the easy-browsing bucket created earlier. The buckets are presented as folders.
-
Objects in the bucket are presented as files, the
test.txt
file and two image files uploaded to the bucket are visible. -
Double click the
test.txt
file opens it and displays the contents.
Configure and Use CyberDuck on MacOS
Task1: Install CyberDuck
-
Download CyberDuck, see CyberDuck website.
-
Follow the installation directions on the website to install on your desktop or laptop.
Task 2: Configure CyberDuck to Connect to Oracle Roving Edge Infrastructure Object Storage
-
Start the CyberDuck application and click Open Connection.
-
When the pop-up appears, select S3(HTTPS) from the drop-down menu.
-
Enter the Oracle Roving Edge Infrastructure node IP address or server name, port 8019, the Customer Access Key ID, and Secret Access Key, click Connect.
Explore the CyberDuck Interface
CyberDuck is a convenient cloud storage browser which works on MacOS and Windows to give users a familiar GUI interface to interact with Oracle Roving Edge Infrastructure Object Storage.
-
Once connected, each bucket will be presented as a drive in CyberDuck, the easy-browsing bucket created earlier is the first drive presented along with other buckets on the Oracle Roving Edge Infrastructure Object Storage.
-
Expand the drive to view the objects in the bucket as files, the
test.txt
and the two image files uploaded to the bucket are visible. -
Double click the file name to download it locally, when the download is complete, double click the file name to show it in the local finder.
-
Once downloaded, double click the
test.txt
file opens it and displays the contents.
Related Links
Acknowledgments
Author - Melinda Graham (Senior Principal Product Manager)
More Learning Resources
Explore other labs on docs.oracle.com/learn or access more free learning content on the Oracle Learning YouTube channel. Additionally, visit education.oracle.com/learning-explorer to become an Oracle Learning Explorer.
For product documentation, visit Oracle Help Center.
Utilize File Browsing Clients with Oracle Roving Edge Infrastructure Object Storage
F88227-01
October 2023
Copyright © 2023, Oracle and/or its affiliates.