Cyberduck Mountain Duck CLI

Changes between Version 95 and Version 96 of help/en/howto/mount/issues


Ignore:
Timestamp:
May 25, 2021 10:36:59 AM (5 months ago)
Author:
lvogt
Comment:

Restructured Page

Legend:

Unmodified
Added
Removed
Modified
  • help/en/howto/mount/issues

    v95 v96  
    3737== Known Issues ==
    3838
    39 === Finder.app does not show files prefixed with `.` on remote volumes ===
    40 You can work around this by setting `defaults write com.apple.finder AppleShowAllFiles YES` in a ''Terminal.app'' window and restart ''Finder.app'' using '' → Force Quit… → Finder → Relaunch''. If you are running macOS Sierra (10.12) you can choose `⌘⇧.` to toggle files starting with a dot to show in Finder.app.
    41 
    42 === Performance issues in  ''Finder.app'' rendering preview  ===
    43 We suggest disabling the option ''View → Show View Options →  Show Icon Preview (⌘-J)'' in ''Finder.app'' and choose ''Use as Defaults''.
    44 
    45 === ~~Saving a file in TextEdit.app will attempt to create a folder `/Temporary Items` on the remote volume. On some servers, this may fail due to a permission failure or because the name of the folder is not allowed as in S3.~~ ===
    46 
    47 ~~You will get the error message `Bucket name is not DNS compatible. Please contact your web hosting service provider for assistance.`.~~
    48 As of version [https://mountainduck.io/changelog/ 2.1], .DS_Store files are only saved in a temporary location and not stored on the mounted remote volume.
    49 
    50 === Writing files to S3 compatible third party service provider may fail ===
    51 The S3 interoperable service must support [http://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html multipart uploads].
    52 
    53 === ~~In Finder.app, creating a new top-level folder in S3 fails with `Interoperability failure. Bucket name is not DNS compatible. Please contact your web hosting service provider for assistance.`~~ ===
    54 ~~A bucket name in S3 cannot have whitespace in the filename. Because a new folder created with Finder.app is named `Untitled Folder` the operation fails. As a workaround, create a new bucket with `mkdir` in ''Terminal.app''.~~ As of version [https://mountainduck.io/changelog/ 2.2] the new bucket is created only after renaming in Finder. Make sure to choose a filename with no whitespace.
    55 
    56 === ~~In Finder.app, creating a new top-level folder in OpenStack Swift will not allow to rename it from `untitled folder`~~ ===
    57 ~~Because OpenStack Swift does not allow to rename containers this operation will fail.~~ As of version [https://mountainduck.io/changelog/ 2.2] the new bucket is created only after renaming in Finder. Make sure to choose a filename with no whitespace.
    58 
    59 === Multiple OpenStack Swift containers in different regions with the same name ===
    60 Browsing containers will be erratic. As a workaround, browse a region by using a [https://trac.cyberduck.io/wiki/help/en/howto/profiles connection profile] limited to a single region as with [https://trac.cyberduck.io/wiki/help/en/howto/cloudfiles#Profilesforasingleregion Rackspace Cloudfiles region profiles].
    61 
    62 === Mounted volumes do not appear on the Desktop ===
    63 Navigate to volumes using ``⌘⇧-C `` in a ''Finder.app'' window or choose ''Finder → Preferences… → General → Show these items on the desktop: Connected Servers'' to make the volume appear on the Desktop. Mounted volumes are also listed in the ''Finder.app'' sidebar in ''Favorites''.
     39=== Can only open single PDF in Adobe Acrobat Reader ===
     40This is a known bug in Adobe Acrobat Reader when opening documents from a network volume. As a workaround uncheck ''edit → Preferences… → Security (Enhanced) → Enable Protected Mode at startup.''
     41
     42 * Adobe Documentation [https://helpx.adobe.com/reader/11/using/protected-mode-windows.html Protected mode (Windows)]
     43
     44=== rsync fails with error ===
     45If your server does not accept the creation of `.` temporary files you might need to add the `--inplace` when running `rsync`.
     46
     47=== High CPU usage when working with Sublime Text ===
     48When working with Sublime Text we recommend turning off indexing by adding the following setting to your user preferences in Sublime Text.
     49
     50{{{
     51    "index_files": false
     52}}}
     53
     54=== Sharing a mounted drive in local network ===
     55It is not possible to share a mounted drive within the local network.
    6456
    6557=== Changes from server not immediately visible ===
    6658The directory listing in ''Finder.app'' or ''File Explorer'' may become out of date when another application is adding, removing, or modifying files on the server. You can force ''File Explorer'' to refresh the directory listing with `F5`. On the Mac, choose ''Reload'' from the [wiki:help/en/howto/mount#FinderExtensionWindowsFileExplorerExtension Finder Extension] menu. Enable ''Sync → Index files'' in Preferences to look for remote file changes every 10 minutes.
    6759
    68 === Search in Finder.app (Spotlight) ===
    69 The Spotlight indexer does not work on remote volumes.
    70 
    71 === Windows Search Indexer ===
    72 The Windows Search indexer does not work on network drives.
    73 
    74 === 0 byte files on WebDAV server ===
    75 If you are running an Apache configuration make sure to disable `fastcgi` and `php-fpm`. Refer to our [[issues/fastcgi|best practice for Nextcloud and ownCloud installations]].
    76 
    77 === ~~Additional `._*` files saved on remote volume~~ ===
    78 ~~The `._*` files contain metadata about the file some applications write in addition to the file content. On macOS, this metadata can be stored alongside the file on the filesystem, but on remote volumes, with no metadata support, an auxiliary file is created to contain this information. You can delete metadata on files using `xattr -d <filename>`.~~~
    79 
    80 As of version [https://mountainduck.io/changelog/ 2.1],  extended attributes are only saved in a temporary location and not stored on the mounted remote volume. If you want to revert to saving extended attributes to the server, enter in a ''Terminal.app'' window
    81 
    82 {{{
    83 defaults write io.mountainduck fs.filenames.metadata.enable false
    84 }}}
    85 
    86 If you want to delete metadata files, you can open a Terminal.app window and enter `dot_clean -m <folder>`
    87 
    88 === File permissions reset when saving file (SFTP) ===
    89 Mountain Duck will forward all permission changes done by Finder or the editing application to the SFTP server. There is a hidden preference to disable the writing of permissions. On macOS, enter in a Terminal.app window
    90 
    91 {{{
    92 defaults write io.mountainduck fs.setattr.chmod false
    93 }}}
    94 
    95 to disable. Make sure to quit Mountain Duck before making the change and then re-open the application.
    96 
    97 === File owner reset when saving file (SFTP) ===
    98 Some editors save files using an ''Atomic Save'' feature that writes changes to a file to a temporary file later replacing the edited file by renaming the temporary file to the name of the edited file. This works well on local filesystems, where there is support to retain the owner of the file that is different from the editing user using a special [https://developer.apple.com/legacy/library/documentation/Darwin/Reference/ManPages/man2/exchangedata.2.html function call]. This does not work for volumes mounted with Mountain Duck and the file owner will be reset to the default owner for new files created on the server by the logged-in user. As a workaround, try to find a setting for the editor to disable the ''Atomic Save'' feature.
    99 
    100 See also
    101  * [https://github.com/textmate/textmate/blob/master/Applications/TextMate/about/Changes.md#atomic-saving TextMate].
    102 
    103 
    104 === File Locks with vsftpd ===
    105 Set the property `lock_upload_files=NO` in ''vsftpd_conf''.
    106 
    107 === rsync fails with error ===
    108 If your server does not accept the creation of `.` temporary files you might need to add the `--inplace` when running `rsync`.
    109 
    110 === High CPU usage when working with Sublime Text ===
    111 When working with Sublime Text we recommend turning off indexing by adding the following setting to your user preferences in Sublime Text.
    112 
    113 {{{
    114     "index_files": false
    115 }}}
    116 
    117 === Sharing a mounted drive in local network ===
    118 It is not possible to share a mounted drive within the local network.
    119 
    120 === Cache uses a lot of disk space on the system drive ===
    121 The cache directory is located in `%LocalAppData%\Cyberduck\Cache` by default. You can choose another disk for storage of files to be stored in the local cache. You can clear files cached on local disk with the ''Delete on local disk'' [wiki:help/en/howto/mount/sync#DeleteonLocalDisk context menu] option.
     60=== Cache uses a lot of disk space ===
     61The cache directory is located in `%LocalAppData%\Cyberduck\Cache` on Windows or in `~/Library/Group Containers/G69SCX94XU.duck/Library/Application Support/duck` on macOS by default. You can [wiki:help/en/howto/mount/preferences#SyncCacheLocation choose another disk] for storage of files to be stored in the local cache. You can clear files cached on local disk with the ''Delete on local disk'' [wiki:help/en/howto/mount/sync#DeleteonLocalDisk context menu] option.
    12262
    12363[[Image(Custom Location Sync Cache.png, 600px)]]
    12464
    125 === Enable application icon in Dock (macOS) ===
    126 As a utility application with no application windows, no icon is displayed in the Dock but only in the system status bar. If you want to enable the application icon to appear in the Dock set the following property
    127 {{{
    128 defaults write io.mountainduck application.dock.icon.enable true
    129 }}}
    130 
    131 === Original document can't be changed (Preview.app) ===
    132 Files opened in Preview.app and edited cannot be saved at the original location but the message "The original document can't be changed, so a duplicate with your changes has been created" is displayed in the title bar. As a workaround, you can set a custom mount point in ''Preferences → Connection → Mount Location'' for volumes such as a `~/Volumes/` folder in your home directory.
    133 
    134 === Missing sync status icons in Windows Explorer ===
    135 Windows has a limitation on the number of applications that can register for badge icons in File Explorer. You will need to either uninstall other applications or edit your registry key `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers`.
    136 
    137 You can find this well documented by Microsoft at [https://support.office.com/en-us/article/sync-icon-overlays-are-missing-from-onedrive-and-onedrive-for-business-b25070ab-2226-4ad8-b1fc-ae28cc44ecd2 Sync icon overlays are missing].
    138 
    139 === Missing sync status icons in Finder ===
     65=== Missing sync status icons ===
     66{{{#!html
     67<ul class="nav nav-tabs" style="display: flex;">
     68    <li class="active"><a href="#tabpanel-macos-2" data-toggle="tab">macOS</a></li>
     69    <li><a href="#tabpanel-windows-2" data-toggle="tab">Windows</a></li>
     70</ul>
     71}}}
     72{{{#!div class="tab-content"
     73
     74{{{#!div class="tab-pane active" id="tabpanel-macos-2"
     75
     76=== Finder ===
    14077When you have other applications installed that register a Finder Extension (macOS) for the volume mounted, the status icon may not appear. This has been reported for the following applications:
    14178  * ''Araxis Merge''
     
    14582Please check-in ''System Preferences → Extensions → Finder'' for other applications that may override the badge icons.
    14683
     84}}}
     85
     86{{{#!div class="tab-pane" id="tabpanel-windows-2"
     87
     88=== Windows Explorer ===
     89Windows has a limitation on the number of applications that can register for badge icons in File Explorer. You will need to either uninstall other applications or edit your registry key `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers`.
     90
     91You can find this well documented by Microsoft at [https://support.office.com/en-us/article/sync-icon-overlays-are-missing-from-onedrive-and-onedrive-for-business-b25070ab-2226-4ad8-b1fc-ae28cc44ecd2 Sync icon overlays are missing].
     92
     93}}}
     94
     95}}}
     96
     97=== Operating system specific issues ===
     98{{{#!html
     99<ul class="nav nav-tabs" style="display: flex;">
     100    <li class="active"><a href="#tabpanel-macos-3" data-toggle="tab">macOS</a></li>
     101    <li><a href="#tabpanel-windows-3" data-toggle="tab">Windows</a></li>
     102</ul>
     103}}}
     104{{{#!div class="tab-content"
     105
     106{{{#!div class="tab-pane active" id="tabpanel-macos-3"
     107
     108[[TOC()]]
     109
     110=== Finder.app does not show files prefixed with `.` on remote volumes ===
     111You can work around this by setting `defaults write com.apple.finder AppleShowAllFiles YES` in a ''Terminal.app'' window and restart ''Finder.app'' using '' → Force Quit… → Finder → Relaunch''. If you are running macOS Sierra (10.12) you can choose `⌘⇧.` to toggle files starting with a dot to show in Finder.app.
     112
     113=== Original document can't be changed (Preview.app) ===
     114Files opened in Preview.app and edited cannot be saved at the original location but the message "The original document can't be changed, so a duplicate with your changes has been created" is displayed in the title bar. As a workaround, you can set a custom mount point in ''Preferences → Connection → Mount Location'' for volumes such as a `~/Volumes/` folder in your home directory.
     115
     116=== Enable application icon in Dock ===
     117As a utility application with no application windows, no icon is displayed in the Dock but only in the system status bar. If you want to enable the application icon to appear in the Dock set the following property
     118{{{
     119defaults write io.mountainduck application.dock.icon.enable true
     120}}}
     121
     122=== Mounted volumes do not appear on the Desktop ===
     123Navigate to volumes using ``⌘⇧-C `` in a ''Finder.app'' window or choose ''Finder → Preferences… → General → Show these items on the desktop: Connected Servers'' to make the volume appear on the Desktop. Mounted volumes are also listed in the ''Finder.app'' sidebar in ''Favorites''.
     124
     125=== Search in Finder.app (Spotlight) ===
     126The Spotlight indexer does not work on remote volumes.
     127
     128=== Solved Issues ===
     129==== ~~Additional `._*` files saved on remote volume~~ ====
     130~~The `._*` files contain metadata about the file some applications write in addition to the file content. On macOS, this metadata can be stored alongside the file on the filesystem, but on remote volumes, with no metadata support, an auxiliary file is created to contain this information. You can delete metadata on files using `xattr -d <filename>`.~~~
     131
     132As of version [https://mountainduck.io/changelog/ 2.1],  extended attributes are only saved in a temporary location and not stored on the mounted remote volume. If you want to revert to saving extended attributes to the server, enter in a ''Terminal.app'' window
     133
     134{{{
     135defaults write io.mountainduck fs.filenames.metadata.enable false
     136}}}
     137
     138If you want to delete metadata files, you can open a Terminal.app window and enter `dot_clean -m <folder>`
     139
     140}}}
     141
     142{{{#!div class="tab-pane" id="tabpanel-windows-3"
     143
     144[[TOC()]]
     145
    147146=== Missing files in Windows Explorer ===
    148147Windows has a limitation on the maximum path length. It might happen that Mountain Duck exceeds this maximum for long filenames when trying to create placeholders in the local cache. If Mountain Duck is unable to create a placeholder file for a remote file it will not appear in the Windows Explorer listings.
     
    155154Please refer to [https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation Maximum Path Length Limitation].
    156155
    157 === Can only open single PDF in Adobe Acrobat Reader ===
    158 This is a known bug in Adobe Acrobat Reader when opening documents from a network volume. As a workaround uncheck ''edit → Preferences… → Security (Enhanced) → Enable Protected Mode at startup.''
    159 
    160  * Adobe Documentation [https://helpx.adobe.com/reader/11/using/protected-mode-windows.html Protected mode (Windows)]
     156=== Windows Search Indexer ===
     157The Windows Search indexer does not work on network drives.
    161158
    162159=== Windows sessions ===
     
    168165==== A Windows service has no access to a mounted drive ====
    169166See Windows sessions above. Services do not have access to logged-in user drives.
     167
     168}}}
     169
     170}}}
    170171
    171172== Interoperability ==
     
    175176 * ''Bitnami ownCloud''. PHP-FPM is enabled by default in virtual machines and Ubuntu-based cloud images but must be disabled for uploads to complete. Refer to  [https://wiki.bitnami.com/Components/PHP-FPM#How_to_disable_PHP-FPM How to disable PHP-FPM] and [#a0bytefilesonWebDAVserver 0 byte files on WebDAV server].
    176177
    177 === Server Configurations ===
    178 ==== mod_evasive ====
    179 Deployments with WebDAV on Apache HTTP server with the ''mod_evasive'' module may block requests leading to permission failures with `403` HTTP errors returned by the server.
    180  
    181178=== Third party software ===
    182179==== Kaspersky Internet Security ====
     
    189186May interfere with installation.
    190187
    191 === Time Machine ===
     188=== Backups ===
     189{{{#!html
     190<ul class="nav nav-tabs" style="display: flex;">
     191    <li class="active"><a href="#tabpanel-timemachine-1" data-toggle="tab">Time Machine (macOS)</a></li>
     192    <li><a href="#tabpanel-windowsbackup-1" data-toggle="tab">Windows Backup</a></li>
     193</ul>
     194}}}
     195{{{#!div class="tab-content"
     196
     197{{{#!div class="tab-pane active" id="tabpanel-timemachine-1"
     198
    192199Backups to Time Machine do not work with volumes mounted from Mountain Duck. Time Machine requires disks mounted using Apple File Protocol (AFP). See [https://support.apple.com/en-us/HT202784 Backup disks you can use with Time Machine].
    193200
    194 === Windows Backup ===
     201}}}
     202
     203{{{#!div class="tab-pane" id="tabpanel-windowsbackup-1"
     204
    195205Volumes mounted with Mountain Duck cannot be used by ''Windows Backup''. It can only save backups on destinations that are located within your local system or within your local network.
    196206
    197 == Bug Reports ==
    198 Please open a ticket from [https://mountainduck.io/help/].
    199 
    200 === Provide logging output ===
    201 
    202 {{{#!html
    203 <ul class="nav nav-tabs" style="display: flex;">
    204     <li class="active"><a href="#tabpanel-macos-2" data-toggle="tab">macOS</a></li>
    205     <li><a href="#tabpanel-windows-2" data-toggle="tab">Windows</a></li>
    206 </ul>
    207 }}}
    208 {{{#!div class="tab-content"
    209 
    210 {{{#!div class="tab-pane active" id="tabpanel-macos-2"
    211 
    212 * ''macOS 10.8'' or later. Choose ''Preferences → Connection → Log → Show in Finder'' and copy the output.
    213 * ''macOS 10.12'' or later. Choose ''Preferences → Connection → Log → Show'' and copy the output out of the terminal window.
    214 
    215 The log output can also be found in ''Console.app'' (Open from ''/Applications/Utilities''). When requested, enable info and debug messages from ''Action → Include Info Messages'' and ''Action → Include Debug Messages'' respectively. Filter output by pasting `Mountain Duck` in the search input field in the toolbar of the window and choose ''Process'' in the small dropdown menu. Choose ''Edit → Select All'' and ''Edit → Copy'' to copy the output to the clipboard.
    216 
    217 Alternatively, if you are familiar with ''Terminal.app'' you can get the current log output streamed with
    218 
    219 {{{
    220 log stream --predicate '(process =="Mountain Duck")' --level debug
    221 }}}
    222 
    223 }}}
    224 
    225 {{{#!div class="tab-pane" id="tabpanel-windows-2"
    226 
    227 Choose ''Preferences → Connection → Log → Show'' and attach the selected file `%AppData%\Cyberduck\mountainduck.log`.
    228 
    229 }}}
    230 
    231 }}}
     207}}}
     208
     209}}}
     210
     211=== Bug Reports and Feature Requests ===
     212To get help with bugs, feature requests, or other issues please refer to the [wiki:help/en/support support page].