]> git.proxmox.com Git - ceph.git/blob - ceph/doc/releases/argonaut.rst
409d1af91336132b0a5ca1375c60d5d5e0aa6d14
[ceph.git] / ceph / doc / releases / argonaut.rst
1 ========
2 Argonaut
3 ========
4
5 Argonaut is the first stable release of Ceph. It is named after a
6 genus of octopuses, sometimes also referred to as paper nautiluses.
7
8
9 v0.48.3 "argonaut"
10 ==================
11
12 This release contains a critical fix that can prevent data loss or
13 corruption after a power loss or kernel panic event. Please upgrade
14 immediately.
15
16 Upgrading
17 ---------
18
19 * If you are using the undocumented ``ceph-disk-prepare`` and
20 ``ceph-disk-activate`` tools, they have several new features and
21 some additional functionality. Please review the changes in
22 behavior carefully before upgrading.
23 * The .deb packages now require xfsprogs.
24
25 Notable changes
26 ---------------
27
28 * filestore: fix op_seq write order (fixes journal replay after power loss)
29 * osd: fix occasional indefinitely hung "slow" request
30 * osd: fix encoding for pool_snap_info_t when talking to pre-v0.48 clients
31 * osd: fix heartbeat check
32 * osd: reduce log noise about rbd watch
33 * log: fixes for deadlocks in the internal logging code
34 * log: make log buffer size adjustable
35 * init script: fix for 'ceph status' across machines
36 * radosgw: fix swift error handling
37 * radosgw: fix swift authentication concurrency bug
38 * radosgw: don't cache large objects
39 * radosgw: fix some memory leaks
40 * radosgw: fix timezone conversion on read
41 * radosgw: relax date format restrictions
42 * radosgw: fix multipart overwrite
43 * radosgw: stop processing requests on client disconnect
44 * radosgw: avoid adding port to url that already has a port
45 * radosgw: fix copy to not override ETAG
46 * common: make parsing of ip address lists more forgiving
47 * common: fix admin socket compatibility with old protocol (for collectd plugin)
48 * mon: drop dup commands on paxos reset
49 * mds: fix loner selection for multiclient workloads
50 * mds: fix compat bit checks
51 * ceph-fuse: fix segfault on startup when keyring is missing
52 * ceph-authtool: fix usage
53 * ceph-disk-activate: misc backports
54 * ceph-disk-prepare: misc backports
55 * debian: depend on xfsprogs (we use xfs by default)
56 * rpm: build rpms, some related Makefile changes
57
58 For more detailed information, see :download:`the complete changelog <../changelog/v0.48.3argonaut.txt>`.
59
60 v0.48.2 "argonaut"
61 ==================
62
63 Upgrading
64 ---------
65
66 * The default search path for keyring files now includes /etc/ceph/ceph.$name.keyring. If such files are present on your cluster, be aware that by default they may now be used.
67
68 * There are several changes to the upstart init files. These have not been previously documented or recommended. Any existing users should review the changes before upgrading.
69
70 * The ceph-disk-prepare and ceph-disk-active scripts have been updated significantly. These have not been previously documented or recommended. Any existing users should review the changes before upgrading.
71
72 Notable changes
73 ---------------
74
75 * mkcephfs: fix keyring generation for mds, osd when default paths are used
76 * radosgw: fix bug causing occasional corruption of per-bucket stats
77 * radosgw: workaround to avoid previously corrupted stats from going negative
78 * radosgw: fix bug in usage stats reporting on busy buckets
79 * radosgw: fix Content-Range: header for objects bigger than 2 GB.
80 * rbd: avoid leaving watch acting when command line tool errors out (avoids 30s delay on subsequent operations)
81 * rbd: friendlier use of --pool/--image options for import (old calling convention still works)
82 * librbd: fix rare snapshot creation race (could "lose" a snap when creation is concurrent)
83 * librbd: fix discard handling when spanning holes
84 * librbd: fix memory leak on discard when caching is enabled
85 * objecter: misc fixes for op reordering
86 * objecter: fix for rare startup-time deadlock waiting for osdmap
87 * ceph: fix usage
88 * mon: reduce log noise about "check_sub"
89 * ceph-disk-activate: misc fixes, improvements
90 * ceph-disk-prepare: partition and format osd disks automatically
91 * upstart: start everyone on a reboot
92 * upstart: always update the osd crush location on start if specified in the config
93 * config: add /etc/ceph/ceph.$name.keyring to default keyring search path
94 * ceph.spec: don't package crush headers
95
96 For more detailed information, see :download:`the complete changelog <../changelog/v0.48.2argonaut.txt>`.
97
98 v0.48.1 "argonaut"
99 ==================
100
101 Upgrading
102 ---------
103
104 * The radosgw usage trim function was effectively broken in v0.48. Earlier it would remove more usage data than what was requested. This is fixed in v0.48.1, but the fix is incompatible. The v0.48 radosgw-admin tool cannot be used to initiate the trimming; please use the v0.48.1 version.
105
106 * v0.48.1 now explicitly indicates support for the CRUSH_TUNABLES feature. No other version of Ceph requires this, yet, but future versions will when the tunables are adjusted from their historical defaults.
107
108 * There are no other compatibility changes between v0.48.1 and v0.48.
109
110 Notable changes
111 ---------------
112
113 * mkcephfs: use default 'keyring', 'osd data', 'osd journal' paths when not specified in conf
114 * msgr: various fixes to socket error handling
115 * osd: reduce scrub overhead
116 * osd: misc peering fixes (past_interval sharing, pgs stuck in 'peering' states)
117 * osd: fail on EIO in read path (do not silently ignore read errors from failing disks)
118 * osd: avoid internal heartbeat errors by breaking some large transactions into pieces
119 * osd: fix osdmap catch-up during startup (catch up and then add daemon to osdmap)
120 * osd: fix spurious 'misdirected op' messages
121 * osd: report scrub status via 'pg ... query'
122 * rbd: fix race when watch registrations are resent
123 * rbd: fix rbd image id assignment scheme (new image data objects have slightly different names)
124 * rbd: fix perf stats for cache hit rate
125 * rbd tool: fix off-by-one in key name (crash when empty key specified)
126 * rbd: more robust udev rules
127 * rados tool: copy object, pool commands
128 * radosgw: fix in usage stats trimming
129 * radosgw: misc API compatibility fixes (date strings, ETag quoting, swift headers, etc.)
130 * ceph-fuse: fix locking in read/write paths
131 * mon: fix rare race corrupting on-disk data
132 * config: fix admin socket 'config set' command
133 * log: fix in-memory log event gathering
134 * debian: remove crush headers, include librados-config
135 * rpm: add ceph-disk-{activate, prepare}
136
137 For more detailed information, see :download:`the complete changelog <../changelog/v0.48.1argonaut.txt>`.
138
139 v0.48 "argonaut"
140 ================
141
142 Upgrading
143 ---------
144
145 * This release includes a disk format upgrade. Each ceph-osd daemon, upon startup, will migrate its locally stored data to the new format. This process can take a while (for large object counts, even hours), especially on non-btrfs file systems.
146
147 * To keep the cluster available while the upgrade is in progress, we recommend you upgrade a storage node or rack at a time, and wait for the cluster to recover each time. To prevent the cluster from moving data around in response to the OSD daemons being down for minutes or hours, you may want to::
148
149 ceph osd set noout
150
151 This will prevent the cluster from marking down OSDs as "out" and re-replicating the data elsewhere. If you do this, be sure to clear the flag when the upgrade is complete::
152
153 ceph osd unset noout
154
155 * There is a encoding format change internal to the monitor cluster. The monitor daemons are careful to switch to the new format only when all members of the quorum support it. However, that means that a partial quorum with new code may move to the new format, and a recovering monitor running old code will be unable to join (it will crash). If this occurs, simply upgrading the remaining monitor will resolve the problem.
156
157 * The ceph tool's -s and -w commands from previous versions are incompatible with this version. Upgrade your client tools at the same time you upgrade the monitors if you rely on those commands.
158
159 * It is not possible to downgrade from v0.48 to a previous version.
160
161 Notable changes
162 ---------------
163
164 * osd: stability improvements
165 * osd: capability model simplification
166 * osd: simpler/safer --mkfs (no longer removes all files; safe to re-run on active osd)
167 * osd: potentially buggy FIEMAP behavior disabled by default
168 * rbd: caching improvements
169 * rbd: improved instrumentation
170 * rbd: bug fixes
171 * radosgw: new, scalable usage logging infrastructure
172 * radosgw: per-user bucket limits
173 * mon: streamlined process for setting up authentication keys
174 * mon: stability improvements
175 * mon: log message throttling
176 * doc: improved documentation (ceph, rbd, radosgw, chef, etc.)
177 * config: new default locations for daemon keyrings
178 * config: arbitrary variable substitutions
179 * improved 'admin socket' daemon admin interface (ceph --admin-daemon ...)
180 * chef: support for multiple monitor clusters
181 * upstart: basic support for monitors, mds, radosgw; osd support still a work in progress.
182
183 The new default keyring locations mean that when enabling authentication (``auth supported = cephx``), keyring locations do not need to be specified if the keyring file is located inside the daemon's data directory (``/var/lib/ceph/$type/ceph-$id`` by default).
184
185 There is also a lot of librbd code in this release that is laying the groundwork for the upcoming layering functionality, but is not actually used. Likewise, the upstart support is still incomplete and not recommended; we will backport that functionality later if it turns out to be non-disruptive.