5.6 release notes (#731)

Author: Ben Mansheim

content/rs/release-notes/legacy-release-notes/_index.md

@@ -0,0 +1,8 @@
+---
+Title: Previous Releases
+description:
+weight: 100
+alwaysopen: false
+categories: ["RS"]
+---
+{{%allchildren style="h2" sort="Weight"%}}

content/rs/release-notes/redis-enterprise-5.md renamed to content/rs/release-notes/legacy-release-notes/redis-enterprise-5.md

@@ -0,0 +1,163 @@
+---
+Title: Redis Enterprise Software Release Notes 5.6.0 (April 2020)
+description:
+weight: 81
+alwaysopen: false
+categories: ["RS"]
+---
+[Redis Enterprise Software (RS) 5.6.0](https://redislabs.com/download-center.md#downloads" >}}) is now available. This major version release includes:
+
+- Improved installation process to be customizable
+- Support for the HyperLogLog data type in Active-Active databases
+- RedisJSON support in Redis on Flash databases
+- Support for Redis OSS Cluster API for Active-Active and Replica Of databases
+- Slave HA enabled by default for Active-Active databases
+- Cloud backup locations support
+- Support for Red Hat Enterprise Linux version 7.7
+- Additional enhancements, and minor bug fixes
+
+## Information
+
+### Upgrade
+
+- Follow [these instructions]({{< relref "/rs/installing-upgrading/upgrading.md" >}}) for upgrading to RS 5.6.0 from RS 5.0.2 and above.
+
+### End of Life
+
+- End of Life (EOL) for Redis Enterprise Software 5.6 and previous RS versions can be found [here]({{< relref "/rs/administering/product-lifecycle.md" >}}).
+    EOL for Redis Modules can be found [here]({{< relref "/modules/modules-lifecycle.md#modules-endoflife-schedule" >}}).
+- Support of Red Hat Enterprise Linux 6 and Oracle Linux 6 [operating systems platforms]({{< relref "/rs/installing-upgrading/supported-platforms.md" >}}) will end on November 30, 2020.
+- Support of OpenStack Object Storage ("Swift") for [backup, import and export location]({{< relref "/rs/administering/database-operations/importing-data.md" >}}) will end on November 30, 2020.
+
+## New Features
+
+### Redis Software Installer
+
+Redis Enterprise Software installer adds the ability to specify custom installation paths and a custom installation user, group, or both on RHEL versions 6 and 7.
+
+When you run the installer you can specify the installation, the configuration and the var as well as the user and the group:
+
+```src
+sudo ./install.sh --install-dir <path> --config-dir <path> --var-dir <path> --os-user <user> --os-group <group>
+```
+
+For more information, check out the [Redis Enterprise Software installer documentation]({{< relref "/rs/installing-upgrading/_index.md" >}}).
+
+### Hyperloglog on Active-Active
+
+RS 5.6.0 adds the support of [HyperLogLog](http://www.antirez.com/news/75) data structure for [Active-Active Redis]({{< relref "/rs/administering/active-active.md" >}}) Databases.
+
+Because HyperLogLog is a counting data structure by nature, conflicts can occur when deleting entries. For efficiency, performance and memory considerations, conflicts between instances are resolved with DEL (delete) operations winning over ADD operations that took place in concurrent or before the DEL operation.
+
+For more information, check out the [HyperLogLog on Active-Active documentation]({{< relref "/rs/developing/crdbs/developing-hll-crdb.md" >}}).
+
+### RedisJSON on Redis on Flash
+
+RS 5.6.0 adds support for [Redis on Flash]({{< relref "/rs/concepts/memory-architecture/redis-flash.md" >}}) (RoF) databases with [Redis Modules]({{< relref "/modules/_index.md" >}}). [RedisJSON]({{< relref "/modules/redisjson/_index.md" >}}) is the first module to be available to run on a Redis on Flash database.
+
+Using RedisJSON on Redis on Flash allows you to benefit from high performance redis with high data volume at lower costs.
+
+### OSS Cluster API Support
+
+For more information, check out the [OSS Cluster API documentation]({{< relref "/rs/administering/designing-production/networking/using-oss-cluster-api.md" >}}).
+
+**Support for Active-Active and Replica Of databases**
+
+You can configure [Active-Active]({{< relref "/rs/administering/active-active.md" >}}) and [Replica Of]({{< relref "/rs/administering/active-passive.md" >}}) databases to use the [OSS Cluster API]({{< relref "/rs/concepts/data-access/oss-cluster-api.md" >}}) using the web UI.
+The OSS Cluster API improves the performance of user operations against your database.
+
+You can also create or modify an Active-Active Redis database in OSS Cluster mode using the `crdb-cli` tool with the `--oss-cluster` option to apply the changes to all of the instances.
+
+**Create and edit database using the web UI**
+
+You can configure OSS Cluster API for databases using the web UI.
+
+For Active-Active databases, you can create the database with OSS Cluster API enabled for all of its instances.
+When you enable OSS Cluster after the Active-Active database is created, the change applies only to the local instance.
+
+### Slave HA defaults for Active-Active
+
+To enhance the availability and the consistency of [Active-Active Geo-Distributed Redis]({{< relref "/rs/administering/active-active.md" >}}),
+[Slave HA]({{< relref "/rs/administering/database-operations/slave-ha.md" >}}) is enabled by default for all existing and new Active-Active Redis Databases.
+
+To disable Slave HA for for a local instance of an Active-Active database, run this command on the instance: `rladmin tune db <bdb_uid> slave_ha disabled`
+
+### Cloud Backup Locations Support
+
+Redis Enterprise 5.6.0 adds the ability to configure Azure Blob Storage and Google Cloud Storage as backup, import, and export locations.
+
+### Red Hat Enterprise Linux 7.7
+
+Redis Enterprise 5.6.0 adds RHEL 7.7 to its [supported platforms]({{< relref "/rs/installing-upgrading/supported-platforms.md" >}}).
+
+## Redis Modules
+
+The following GA releases of Redis Modules are bundled in RS 5.6.0:
+
+- [RedisBloom](https://redislabs.com/redis-enterprise/redis-bloom.md" >}}), version [2.2.1]({{< relref "/modules/redisbloom/release-notes/redisbloom-2.2-release-notes.md" >}})
+- [RedisGraph](https://redislabs.com/redis-enterprise/redis-graph.md" >}}), version [2.0.10]({{< relref "/modules/redisgraph/release-notes/redisgraph-2.0-release-notes.md" >}})
+- [RedisJson](https://redislabs.com/redis-enterprise/redis-json.md" >}}), version [1.0.4]({{< relref "/modules/redisjson/release-notes/redisjson-1.0-release-notes.md" >}})
+- [RediSearch](https://redislabs.com/redis-enterprise/redis-search.md" >}}), version [1.6.11]({{< relref "/modules/redisearch/release-notes/redisearch-1.6-release-notes.md" >}}) (updated)
+- [RedisTimeSeries](https://redislabs.com/redis-enterprise/redis-time-series.md" >}}), version [1.2.3]({{< relref "/modules/redistimeseries/release-notes/redistimeseries-1.2-release-notes.md" >}})
+
+## Additional Capabilities
+
+- OSS Redis version [5.0.8](https://raw.githubusercontent.com/antirez/redis/5.0/00-RELEASENOTES)  is merged into RS 5.6.0.
+- Starting RS 5.6.0, to upgrade modules during database upgrade you must use the module_args option instead of keep_module_args or <argument> or “ ” (for no arguments). The module_args option must follow with one of the following (Always in quotation marks): “keep_args” or “ “ or “<argument>”.
+For more info and examples, check out [upgrading Redis Modules documentation]({{< relref "/modules/upgrading-rs.md#upgrading-the-module-for-the-database" >}}) .
+- rladmin adds the ability to demote the cluster master node when setting it to [maintenance mode]({{< relref "/rs/administering/cluster-operations/maintenance-mode.md" >}}) by using the `demote_node` option:
+
+```src
+rladmin node <node_uid> maintenance_mode on demote_node
+```
+
+- The `SENTINEL MASTER` command output format was updated to be aligned with OSS equivalent output.
+
+## Important Fixes
+
+- RS38315, RS33747 - Added the LUA script name (SHA) and its arguments to the warning message indicating the LUA script has been running for more than 5 seconds.
+- RS38706 - Fixed a bug which caused a stuck state machine in some scenarios of restoring DB from RDB.
+- RS34309 - Improved internal passwords handling.
+- RS38498 - Fixed a bug in the upgrade process of a database to avoid failure when saving large RDB (Redis Database Backup) file.
+- RS38706 - Fixed a bug that caused a stuck state machine after restoring a snapshot of an Active-Active database.
+
+
+## Known Limitations
+
+### Upgrade Notes
+
+- [RS 5.4.2]({{< relref "/rs/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.md#upgrading-crdbs" >}}).
+- When you upgrade an Active-Active Redis with active AOF from version [RS 5.4.2]({{< relref "/rs/release-notes/rs-5-4-2-april-2019.md" >}}) or earlier to version [RS 5.4.4]({{< relref "/rs/release-notes/rs-5-4-4-june-2019.md" >}}) or later:
+    - If replication is enabled, you must run the BGREWRITEAOF command on all slave shards after the upgrade.
+    - If replication is not enabled, you must run the BGREWRITEAOF command on all shards after the upgrade.
+- Node upgrade fails if the SSL certificates were configured in version 5.0.2 or above by manually updating the certificates on the disk instead of [updating them through the API]({{< relref "/rs/administering/cluster-operations/updating-certificates.md" >}}).
+    For assistance with this issue, contact Support.
+- Starting from [RS 5.4.2]({{< relref "/rs/release-notes/rs-5-4-2-april-2019.md" >}}), to preserve the current Redis major.minor version during database upgrade you must use the keep_redis_version option instead of keep_current_version.
+- Google Chrome browser on macOS Catalina requires a self-signed certificate generated after June 2019 to include the extendedKeyUsage field in order to connect to the RS web UI. If you use a self-signed certificate that does not include this field, [update the self-signed certificate]({{< relref "/rs/administering/cluster-operations/updating-certificates.md" >}}).
+
+### Modules Upgrade
+
+- We recommend that you test module upgrade commands in a test environment before you upgrade modules in a production environment. The module upgrade arguments are not validated during the upgrade process and incorrect arguments can cause unexpected downtime.
+- Before you upgrade a database with RediSearch Module to Redis 5.0, you must [upgrade the RediSearch Module]({{< relref "/modules/upgrading-rs.md" >}}) to version 1.4.2 or above.
+
+### Cluster API
+
+- The API for removing a node is updated in [RS 5.4.2]({{< relref "/rs/release-notes/rs-5-4-2-april-2019.md" >}}) or higher. The API call must include json data and the "Content-Type: application/json" header. For example:
+
+    ```src
+    curl -X POST -H "Content-Type: application/json" -i -k -u user@redislabs.com:password https://localhost:9443/v1/nodes/3/actions/remove --data "{}"
+    ```
+
+### Discover Service
+
+- For [Redis Sentinel (Discovery Service)]({{< relref "/rs/concepts/data-access/discovery-service.md" >}}), every database name must be unique across the cluster.
+
+### Redis Commands
+
+- The capability of disabling specific Redis commands does not work on commands specific to Redis Modules.
+- The CLIENT ID command cannot guarantee incremental IDs between clients that connect to different nodes under multi proxy policies.
+- CLIENT UNBLOCK command is not supported in RS 5.4 and above
+- Starting from RS 5.4.2 and after upgrading the CRDB, TYPE commands for string data-type in CRDBs return "string" (OSS Redis standard).