Cyberduck Mountain Duck CLI

Version 95 (modified by svogt, on Apr 28, 2021 at 12:59:11 PM) (diff)

Edit tabs

Table of Contents

  1. Performance Considerations
  2. Known Issues
    1. Finder.app does not show files prefixed with . on remote volumes
    2. Performance issues in Finder.app rendering preview
    3. Saving a file in TextEdit.app will attempt to create a folder …
    4. Writing files to S3 compatible third party service provider may fail
    5. In Finder.app, creating a new top-level folder in S3 fails with …
    6. In Finder.app, creating a new top-level folder in OpenStack Swift …
    7. Multiple OpenStack Swift containers in different regions with the same name
    8. Mounted volumes do not appear on the Desktop
    9. Changes from server not immediately visible
    10. Search in Finder.app (Spotlight)
    11. Windows Search Indexer
    12. 0 byte files on WebDAV server
    13. Additional ._* files saved on remote volume
    14. File permissions reset when saving file (SFTP)
    15. File owner reset when saving file (SFTP)
    16. File Locks with vsftpd
    17. rsync fails with error
    18. High CPU usage when working with Sublime Text
    19. Sharing a mounted drive in local network
    20. Cache uses a lot of disk space on the system drive
    21. Enable application icon in Dock (macOS)
    22. Original document can't be changed (Preview.app)
    23. Missing sync status icons in Windows Explorer
    24. Missing sync status icons in Finder
    25. Missing files in Windows Explorer
    26. Can only open single PDF in Adobe Acrobat Reader
    27. Windows sessions
      1. Windows Task Scheduler script cannot see the mounted drive
      2. A Windows service has no access to a mounted drive
  3. Interoperability
    1. Hosting Service Providers
    2. Server Configurations
      1. mod_evasive
    3. Third party software
      1. Kaspersky Internet Security
      2. Eset Cyber Security Pro
      3. Bitdefender
      4. Sophos Endpoint Protection
    4. Time Machine
    5. Windows Backup
  4. Bug Reports
    1. Provide logging output

Help / Howto / Mountain Duck / Known Issues

Performance Considerations

To reduce the number of requests to the remote server for mounted volumes, we recommend the following settings when running in Online connect mode.

Finder.app

  • Enable View → Show Status Bar (⌘-/)
  • Choose View → Hide Preview (⌘⇧-P)
  • Disable View → Show View Options → Show icon preview
  • Finder → Preferences… → General → Show these items on the desktop: Connected servers

Windows Explorer

Choose File Explorer → Folder Options.

  • Check Always show icons, never thumbnails
  • Check Display File Icon on thumbnails
  • Uncheck Show preview handlers in preview pane

Known Issues

Finder.app does not show files prefixed with . on remote volumes

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.

Performance issues in Finder.app rendering preview

We suggest disabling the option View → Show View Options → Show Icon Preview (⌘-J) in Finder.app and choose Use as Defaults.

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.

You will get the error message Bucket name is not DNS compatible. Please contact your web hosting service provider for assistance.. As of version 2.1, .DS_Store files are only saved in a temporary location and not stored on the mounted remote volume.

Writing files to S3 compatible third party service provider may fail

The S3 interoperable service must support multipart uploads.

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.

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 2.2 the new bucket is created only after renaming in Finder. Make sure to choose a filename with no whitespace.

In Finder.app, creating a new top-level folder in OpenStack Swift will not allow to rename it from untitled folder

Because OpenStack Swift does not allow to rename containers this operation will fail. As of version 2.2 the new bucket is created only after renaming in Finder. Make sure to choose a filename with no whitespace.

Multiple OpenStack Swift containers in different regions with the same name

Browsing containers will be erratic. As a workaround, browse a region by using a connection profile limited to a single region as with Rackspace Cloudfiles region profiles.

Mounted volumes do not appear on the Desktop

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.

Changes from server not immediately visible

