mirror of https://github.com/ceph/ceph
184 lines
3.3 KiB
Groff
184 lines
3.3 KiB
Groff
.TH MOUNT.CEPH 8
|
|
.SH NAME
|
|
mount.ceph \- mount a ceph file system
|
|
.SH SYNOPSIS
|
|
.B mount.ceph
|
|
\fImonaddr1\fR[,\fImonaddr2\fR,...]:/[\fIsubdir\fR]
|
|
\fIdir\fR
|
|
[ \fB\-o \fIoptions\fR ]
|
|
.SH DESCRIPTION
|
|
.B 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
|
|
.B mount.ceph
|
|
by specifying monitor address(es) by IP:
|
|
.IP
|
|
mount -t ceph 1.2.3.4:/ mountpoint
|
|
.PP
|
|
Each monitor address \fImonaddr\fR takes the form
|
|
\fIhost\fR[:\fIport\fP]. If the port is not specified, the Ceph
|
|
default of \fI6789\fP is assumed.
|
|
.PP
|
|
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.
|
|
.PP
|
|
A subdirectory \fIsubdir\fP may be specified if a subset of the file system is to be
|
|
mounted.
|
|
|
|
.SH OPTIONS
|
|
|
|
wsize
|
|
.IP
|
|
int, max write size. Default: none (writeback uses smaller of wsize and stripe unit)
|
|
.PP
|
|
|
|
rsize
|
|
.IP
|
|
int (bytes), max readahead, multiple of 1024, Default: 524288 (512*1024)
|
|
.PP
|
|
|
|
osdtimeout
|
|
.IP
|
|
int (seconds), Default: 60
|
|
.PP
|
|
|
|
osdkeepalivetimeout
|
|
.IP
|
|
int, Default: 5
|
|
.PP
|
|
|
|
mount_timeout
|
|
.IP
|
|
int (seconds), Default: 60
|
|
.PP
|
|
|
|
osd_idle_ttl
|
|
.IP
|
|
int (seconds), Default: 60
|
|
.PP
|
|
|
|
caps_wanted_delay_min
|
|
.IP
|
|
int, cap release delay, Default: 5
|
|
.PP
|
|
|
|
caps_wanted_delay_max
|
|
.IP
|
|
int, cap release delay, Default: 60
|
|
.PP
|
|
|
|
cap_release_safety
|
|
.IP
|
|
int, Default: calculated
|
|
.PP
|
|
|
|
readdir_max_entries
|
|
.IP
|
|
int, Default: 1024
|
|
.PP
|
|
|
|
readdir_max_bytes
|
|
.IP
|
|
int, Default: 524288 (512*1024)
|
|
.PP
|
|
|
|
write_congestion_kb
|
|
.IP
|
|
int (kb), max writeback in flight. scale with available memory. Default: calculated from available memory
|
|
.PP
|
|
|
|
snapdirname
|
|
.IP
|
|
string, set the name of the hidden snapdir. Default: .snap
|
|
.PP
|
|
|
|
name
|
|
.IP
|
|
string, used with authx, Default: guest
|
|
.PP
|
|
|
|
secret
|
|
.IP
|
|
string, used with authx
|
|
.PP
|
|
|
|
ip
|
|
.IP
|
|
my ip
|
|
.PP
|
|
|
|
noshare
|
|
.IP
|
|
create a new client instance, instead of sharing an existing instance of a client mounting the same cluster
|
|
.PP
|
|
|
|
dirstat
|
|
.IP
|
|
funky `cat dirname` for stats, Default: off
|
|
.PP
|
|
|
|
nodirstat
|
|
.IP
|
|
no funky `cat dirname` for stats
|
|
.PP
|
|
|
|
rbytes
|
|
.IP
|
|
Report the recursive size of the directory contents for st_size on directories. Default: on
|
|
.PP
|
|
|
|
norbytes
|
|
.IP
|
|
Do not report the recursive size of the directory contents for st_size on directories.
|
|
.PP
|
|
|
|
nocrc
|
|
.IP
|
|
no data crc on writes
|
|
.PP
|
|
|
|
noasyncreaddir
|
|
.IP
|
|
no dcache readdir
|
|
.PP
|
|
|
|
|
|
.SH EXAMPLES
|
|
Mount the full file system:
|
|
.IP
|
|
mount.ceph monhost:/ /mnt/foo
|
|
.PP
|
|
If there are multiple monitors:
|
|
.IP
|
|
mount.ceph monhost1,monhost2,monhost3:/ /mnt/foo
|
|
.PP
|
|
If
|
|
.BR cmon (8)
|
|
is running on a non-standard port:
|
|
.IP
|
|
mount.ceph monhost1:7000,monhost2:7000,monhost3:7000:/ /mnt/foo
|
|
.PP
|
|
To mount only part of the namespace:
|
|
.IP
|
|
mount.ceph monhost1:/some/small/thing /mnt/thing
|
|
.PP
|
|
Assuming
|
|
.BR mount.ceph (8)
|
|
is installed properly, it should be automatically invoked by
|
|
.BR mount (8)
|
|
like so:
|
|
.IP
|
|
mount -t ceph monhost:/ /mnt/foo
|
|
.SH AVAILABILITY
|
|
.B 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.
|
|
.SH SEE ALSO
|
|
.BR cfuse (8),
|
|
.BR ceph (8)
|