+ jungledisk - Jungle Disk Desktop Command Line Interface
+ jungledisk mountpoint [options]
+ jungledisk command-line-only daemon was designed for headless servers
+ and/or for use in fstab and cron jobs. jungledisk supports file
+ system mounting via FUSE, as well as automatic backup.
+ Please note that Jungle Disk Desktop CLI does not support Backup Vaults or Sync
+ -h/--help print this help
+ -v/--version print version
+ -V/--verbose verbose mode (only valid with -f)
+ -b/--startbackups start all backup jobs
+ -f run in foreground (default is daemon)
+ --startbackup <name|guid> start a single backup job
+ --listbackups list all configured backups
+ --listbuckets/--listonlinedisks list all configured buckets
+ -x/--exit exit when idle for 1 minute
+ --exitdelay <minutes> exit after X idle minutes
+ --config <filename> use the specified configuration file
+ -o opt[,opt...] additional FUSE mount options
+ jungledisk does not provide a configuration interface and must be
+ provided with a valid configuration file. We do not recommend creating
+ your configuration by hand. Instead, use junglediskmonitor on another
+ machine with a GUI, and copy the config file to your server.
+ If you do not have a Linux Desktop machine available, you can
+ use the "USB" version of the Mac or Windows Jungle Disk Client to
+ create a configuration file to use on your server. You cannot use
+ a configuration file from the non-USB versions on Mac or Windows,
+ as they encrypt their settings in a way that is not readable on Linux.
+ The configuration file can be placed in $HOME/.jungledisk, or in
+ /etc or another path, and you can specify the path to the file on
+ Although less reliable than FUSE, you can also access the disk
+ via any WebDAV client: http://localhost:2667
+ The WebDAV interface to Jungle Disk is optional with the command
+ line version. You can disable it by setting the ListenPort to 0 in
+ If you have the WebDAV server enabled, you can view any background
+ operations by loading: http://localhost:2667/~operations via a
+ You can mount your filesystem via the fstab file by adding a line
+ such as the one below (note how the path to the config file is
+ specified as part of the FUSE options.)
+ Sample fstab file entry:
+ jungledisk /mnt/jungle \\
+ fuse noauto,config=/path/to/jungledisk-settings.xml 0 0
+ You can then mount your filesystem with "mount /mnt/jungle", or place
+ this command somewhere in your boot process to mount the filesystem
+ at boot time (after the network comes up).
+ Note: jungledisk will mount all of your online disks that have been
+ configured with mount points. The first mount point will be set to
+ the one specified in fstab, but the remaining network drives will
+ be mounted as found in your settings file.
+ jungledisk MUST be in your path to mount via fstab. Also, you
+ must ensure that the FUSE module is loaded on boot. This varies by
+ distribution. Some common ones:
+ $ echo "fuse" >> /etc/modules
+ $ echo "fuse" >> /etc/modules.autoload.d/kernel-2.6
+ $ echo "/sbin/modprobe fuse" >> /etc/rc.local
+ Edit /etc/sysconfig/kernel and add "fuse" to the MODULES_LOADED_ON_BOOT
+ By default the mounted path will only be available to the user who
+ If you want to allow root or other users to access the mount you
+ need to use the FUSE options "-o allow_root" or "-o allow_other". You
+ may also need to set the umask, as in "-o umask=007".
+ These parameters can be specified in fstab or on the command line:
+ jungledisk /mnt/mountpoint fuse defaults,noauto,user, \\
+ config=/path/to/jungledisk-settings.xml,allow_other,umask=007 0 0
+ $ jungledisk /mnt/mountpoint \\
+ -o rw,umask=007,allow_other,default_permissions
+ Alternatively, you can configure FUSE options in the configuration
+ file after the mountpoint path (similar to the way it is done on the
+ command line). This approach is particularly useful when mounting
+ multiple disks, since only the first disk will pick up the extra
+ FUSE options specified on the command line or in fstab.
+ To allow the options to work for non-root users, be sure to add
+ the option "user_allow_other" to your /etc/fuse.conf file.
+ Once running and mounted on the local file system, you can use rsync
+ to easily copy files to and from your S3 storage. Most rsync options
+ should work fine, however for best performance we recommend using
+ the --inplace option which avoids extra renames.
+ You should also use the --times (-t) option so that modification
+ times are replicated and used to detect changes. If you prefer not
+ to replicate modification times, you may want to use --checksum (-c)
+ or --size-only to prevent files from being re-copied on every run.
+ Jungle Disk can preserve symlinks, devices, group/owner/permissions,
+ and modification/creation times if those options are
+ specified. Currently, hard-links are not supported.
+ Copy all files and attributes(times/permissions/owners/links/etc)
+ $ rsync -a --inplace /src/* /mnt/jungle
+ Copy only normal files and preserve modification times
+ $ rsync -t -r --inplace /src/* /mnt/jungle
+ Copy only file data and use size to determine changes
+ $ rsync -r --size-only --inplace /src/* /mnt/jungle
+ Sample jungledisk command line arguments:
+ $ jungledisk -df --config /etc/jungledisk-settings.xml
+ $ jungledisk /mnt/cloudstorage --config /etc/settings.xml
+ $ jungledisk -o allow_other
+ jungledisk logs all errors to /var/log/jungledisk.log when running
+ as root, and ~/.jungledisk/jungledisk.log when running as non-root.
+ Make sure you check the log file if your disk does not mount properly.
+ Jungle Disk includes several optimizations to improve performance
+ by delaying network activity until needed. In most cases this is
+ transparent to applications.
+ By default, Jungle Disk also assumes that when an application opens
+ a file using the O_WRONLY mode it intends to write the entire file,
+ so the previous file contents are not downloaded. This assumption
+ holds true for many, but not all applications.
+ The following signals are supported by Jungledisk:
+ SIGHUP Reload configuration
+ SIGQUIT Exits gracefully
+ Manual written by Erik Southworth; referenced from usage and INSTALL file.
+ Copyright (c) 2010 Jungle Disk, LLC. This is non-free software:
+ see the LICENSE file included with the software for copying conditions.
+ Copyright (c) 2010 Erik Southworth This is free documentation:
+ copying and distribution of this file, with or without modification,
+ are permitted in any medium without royalty provided the copyright
+ notice and this notice are preserved.
+ junglediskdesktop(1) rsync(1)
+ Support Site http://support.jungledisk.com
+ FUSE Filesystem http://fuse.sourceforge.net
+ See also the INSTALL file for some useful tips and tricks.