The 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 Finder Extension menu. Enable Sync → Index files in Preferences to look for remote file changes every 10 minutes.

Search in Finder.app (Spotlight)

The Spotlight indexer does not work on remote volumes.

Windows Search Indexer

The Windows Search indexer does not work on network drives.

0 byte files on WebDAV server

If you are running an Apache configuration make sure to disable fastcgi and php-fpm. Refer to our best practice for Nextcloud and ownCloud installations.

Additional ._* files saved on remote volume

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>.~

As of version 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

defaults write io.mountainduck fs.filenames.metadata.enable false

If you want to delete metadata files, you can open a Terminal.app window and enter dot_clean -m <folder>

File permissions reset when saving file (SFTP)

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

defaults write io.mountainduck fs.setattr.chmod false

to disable. Make sure to quit Mountain Duck before making the change and then re-open the application.

File owner reset when saving file (SFTP)

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 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.

See also

File Locks with vsftpd

Set the property lock_upload_files=NO in vsftpd_conf.

rsync fails with error

If your server does not accept the creation of . temporary files you might need to add the --inplace when running rsync.

High CPU usage when working with Sublime Text

When working with Sublime Text we recommend turning off indexing by adding the following setting to your user preferences in Sublime Text.

    "index_files": false

Sharing a mounted drive in local network

It is not possible to share a mounted drive within the local network.

Cache uses a lot of disk space on the system drive

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 context menu option.

Enable application icon in Dock (macOS)

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

defaults write io.mountainduck application.dock.icon.enable true

Original document can't be changed (Preview.app)

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.

Missing sync status icons in Windows Explorer

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.

You can find this well documented by Microsoft at Sync icon overlays are missing.

Missing sync status icons in Finder

When 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:

Please check-in System Preferences → Extensions → Finder for other applications that may override the badge icons.

Missing files in Windows Explorer

Windows 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.

To work around this Windows limitation you can enable long path support in Windows 10 as of version 1607.

  1. Open the Local Group Policy editor (search for Edit Group Policy)
  2. Navigate to Local Computer Policy → Computer Configuration → Administrative Templates → System → Filesystem
  3. Double click the Enable NTFS long paths option and select Enabled

Please refer to Maximum Path Length Limitation.

Can only open single PDF in Adobe Acrobat Reader

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.

Windows sessions

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 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.

Windows Task Scheduler script cannot see the mounted drive

Please make sure you have not checked Run whether user is logged on or not on the scheduled task configuration.

A Windows service has no access to a mounted drive

See Windows sessions above. Services do not have access to logged-in user drives.

Interoperability

Hosting Service Providers

A list of known providers that fail to work with Mountain Duck due to interoperability issues.

Server Configurations

mod_evasive

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.

Third party software

Kaspersky Internet Security

Make sure to uninstall Kaspersky Internet Security with its kernel extensions causing kernel panics prior to mounting a volume.

Eset Cyber Security Pro

Make sure not connections on the loopback interface are blocked.

Bitdefender

Be aware that Bitdefender may interfere with connections.

Sophos Endpoint Protection

May interfere with installation.

Time Machine

Backups to Time Machine do not work with volumes mounted from Mountain Duck. Time Machine requires disks mounted using Apple File Protocol (AFP). See Backup disks you can use with Time Machine.

Windows Backup

Volumes 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.

Bug Reports

Please open a ticket from https://mountainduck.io/help/.

Provide logging output

  • macOS 10.8 or later. Choose Preferences → Connection → Log → Show in Finder and copy the output.
  • macOS 10.12 or later. Choose Preferences → Connection → Log → Show and copy the output out of the terminal window.

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.

Alternatively, if you are familiar with Terminal.app you can get the current log output streamed with

log stream --predicate '(process =="Mountain Duck")' --level debug

Choose Preferences → Connection → Log → Show and attach the selected file %AppData%\Cyberduck\mountainduck.log.

Attachments (2)

Download all attachments as: .zip