Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -111,6 +111,8 @@ include::third-party:partial$nav.adoc[]
*** xref:manage:manage-nodes/failover-graceful.adoc[Graceful]
*** xref:manage:manage-nodes/failover-hard.adoc[Hard]
** xref:manage:manage-nodes/recover-nodes.adoc[Recover a Node and Rebalance]
** xref:manage:manage-nodes/manage-data-service-and-rebalance.adoc[Adding or Removing the Data Service on Existing Nodes]
** xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance]
** xref:manage:manage-nodes/apply-node-to-node-encryption.adoc[Manage Node-to-Node Encryption]
** xref:manage:manage-nodes/manage-address-families.adoc[Manage Address Families]
* xref:manage:manage-buckets/bucket-management-overview.adoc[Manage Buckets]
Expand Down Expand Up @@ -325,7 +327,9 @@ include::cli:partial$cbcli/nav.adoc[]
**** xref:rest-api:rest-establish-credentials.adoc[Establishing Credentials]
**** xref:rest-api:rest-name-node.adoc[Naming a Node]
**** xref:rest-api:rest-configure-memory.adoc[Configuring Memory]
**** xref:rest-api:rest-set-up-services.adoc[Assigning Services]
**** xref:rest-api:rest-get-memory-information.adoc[Getting Memory Information]
**** xref:rest-api:rest-set-up-services.adoc[Assigning Services to a New Single Node]
**** xref:rest-api:rest-set-up-services-existing-nodes.adoc[Assigning Services to an Existing Node]
**** xref:rest-api:rest-name-cluster.adoc[Naming a Cluster]

*** xref:rest-api:rest-adding-and-removing-nodes.adoc[Node Addition and Removal]
Expand Down Expand Up @@ -400,6 +404,7 @@ include::cli:partial$cbcli/nav.adoc[]
** xref:rest-api:rest-memory-and-storage.adoc[Memory and Storage API]
*** xref:rest-api:rest-initialize-node.adoc[Initializing a Node]
*** xref:rest-api:rest-configure-memory.adoc[Configuring Memory]
*** xref:rest-api:rest-get-memory-information.adoc[Getting Memory Information]
*** xref:rest-api:rest-reader-writer-thread-config.adoc[Setting Thread Allocations]
*** xref:rest-api:rest-getting-storage-information.adoc[Getting Storage Information]
*** xref:rest-api:rest-compact-post.adoc[Performing Compaction Manually]
Expand Down
17 changes: 17 additions & 0 deletions modules/introduction/partials/new-features-80.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,23 @@ curl --get -u <username:password> \
-d clusterLabels=none|uuidOnly|uuidAndName
----

