DOC-2514 Known limitation & workaround for root directory installatio…

…n in release notes

content/rs/release-notes/rs-6-0-12-january-2021.md

@@ -19,26 +19,26 @@ This version includes the following new features and improvements:
 
 And other functional and stability improvements.
 
-### Version information
+## Version information
 
-#### Upgrade instructions
+### Upgrade instructions
 
 - Follow [these instructions]({{<relref "/rs/installing-upgrading/upgrading">}}) for upgrading to RS 6.0.12 from RS 5.4.0 and above.
 - For Active-Active deployments, this release requires that you [upgrade the CRDB featureset version]({{<relref "/rs/installing-upgrading/upgrading/upgrade-active-active">}}).
 
-#### Product lifecycle information
+### Product lifecycle information
 
 - End of Life (EOL) for Redis Enterprise Software 6.0 and previous RS versions, can be found [here]({{<relref "/rs/installing-upgrading/product-lifecycle.md">}}).
 - EOL for Redis modules can be found [here]({{<relref "/stack/modules-lifecycle#modules-endoflife-schedule">}}).
 
-#### Deprecation Notice
+### Deprecation Notice
 
 - Support for RS 5.4.X ended on December 31, 2020.
 - Support for Red Hat Enterprise Linux 6 and Oracle Linux 6 and Ubuntu 14.04 (Trusty) operating systems platforms ended on November 30, 2020.
 - This is the last RS version that supports direct upgrades from versions below 5.6.0.
 - This is the last RS version that supports Active-Active protocol version below 1 and featureset version below 1.
 
-### New Features
+## New Features
 
 #### Distributed Syncer
 
@@ -102,7 +102,7 @@ To enable the syncer automatic recovery, do these steps on each participating cl
 
 The syncer process restarts to with automatic recovery on.
 
-### Redis modules
+## Redis modules
 
 The following GA releases of Redis modules are bundled with RS 6.0.12:
 
@@ -114,14 +114,14 @@ The following GA releases of Redis modules are bundled with RS 6.0.12:
 
 To use the updated modules with a database, you must [upgrade the module on the database]({{<relref "/stack/install/upgrade-module">}}).
 
