Skip to content

Commit 9aec644

Browse files
authored
Doc 13339 change bucket eviction w o restart (#3864)
This PR addresses three DOC JIRAs which are unrelated but whose impact overlap: DOC-13339 DOC: Option to allow bucket eviction policy to be changed without bucket restart DOC-13332 Remove Bucket Priority Setting from our documentation Also addresses MB-68541 Change ejection policy for ephemeral buckets (#3885), which was created a a dev ticket.
1 parent 91ffbeb commit 9aec644

23 files changed

+679
-552
lines changed

migrate_bucket.adoc

Lines changed: 0 additions & 313 deletions
This file was deleted.

modules/ROOT/nav.adoc

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -123,8 +123,9 @@ include::third-party:partial$nav.adoc[]
123123
** xref:manage:manage-buckets/create-bucket.adoc[Create a Bucket]
124124
** xref:manage:manage-buckets/edit-bucket.adoc[Edit a Bucket]
125125
** xref:manage:manage-buckets/flush-bucket.adoc[Flush a Bucket]
126-
** xref:manage:manage-buckets/delete-bucket.adoc[Drop a Bucket]
127-
** xref:manage:manage-buckets/migrate-bucket.adoc[]
126+
** xref:manage:manage-buckets/delete-bucket.adoc[Drop a Bucket]
127+
** xref:manage:manage-buckets/migrate-bucket.adoc[]
128+
** xref:manage:manage-buckets/change-ejection-policy.adoc[]
128129
* xref:manage:manage-scopes-and-collections/manage-scopes-and-collections.adoc[Manage Scopes and Collections]
129130
* xref:manage:manage-logging/manage-logging.adoc[Manage Logging]
130131
* xref:manage:manage-settings/manage-settings.adoc[Manage Settings]

modules/introduction/partials/new-features-80.adoc

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -242,6 +242,32 @@ The metric includes the first 32 characters sent by any clients up to the first
242242
and limits the number of metrics to 100.
243243
Additional information sent by clients at connection time can be found in the logs.
244244
245+
[#ejection-policy-without-restart]
246+
https://jira.issues.couchbase.com/browse/MB-67082[MB-67082] Allow eviction policy to be changed without bucket restart::
247+
The new `noRestart` parameter for the `/pools/default/buckets/{BUCKET-NAME}` REST API lets you change the ejection policy of a Couchbase bucket without automatically restarting it.
248+
If you prevent the restart, perform one of the following:
249+
+
250+
--
251+
* A swap rebalance
252+
* On each data node, perform a graceful failover, then either a delta (when not performing a storage backend migration) or full recovery followed by a rebalance.
253+
--
254+
+
255+
Either of these procedures lets you avoid the downtime associated with restarting the bucket.
256+
For more information, see xref:manage:manage-buckets/change-ejection-policy.adoc[].
257+
258+
+
259+
This setting is useful when you migrate a bucket to a new storage engine that would benefit from a new ejection policy.
260+
For example, you should consider changing a bucket's ejection policy to Full Ejection when migrating a bucket to the xref:learn:buckets-memory-and-storage/storage-engines.adoc#storage-engine-magma[Magma storage engine].
261+
Using the `noRestart` parameter, you can change the ejection policy at the same time you migrate the bucket to the new storage engine.
262+
See xref:manage:manage-buckets/migrate-bucket.adoc[] for more information.
263+
264+
[#ejection-ephemeral-buckets]
265+
https://jira.issues.couchbase.com/browse/MB-64104[MB-64104] Allow changing the ejection policy of ephemeral buckets::
266+
You can now change the ejection policy of an ephemeral bucket using the Couchbase Server Web Console and the REST API.
267+
Unlike Couchstore buckets, changing the ejection policy of an ephemeral bucket does not require a bucket restart or other additional steps.
268+
For more information, see xref:manage:manage-buckets/change-ejection-policy.adoc[].
269+
270+
245271
[#section-new-feature-800-disk-limits]
246272
https://jira.issues.couchbase.com/browse/MB-59113[MB-59113] Prevent buckets from causing nodes to run out of disk space::
247273
You can configure Couchbase Server to prevent the Data Service from writing to the data service path once the filesystem has filled to a configurable threshold.
@@ -279,6 +305,7 @@ include::learn:partial$maintain-durability-warning.adoc[]
279305
See xref:learn:data/durability.adoc#maintaining-durable-writes[Maintaining Durable Writes During Single Replica Failovers] for more information about this feature.
280306
281307
308+
282309
[#section-new-feature-800-backup-service]
283310
=== Backup and Restore
284311
https://jira.issues.couchbase.com/browse/MB-44863[MB-44863]::

0 commit comments

Comments
 (0)