[#section-new-feature-800-services]
=== Services

https://jira.issues.couchbase.com/browse/MB-60349[MB-60349]::
Now you can add or remove non-Data Services dynamically on existing nodes in a cluster, without adding or removing nodes.
Rebalancing is automatically triggered to distribute service workloads and complete the modification.
These are the services that can be modified:

** `index` (Index Service)
** `n1ql` (Query Service)
** `fts` (Search Service)
** `cbas` (Analytics Service)
** `eventing` (Eventing Service)
** `backup` (Backup Service)

You can modify these services using the Couchbase xref:manage:manage-nodes/modify-services-on-nodes-and-rebalance.adoc#modify-mds-services-from-ui[UI], xref:rest-api:rest-set-up-services-existing-nodes.adoc[REST API], or xref:manage:manage-nodes/modify-services-on-nodes-and-rebalance.adoc#modify-mds-services-using-cli[CLI].

[#section-new-feature-data-service]
=== Data Service

Expand Down
23 changes: 17 additions & 6 deletions modules/learn/pages/clusters-and-availability/nodes.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -87,9 +87,8 @@ Alternatively, the default itself can be changed, provided that it does not requ
The available node must be at stage 2 or 3: that is, it must have been started, and may have had its data, index, analytics, and eventing paths configured.
However, it cannot have been provisioned in any way: if the routine for joining is executed on a provisioned node, an error is flagged, and the operation fails.
+
Note that services can nevertheless be assigned to the new node during the join operation itself.
The
memory quota for each service defaults to the setting for the existing cluster.
NOTE: Services can be assigned to the new node during the join operation or on-demand.
The memory quota for each service defaults to the setting for the existing cluster.
An error occurs if the new node does not have sufficient memory.
+
If Couchbase Web Console is used to perform the join, the data, index, analytics, and eventing paths can be modified as part of the join operations.
Expand Down Expand Up @@ -150,14 +149,26 @@ Fast failover can be achieved by deploying an arbiter node, which is a node that
Such a deployment ensures that the Cluster Manager automatically deploys critical system infrastructure on the arbiter node, rather than on any other, so as to avoid clashes.
This may lead to several seconds of latency reduction, when a busy cluster undergoes failover.

For information about service deployment with:
=== Deploying Services on a Node

* The REST API, see xref:rest-api:rest-set-up-services.adoc[Assigning Services].
You can add services to a new node when adding the node to a cluster.

* Couchbase Server Web Console during node-addition and node-joining, see the demonstrated uses of checkboxes, in xref:manage:manage-nodes/add-node-and-rebalance#arbiter-node-addition[Add a Node and Rebalance] and in xref:manage:manage-nodes/join-cluster-and-rebalance#arbiter-node-join[Join a Cluster and Rebalance].
You can also add or remove non-Data Services on an existing node in a cluster, without adding or removing nodes.

For information about the deployment of services on a new node using:

* The REST API, see xref:rest-api:rest-set-up-services.adoc[Assigning Services to a New Single Node], xref:rest-api:rest-cluster-addnodes.adoc[Adding Nodes to Clusters], and xref:rest-api:rest-cluster-joinnode.adoc[Joining Nodes into Clusters].

* The Couchbase Server Web Console during node-addition and node-joining, see xref:manage:manage-nodes/add-node-and-rebalance#arbiter-node-addition[Add a Node and Rebalance] and in xref:manage:manage-nodes/join-cluster-and-rebalance#arbiter-node-join[Join a Cluster and Rebalance].

* The CLI during node-addition, see xref:cli:cbcli/couchbase-cli-server-add[server-add].

You can add or remove non-Data Services on an existing node in a cluster using the following methods:

* From the xref:manage:manage-nodes/modify-services-on-nodes-and-rebalance.adoc#modify-mds-services-from-ui[UI] or xref:manage:manage-nodes/modify-services-on-nodes-and-rebalance.adoc#modify-mds-services-using-cli[CLI].
For more information, see xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance].
* Using the REST API. For more information, see xref:rest-api:rest-set-up-services-existing-nodes.adoc[Assigning Services to an Existing Node].

[#Node Quantity]
== Node Quantity

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -112,9 +112,15 @@ This continuous data ingestion allows operational and analytic queries to run co

Due to the large scale and duration of operations it is likely to perform, the Analytics Service should be run _alone_, on its node or nodes in the cluster, _with no other Couchbase Service running on the Analytics nodes_.

For the practical steps required to initialize or join a cluster, and to deploy services, see
xref:manage:manage-nodes/create-cluster.adoc[Create a Cluster].
For information on how to run analytic queries, see the xref:analytics:introduction.adoc[Introduction] to Couchbase Analytics.
For more information about:

* How to initialize a cluster, see xref:manage:manage-nodes/create-cluster.adoc[Create a Cluster].

* How to join or add a new node to a cluster to support the Analytics Service, see xref:manage:manage-nodes/join-cluster-and-rebalance.adoc[Join a Cluster and Rebalance] and see xref:manage:manage-nodes/add-node-and-rebalance.adoc[Add a Node and Rebalance].

* How to add or remove services on an existing node of a cluster, see xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance].

* How to run analytic queries, see the xref:analytics:introduction.adoc[Introduction] to Couchbase Analytics.

[WARNING]
.Non-Uniform Memory Access (NUMA)
Expand All @@ -125,3 +131,7 @@ NUMA architectures divide memory into different zones, each with a specific CPU,
Couchbase Analytics is not configured to align with the NUMA architecture.
Deploying Couchbase Analytics on a server with the NUMA architecture may result in uneven memory distribution, increased latency, and degraded performance. Specifically, queries can become slower, and overall system efficiency can drop as memory access times vary significantly.
====

== See Also

* For more information about adding or removing the Analytics Service on an existing node of a cluster, see xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance].
Original file line number Diff line number Diff line change
Expand Up @@ -44,11 +44,8 @@ the Cluster Manager elects one of them to be the leader.
The leader is responsible for:

* Dispatching backup tasks.

* Adding and removing nodes from the Backup Service.

* Cleaning orphaned tasks.

* Ensuring that all Backup Service nodes can reach the global storage locations.

