Poster of Linux kernelThe best gift for a Linux geek
MOUNT.CEPH

MOUNT.CEPH

Section: Maintenance Commands (8)
Local index Up
 

NAME

mount.ceph - mount a ceph file system  

SYNOPSIS

mount.ceph monaddr1[,monaddr2,...]:/[subdir] dir [ -o options ]  

DESCRIPTION

mount.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 hostname(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 responsible 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 rbytes for st_size on directories. Default: on

norbytes

Do not report rbytse for st_size.

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 cmon(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 automatically invoked by mount(8) like so:

mount -t ceph monhost:/ /mnt/foo
 

AVAILABILITY

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

cfuse(8), ceph(8)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
AVAILABILITY
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 22:02:00 GMT, April 16, 2011