From acc98e728cdd0bc8691e4e84c07c16da02eeb333 Mon Sep 17 00:00:00 2001 From: TimLFletcher Date: Fri, 4 Sep 2026 12:17:18 +0100 Subject: [PATCH] [DOC-14595][AI] Document disk_io_optimized for reader and writer threads The Setting Storage Thread Allocations reference described num_reader_threads and num_writer_threads as taking a number of threads, without mentioning that they also accept disk_io_optimized. That value corresponds to the Disk i/o optimized option already documented under Data Settings, which storage-engines.adoc recommends for Magma buckets. Adds the accepted value to both parameter descriptions and to the curl syntax block, and links to Data Settings for guidance on when to use it. Co-Authored-By: Claude Opus 5 --- .../rest-api/pages/rest-reader-writer-thread-config.adoc | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/modules/rest-api/pages/rest-reader-writer-thread-config.adoc b/modules/rest-api/pages/rest-reader-writer-thread-config.adoc index 797f2b369c..f4b32a8ef2 100644 --- a/modules/rest-api/pages/rest-reader-writer-thread-config.adoc +++ b/modules/rest-api/pages/rest-reader-writer-thread-config.adoc @@ -100,8 +100,8 @@ To set the global thread allocations for Couchbase Server, send a `POST` to the ---- curl -X POST http[s]://{host}:{port}/pools/default/settings/memcached/global -u $USER:$PASSWORD - [-d num_reader_threads=] - [-d num_writer_threads=] + [-d num_reader_threads=|disk_io_optimized] + [-d num_writer_threads=|disk_io_optimized] [-d num_nonio_threads=] [-d num_auxio_threads=] [-d num_storage_threads=] @@ -118,9 +118,13 @@ include::partial$user_pwd_host_port_params.adoc[] `num_reader_threads`:: (optional) Sets the number of threads Couchbase Server uses to read data. +Accepts an integer, or `disk_io_optimized` to allocate threads equal to the number of CPU cores on the node. +For guidance on when to choose `disk_io_optimized`, particularly for buckets that use the Magma storage engine, see xref:manage:manage-settings/general-settings.adoc#data-settings[Data Settings]. `num_writer_threads`:: (optional) Sets the number of threads Couchbase Server uses to write data. +Accepts an integer, or `disk_io_optimized` to allocate threads equal to the number of CPU cores on the node. +For guidance on when to choose `disk_io_optimized`, particularly for buckets that use the Magma storage engine, see xref:manage:manage-settings/general-settings.adoc#data-settings[Data Settings]. `num_nonio_threads`:: (optional) Sets the number of NonIO threads to be used by Couchbase Server.