If the leader becomes unresponsive or fails over, the Backup Service stops until a rebalance takes place.
Expand Down Expand Up @@ -250,3 +247,4 @@ You may want to experiment with different thread settings to find a balance betw
* See xref:rest-api:backup-rest-api.adoc[Backup Service API] for information about using the Backup Service from the REST API.
* To learn about the port numbers the Backup Service uses, see xref:install:install-ports.adoc[Couchbase Server Ports].
* For a list of Backup Service audit events, see xref:audit-event-reference:audit-event-reference.adoc[Audit Event Reference].
* For more information about adding or removing the Backup Service on an existing node of a cluster, see xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance].
Original file line number Diff line number Diff line change
Expand Up @@ -48,8 +48,9 @@ For further information, see xref:buckets-memory-and-storage/memory.adoc[Memory]
For information on how to activate, see
xref:manage:manage-buckets/flush-bucket.adoc[Flush a Bucket].
** *Expiry Pager*: Scans for items that have expired, and erases them from memory and disk; after which, a _tombstone_ remains for a default period of 3 days.
The expiry pager runs every 10 minutes by default: for information on changing the interval, see `cbepctl` xref:cli:cbepctl/set-flush_param.adoc[set flush_param].
For more information on item-deletion and tombstones, see xref:data/expiration.adoc[Expiration].
The expiry pager runs every 10 minutes by default.
For information about changing the interval, see xref:rest-api:rest-bucket-create.adoc#expirypagersleeptime[expiryPagerSleepTime].
For more information about item-deletion and tombstones, see xref:data/expiration.adoc[Expiration].
** *Batch Reader*: Enhances performance by combining changes made to multiple items into _batches_, which are placed on the disk queue, to be written to disk.
* *Scheduler*: A pool of threads mainly used for handling I/O.
The threads are divided into four kinds, which run independently of and without effect on one another:
Expand All @@ -61,3 +62,5 @@ The threads are divided into four kinds, which run independently of and without

+
For more information on the Data Service' threading model, see xref:buckets-memory-and-storage/storage-settings.adoc[Storage Properties].

For more information about adding or removing the Data Service on an existing node, see xref:manage:manage-nodes/manage-data-service-and-rebalance.adoc[Adding or Removing the Data Service on Existing Nodes].
Original file line number Diff line number Diff line change
Expand Up @@ -12,4 +12,6 @@ Events include changes made to specified items, and the arrival of scheduled poi

The Eventing Service depends on the xref:services-and-indexes/services/data-service.adoc[Data Service], which must therefore be running on at least one cluster node.

For information on using the Eventing Service, see xref:eventing:eventing-overview.adoc[Eventing Service: Fundamentals].
For more information about using the Eventing Service, see xref:eventing:eventing-overview.adoc[Eventing Service: Fundamentals].

For more information about adding or removing the Eventing Service on an existing node of a cluster, see xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance].
Original file line number Diff line number Diff line change
Expand Up @@ -68,3 +68,7 @@ _Secondary_ Indexes, often referred to as _Global Secondary Indexes_ or _GSIs_,
Secondary Indexes can be created on specified fields; placed on specific cluster-nodes; and replicated.

For information on using the Indexing Service, see xref:indexes:indexing-overview.adoc[].

== See Also

* For more information about adding or removing the Index Service on an existing node of a cluster, see xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance].
Original file line number Diff line number Diff line change
Expand Up @@ -43,3 +43,7 @@ Note the degree of parallelism with which operations are frequently performed, r
The Query Service supports queries made in {sqlpp}.
As well as providing a rich variety of query-options, {sqlpp} allows statements to be _prepared_, so that the parsing and compiling of plans is completed prior to execution; and permits _consistency-levels_ to be configured.
For detailed information, see xref:n1ql:n1ql-language-reference/index.adoc[{sqlpp} Language Reference].

== See Also

* For more information about adding or removing the Query Service on an existing node of a cluster, see xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance].
Original file line number Diff line number Diff line change
Expand Up @@ -64,3 +64,7 @@ In Couchbase Server 6.6 Enterprise Edition and later, the _Flex Index_ feature p
For detailed information, see xref:n1ql:n1ql-language-reference/flex-indexes.adoc[Flex Indexes].

To use the Search Service in {sqlpp}, the Query, Index, and Search Services must all be running on the cluster.

== See Also

* For more information about adding or removing the Search Service on an existing node of a cluster, see xref:manage:manage-nodes/modify-services-and-rebalance.adoc[Modify Services and Rebalance].
Loading