Cyberduck Mountain Duck CLI

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


Ignore:
Timestamp:
Apr 28, 2021 12:59:11 PM (5 months ago)
Author:
svogt
Comment:

Edit tabs

Legend:

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

    v94 v95  
    55== Performance Considerations ==
    66To reduce the number of requests to the remote server for mounted volumes, we recommend the following settings when running in ''Online'' connect mode.
     7{{{#!html
     8<ul class="nav nav-tabs" style="display: flex;">
     9    <li class="active"><a href="#tabpanel-macos-1" data-toggle="tab">macOS</a></li>
     10    <li><a href="#tabpanel-windows-1" data-toggle="tab">Windows</a></li>
     11</ul>
     12}}}
     13{{{#!div class="tab-content"
     14
     15{{{#!div class="tab-pane active" id="tabpanel-macos-1"
     16
    717=== Finder.app ===
    818 * Enable ''View → Show Status Bar'' (⌘-/)
     
    1121 * ''Finder → Preferences… → General → Show these items on the desktop: Connected servers''
    1222
     23}}}
     24
     25{{{#!div class="tab-pane" id="tabpanel-windows-1"
     26
    1327=== Windows Explorer ===
    1428Choose ''File Explorer → Folder Options''.
     
    1731 * Uncheck ''Show preview handlers in preview pane''
    1832
     33}}}
     34
     35}}}
     36
    1937== Known Issues ==
    20 === ~~Finder.app will write .DS_Store files to the remote volume~~ ===
    21 ~~You can workaround this with setting `defaults write com.apple.desktopservices DSDontWriteNetworkStores -string true` in a ''Terminal.app'' window and restart ''Finder.app'' using '' → Force Quit… → Finder → Relaunch''.~~~
    22 
    23 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.
    2438
    2539=== Finder.app does not show files prefixed with `.` on remote volumes ===
    26 You can workaround this with 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.
     40You 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.
    2741
    2842=== Performance issues in  ''Finder.app'' rendering preview  ===
    29 We suggest to disable the option ''View → Show View Options →  Show Icon Preview (⌘-J)'' in ''Finder.app'' and choose ''Use as Defaults''.
    30 
    31 === ~~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.~~ ===
     43We 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.~~ ===
    3246
    3347~~You will get the error message `Bucket name is not DNS compatible. Please contact your web hosting service provider for assistance.`.~~
     
    3751The S3 interoperable service must support [http://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html multipart uploads].
    3852
    39 === ~~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.`~~ ===
     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.`~~ ===
    4054~~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.
    4155
    42 === ~~In Finder.app, creating a new top level folder in OpenStack Swift will not allow to rename it from `untitled folder`~~ ===
     56=== ~~In Finder.app, creating a new top-level folder in OpenStack Swift will not allow to rename it from `untitled folder`~~ ===
    4357~~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.
    4458
     
    5064
    5165=== Changes from server not immediately visible ===
    52 The directory listing in ''Finder.app'' or ''File Explorer'' may become out of date when another applications 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.
     66The 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.
    5367
    5468=== Search in Finder.app (Spotlight) ===
     
    6276
    6377=== ~~Additional `._*` files saved on remote volume~~ ===
    64 ~~The `._*` files contain metadata about the file some application 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>`.~~~
     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>`.~~~
    6579
    6680As 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
     
    8296
    8397=== File owner reset when saving file (SFTP) ===
    84 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.
     98Some 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.
    8599
    86100See also
     
    94108If your server does not accept the creation of `.` temporary files you might need to add the `--inplace` when running `rsync`.
    95109
    96 ===  ~~Warning when copying or moving files from network drive~~ ===
    97 ~~Depending on your trusted sites settings you might see a warning dialog with the message ''These files might be harmful to your computer'' when trying to copy or move files and folders from a mounted network drive to your local computer. To make Windows trust your remote storage you need to add the hostname of your mount to your ''Internet Options''. Please refer to [https://superuser.com/a/149057] for more details.~~
    98 As of version [https://mountainduck.io/changelog/ 2.1] this is no more an issue.
    99 
    100110=== High CPU usage when working with Sublime Text ===
    101111When working with Sublime Text we recommend turning off indexing by adding the following setting to your user preferences in Sublime Text.
     
    114124
    115125=== Enable application icon in Dock (macOS) ===
    116 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
     126As 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
    117127{{{
    118128defaults write io.mountainduck application.dock.icon.enable true
     
    120130
    121131=== Original document can't be changed (Preview.app) ===
    122 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.
     132Files 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.
    123133
    124134=== Missing sync status icons in Windows Explorer ===
     
    128138
    129139=== Missing sync status icons in Finder ===
    130 When you have other applications installed that register a Finder Extension (macOS) for the volume mounted, status icon may not appear. This has been reported for the following applications:
     140When 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:
    131141  * ''Araxis Merge''
    132142  * ''BetterZip''
    133143  * ''Sophos''. Documented in [https://community.sophos.com/kb/en-us/132136 SAV for Mac OS - Sophos Finder Extension Known Issues]
    134144
    135 Please check in ''System Preferences → Extensions → Finder'' for other applications that may override the badge icons.
     145Please check-in ''System Preferences → Extensions → Finder'' for other applications that may override the badge icons.
    136146
    137147=== Missing files in Windows Explorer ===
     
    151161
    152162=== Windows sessions ===
    153 Mountain Duck requires an interactive user logon session. This separation is done to ensure that each user in a multi-user scenario has access to all available Windows drive letters (otherwise this would be limited to 26 drive letters, shared across all users). Bookmarks are mounted in your regular and elevated user session only - there is no way of other logged in users or non-interactive services to access your drive. There are no persistent mounts created for anyone to use and cannot work across user sessions - mounts for user A are not visible nor accessible by user B even on the same machine.
     163Mountain Duck requires an interactive user logon session. This separation is done to ensure that each user in a multi-user scenario has access to all available Windows drive letters (otherwise this would be limited to 26 drive letters, shared across all users). Bookmarks are mounted in your regular and elevated user session only - there is no way for other logged-in users or non-interactive services to access your drive. There are no persistent mounts created for anyone to use and cannot work across user sessions - mounts for user A are not visible nor accessible by user B even on the same machine.
    154164
    155165==== Windows Task Scheduler script cannot see the mounted drive ====
     
    157167
    158168==== A Windows service has no access to a mounted drive ====
    159 See Windows sessions above. Services do not have access to logged in users drives.
     169See Windows sessions above. Services do not have access to logged-in user drives.
    160170
    161171== Interoperability ==
     
    171181=== Third party software ===
    172182==== Kaspersky Internet Security ====
    173 Make sure to uninstall Kaspersky Internet Security with its kernel extensions causing kernel panics prior mounting a volume.
     183Make sure to uninstall Kaspersky Internet Security with its kernel extensions causing kernel panics prior to mounting a volume.
    174184==== Eset Cyber Security Pro ====
    175185Make sure not connections on the loopback interface are blocked.
     
    189199
    190200=== Provide logging output ===
    191 ==== Windows ====
    192 Choose ''Preferences → Connection → Log → Show'' and attach the selected file `%AppData%\Cyberduck\mountainduck.log`.
    193 ==== Mac ====
     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
    194212* ''macOS 10.8'' or later. Choose ''Preferences → Connection → Log → Show in Finder'' and copy the output.
    195213* ''macOS 10.12'' or later. Choose ''Preferences → Connection → Log → Show'' and copy the output out of the terminal window.
     
    197215The 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.
    198216
    199 Alternatively if you are familiar with ''Terminal.app'' you can get the current log output streamed with
     217Alternatively, if you are familiar with ''Terminal.app'' you can get the current log output streamed with
    200218
    201219{{{
    202220log stream --predicate '(process =="Mountain Duck")' --level debug
    203221}}}
     222
     223}}}
     224
     225{{{#!div class="tab-pane" id="tabpanel-windows-2"
     226
     227Choose ''Preferences → Connection → Log → Show'' and attach the selected file `%AppData%\Cyberduck\mountainduck.log`.
     228
     229}}}
     230
     231}}}