Table of Contents
Mac Apps Legacy (deprecated)
last updated on: Sept. 7, 2021
See also Mac Tools Release Notes (Legacy), File Fabric Mac Tools Packager Legacy (deprecated)
Supported Operating Systems: The File Fabric certifies its Mac Application against the last two versions of OSX. Currently this is Big Sur (11.5.1) and Catalina (10.15.7).
1-2 Overview and Installation
The File Fabric Cloud Apps provide a suite of tools that can be used as a means of interacting with one or more cloud storage providers directly from Mac OSX. User can choose to use the entire suite or choose which of the tools fit their working patter. The Apps include:
- A 'Cloud Drive' directly accessible from Finder which provide a 'view' and download on demand of remote files.
- A local-to-remote folder mapping App to sync files off-line.
- An OSX menu bar 'Search App' that functions like a cloud spotlight search for quickly finding / sharing / downloading remote cloud files.
- An OSX Mail plug-in that enables secure file links to be added to Mac Mail. (a similar toolbar option is provided for those who use Outlook or other Mac email providers).
- Finder integration for file sharing and other actions.
The virtual drive feature makes use of a technology known as OSXFuse which is installed as part of the setup. This is seamless unless you have MacFuse already installed. If this is the case then may be prompted to upgrade MacFuse before installing the Mac Cloud Apps. If you are using an existing App with MacFuse then be sure to choose to use the compatibility layer and remove the existing MacFuse installation. You can also check for later versions from the SME advanced tab accessible using System Preferences.
What is OSXFuse ?
OSXFuse is an open source library to enable the development of Mac OSX file systems. You can find out more about OSXFuse here.
The setup is available from download after web login from the Cloud Apps link on the right sidebar (for paid customers) or from the Partner Support Portal for Enterprise customers.
As part of the setup a third party application knows as OSXFuse is installed to enable the virtual drive element. Users will be prompted to install this when they step through the installer process. If users have a prior or incorrect version of FUSE already installed, users may be prompted to upgrade to the latest version.
Users can uninstall the tools from the uninstaller in the same DMG. Note this will remove the File Fabric Applications, Preferences panel and all settings.
Please note the restrictions and caveats that need to be understood when installing / using the Cloud Drive on OSX.
In general the File Fabric Apps should install fine on M1 Macs but we have had a small percentage of reports in which they can only be installed by Disabling System Integrity Protection on the M1 Mac. This is likely due to some machine specific configuration or security option which needs SIP to be disabled for the MACFUSE Kernel extension to be installed.
In this case to disable SIP:
- Reboot your Mac into Recovery Mode by restarting your computer and holding down Command+R until the Apple logo appears on your screen.
- Click Utilities > Terminal.
- In the Terminal window, type in csrutil disable and press Enter.
- Restart your Mac.
Once launched try to install the File Fabric Mac App suite again. Note that you may need to click “allow” in the security prefpane.
Once complete SIP can be re-enabled.
Once installed you will see a new System Preferences option called SME. The pane will auto-launch on first install.
4 Preferences Configuration Screen
An existing File Fabric user account is needed to login to the Mac Apps. When launched proceed to login using a File Fabric username and password. Once logged in configuration options are available.
Synchronization can be enabled if offline folders are required.
In the next few sections we'll cover what each of these options do.
5 Advanced Options
The Advanced option tab enables you to:
1. if files are encrypted on remote Cloud(s) a decryption password can be entered to automatically decrypt on download.
2. For a secure connection to the File Fabric please ensure “run over https” is checked.
3. The API endpoint should never be changed unless instructed by SME Support.
4. Decide how want to handle file deletions on sync. There are three choices.
5. Decide which hidden files or extensions you wish to ignore on Sync
6. The 'clear virtual drive cache' resets the virtual drive cache. This can be useful if there are any 'ghost' entries or to reset the view.
7. The 'Check Fuse Installation' button is a way to check and upgrade to the latest version of OSXFuse.
8. The “Stop all Tools” button forces all running tools and services to stop.
9.'The virtual drive cache expires after n seconds' - When a user requests a directory listing in Finder by, for example, navigating to a folder, Finder passes the request on to the Drive. The Drive may already have a cached copy of the directory listing. If so, the Drive will return that copy to Finder for display unless the Drive's copy is older than the number of seconds configured here. If the Drive's copy is older than the number of seconds (or if the Drive doesn't have a cached directory listing for the folder) then the Drive will ask the File Fabric for the directory listing. It will then cache this listing and return it to Finder.
6 Cloud to Desktop Sync Option
Cloud to Desktop Sync enables files and folder from the Mac desktop to be automatically synchronised with remote Cloud(s), and vice-versa. If new files are added to local sync folders then these are sync'd up to the cloud when the next sync occurs. Similarily if files are added to the remote clouds, these are sync'd down.
To enable Cloud/Desktop sync check the “Enable automatic synchronisation” checkbox. Once this is checked sync folders can be specified by clicking the “Setup” button.
7 Adding desktop sync folders part 1
There are two modes for working with the Cloud Apps. One is to work with local files and have them sync'd back to the Cloud. The second is to work with files that are stored on the Cloud.
Sync Folders represent the former in which users can map local folders to Cloud Folders and files that are stored on the desktop are regularly sync'd back to the Cloud.
Clicking the “Setup” button for Sync takes users to the above screen. If folders have never previously been added users will need to click the “+” to map the first sync folder request between the cloud and the desktop.
8 Adding desktop sync folder part 2
When adding a cloud folder to be synchronised with the desktop users should select the folders that they want to pair up. Ideally one of the folders will be empty (either on the cloud or the desktop), if they are not then users can choose to merge files.
Users may think that they have selected an empty folder on the desktop or the cloud and still be asked merge files. Why ? There are often hidden files that users cannot see, which is why this message occurs.
9 Adding desktop sync folder part 3
Once a folder pair has been added then all files from the cloud will be sync'd down and any files added later to this folder will be sync'd up to the cloud. This can be done with as many folder combinations are required.
Users can also set how often the sync should be ran. Choosing “Often” runs the sync every 5 minutes and the other sync times are self-descriptive.
10 Sync toolbar menu options
The sync toolbar menu options let you:
- Open the desktop cloud folders to view files
- Force a desktop / cloud sync
- Open the Sync console
- View the Sync console to monitor the sync
11 Sync Console
The Sync Console is available as a menu option so that users can see in more details what files are being synchronized. It also displays other logging information and can be useful to get a more detailed view of what is occurring in real-time.
12 Sync Quick Upload
Other than using the Sync Tools and the virtual drive there is another mechanism to quickly 'drop' files for upload.
Once you set an upload directory for quick upload files in the SME System Preferences panel you can choose to drag a file onto the sync icon and it will be automatically uploaded to the directory you set. After upload a sharing URL will be copied to the clipboard also.
This can be useful if you choose to only use the Sync tools and not the drive and want to upload files quickly and get a shared URL.
13 Mac Cloud Drive
The Cloud Drive is a drive mount to files on different clouds. It is available directly from Finder and the command line and it presents a “view” of files that are stored on remote clouds mapped to an account. The Cloud Drive can be enabled from the system preferences panel.
- Enable Virtual Drive: Simply governs whether the drive is active and displayed on the menu bar
- Start drive automatically: Choosing this option will make the drive available on reboot. However if you don't choose it, that is fine, you can choose to mount the drive from the toolbar.
- Enable Finder Service: Choosing to enable the SME Service enables right click options so that you can perform actions on files from within finder. See the Cloud File Actions section for more details.
14 Cloud Drive Mounting
When the preferences panel is “On” and then closed, the drive is mounted if automatic mounting is checked. Otherwise the drive need to be mounted manually from the toolbar.
The drive will initialise and then mount and the status of this will be displayed to the user.
Once mounted a new finder window that displays the drive, and the drive may appear on the Finder sidebar depending on the version of OSX. If it does not appear on the sidebar you can simply drag it to devices and a shortcut is created.
The first time you access a cloud directory, especially if there are many files in a directory then it can take time to create the initial view.After this the view is cached and navigation should be fairly instant.
You can also access the drive directly from Terminal: cd /Volumes/SME_VDrive
Note: The Mac OS also treat files that have “.” in their name differently. It does some extra parsing to check whether they are applications or not which can take some extra time.
Note: The Finder can request that some files are downloaded as it needs more information to do its indexing. This is outside of the control of SME and such files are then cached locally.
Note: If you have files you have encrypted on the File Fabric the same decryption password will be used for the drive as is used for the sync which you can set in the preferences panel.
15 Drive toolbar options
There are a number of options that you can access from the toolbar for the Cloud Drive. You can choose to:
- Hide Progress Dialog: Hides the dialog you see on uploads etc
- Open Drive in Finder: Takes the user to the drive within Finder
- Refresh drive view: Refreshes the meta data on the Fiel Fabric with the underlying primary Cloud. You should not really need to use this as the File Fabric will automatically do this every 10 minutes.
- View Console: Launches the Drive console which provides more details on operations
- Stop/ Start Drive: Stops or Starts the Drive
- Real-Time update: Rather than using caching it turns on real-time updates which means each data stream is pulled in real-time from the end provider for each call. This will be significantly slower than using the drive in normal mode.
- Move file to trash when deleted: Lets you decide whether files you delete are instantly deleted on your mapped cloud or moved to the File Fasbric's Trash folder, in which case they are not removed from the underlying cloud until the Trash folder is emptied.
16 Uploading / Copying files with the Drive
When files are uploaded or copied to the drive what actually happens is that they are added to a cache and then background uploaded to the remote cloud. This kicks in after around 20 seconds. Y
User will see a status in the top right hand side of the screen as to the current status of the files being uploaded and also how many files remain. If users quit the OS session before all files are uploaded or have a crash next time users mount the drive the files will continue to be uploaded.
If the network drops or the mac is closed again the drive will auto-mount and resume the upload once the network re-connects or the mac is opened with a network available.
Users will sometimes see the Cloud Drive refreshing the local cache it keeps of any files downloaded to ensure the latest versions of the files are either uploaded or downloaded from the local cache.
17 Search Integration
Menu Bar Search can be added by choosing to enable it from the SME system preferences.
Once enabled all data can easily be search and subsequently shared or downloaded from the Mac Menu Bar.
18 Enabling Finder integration
Once the virtual drive is enabled and mounted enable special Finder services are available on right click for Cloud Files.
19 Mail Plugin
The Mail Plugin can be turned on from system preference→SME. A new icon is added to the new mail messages or reply mail messages toolbar that enables the user to send secure links instead of files.
For Outlook or for other OSX Mail clients then the 'status bar sharing tool' can be used as an alternative. It can be turned on from System Preferences→SME→General Options and Tools→Share Tools.
20 Sending links
Once the SME icon is clicked users can choose to pick an existing file and generate a link or upload a new file which after completion inserts a link.
There are icons to refresh the view, take the user to the root folder (home) and also to create a new folder.
By default the last view the user opened will be the view shown when the SME file sharing icon is clicked.
21 Creating Secure file share links
Secure file share links can be created by specifying the additional options for each files share:
1. Set a link expiry:
2. Add a password: This will take the user to a page where the must enter a password before the can download a file.
22 Editing files in realtime
Many users want to treat the Cloud Drive as they would any other drive. That means choosing to preview files, and double click to edit files for example. This is fine, you can do this and, for example, when you preview a file the file will be downloaded and cached locally.
Editing documents should also work in most cases. Applications like MS Office on Mac, for example, have to be explicitly coded for as they implement locks and temporary files that don't naturally fit well with offline Cloud Storage. If you do come across an App that you have issues with, please contact us and we'll do our best to support it.
Note: For Omnigraffle files saved directly to the drive users must select to the file as a flat file as by default the Omnigraffle file is save as a folder structure which works fine on local Mac Drive's but not on remote networks.
23 Finder View
Due to the way in which OS X handles thumbnailing, the only view currently enabled in the drive is tree view. This prevents excessive downloading of content, reducing bandwidth.
If you switch views then due to the way the Mac OS works it will try and download files or elements of files to create a thumbnail view and this can cause excessive download and slowness in loading.
You can uninstall the tools from the uninstaller in the same PKG. Note this will remove the preference panel and all settings.
For certain providers we are unable to get the file size after the first cloud sync. This is because they either do not provide file sizes, such as OneDrive, or they store files in internal formats so the file size is unknown, such as Google. The Mac OS cannot handle zero file sizes so for files such as this they are given a special file type which is that of a web location or .webloc. These files, when you try and download or copy will launch a web browser and download the file. This will only happen once. On the first download the file size is known so the next time
Many Clouds have policies around character support in filenames. If your files contain any of the following characters:
? [ ] / \ = + < > : ; “ , * |
Then the files may not be uploaded. Many Clouds actually don't give a rejection response in their API for such files so although they may appear to upload they will not be uploaded. Please ensure you don't use such characters in filenames that you wish to store on the Cloud.
Warning: If you are in icon view rather than list view Finder pulls down data to build the icons. This can take longer to view the file lists until this caching is done.
Also note that Finder may download some file types on demand if it requires further information about them. This is an idiosyncracy of the Finder in Mac and it affects very few file types, but if you have this problem you can zip the files in question to prevent this occurring.
OSXFuse: It is not unknown for OSXFFuse to crash. If you experience this problem you can stop and restart the tools. You should also check whether you are running the recommended version of OSXFuse and also whether you are running the latest version of the Cloud Tools.
Anti-Virus: If you are using anti-virus software with the Mac please make sure to exempt the Mac Drive location otherwise the performance will be slow and in some cases this may cause crashes. The drive provides a virtual view, there are no real files there and so the anti-virus makes remote network requests to try and access and dowlnoad the files for virus scanning which negates the whole purpose of having such a cloud drive.
Other FUSE Based Apps If you use any other FUSE based Apps that use a different version or different FUSE bases subsystem then this may conflict with the Drive.
Any file you move from the drive to a local location can be scanned still if only the drive is exempted from any anti-virus software.
CloudDav CloudDAV is not supported for use with Mac OS X Finder's “add server” feature and CloudDAV will reject attempts by Finder to connect.