Differences

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

--- maccloudtools [2020_07_28 13:38] – jim
+++ maccloudtools [2023_06_22 05:41] – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-# Mac Apps
+# Mac Apps Legacy (deprecated)
-##### Last updated on March 12, 2020 #####
+##### last updated on: Sept. 7, 2021
 See also [[:tools/mac/release-notes]], [[:packagers/macos]]
-Supported Operating Systems: Mojave (10.14) and Catalina (10.15).  An unsupported version of the Mac Tools Cloud Apps for use with Sierra and High Sierra is available on request.
+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
@@ Line 20: / Line 21: @@
 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]].
+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]].
 Installation:
@@ Line 26: / Line 27: @@
 {{:/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).
+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 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.
+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 [[macclouddrive|note the restrictions and caveats]] that need to be understood when installing / using the Cloud Drive on OSX.
+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.
+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.
-You can uninstall the tools from the uninstaller in the same DMG. Note this will remove the preference panel and all settings.
@@ Line 43: / Line 62: @@
 {{:/maccloudtools:steps:sme_4_perferences_configur.png}}
-A [[http://StorageMadeEasy.com|Storage Made Easy]] account is needed to use the Mac Apps. When launched proceed to login using a File Fabric username and password. Once logged in configuration options are available.
+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.
-The default provider lets users set the Primary (default) cloud provider for the cloud drive. Synchronization can be enabled if offline folders are required.
+Synchronization can be enabled if offline folders are required.
-For further details on the Primary Cloud provider please review [[top5things|]].
 In the next few sections we'll cover what each of these options do.
@@ Line 58: / 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 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.  \\ 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 80: / 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 235: / 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 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.