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  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

OPTIONS

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

MOUNT SECRETS

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

EXAMPLES

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

AVAILABILITY

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

SEE ALSO

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)
Impressum