1MOUNT.CEPH(8) Ceph MOUNT.CEPH(8)
2
3
4
6 mount.ceph - mount a ceph file system
7
9 mount.ceph [monaddr1,monaddr2,...]:/[subdir] dir [
10 -o options ]
11
12
14 mount.ceph is a helper for mounting the Ceph file system on a Linux
15 host. It serves to resolve monitor hostname(s) into IP addresses and
16 read authentication keys from disk; the Linux kernel client component
17 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 If the host portion of the device is left blank, then mount.ceph will
33 attempt to determine monitor addresses using local configuration files
34 and/or DNS SRV records.
35
36 A subdirectory subdir may be specified if a subset of the file system
37 is to be mounted.
38
39 Mount helper application conventions dictate that the first two options
40 are device to be mounted and destination path. Options must be passed
41 only after these fixed arguments.
42
44 wsize int (bytes), max write size. Default: 16777216 (16*1024*1024)
45 (writeback uses smaller of wsize and stripe unit)
46
47 rsize int (bytes), max read size. Default: 16777216 (16*1024*1024)
48
49 rasize int (bytes), max readahead. Default: 8388608 (8192*1024)
50
51 osdtimeout
52 int (seconds), Default: 60
53
54 osdkeepalive
55 int, Default: 5
56
57 mount_timeout
58 int (seconds), Default: 60
59
60 osd_idle_ttl
61 int (seconds), Default: 60
62
63 caps_wanted_delay_min
64 int, cap release delay, Default: 5
65
66 caps_wanted_delay_max
67 int, cap release delay, Default: 60
68
69 cap_release_safety
70 int, Default: calculated
71
72 readdir_max_entries
73 int, Default: 1024
74
75 readdir_max_bytes
76 int, Default: 524288 (512*1024)
77
78 write_congestion_kb
79 int (kb), max writeback in flight. scale with available memory.
80 Default: calculated from available memory
81
82 snapdirname
83 string, set the name of the hidden snapdir. Default: .snap
84
85 name RADOS user to authenticate as when using cephx. Default: guest
86
87 secret secret key for use with cephx. This option is insecure because
88 it exposes the secret on the command line. To avoid this, use
89 the secretfile option.
90
91 secretfile
92 path to file containing the secret key to use with cephx
93
94 ip my ip
95
96 noshare
97 create a new client instance, instead of sharing an existing
98 instance of a client mounting the same cluster
99
100 dirstat
101 funky cat dirname for stats, Default: off
102
103 nodirstat
104 no funky cat dirname for stats
105
106 rbytes Report the recursive size of the directory contents for st_size
107 on directories. Default: off
108
109 norbytes
110 Do not report the recursive size of the directory contents for
111 st_size on directories.
112
113 nocrc no data crc on writes
114
115 noasyncreaddir
116 no dcache readdir
117
118 conf Path to a ceph.conf file. This is used to initialize the ceph
119 context for autodiscovery of monitor addresses and auth secrets.
120 The default is to use the standard search path for ceph.conf
121 files.
122
124 If the secret and secretfile options are not specified on the com‐
125 mand-line then the mount helper will spawn a child process that will
126 use the standard ceph library routines to find a keyring and fetch the
127 secret from it.
128
130 Mount the full file system:
131
132 mount.ceph monhost:/ /mnt/foo
133
134 If there are multiple monitors:
135
136 mount.ceph monhost1,monhost2,monhost3:/ /mnt/foo
137
138 If ceph-mon(8) is running on a non-standard port:
139
140 mount.ceph monhost1:7000,monhost2:7000,monhost3:7000:/ /mnt/foo
141
142 To automatically determine the monitor addresses from local configura‐
143 tion:
144
145 mount.ceph :/ /mnt/foo
146
147 To mount only part of the namespace:
148
149 mount.ceph monhost1:/some/small/thing /mnt/thing
150
151 Assuming mount.ceph(8) is installed properly, it should be automati‐
152 cally invoked by mount(8) like so:
153
154 mount -t ceph monhost:/ /mnt/foo
155
157 mount.ceph is part of Ceph, a massively scalable, open-source, distrib‐
158 uted storage system. Please refer to the Ceph documentation at
159 http://ceph.com/docs for more information.
160
162 ceph-fuse(8), ceph(8)
163
165 2010-2020, Inktank Storage, Inc. and contributors. Licensed under Cre‐
166 ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
167
168
169
170
171dev Apr 21, 2020 MOUNT.CEPH(8)