1MOUNT.CEPH(8)                        Ceph                        MOUNT.CEPH(8)
2
3
4

NAME

6       mount.ceph - mount a ceph file system
7

SYNOPSIS

9       mount.ceph monaddr1[,monaddr2,...]:/[subdir] dir [
10       -o options ]
11
12

DESCRIPTION

14       mount.ceph  is  a  simple helper for mounting the Ceph file system on a
15       Linux host. It serves to resolve monitor hostname(s) into IP  addresses
16       and  read authentication keys from disk; the Linux kernel client compo‐
17       nent does most of the real work. In fact, it is  possible  to  mount  a
18       non-authenticated  Ceph  file  system  without mount.ceph by specifying
19       monitor address(es) by IP:
20
21          mount -t ceph 1.2.3.4:/ mountpoint
22
23       Each monitor address monaddr takes the form host[:port]. If the port is
24       not specified, the Ceph default of 6789 is assumed.
25
26       Multiple monitor addresses can be separated by commas. Only one respon‐
27       sible monitor is needed to successfully mount; the  client  will  learn
28       about  all  monitors from any responsive monitor. However, it is a good
29       idea to specify more than one in case one happens to  be  down  at  the
30       time of mount.
31
32       A  subdirectory  subdir may be specified if a subset of the file system
33       is to be mounted.
34
35       Mount helper application conventions dictate that the first two options
36       are  device  to be mounted and destination path. Options must be passed
37       only after these fixed arguments.
38

OPTIONS

40       wsize  int (bytes), max  write  size.  Default:  none  (writeback  uses
41              smaller of wsize and stripe unit)
42
43       rsize  int (bytes), max read size. Default: none
44
45       rasize int  (bytes),  max readahead, multiple of 1024, Default: 8388608
46              (8192*1024)
47
48       osdtimeout
49              int (seconds), Default: 60
50
51       osdkeepalive
52              int, Default: 5
53
54       mount_timeout
55              int (seconds), Default: 60
56
57       osd_idle_ttl
58              int (seconds), Default: 60
59
60       caps_wanted_delay_min
61              int, cap release delay, Default: 5
62
63       caps_wanted_delay_max
64              int, cap release delay, Default: 60
65
66       cap_release_safety
67              int, Default: calculated
68
69       readdir_max_entries
70              int, Default: 1024
71
72       readdir_max_bytes
73              int, Default: 524288 (512*1024)
74
75       write_congestion_kb
76              int (kb), max writeback in flight. scale with available  memory.
77              Default: calculated from available memory
78
79       snapdirname
80              string, set the name of the hidden snapdir. Default: .snap
81
82       name   RADOS user to authenticate as when using cephx. Default: guest
83
84       secret secret  key  for use with cephx. This option is insecure because
85              it exposes the secret on the command line. To  avoid  this,  use
86              the secretfile option.
87
88       secretfile
89              path to file containing the secret key to use with cephx
90
91       ip     my ip
92
93       noshare
94              create  a  new  client  instance, instead of sharing an existing
95              instance of a client mounting the same cluster
96
97       dirstat
98              funky cat dirname for stats, Default: off
99
100       nodirstat
101              no funky cat dirname for stats
102
103       rbytes Report the recursive size of the directory contents for  st_size
104              on directories.  Default: on
105
106       norbytes
107              Do  not  report the recursive size of the directory contents for
108              st_size on directories.
109
110       nocrc  no data crc on writes
111
112       noasyncreaddir
113              no dcache readdir
114

EXAMPLES

116       Mount the full file system:
117
118          mount.ceph monhost:/ /mnt/foo
119
120       If there are multiple monitors:
121
122          mount.ceph monhost1,monhost2,monhost3:/ /mnt/foo
123
124       If ceph-mon(8) is running on a non-standard port:
125
126          mount.ceph monhost1:7000,monhost2:7000,monhost3:7000:/ /mnt/foo
127
128       To mount only part of the namespace:
129
130          mount.ceph monhost1:/some/small/thing /mnt/thing
131
132       Assuming mount.ceph(8) is installed properly, it  should  be  automati‐
133       cally invoked by mount(8) like so:
134
135          mount -t ceph monhost:/ /mnt/foo
136

AVAILABILITY

138       mount.ceph is part of Ceph, a massively scalable, open-source, distrib‐
139       uted  storage  system.  Please  refer  to  the  Ceph  documentation  at
140       http://ceph.com/docs for more information.
141

SEE ALSO

143       ceph-fuse(8), ceph(8)
144

146       2010-2014,  Inktank Storage, Inc. and contributors. Licensed under Cre‐
147       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
148
149
150
151
152dev                              Apr 14, 2019                    MOUNT.CEPH(8)
Impressum