-### Additional capabilities
+## Additional capabilities
 
 - RS 6.0.12 includes open source Redis 6.0.6. For more information about Redis 6.0.6, check out the [release notes](https://raw.githubusercontent.com/redis/redis/6.0.6/00-RELEASENOTES).
 - The bundled Nginx version was updated from version 1.16.0 to 1.18.0.
 - The crdb-cli syntax to remove an instance is changed from
 `remove-instance [--ordered|--unordered]` to `remove-instance [--force|--no-force]`.
 
-### Important fixes
+## Important fixes
 
 - RS45627, RS47382 - Fixed bugs causing clients to disconnect when using XREAD and XREADGROUP commands in blocking mode on other clients’ connections.
 - RS44656 - Fixed a bug causing TLS mode for clients connections to toggle between ‘all communication’ to ‘for crdb communication only’ when performing a global configuration change.
@@ -136,10 +136,20 @@ with 6.0.12-58:
 - RS51359 - Fixed a memory leak on replica shards in Active-Active databases with replication and AOF for persistence.
 - RS52363 - Updated PUB/SUB max message value size from 64KB to 512MB 
 
-### Known limitations
+## Known limitations
 
 -RS81463 - A shard may crash when resharding an Active-Active database with Redis on Flash (RoF). Specifically, the shard will crash when volatile keys or Active-Active tombstone keys reside in Flash memory.
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 #### Upgrade
 
 - [RS 5.4.2]({{<relref "/rs/release-notes/legacy-release-notes/rs-5-4-2-april-2019.md">}}) introduced new Active-Active Redis Database capabilities that improve its compatibility with open source Redis. Now the string data-type in Active-Active Redis Database is implicitly and dynamically typed, just like open source Redis. To use the new capabilities on nodes that are upgraded from version RS 5.4.2 or lower, you must [upgrade the Active-Active Redis Database protocol]({{<relref "/rs/installing-upgrading/upgrading#upgrading-crdbs">}}).

content/rs/release-notes/rs-6-0-20-april-2021.md

@@ -34,9 +34,9 @@ improvements:
 
 And other functional and stability improvements.
 
-### Version information
+## Version information
 
-#### Upgrade instructions
+### Upgrade instructions
 
 -   Follow [these instructions]({{<relref "/rs/installing-upgrading/upgrading">}})
     for upgrading to Redis Software 6.0.20 from Redis Software 5.6.0 and above.
@@ -50,7 +50,7 @@ And other functional and stability improvements.
     Active-Active databases running on protocol version 0 and/or featureset
     version 0 will block the upgrade.
 
-#### Product lifecycle information
+### Product lifecycle information
 
 -   End of Life (EOL) for Redis Enterprise Software 6.0 and earlier 
     versions, can be found
@@ -59,7 +59,7 @@ And other functional and stability improvements.
 -   EOL for Redis modules can be found
     [here]({{<relref "/stack/modules-lifecycle#modules-endoflife-schedule">}}).
 
-#### Deprecation Notice
+### Deprecation Notice
 
 -   Upgrades to the next Redis Software will be enabled from version 6.0 and above.
 
@@ -197,6 +197,16 @@ All known bugs around setting ciphers were fixed.  To learn more, see [Configure
 -   RS61114 - Active-Active synchronization will fail in the following scenario: a new syncer connection is established AND a partial sync (psync) was initiated AND a cron job runs before the first ACK of the psync was received.
 -   RS55504 - Bug RS6.0.20-66 (Build #66) causes RediSearch cursor to break. Please upgrade to a higher build when running with RediSearch.
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 #### Upgrade
 
 -   [Redis Software 5.4.2]({{<relref "/rs/release-notes/legacy-release-notes/rs-5-4-2-april-2019.md">}})

content/rs/release-notes/rs-6-0-8-september-2020.md

@@ -75,6 +75,16 @@ With build 6.0.8-32:
 - RS44656 - A bug causing TLS mode for clients connections to toggle between ‘all communication’ to ‘for crdb communication only’ when performing a global configuration change. ***TBD***
 - RS51359 - Active-Active databases, using replication and Append Only File (AOF) for [Database persistence]({{< relref "/rs/databases/configure/database-persistence.md" >}}), are suffering from memory leaks on replica shards, causing them to grow bigger than the master shards. Customers are advised to upgrade to RS 6.0.12 ***TBD***. Meanwhile you can use snapshots for database persistence or restart the replica shards ***TBD***.
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 ### Upgrade
 
 - [RS 5.4.2]({{< relref "rs/release-notes/legacy-release-notes/rs-5-4-2-april-2019.md" >}}) introduced new Active-Active Redis Database capabilities that improve its compatibility with open source Redis. Now the string data-type in Active-Active Redis Database is implicitly and dynamically typed, just like open source Redis. To use the new capabilities on nodes that are upgraded from version RS 5.4.2 or lower, you must [upgrade the Active-Active Redis Database protocol]({{< relref "/rs/installing-upgrading/upgrading#upgrading-crdbs" >}}).

content/rs/release-notes/rs-6-0-may-2020.md

@@ -111,6 +111,16 @@ To use the updated modules with a database, you must [upgrade the module on the
 ### Active-Active databases
 - RS51359 - Active-Active databases, using replication and Append Only File (AOF) for [database persistence]({{< relref "/rs/databases/configure/database-persistence.md" >}}), are suffering from memory leaks on replica shards, causing them to grow bigger than the master shards. Customers are advised to upgrade to RS 6.0.12 ***TBD***. Meanwhile you can use snapshots for database persistence or restart the replica shards ***TBD***.
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 ### Upgrade
 
 - RS 5.4.2 introduced new Active-Active Redis Database capabilities that improve its compatibility with open source Redis. Now the string data-type in Active-Active Redis Database is implicitly and dynamically typed, just like open source Redis. To use the new capabilities on nodes that are upgraded from version RS 5.4.2 or lower, you must upgrade the Active-Active Redis Database protocol.

content/rs/release-notes/rs-6-2-10-february-2022.md

@@ -154,6 +154,16 @@ For help upgrading a module, see [Add a module to a cluster](https://docs.redis.
 
 All [known limitations]({{<relref "/rs/release-notes/rs-6-2-4-august-2021.md#known-limitations">}}) listed in the v6.2.4 release notes have been addressed.
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 ## Known issues
 
 - The `ZRANGESTORE` command, with a special `zset-max-ziplist-entries` configuration can crash Redis 6.2. See [Redis repository 10767](https://github.com/redis/redis/pull/10767) for more details.

content/rs/release-notes/rs-6-2-12.md

@@ -123,6 +123,16 @@ For help upgrading a module, see [Add a module to a cluster](https://docs.redis.
 
 - RS40641 - API requests are redirected to an internal IP in case the request arrives from a node which is not the master. To avoid this issue, use [`rladmin cluster config`]({{<relref "/rs/references/cli-utilities/rladmin/cluster/config">}}) to configure `handle_redirects` or `handle_metrics_redirects`.
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 ## Security
 
 ### Open Source Redis Security fixes compatibility

content/rs/release-notes/rs-6-2-18-releases/_index.md

@@ -65,6 +65,16 @@ Certain operating systems, such as RHEL 8, have already removed support for 3DES
 
 - RS51144, RS102128 - Active-Active: To start successfully, the syncer (`crdt-syncer`) must connect to all sources. In multi-cluster configurations (more than 2 A-A clusters participating), in some cases, if one or more of the clusters is not available, A-A replication will be down.
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 ### Upgrade limitations
 
 Before you upgrade a cluster that hosts Active-Active databases with modules to v6.2.18, perform the following steps:

content/rs/release-notes/rs-6-2-4-august-2021.md

@@ -155,6 +155,18 @@ To learn more, see [`rladmin upgrade`]({{<relref "/rs/references/cli-utilities/r
 
 - RS48988 - Add the username description in the log upon an unauthorized REST API request
 
+## Known limitations
+
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 ## Known issues 
 
 - A new command was added as part of Redis 6.2: [`XAUTOCLAIM`](https://redis.io/commands/xautoclaim/). When used in an Active-Active configuration, this command may cause Redis shards to crash, potentially resulting in data loss. The issue is fixed in Redis Enterprise Software version 6.2.12. Additionally, we recommend enabling AOF persistence for all Active-Active configurations.

content/rs/release-notes/rs-6-2-8-october-2021.md

@@ -96,6 +96,16 @@ To learn more, see [Upgrade the module for a database]({{<relref "/stack/install
 
 All [known limitations]({{<relref "/rs/release-notes/rs-6-2-4-august-2021.md#known-limitations">}}) from v6.2.4 have been fixed. 
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 ## Known issues 
 
 - A new command was added as part of Redis 6.2: [`XAUTOCLAIM`](https://redis.io/commands/xautoclaim/). When used in an Active-Active configuration, this command may cause Redis shards to crash, potentially resulting in data loss. The issue is fixed in Redis Enterprise Software version 6.2.12. Additionally, we recommend enabling AOF persistence for all Active-Active configurations.

content/rs/release-notes/rs-6-4-2-releases/_index.md

@@ -91,6 +91,16 @@ After the resharding process is complete, you can re-enable rack awareness:
 curl -k -u "<user>:<password>" -H "Content-type: application/json" -d '{"rack_aware": true}' -X PUT "https://localhost:9443/v1/bdbs/<bdb_uid>"
 ```
 
+### Installation limitations
+
+Several Redis Enterprise Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories]({{<relref "/rs/installing-upgrading/install/customize-install-directories">}}).
+
+As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:
+
+1. Create all custom, non-root directories you want to use with Redis Enterprise Software.
+
+1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.
+
 ### Upgrade limitations
 
 Before you upgrade a cluster that hosts Active-Active databases with modules to v6.4.2-30, perform the following steps: