mount.ceph(8)

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

EXAMPLES

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

AVAILABILITY

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

COPYRIGHT

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