MOUNT.CEPH(8) Ceph MOUNT.CEPH(8)NAMEmount.ceph - mount a ceph file system
SYNOPSISmount.ceph monaddr1[,monaddr2,...]:/[subdir] dir [
-o options ]
DESCRIPTIONmount.ceph is a simple helper for mounting the Ceph file system on a
Linux host. The only real purpose it serves is to resolve monitor host‐
name(s) into IP addresses; the Linux kernel client component does most
of the real work. In fact, it is possible to mount a Ceph file system
without mount.ceph by specifying monitor address(es) by IP:
mount -t ceph 1.2.3.4:/ mountpoint
Each monitor address monaddr takes the form host[:port]. If the port is
not specified, the Ceph default of 6789 is assumed.
Multiple monitor addresses can be separated by commas. Only one respon‐
sible monitor is needed to successfully mount; the client will learn
about all monitors from any responsive monitor. However, it is a good
idea to specify more than one in case one happens to be down at the
time of mount.
A subdirectory subdir may be specified if a subset of the file system
is to be mounted.
OPTIONS
wsize int, max write size. Default: none (writeback uses smaller of
wsize and stripe unit)
rsize int (bytes), max readahead, multiple of 1024, Default: 524288
(512*1024)
osdtimeout
int (seconds), Default: 60
osdkeepalivetimeout
int, Default: 5
mount_timeout
int (seconds), Default: 60
osd_idle_ttl
int (seconds), Default: 60
caps_wanted_delay_min
int, cap release delay, Default: 5
caps_wanted_delay_max
int, cap release delay, Default: 60
cap_release_safety
int, Default: calculated
readdir_max_entries
int, Default: 1024
readdir_max_bytes
int, Default: 524288 (512*1024)
write_congestion_kb
int (kb), max writeback in flight. scale with available memory.
Default: calculated from available memory
snapdirname
string, set the name of the hidden snapdir. Default: .snap
name string, used with authx, Default: guest
secret string, used with authx
ip my ip
noshare
create a new client instance, instead of sharing an existing
instance of a client mounting the same cluster
dirstat
funky cat dirname for stats, Default: off
nodirstat
no funky cat dirname for stats
rbytes Report the recursive size of the directory contents for st_size
on directories. Default: on
norbytes
Do not report the recursive size of the directory contents for
st_size on directories.
nocrc no data crc on writes
noasyncreaddir
no dcache readdir
EXAMPLES
Mount the full file system:
mount.ceph monhost:/ /mnt/foo
If there are multiple monitors:
mount.ceph monhost1,monhost2,monhost3:/ /mnt/foo
If ceph-mon(8) is running on a non-standard port:
mount.ceph monhost1:7000,monhost2:7000,monhost3:7000:/ /mnt/foo
To mount only part of the namespace:
mount.ceph monhost1:/some/small/thing /mnt/thing
Assuming mount.ceph(8) is installed properly, it should be automati‐
cally invoked by mount(8) like so:
mount -t ceph monhost:/ /mnt/foo
AVAILABILITYmount.ceph is part of the Ceph distributed file system. Please refer to
the Ceph wiki at http://ceph.newdream.net/wiki for more information.
SEE ALSOceph-fuse(8), ceph(8)COPYRIGHT
2011, New Dream Network
dev September 22, 2011 MOUNT.CEPH(8)