Caringo Drive

Caringo Drive is a virtual drive to make vast Swarm scale-out object storage accessible by systems running macOS and Windows. Once you install it locally, you can drag and drop files up to Swarm-based cloud storage, and you can view files from Swarm directly on your PC or Mac.

Release Notes

Note the following known issues and watch items:

• With Windows 7, if you cannot Disconnect a Caringo Drive from File Explorer, click Eject Drive in the Caringo Drive application instead. 

Supported Operating Systems

Caringo Drive supports the following operating systems:

• Windows Vista and newer (including 64-bit and Windows Server installations)

• macOS (Mac OS X) 10.7 and newer

Preparing the Swarm environment

To support Caringo Drive, make these changes to your Swarm environment:

1. Swarm does not do SSL by default, so install an SSL offloader such as HAProxy.

2. Configure Gateway for S3 and verify the S3 bindPort uses the default (80). See Gateway Configuration.

3. Verify each Swarm domain to be mapped is reachable using a nameserver. This can be a DNS nameserver supporting *.example.com notation (such as through a BIND9 file) or using an entry in the /etc/hosts file:

   1. Right-click Notepad and choose Run as administrator.

   2. Open the hosts file: c:\Windows\System32\Drivers\etc\hosts

   3. Add your entry, such as 172.30.28.109 my.test.domain

   4. Choose File > Save, and reboot to apply the changes.

Creating the S3 tokens

Drives map directly to domains. Before setting up Caringo Drive on a PC or Mac, create an S3 Token for each domain to be mapped using Caringo Drive.

1. From the Content UI, browse to a domain to be mapped and view its Settings (gear icon).

2. Create a token to authorize the domain mapping.

   1. From the toolbar, select Tokens.

   2. Select Add, and enter a helpful Description to identify the token.

   3. Select a duration for the token from the Expiration Date drop-list.

   4. (required) Enable S3 Secret Key, adding a custom (friendly) key string, if desired.

   5. Save the token.

   6. Copy all token information into a secure document when the Success message appears. Refer to this during drive mapping.

3. Repeat for each domain for which you need to map a drive.

Installing on macOS

1. Download Caringo Drive for macOS from Caringo Connect (connect.caringo.com).

2. Unpack CaringoDrive.zip.

3. Move Caringo Drive.app to the Applications folder.

4. Launch Caringo Drive.

5. Open the Caringo Drive Settings.

6. Create a mapping to a Swarm domain for your Mac by entering the following information:

   • Server: Name of the Caringo domain to be mapped

   • Access Key (Token) ID

   • S3 Secret Key

7. Repeat for each additional domain to be mapped.

Installing on Windows

1. (optional) Temporarily disable antivirus software that may interfere with installation.

2. Download Caringo Drive for Windows from Caringo Connect (connect.caringo.com).

3. Run the CaringoDriveSetup.exe file.

4. Launch Caringo Drive.

5. Open the Caringo Drive Settings.

6. Create a mapping to a Swarm domain for your PC by entering the following information:

   • Server: Name of the Swarm domain to be mapped

   • Access Key (Token) ID

   • S3 Secret Key

7. Repeat for each additional domain to be mapped.

Usage Notes

• Once a subfolder contains content, it cannot be renamed, due to the S3 API.

Troubleshooting

1. Verify you have the correct version, which is Caringo Drive v6.3.0 or higher.

2. Locate the logs:

   1. Click the Settings icon.

   2. Select View Logs.

   3. Click Reveal to see the log directory.

3. Important: Enable DEBUG logging. (See the Logs Tab in Managing Chassis and Drives.)

4. Send DataCore Support logs from the Gateway(s), including any files rolled over during usage:

   • /var/log/caringo/cloudgateway_audit.log

   • /var/log/caringo/cloudgateway_server.log

5. Disable DEBUG logging.