Merge branch 'release-rs-fuya-fuya' into DOC-4307

Author: rrelledge

content/operate/oss_and_stack/stack-with-enterprise/search/query-performance-factor.md

@@ -34,9 +34,9 @@ If you do not have a cluster that supports Redis Query Engine, [install Redis En
 
 1. [Determine the query performance factor](#calculate-performance-factor) you want and the required number of CPUs. Unused CPUs, above the 20% necessary for Redis, can be used for the scalable Redis Query Engine.
 
-1. Create a new Redis database with the number of CPUs configured for the Query performance factor.
+1. Create a new Redis database with the number of CPUs configured for the query performance factor.
 
-## Calculate performance factor
+## Calculate query performance factor
 
 ### CPUs for query performance factor
 
@@ -73,11 +73,92 @@ The following table shows the number of CPUs required for each performance facto
 | Scale factor | 4x |
 | Minimum CPUs required for scale factor | 6 |
 
-## Configure query performance factor
+## Configure query performance factor manually
 
-To configure the query performance factor in Redis Enterprise, use the [REST API]({{<relref "/operate/rs/references/rest-api">}}) to create a new database or update an existing database.
+To manually configure the query performance factor in Redis Enterprise Software:
 
-### Create new database
+1. [Configure query performance factor parameters](#config-db-ui) when you create a new database or edit an existing database's configuration in the Cluster Manager UI.
+
+1. If you configure the query performance factor for an existing database, you also need to [restart shards](#restart-shards). Newly created databases can skip this step.
+
+### Configure query performance factor parameters in the Cluster Manager UI {#config-db-ui}
+
+You can use the Cluster Manager UI to configure the query performance factor when you [create a new database]({{<relref "/operate/rs/databases/create">}}) or [edit an existing database]({{<relref "/operate/rs/databases/configure#edit-database-settings">}}) with search enabled.
+
+1. In the **Capabilities** section of the database configuration screen, click **Parameters**.
+
+1. If you are creating a new database, select **Search and query**.
+
+1. Adjust the **RediSearch** parameters to include: 
+
+    `MT_MODE MT_MODE_FULL WORKER_THREADS <NUMBER_OF_THREADS>`
+
+    See [Calculate query performance factor](#calculate-query-performance-factor) to determine the minimum CPUs required to use for `<NUMBER_OF_THREADS>`.
+    
+1. Expand the **Query Performance Factor** section and enter the following values:
+
+    - `mnp` for **Connections routing**
+
+    - `32` for **Connections limit**
+
+    {{<image filename="images/rs/screenshots/databases/rs-config-query-performance-factor.png" alt="Configure search parameters and query performance factor.">}}
+    
+1. Click **Done** to close the parameter editor.
+
+1. Click **Create** or **Save**.
+
+### Restart shards {#restart-shards}
+
+After you update the query performance factor for an existing database, restart all shards to apply the new settings. You can migrate shards to restart them. Newly created databases can skip this step.
+
+1. Use [`rladmin status shards db <db-name>`]({{<relref "/operate/rs/references/cli-utilities/rladmin/status#status-shards">}}) to list all shards for your database:
+
+    ```sh
+    rladmin status shards db db-name
+    ```
+
+    Example output:
+
+    ```sh
+    SHARDS:
+    DB:ID   NAME                ID      NODE   ROLE   SLOTS   USED_MEMORY STATUS
+    db:2    db-name             redis:1 node:1 master 0-16383 1.95MB      OK    
+    db:2    db-name             redis:2 node:2 slave  0-16383 1.95MB      OK    
+    ```
+
+    Note the following fields for the next steps: 
+    - `ID`: the Redis shard's ID.
+    - `NODE`: the node on which the shard currently resides.
+    - `ROLE`: `master` is a primary shard; `slave` is a replica shard.
+
+1. For each replica shard, use [`rladmin migrate shard`]({{<relref "/operate/rs/references/cli-utilities/rladmin/migrate">}}) to move it to a different node and restart it:
+
+    ```sh
+    rladmin migrate shard <shard_id> target_node <node_id>
+    ```
+
+1. After you migrate the replica shards, migrate the original primary shards.
+
+1. Rerun `rladmin status shards db <db-name>` to verify the shards migrated to different nodes:
+
+    ```sh
+    rladmin status shards db db-name
+    ```
+
+    Example output:
+
+    ```sh
+    SHARDS:
+    DB:ID   NAME                ID      NODE   ROLE   SLOTS   USED_MEMORY STATUS
+    db:2    db-name             redis:1 node:2 master 0-16383 1.95MB      OK    
+    db:2    db-name             redis:2 node:1 slave  0-16383 1.95MB      OK    
+    ```
+
+## Configure query performance factor with the REST API
+
+You can configure the query performance factor when you [create a new database](#create-db-rest-api) or [update an existing database](#update-db-rest-api) using the Redis Enterprise Software [REST API]({{<relref "/operate/rs/references/rest-api">}}).
+
+### Create new database with the REST API {#create-db-rest-api}
 
 To create a database and configure the query performance factor, use the [create database REST API endpoint]({{<relref "/operate/rs/references/rest-api/requests/bdbs#post-bdbs-v1">}}) with a [BDB object]({{<relref "/operate/rs/references/rest-api/objects/bdb">}}) that includes the following parameters:
 
@@ -126,7 +207,7 @@ The following [cURL](https://curl.se/docs/) request creates a new database from
 curl -k -u "<user>:<password>" https://<host>:9443/v1/bdbs -H "Content-Type:application/json" -d @scalable-search-db.json
 ```
 
-### Update existing database 
+### Update existing database with the REST API {#update-db-rest-api}
 
 To configure the query performance factor for an existing database, use the following REST API requests:
 

content/operate/rs/release-notes/rs-7-8-releases/_index.md

@@ -1,5 +1,5 @@
 ---
-Title: Redis Software release notes 7.8.0
+Title: Redis Software release notes 7.8.2
 alwaysopen: false
 categories:
 - docs
@@ -8,12 +8,12 @@ categories:
 compatibleOSSVersion: Redis 7.4.0
 description: Client-side caching support. New APIs to check database availability, rebalance shards, fail over shards, and control database traffic. Cluster Manager UI enhancements for node actions, database tags, and database configuration. Log rotation based on both size and time. Module management enhancements. V2 Prometheus metrics. Configurable minimum password length. Configurable license expiration alert threshold.
 hideListLinks: true
-linkTitle: 7.8.0 releases
+linkTitle: 7.8.2 releases
 toc: 'true'
 weight: 69
 ---
 
-​[​Redis Software version 7.8.0](https://redis.com/redis-enterprise-software/download-center/software/) is now available!
+​[​Redis Software version 7.8.2](https://redis.com/redis-enterprise-software/download-center/software/) is now available!
 
 ## Highlights
 
@@ -47,7 +47,7 @@ For more detailed release notes, select a build version from the following table
 
 ### Breaking changes
 
-Redis Software version 7.8.0 introduces the following breaking changes:
+Redis Software version 7.8.2 introduces the following breaking changes:
 
 - When you upgrade a database, the upgrade process also attempts to upgrade database modules by default.
 
@@ -131,21 +131,21 @@ New Redis modules will not be available for download from the Redis download cen
 
 #### Legacy UI not supported
 
-The legacy UI was deprecated in favor of the new Cluster Manager UI in Redis Software version 7.2.4 and is no longer supported as of Redis Software version 7.8.0.
+The legacy UI was deprecated in favor of the new Cluster Manager UI in Redis Software version 7.2.4 and is no longer supported as of Redis Software version 7.8.2.
 
 #### Redis 6.0 databases not supported
 
-Redis database version 6.0 was deprecated in Redis Software version 7.4.2 and is no longer supported as of Redis Software version 7.8.0.
+Redis database version 6.0 was deprecated in Redis Software version 7.4.2 and is no longer supported as of Redis Software version 7.8.2.
 
-To prepare for the removal of Redis database version 6.0 before you upgrade to Redis Software version 7.8.0:
+To prepare for the removal of Redis database version 6.0 before you upgrade to Redis Software version 7.8.2:
 
 - For Redis Software 6.2.* clusters, upgrade Redis 6.0 databases to Redis 6.2. See the [Redis 6.2 release notes](https://raw.githubusercontent.com/redis/redis/6.2/00-RELEASENOTES) for the list of changes.
 
 - For Redis Software 7.2.4 and 7.4.2 clusters, upgrade Redis 6.0 databases to Redis 7.2. Before you upgrade your databases, see the list of [Redis 7.2 breaking changes]({{< relref "/operate/rs/release-notes/rs-7-2-4-releases/rs-7-2-4-52#redis-72-breaking-changes" >}}) and update any applications that connect to your database to handle these changes.
 
 #### Ubuntu 18.04 not supported
 
-Ubuntu 18.04 was deprecated in Redis Software version 7.2.4 and is no longer supported as of Redis Software version 7.8.0.
+Ubuntu 18.04 was deprecated in Redis Software version 7.2.4 and is no longer supported as of Redis Software version 7.8.2.
 
 ### Upcoming changes
 

content/operate/rs/release-notes/rs-7-8-releases/rs-7-8-0-tba.md renamed to content/operate/rs/release-notes/rs-7-8-releases/rs-7-8-2-tba.md

@@ -1,17 +1,17 @@
 ---
-Title: Redis Software release notes 7.8.0-tba (October 2024)
+Title: Redis Software release notes 7.8.2-tba (October 2024)
 alwaysopen: false
 categories:
 - docs
 - operate
 - rs
 compatibleOSSVersion: Redis 7.4.0
 description: Client-side caching support. New APIs to check database availability, rebalance shards, fail over shards, and control database traffic. Cluster Manager UI enhancements for node actions, database tags, and database configuration. Log rotation based on both size and time. Module management enhancements. V2 Prometheus metrics. Configurable minimum password length. Configurable license expiration alert threshold.
-linkTitle: 7.8.0-tba (October 2024)
+linkTitle: 7.8.2-tba (October 2024)
 weight: 90
 ---
 
-​[​Redis Software version 7.8.0](https://redis.com/redis-enterprise-software/download-center/software/) is now available!
+​[​Redis Software version 7.8.2](https://redis.com/redis-enterprise-software/download-center/software/) is now available!
 
 ## Highlights
 
@@ -47,7 +47,7 @@ This version offers:
 
     - For more information, see the [client-side caching introduction]({{<relref "/develop/connect/clients/client-side-caching">}}) and [client-side caching compatibility with Redis Software]({{<relref "/operate/rs/references/compatibility/client-side-caching">}}).
 
-- [Database availability API](<!--TODO: Add link-->), which verifies whether a Redis Software database is available to peform read and write operations and can respond to queries from client applications. Load balancers and automated monitoring tools can use this API to monitor database availability.
+- [Database availability API]({{<relref "/operate/rs/references/rest-api/requests/bdbs/availability">}}), which verifies whether a Redis Software database is available to perform read and write operations and can respond to queries from client applications. Load balancers and automated monitoring tools can use this API to monitor database availability.
 
 - [Rebalance shard placement REST API request](<!--TODO: Add REST API ref link-->), which distributes the database's shards across nodes based on the database's shard placement policy. See [Shard placement policy]({{<relref "/operate/rs/databases/memory-performance/shard-placement-policy">}}) for more information about shard placement and available policies.
 
@@ -95,7 +95,7 @@ This version offers:
 
 #### Redis module feature sets
 
-Redis Software comes packaged with several modules. As of version 7.8.0, Redis Software includes three feature sets, compatible with different Redis database versions.
+Redis Software comes packaged with several modules. As of version 7.8.2, Redis Software includes three feature sets, compatible with different Redis database versions.
 
 The following table shows which Redis modules are compatible with each Redis database version included in this release.
 
@@ -153,7 +153,7 @@ The following table shows which Redis modules are compatible with each Redis dat
 
 ### Breaking changes
 
-Redis Software version 7.8.0 introduces the following breaking changes:
+Redis Software version 7.8.2 introduces the following breaking changes:
 
 - When you upgrade a database, the upgrade process also attempts to upgrade database modules by default.
 
@@ -237,21 +237,21 @@ New Redis modules will not be available for download from the Redis download cen
 
 #### Legacy UI not supported
 
-The legacy UI was deprecated in favor of the new Cluster Manager UI in Redis Software version 7.2.4 and is no longer supported as of Redis Software version 7.8.0.
+The legacy UI was deprecated in favor of the new Cluster Manager UI in Redis Software version 7.2.4 and is no longer supported as of Redis Software version 7.8.2.
 
 #### Redis 6.0 databases not supported
 
-Redis database version 6.0 was deprecated in Redis Software version 7.4.2 and is no longer supported as of Redis Software version 7.8.0.
+Redis database version 6.0 was deprecated in Redis Software version 7.4.2 and is no longer supported as of Redis Software version 7.8.2.
 
-To prepare for the removal of Redis database version 6.0 before you upgrade to Redis Software version 7.8.0:
+To prepare for the removal of Redis database version 6.0 before you upgrade to Redis Software version 7.8.2:
 
 - For Redis Software 6.2.* clusters, upgrade Redis 6.0 databases to Redis 6.2. See the [Redis 6.2 release notes](https://raw.githubusercontent.com/redis/redis/6.2/00-RELEASENOTES) for the list of changes.
 
 - For Redis Software 7.2.4 and 7.4.2 clusters, upgrade Redis 6.0 databases to Redis 7.2. Before you upgrade your databases, see the list of [Redis 7.2 breaking changes]({{< relref "/operate/rs/release-notes/rs-7-2-4-releases/rs-7-2-4-52#redis-72-breaking-changes" >}}) and update any applications that connect to your database to handle these changes.
 
 #### Ubuntu 18.04 not supported
 
-Ubuntu 18.04 was deprecated in Redis Software version 7.2.4 and is no longer supported as of Redis Software version 7.8.0.
+Ubuntu 18.04 was deprecated in Redis Software version 7.2.4 and is no longer supported as of Redis Software version 7.8.2.
 
 ### Upcoming changes
 
@@ -300,7 +300,7 @@ The following table provides a snapshot of supported platforms as of this Redis
 
 The following table shows the SHA256 checksums for the available packages:
 
-| Package | SHA256 checksum (7.8.0-tba Oct release) |
+| Package | SHA256 checksum (7.8.2-tba Oct release) |
 |---------|---------------------------------------|
 | Ubuntu 20 | <span class="break-all"></span> |
 | Red Hat Enterprise Linux (RHEL) 8 | <span class="break-all"></span> |
@@ -335,7 +335,7 @@ As part of Redis's commitment to security, Redis Software implements the latest
 
 Some CVEs announced for open source Redis do not affect Redis Software due to different or additional functionality available in Redis Software that is not available in open source Redis.
 
-Redis Software 7.8.0-tba supports open source Redis 7.4, 7.2, and 6.2. Below is the list of open source Redis CVEs fixed by version.
+Redis Software 7.8.2-tba supports open source Redis 7.4, 7.2, and 6.2. Below is the list of open source Redis CVEs fixed by version.
 
 Redis 7.2.x: