JungleDisk Desktop / man / jungledisk.man1

  jungledisk - Jungle Disk Desktop Command Line Interface
  jungledisk [options]
  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.

  ** Important **
  Please note that Jungle Disk Desktop CLI does not support Backup Vaults or Sync
  -h/--help                        print this help
  -v/--version                     print version
  -d                               enable debugging
  -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
  the command line.
  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
  the configuration.

  If you have the WebDAV server enabled, you can view any background
  operations by loading: http://localhost:2667/~operations via a
  web browser or curl.
  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:

    Debian / Ubuntu:
      $ 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
  mounted it.
  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
  SIGTERM  Exits
  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 manual, 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
  FUSE Filesystem

  See also the INSTALL file for some useful tips and tricks.