Warning: Undefined array key 5 in /var/www/inc/parser/xhtml.php on line 224

Cloud Drive for Mac (Mac Drive)

last updated on: Nov 29, 2023

About the Cloud Drive

The Mac Drive uses Apple's File Provider technology.

Initial Install

After logging in be sure to enable the Cloud Drive and watch out for subsequent prompts when you launch Mac Finder.

Functionality

Current

All basic file and folder operations are supported:

  • Creating folders
  • Copying folders
  • Moving folders
  • Renaming folders
  • Deleting folders
  • Creating files (upload)
  • Updating files (upload)
  • Copying files
  • Moving files
  • Renaming files
  • Deleting files

Also supported:

  • Locking
  • File Sharing
  • Marking files/folders to download (cloud icon)
  • Offline Use
  • M-Stream support
  • Pre-configuring the Access Anywhere endpoint

Embedded External File References

Many applications, for example: AutoCAD, Word and Excel, allow references to other files to be embedded in their respective document file types. Where these paths are relative to the main document, they will often but not always be found and loaded successfully when the main document is opened in its editor (e.g. AutoCAD for .dxf files) from the Cloud Drive. Absolute paths can also work in some circumstances, but some configuration may be required to achieve this. For help with specific cases please contact Support. Note that the only solution in some cases may be to update the internal references to the external files.

Drive Operation

The drive can be accessed under “Locations” from the Mac Finder. Users or applications can browse through the drive, opening and editing documents.

Metadata Cache

File and folder metadata is cached the first time a folder is accessed speeding up subsequent access.

If this folder is open within a Finder window the drive will periodically check with the server for updated metadata.

File Cache

Files that are opened through the Finder or by applications are automatically downloaded by the drive into local cache. If a file is already in cache the drive checks to see if a later version is available on the server and downloads it if needed.

An icon within finder shows if the file is available in the cloud but not downloaded, or if an update has been made to the file but not yet uploaded. No icon is shown for items that are cached locally.

MacOS manages the file cache and will remove (aka expire) files from cache to free up space.

Locking

Some file types that are opened through the drive are locked. This is indicated with red lock in Finder.

The Mac Drive currently supports automatic locking for:

  • MS Office — .docx and .pptx
  • PDF — When opened with Preview
  • Text Files — When opened with TextEdit
  • Adobe Indesign — When Indesign opens and updates the file's last accessed time.

Files can also be locked and unlocked via the Finder “Quick Actions” menu for a file.

Files and folders can be shared from within Finder through the “Quick Actions” menu “Share With Email or URL”.

Spotlight

File names are indexed by Spotlight and become searchable from the desktop when the folder containing the files becomes visible in the Cloud Drive. Similarly, file content will be indexed by Spotlight until the file has been downloaded to the desktop.

This behavior (files being indexed by Spotlight and returned by desktop searches, whether by name or contents) can be prevented by adding the ~/Library/CloudStorage to the Spotlight search exclusions list on the Privacy tab of the Spotlight settings.

Offline Access

Files and folders downloaded to the drive are available for read & write access when no network connection is present, or the server is not accessible. The user can browse folders with items not available offline since metadata is also cached.

To download a file or folder use the Finder menu to “Download Now”.

When the server connection is re-established, changes that have been made are synchronized. This includes new, updated and renamed files and folders. Local changes that have not been uploaded are indicated with a cloud icon with an exclamation point.

If a file or folder was modified while offline but the parent folder had been deleted that parent folder is recreated so that the modified information is not lost.

Conflict Scenarios

Same file changed by offline user and online user: Offline user’s file should be renamed in the format:. Budget - Conflict - Jo Smyth Macbook Pro.xlsx.

Enterprise Deployments

Version 2.1 and greater enables IT Administrators to configure the Mac Drive via commercial provisioning software, like JAMF. The available configuration options are:

Key Value(s) Purpose
endpoint https://naa.example.com API Endpoint for NAA installation
restrictEndpoint true or false Defines if users can override the default endpoint value. Default false
AllowSelfUpgrade true or false Defines if automatic upgrade is allowed by the user. Default true

Customers wishing to deploy these, should deploy these as a Plist-based configuration profile to the end-user devices.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
	<dict>
		<key>endpoint</key>
		<string>https://naa.example.com</string>
		<key>restrictEndpoint</key>
		<false/>
		<key>AllowSelfUpgrade</key>
		<true/>
	</dict>
</plist>

This configuration should be pushed to the following Preference Domain:

com.vehera.storagemadeeasy.enterprisefilefabric

Instructions for installing the above Plist file onto end-user devices will vary by the software you are using. An example of configuration with JAMF can be found here: https://docs.jamf.com/technical-articles/Deploying_Custom_Configuration_Profiles_Using_Jamf_Pro.html

Troubleshooting

Application Logs

Logs can be accessed from Settings > About > Open Logs Directory.

To open the logs from the terminal:

 open "$HOME/Library/Containers/com.vehera.storagemadeeasy.enterprisefilefabric.StorageMadeEasyProvider/Data/Library/Logs/Nasuni Access Anywhere Provider"