Differences

This shows you the differences between two versions of the page.

--- maccloudtools [2019_05_06 12:49] – jim
+++ maccloudtools [2023_06_22 05:41] – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
+# Mac Apps Legacy (deprecated)
+##### last updated on: Sept. 7, 2021
+See also [[:tools/mac/release-notes]], [[:packagers/macos]]
-====== Storage Made Easy Mac Cloud Apps ======
+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
-===== 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 ?
-{{:/maccloudtools:steps:sme_1_sme_mac_cloud_tools.png}}
+OSXFuse is an open source library to enable the development of Mac OSX file systems. You can find out more about OSXFuse   [[https://osxfuse.github.io/|here]].
-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   [[http://code.google.com/p/macfuse/wiki/FAQ|here]]. \\  \\ Supported Operating Systems:\\ \\ High Sierra and Mojave validated up to 10.14
+Installation:
+{{:/maccloudtools:steps:sme_2_installation.png}}
-Installation:\\ \\ {{:/maccloudtools:steps:sme_2_installation.png}}\\ \\ The setup is available from download after web login from the Cloud Apps link on the right sidebar (for paid customers).\\ \\ As part of the setup we install a technology know as OSXFuse for the virtual drive element. You will be prompted to install this when you install the SME preferences pane, after double clicking to open the package file.. If you have a prior version of Fuse, you may be prompted to upgrade to the latest version.\\ \\ You can uninstall the tools from the uninstaller in the same DMG. Note this will remove the preference panel and all settings.\\ \\
+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.
-===== 3 Setup =====
+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.
-{{:/maccloudtools:steps:sme_3_setup.png}}
+Please [[macclouddrive|note the restrictions and caveats]] that need to be understood when installing / using the Cloud Drive on OSX.
-Once installed you will see a new System Preferences option called SME. The pane will auto-launch on first install\\ \\
+M1 Mac's
+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 [[https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection|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.
-===== 4 Preferences Configurations Screen =====
+In this case to disable SIP:
-{{:/maccloudtools:steps:sme_4_perferences_configur.png}}
+- 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.
-A [[http://StorageMadeEasy.com|Storage Made Easy]] account is needed to use the Mac Apps. When launched proceed to login using a SME username and password. Once logged in configuration options are available.
+Once launched try to install the File Fabric Mac App suite again. Note that you may need to click  “allow” in the security prefpane.
-The default provider lets users set the Primary (default) cloud provider for the cloud drive. Synchronization can be enabled if offline folders are required.
+Once complete SIP can be re-enabled.
-For further details on the Primary Cloud provider please review [[top5things|]].
+===== 3 Setup =====
+{{:/maccloudtools:steps:sme_3_setup.png}}
+Once installed you will see a new System Preferences option called SME. The pane will auto-launch on first install.
+===== 4 Preferences Configuration Screen =====
+{{:/maccloudtools:steps:sme_4_perferences_configur.png}}
+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.
@@ Line 44: / Line 75: @@
 {{:/maccloudtools:steps:sme_5_advanced_options.png}}
-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 SME Cloud Platform 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.  \\ 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.
+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.
@@ Line 66: / Line 97: @@
 ===== 8 Adding desktop sync folder part 2 =====
 {{:/maccloudtools:steps:sme_8_adding_desktop_sync_.png}}
-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.\\ \\ \\
+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.
@@ Line 125: / Line 158: @@
 {{:/maccloudtools:steps:sme_14_cloud_drive_mounting.png}}
-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 SME the same decryption password will be used for the drive as is used for the sync which you can set in the preferences panel.\\
+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 SME Drive toolbar options =====
+===== 15 Drive toolbar options =====
@@ Line 134: / Line 167: @@
 {{:/maccloudtools:steps:sme_15_sme_drive_toolbar_op.png}}
-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 SME Drive in Finder://** Takes the user to the drive within Finder\\ //-// **Refresh drive view:** Refreshes the meta data on SME with the underlying primary Cloud. You should not really need to use this as SME 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 SME Trash folder, in which case they are not removed from the underlying cloud until the Trash folder is emptied.
+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.
@@ Line 196: / Line 229: @@
 {{:/maccloudtools:steps:sme_22_editing_files_in_rea.png}}
-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 [[mailto:%20support@smestorage.com|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.
+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 [[mailto:%20support@storagemadeeasy.com|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.
@@ Line 221: / Line 254: @@
 {{:/maccloudtools:steps:sme_25_note.png}}
-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 SME 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.\\ \\
+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.