Skip to content

Commit

Permalink
RS v6.0.20 release notes (#1316)
Browse files Browse the repository at this point in the history
* Follow-up to PR #1231; fixing assorted minor issues  (#1311)

* First set of quick fixes.

* More edits and updates, mainly to redirects.

* Updating python library to be more current.

* Updating backup article aliases (#1315)

* First set of quick fixes.

* More edits and updates, mainly to redirects.

* Updating python library to be more current.

* Updating aliases

* Initial draft for release notes
  • Loading branch information
lanceleonard authored Apr 13, 2021
1 parent b2dfe45 commit db34f15
Show file tree
Hide file tree
Showing 9 changed files with 244 additions and 19 deletions.
13 changes: 8 additions & 5 deletions content/rc/databases/back-up-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,18 @@ weight: 40
alwaysopen: false
categories: ["RC"]
linktitle: Back up data
aliases: /rv/administration/configure/backups/
/rc/administration/configure/backups/
/rv/administration/configuration/backups/
/rc/databases/backups/
aliases: [ "/rv/administration/configure/backups/",
"/rc/administration/configure/backups/",
"/rv/administration/configuration/backups/",
"/rc/administration/configuration/backups.md",
"/rc/administration/configuration/backups/",
"/rc/databases/backups/" ]

---

The back up process for Redis Enterprise Cloud data depends on your plan:

- Flexible and Annual can use the **Backup** icon on the View Database screen or schedule regular backups.
- Flexible and Annual can use the **Backup** icon on the **View Database** screen or schedule regular backups.

- Paid Fixed plans run scheduled backups every 24 hours.

Expand Down
3 changes: 2 additions & 1 deletion content/rc/databases/import-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,9 @@ categories: ["RC"]
linktitle: Import data
aliases: /rv/how-to/importing-dataset-redis-cloud/
/rc/how-to/importing-dataset-redis-cloud/
/rc/how-to/importing-data-database/
/rv/how-to/importing-data-database/
/rc/how-to/importing-data-database/
/rc/how-to/importing-data-database.md
/rc/databases/import-data/
---
You can import an existing dataset into your Redis Cloud instance from an existing Redis server or an RDB file.
Expand Down
2 changes: 2 additions & 0 deletions content/rc/databases/view-edit-database.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ alwaysopen: false
categories: ["RC"]
aliases: /rc/administration/setup-and-editing/viewing-editing-database/
/rv/administration/setup_and_editing/viewing-editing-databases/
/rc/administration/setup/edit-database/
/rc/administration/setup/edit-database.md
---
To view the details of a database, select it from the database list:

Expand Down
27 changes: 15 additions & 12 deletions content/rc/rc-quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,13 +71,15 @@ Next, we create a database.

4. Locate the **Activate** button near the bottom of the page and then select it.

5. You're taken to the Configuration tab of the View Database screen. In the upper corner, you'll see an orange box containing a rotating circle. This is the Pending status indicator and it means your database is still being created.
5. You're taken to the **Configuration** tab of the **View Database** screen. In the upper corner, you'll see an orange box containing a rotating circle. This is the Pending status indicator and it means your database is still being created.

Admin console operations are asychronous; they operate in the background. You can continue to use the admin console for other tasks, but your new database isn't available. When the icon changes to show a green box containing a checkmark, your database is ready to use.
![Pending icon](/images/rc/icon-pending.png#no-click "Pending icon")   ![Active icon](/images/rc/icon-active.png#no-click "Active icon")

Admin console operations are asychronous; they operate [in the background]({{< relref "/rc/api/concepts/provisioning-lifecycle.md" >}}). You can continue to use the admin console for other tasks, but your new database isn't available. When the icon changes to show a green box containing a checkmark, your database is ready to use.

## Connect to a database

At this point, you're at the View Database screen for your new database.
At this point, you're at the **View Database** screen for your new database.

To connect to your database, you need the following info:

Expand All @@ -99,9 +101,9 @@ Once you have the connection details, you can connect in a variety of ways, incl

Here's an example of each.

### Using redic-cli (via Docker){#using-rediscli}
### Using redis-cli (via Docker){#using-rediscli}

The `redis-cli` utility is installed when you install Redis.
The `redis-cli` utility is installed when you install Redis. It provides a command-line interface that lets you work with your database using core [Redis commands](https://redis.io/commands).

Docker provides a covenient way to run `redis-cli` without the full installation experience.

Expand All @@ -122,9 +124,9 @@ When you run the `redis` Docker image, you can open a bash shell instance and ru
xxx:yyy>
```

Replace `<endpoint>`, `<port>`, and `<password>` with the details copied from the **View Database** screen.
Replace `<endpoint>`, `<port>`, and `<password>` with the details copied earlier from the **View Database** screen.

3. You should now be connectde to your database and can perform basic Redis commands:
3. You should now be connectded to your database and can perform basic Redis commands:

``` sh
xxx:yyy> ping
Expand All @@ -139,19 +141,20 @@ When you run the `redis` Docker image, you can open a bash shell instance and ru

Different programming languages use different clients to interact with Redis databases.

Here's how to connect to your database using a client for Python.
Here's how to connect to your database using the `redis-py` library for Python.
1. If you don't already have the client installed:

```sh
sudo pip install redis-client
sudo pip install redis-py
```

2. The specific syntax vries according to the client:

```python
import redis-client
r = redis.Redis(host='<endpoint>', port=<port>, password='<password>')
import redis
r = redis.Redis(host='<endpoint>', port=<port>,
password='<password>')
r.set('hello', 'world')
print(r.get('hello'))
```
Expand All @@ -167,7 +170,7 @@ Here's how to connect to your database using a client for Python.

## More info

- [Manage Databases]({{< relref "/rs/databases/_index.md" >}})
- [Manage Databases]({{< relref "/rc/databases/_index.md" >}})
- [Data Persistence with Redis Cloud]({{< relref "rc/concepts/data-persistence.md" >}})
- [Secure Your Redis Cloud Database]({{< relref "/rc/administration/security/_index.md" >}})
- [Back-up Flexible databases]({{< relref "/rc/databases/back-up-data.md" >}})
Expand Down
2 changes: 2 additions & 0 deletions content/rc/security/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ weight: 51
alwaysopen: false
categories: ["RC"]
aliases: /rc/administration/security
/rs/administering/designing-production/security/

---
Redis Enterprise Cloud provides a number of ways to secure subscription and databases.

Expand Down
5 changes: 4 additions & 1 deletion content/rc/subscriptions/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,15 @@ linktitle: Subscriptions
aliases: /rv/administration/setup_and_editing/
/rc/administration/setup-and-editing/
/rc/administration/setup-editing/
/rc/administration/setup/
/rc/administration/setup/_index.md
/rv/administration/setup_and_editing/create-subscription/
/rv/administration/setup_and_editing/creating-subscription/
/rc/administration/setup/create-subscription/

---

This page helps you manage your Redis Cloud subscriptions; it briefly compares available pland and shows where to find help wth common tasks.
This page helps you manage your Redis Cloud subscriptions; it briefly compares available plans and shows where to find help wth common tasks.

## Subscription plans

Expand Down
2 changes: 2 additions & 0 deletions content/rc/subscriptions/create-flexible-subscription.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ weight: 30
alwaysopen: false
categories: ["RC"]
aliases: /rc/administration/customize-pro/
/rc/administration/customize-pro.md
/rc/administration/setup/customize-pro/
/rc/administration/setup/customize-pro.md
/rc/administration/setup/customize-flexible-plan/
---
Expand Down
3 changes: 3 additions & 0 deletions content/rc/subscriptions/view-fixed-subscription.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,9 @@ aliases: /rv/administration/setup_and_editing/view-edit-subscription/
/rc/administration/setup-and-editing/viewing-subscription/
/rc/administration/setup-and-editing/changing-subscription-plan/
/rc/administration/setup-and-editing/changing-subscription-plan/
/rc/administration/setup/edit-subscription/
/rc/administration/setup/edit-subscription.md

---
To view the details of a Fixed subscription:

Expand Down
206 changes: 206 additions & 0 deletions content/rs/release-notes/rs-6-0-20-april-2021.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,206 @@
---
Title: Redis Enterprise Software Release Notes 6.0.20 (April 2021)
description:
weight: 77
alwaysopen: false
categories: ["RS"]
---
[Redis Enterprise Software version 6.0.20](https://redislabs.com/redis-enterprise-software/download-center/software/)
is now available! This version includes the following new features and
improvements:

- A [new integration for LDAP](https://docs.redislabs.com/latest/rs/security/LDAP) authentication and
authorization into RS role-based access controls (RBAC). You can now use
LDAP to authorize access to the admin console and to authorize database
access.

- An enhanced [clients mutual authentication](https://docs.redislabs.com/latest/rs/security/tls-ssl/)
mechanism, adding the ability to authenticate client connections using a
Certificate Authority (CA).

- Support of [Redis eviction
policies](https://docs.redislabs.com/latest/rs/administering/database-operations/eviction-policy/)
on
[Active-Active](https://docs.redislabs.com/latest/rs/administering/creating-databases/create-active-active/)
Redis databases.

- A new [migration process from regular Redis database to an Active-Active](https://docs.redislabs.com/latest/rs/administering/database-operations/migrate-to-active-active)
Redis database using the Active-Passive (Replica Of) mechanism.

- Support of [BITFIELD data type on Active-Active](https://docs.redislabs.com/latest/rs/references/developing-for-active-active/Strings-and-Bitfields-with-Active-Active-Databases)
Redis databases.

And other functional and stability improvements.

### Version information

#### Upgrade instructions

- Follow [these instructions](https://docs.redislabs.com/latest/rs/installing-upgrading/upgrading/)
for upgrading to Redis Software 6.0.20 from Redis Software 5.6.0 and above.

- Note that upgrades from earlier Redis Software versions are not supported.

- For Active-Active deployments, this release requires that you [upgrade the CRDB featureset version](https://docs.redislabs.com/latest/rs/installing-upgrading/upgrading/#upgrading-activeactive-databases).

- Upgrades of Active-Active databases to Redis Software 6.0.20, will require all their
instances to run with protocol version 1 and featureset version 1 or above.
Active-Active databases running on protocol version 0 and/or featureset
version 0 will block the upgrade.

#### Product lifecycle information

- End of Life (EOL) for Redis Enterprise Software 6.0 and earlier
versions, can be found
[here](https://docs.redislabs.com/latest/rs/administering/product-lifecycle/).

- EOL for Redis modules can be found
[here](https://docs.redislabs.com/latest/modules/modules-lifecycle/#modules-endoflife-schedule).

#### Deprecation Notice

- Upgrades to the next Redis Software will be enabled from version 6.0 and above.

- Support for the SASL-based LDAP mechanism is considered deprecated, it will
be removed in a future version.

- Starting with Redis Siftware version 6.0.12, Envoy replaces Nginx for internal cluster administration.
Support for Nginx is considered deprecated, it will be removed in a future
version.

## New Features

#### New LDAP integration

Redis Enterprise Software integrates Lightweight Directory Access Protocol
(LDAP) authentication and authorization into its [role-based access controls]
(RBAC). You can now use LDAP to authorize access to the admin console and to
authorize database access.

#### Clients Mutual TLS authentication using a Certificate Authority (CA)

Redis Enterprise Software adds the ability to use a Certificate Authority (CA)
for client authentications, allowing clients to rotate their certificates
without the need to load new certificates to your database.

#### Redis eviction policies on Active-Active Redis databases

All [Redis eviction policies](https://docs.redislabs.com/latest/rs/administering/database-operations/eviction-policy/)
are now supported on Active-Active Redis databases. You can create new
Active-Active databases or edit existing ones using the UI console to enable it.

- Note that eviction is not supported yet for Active-Active Redis databases
running with Redis on Flash (Rof).

#### Migration to an Active-Active Redis database

Redis Enterprise Software adds the ability to easily [migrate your Redis
database to an Active-Active](https://docs.redislabs.com/latest/rs/administering/database-operations/migrate-to-active-active)
Redis database using the Active-Passive (Replica Of) mechanism.

#### BITFIELD on Active-Active Redis databases

Redis Enterprise Software adds the ability to use the BITFIELD data type on
Active-Active Redis databases. Please read more about [developing for Active-Active with BITFIELD](https://docs.redislabs.com/latest/rs/references/developing-for-active-active/Strings-and-Bitfields-with-Active-Active-Databases)
to understand the conflict resolution and limitations.

## Redis modules

The following GA releases of Redis modules are bundled with Redit Software 6.0.20:

- [RediSearch](https://redislabs.com/redis-enterprise/redis-search/), version
[2.0.6](https://docs.redislabs.com/latest/modules/redisearch/release-notes/redisearch-2.0-release-notes/)

- [RedisJSON](https://redislabs.com/redis-enterprise/redis-json/), version
[1.0.7](https://docs.redislabs.com/latest/modules/redisjson/release-notes/redisjson-1.0-release-notes/)

- [RedisGraph](https://redislabs.com/redis-enterprise/redis-graph/), version
[2.2.14](https://docs.redislabs.com/latest/modules/redisgraph/release-notes/)

- [RedisTimeSeries](https://redislabs.com/redis-enterprise/redis-time-series/),
version
[1.4.8](https://docs.redislabs.com/latest/modules/redistimeseries/release-notes/)

- [RedisBloom](https://redislabs.com/redis-enterprise/redis-bloom/), version
[2.2.4](https://docs.redislabs.com/latest/modules/redisbloom/release-notes/redisbloom-2.2-release-notes/)

To use the updated modules with a database, you must [upgrade the module on the
database](https://docs.redislabs.com/latest/modules/upgrading-rs/#upgrading-the-module-for-the-database).

## Additional capabilities

- Redis Software 6.0.20 includes open source Redis 6.0.9. For more information about Redis
6.0.9, check out the [release notes](https://raw.githubusercontent.com/redis/redis/6.0.6/00-RELEASENOTES).

- Redit Software 6.0.20 adds new `rladmin` commands for setting Ciphers suites and minimal
TLS version for:

- Control plane: setting Envoy

- Data plane: setting the Proxy for clients connections

- Sentinel discovery service

All known bugs around setting ciphers were fixed. To learn more, see [Updating certificates](https://docs.redislabs.com/latest/rs/administering/cluster-operations/updating-certificates/#cipher-configuration).

- Starting with Redis Software 6.0.20, the [syncer process](https://docs.redislabs.com/latest/rs/administering/designing-production/active-active/#syncer-process)
was improved to automatically recover and resume synchronisation after
reaching out-of-memory.

- Envoy updated and verified with multiple security headers.


## Important fixes

- RS50905, RS54809, 54940 - Fix in Redis preventing missing process PID

- RS53639 - Fix to avoid stuck state machine when assigning incorrect Redis
ACL with the allkeys alias or \~\* and also with \~\<somekey\>

- RS47983 - Fixed dependencies with installation using custom directories

- RS54382 - Fixed missing API documentation

- RS52433, RS53417, RS42195, RS42194, RS30526, RS46821, RS48928 - Fixed
security headers for Envoy

## Known limitations

#### Upgrade

- [Redis Software 5.4.2](https://docs.redislabs.com/latest/rs/release-notes/rs-5-4-2-april-2019/)
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](https://docs.redislabs.com/latest/rs/installing-upgrading/upgrading/#upgrading-crdbs).

- When you upgrade an Active-Active Redis with active AOF from [Redis Software 5.4.2](https://docs.redislabs.com/latest/rs/release-notes/rs-5-4-2-april-2019/)
or earlier to version [Redis Software 5.4.4](https://docs.redislabs.com/latest/rs/release-notes/rs-5-4-4-june-2019/)
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](https://docs.redislabs.com/latest/rs/administering/cluster-operations/updating-certificates/).
For help with this issue, contact Support.

- Starting from [Redis Software 5.4.2](https://docs.redislabs.com/latest/rs/release-notes/rs-5-4-2-april-2019/),
to preserve the current Redis major.minor version during database upgrade
you must use the keep_redis_version option instead of keep_current_version.

#### Redis commands

- The capability of disabling specific Redis commands does not work on
commands specific to Redis modules.

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

0 comments on commit db34f15

Please sign in to comment.