Cyberduck

Language:

The following sections provide example information to help you install, configure, and use the Cyberduck S3 compatible browser. For additional information about this S3 compatible browser, refer to the official Cyberduck web site.

Note - Cyberduck is a libre multiple storage protocol browser for Apple Macintosh and Microsoft Windows.

Installation: Cyberduck

Download and install the appropriate version from the official Cyberduck web site.

Configuration Example: Cyberduck

The configuration is based on a Cyberduck client on Windows 10. The default Cyberduck S3 profile does not support the Oracle ZFS Storage Appliance S3 API. An Oracle ZFS Storage Appliance cyberduck profile template must be created manually. See the following examples:

Oracle ZFS Storage Appliance S3 (HTTPS) Cyberduck Profile:

The Oracle ZFS Storage Appliance S3 (HTTPS) Cyberduck profile uses S3 signature v4 (recommended version).

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>Protocol</key>
        <string>s3</string>
        <key>Vendor</key>
        <string>s3-https</string>
        <key>Scheme</key>
        <string>https</string>
        <key>Description</key>
        <string>S3 (HTTPS)</string>
        <key>Default Port</key>
        <string>443</string>
        <key>Hostname Configurable</key>
        <true/>
        <key>Port Configurable</key>
        <true/>
        <key>Context</key>
        <string>/s3/v1/export/SHARE</string>
    </dict>
</plist>

Oracle ZFS Storage Appliance AWS2 Signature Version (HTTPS) Cyberduck Profile:

The Oracle ZFS Storage Appliance AWS2 Signature Version (HTTPS) Cyberduck profile uses S3 signature v2.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>Protocol</key>
        <string>s3</string>
        <key>Vendor</key>
        <string>s3-aws2-https</string>
        <key>Scheme</key>
        <string>https</string>
        <key>Description</key>
        <string>S3 AWS2 Signature Version (HTTPS)</string>
        <key>Default Port</key>
        <string>443</string>
        <key>Hostname Configurable</key>
        <true/>
        <key>Port Configurable</key>
        <true/>
        <key>Authorization</key>
        <string>AWS2</string>
        <key>Context</key>
        <string>/s3/v1/export/SHARE</string>
    </dict>
</plist>

In both templates, you need to change "SHARE" in the "Context" keyword to the share that has s3 service enabled. For example, you can change it to /s3/v1/export/S3_enabled_share.

<key>Context</key>

<string>/s3/v1/export/S3_enabled_share</string>

Cyberduck GUI-based Configuration:

Double-click the profile file you just created. An S3 configuration dialog box appears.
In the S3 configuration dialog box, specify the server address that points to the appliance. For example, appliance_hostname.example.com
In the S3 configuration dialog box, click Close. An S3 bookmark for the Oracle ZFS Storage Appliance system appears.
Double-click the bookmark. A Login dialog box appears.
In the Login dialog box, specify the required Access Key and Secret Keys, then click Login.

You have successfully logged in to your Cyberduck S3 account.

Usage: Cyberduck

Cyberduck works as a file explorer, enabling you to browse Amazon S3 storage service such as a hard disk.