ContextQMD
Back to Redis

Rs 5 6 0 April 2020

content/operate/rs/release-notes/legacy-release-notes/rs-5-6-0-april-2020.md

latest12.6 KB
Original Source

Redis Enterprise Software (RS) 5.6.0 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 databases with Auto Tiering enabled
  • Support for Redis OSS Cluster API for Active-Active and Replica Of databases
  • Replica HA enabled by default for Active-Active databases
  • Cloud backup locations support
  • Support for Red Hat Enterprise Linux version 7.7, 7.8
  • Additional enhancements, and minor bug fixes

Information

Upgrade

  • Follow [these instructions]({{< relref "/operate/rs/installing-upgrading/upgrading" >}}) for upgrading to RS 5.6.0 from RS 5.0.2 and above.
  • For Active-Active databases, you must upgrade the [feature set version]({{< relref "/operate/rs/installing-upgrading/upgrading" >}}#upgrade-activeactive-databases).

End of life

  • End of Life (EOL) for Redis Enterprise Software 5.6 and previous RS versions can be found [here]({{< relref "/operate/rs/installing-upgrading/product-lifecycle" >}}). EOL for Redis Modules can be found [here]({{< relref "/operate/oss_and_stack/stack-with-enterprise/modules-lifecycle" >}}#modules-endoflife-schedule).
  • Support of Red Hat Enterprise Linux 6 and Oracle Linux 6 [operating systems platforms]({{< relref "/operate/rs/references/supported-platforms" >}}) will end on November 30, 2020.
  • Support of OpenStack Object Storage ("Swift") for backup, import and export location 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:

sh
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.

Hyperloglog on Active-Active

RS 5.6.0 adds the support of HyperLogLog data structure for [Active-Active Redis]({{< relref "/operate/rs/databases/import-export/replica-of" >}}) 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 "/operate/rs/databases/active-active" >}}develop/hyperloglog-active-active.md).

RedisJSON on Auto Tiering

RS 5.6.0 adds support for [Auto Tiering]({{< relref "/operate/rs/databases/flash/" >}}) databases with Redis Modules. [RedisJSON]({{< relref "/operate/oss_and_stack/stack-with-enterprise/json" >}}) is the first module to be available to run on a database with Auto Tiering enabled.

Using RedisJSON on Auto Tiering 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 "/operate/rs/databases/configure/oss-cluster-api.md" >}}).

Support for Active-Active and Replica Of databases

You can configure [Active-Active]({{< relref "/operate/rs/databases/import-export/replica-of" >}}) databases to use the OSS Cluster API using the admin console. 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 admin console

You can configure OSS Cluster API for databases using the admin console.

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.

Replica HA defaults for Active-Active

To enhance the availability and the consistency of [Active-Active geo-distributed Redis]({{< relref "/operate/rs/databases/active-active" >}}), [Replica HA]({{< relref "/operate/rs/databases/configure/replica-ha" >}}) is enabled by default for all existing and new Active-Active Redis Databases.

To disable Replica 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, 7.8

Redis Enterprise 5.6.0 adds RHEL 7.7, 7.8 to its [supported platforms]({{< relref "/operate/rs/references/supported-platforms" >}}).

Redis modules

The following GA releases of Redis Modules are bundled in RS 5.6.0:

  • RedisBloom, version [2.2.1]({{< relref "/operate/oss_and_stack/stack-with-enterprise" >}}release-notes/redisbloom/redisbloom-2.2-release-notes)
  • RedisGraph, version [2.0.10]({{< relref "/operate/oss_and_stack/stack-with-enterprise" >}}release-notes/redisgraph/redisgraph-2.0-release-notes)
  • RedisJson, version [1.0.4]({{< relref "/operate/oss_and_stack/stack-with-enterprise" >}}release-notes/redisjson/redisjson-1.0-release-notes)
  • RediSearch, version [1.6.11]({{< relref "/operate/oss_and_stack/stack-with-enterprise" >}}release-notes/redisearch/redisearch-1.6-release-notes) (updated)
  • RedisTimeSeries, version [1.2.3]({{< relref "/operate/oss_and_stack/stack-with-enterprise" >}}release-notes/redistimeseries/redistimeseries-1.2-release-notes)

Additional capabilities

  • OSS Redis version 5.0.8 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 "/operate/oss_and_stack/stack-with-enterprise/install/upgrade-module" >}}) .
  • rladmin adds the ability to demote the cluster master node when setting it to [maintenance mode]({{< relref "/operate/rs/clusters/maintenance-mode.md" >}}) by using the demote_node option:
sh
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.
  • RS43996 - Fixed a bug in the upgrade process when using ./install.sh -y and firewalld is not running.
  • RS45777 - Fixed a bug that caused clients on a shared connection to the proxy to get disonnected. Disconnections occured in case a response for a request of an already disconnected client was received. With build 5.6.0-39:
  • 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.

Known limitations

Active-Active databases

  • RS51359 - Active-Active databases, using replication and Append Only File (AOF) for [database persistence]({{<relref "/operate/rs/databases/configure/database-persistence">}}), 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. Meanwhile, you can use a snapshot for database persistence or restart the replica shards.

Upgrade notes

  • [RS 5.4.2]({{< relref "/operate/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 "/operate/rs/installing-upgrading/upgrading#upgrading-crdbs" >}}).
  • When you upgrade an Active-Active Redis with active AOF from version [RS 5.4.2]({{< relref "/operate/rs/release-notes/legacy-release-notes/rs-5-4-2-april-2019.md" >}}) or lower to version [RS 5.4.4]({{< relref "/operate/rs/release-notes/legacy-release-notes/rs-5-4-4-june-2019.md" >}}) or higher:
    • If replication is enabled, you must run the BGREWRITEAOF command on all replica 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 "/operate/rs/security/certificates/updating-certificates" >}}). For assistance with this issue, contact Support.
  • Starting from [RS 5.4.2]({{< relref "/operate/rs/release-notes/legacy-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 admin console. If you use a self-signed certificate that does not include this field, [update the self-signed certificate]({{< relref "/operate/rs/security/certificates/updating-certificates" >}}).

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 "/operate/oss_and_stack/stack-with-enterprise/install/upgrade-module" >}}) to version 1.4.2 or above.

Cluster API

  • The API for removing a node is updated in [RS 5.4.2]({{< relref "/operate/rs/release-notes/legacy-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:

    sh
    curl -X POST -H "Content-Type: application/json" -i -k -u [email protected]:password https://localhost:9443/v1/nodes/3/actions/remove --data "{}"

Discover service

  • For [Redis Sentinel (Discovery Service)]({{< relref "/operate/rs/databases/durability-ha/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).