diff --git a/v19.1/common-errors.md b/v19.1/common-errors.md index ae8ba3ad75a..37f97891f2b 100644 --- a/v19.1/common-errors.md +++ b/v19.1/common-errors.md @@ -199,9 +199,9 @@ the user. ## invalid value for parameter "TimeZone" -This error indicates that the machine running the CockroachDB node is missing the [`tzdata`](https://www.iana.org/time-zones) library (sometimes called `tz` or `zoneinfo`), which is required by certain features of CockroachDB that use time zone data, for example, to support using place names as time zone identifiers. +This error indicates that the machine running the CockroachDB node is missing the [`tzdata`](https://www.iana.org/time-zones) library (sometimes called `tz` or `zoneinfo`), which is required by certain features of CockroachDB that use time zone data, for example, to support using location-based names as time zone identifiers. -To resolve this issue, install the `tzdata` library and keep it up-to-date. +To resolve this issue, install the `tzdata` library and keep it up-to-date. It's important for all nodes to have the same version, so when updating the library, do so as quickly as possible across all nodes. For details about other libraries the CockroachDB binary for Linux depends on, see [Dependencies](recommended-production-settings.html#dependencies). diff --git a/v19.1/known-limitations.md b/v19.1/known-limitations.md index 1774b7b6301..b2db6c68532 100644 --- a/v19.1/known-limitations.md +++ b/v19.1/known-limitations.md @@ -14,6 +14,14 @@ This page describes newly identified limitations in the CockroachDB {{page.relea ## Unresolved limitations +### Location-based time zone names on Windows + +Certain features of CockroachDB require time zone data, for example, to support using location-based names as time zone identifiers. On most distributions, it is therefore required to install and keep up-to-date the `tzdata` library. However, on Windows, even with this library installed, location-based time zone names may not resolve. + +To work around this limitation, install the Go toolchain on the Windows machine running CockroachDB nodes. In this case, the CockroachDB nodes will use the timezone data from that toolchain. + +[Tracking GitHub Issue](https://github.com/cockroachdb/cockroach/issues/32415) + ### Database and table renames are not transactional Database and table renames using [`RENAME DATABASE`](rename-database.html) and [`RENAME TABLE`](rename-table.html) are not transactional. diff --git a/v19.1/recommended-production-settings.md b/v19.1/recommended-production-settings.md index df9d65add23..16eff6c57c3 100644 --- a/v19.1/recommended-production-settings.md +++ b/v19.1/recommended-production-settings.md @@ -248,9 +248,9 @@ Library | Description -----------|------------ [`glibc`](https://www.gnu.org/software/libc/libc.html) | The standard C library.

If you build CockroachDB from source, rather than use the official CockroachDB binary for Linux, you can use any C standard library, including MUSL, the C standard library used on Alpine. `libncurses` | Required by the [built-in SQL shell](use-the-built-in-sql-client.html). -[`tzdata`](https://www.iana.org/time-zones) | Required by certain features of CockroachDB that use time zone data, for example, to support using place names as time zone identifiers. This library is sometimes called `tz` or `zoneinfo`. +[`tzdata`](https://www.iana.org/time-zones) | Required by certain features of CockroachDB that use time zone data, for example, to support using location-based names as time zone identifiers. This library is sometimes called `tz` or `zoneinfo`.

When running CockroachDB on a Windows machine, install the Go toolchain to ensure that location-based time zone names resolve successfully. For more details, see this [known limitation](known-limitations.html#location-based-time-zone-names-on-windows). -These libraries are found by default on nearly all Linux distributions, with Alpine as the notable exception, but it's nevertheless important to confirm that they are installed and kept up-to-date. +These libraries are found by default on nearly all Linux distributions, with Alpine as the notable exception, but it's nevertheless important to confirm that they are installed and kept up-to-date. For the `tzdata` library in particular, it's important for all nodes to have the same version; when updating the library, do so as quickly as possible across all nodes. {{site.data.alerts.callout_info}} In Docker-based deployments of CockroachDB, these dependencies do not need to be manually addressed. The Docker image for CockroachDB includes them and keeps them up to date with each release of CockroachDB. diff --git a/v2.1/common-errors.md b/v2.1/common-errors.md index 04ddea84b16..e2c3c4a670a 100644 --- a/v2.1/common-errors.md +++ b/v2.1/common-errors.md @@ -199,9 +199,9 @@ the user. ## invalid value for parameter "TimeZone" -This error indicates that the machine running the CockroachDB node is missing the [`tzdata`](https://www.iana.org/time-zones) library (sometimes called `tz` or `zoneinfo`), which is required by certain features of CockroachDB that use time zone data, for example, to support using place names as time zone identifiers. +This error indicates that the machine running the CockroachDB node is missing the [`tzdata`](https://www.iana.org/time-zones) library (sometimes called `tz` or `zoneinfo`), which is required by certain features of CockroachDB that use time zone data, for example, to support using location-based names as time zone identifiers. -To resolve this issue, install the `tzdata` library and keep it up-to-date. +To resolve this issue, install the `tzdata` library and keep it up-to-date. It's important for all nodes to have the same version, so when updating the library, do so as quickly as possible across all nodes. For details about other libraries the CockroachDB binary for Linux depends on, see [Dependencies](recommended-production-settings.html#dependencies). diff --git a/v2.1/known-limitations.md b/v2.1/known-limitations.md index 0d0123c8bb0..ad1df38a943 100644 --- a/v2.1/known-limitations.md +++ b/v2.1/known-limitations.md @@ -135,6 +135,14 @@ Currently, the built-in SQL shell provided with CockroachDB (`cockroach sql` / ` ## Unresolved limitations +### Location-based time zone names on Windows + +Certain features of CockroachDB require time zone data, for example, to support using location-based names as time zone identifiers. On most distributions, it is therefore required to install and keep up-to-date the `tzdata` library. However, on Windows, even with this library installed, location-based time zone names may not resolve. + +To work around this limitation, install the Go toolchain on the Windows machine running CockroachDB nodes. In this case, the CockroachDB nodes will use the timezone data from that toolchain. + +[Tracking GitHub Issue](https://github.com/cockroachdb/cockroach/issues/32415) + ### Database and table renames are not transactional Database and table renames using [`RENAME DATABASE`](rename-database.html) and [`RENAME TABLE`](rename-table.html) are not transactional. diff --git a/v2.1/recommended-production-settings.md b/v2.1/recommended-production-settings.md index a1d4570639d..c36e57e15fd 100644 --- a/v2.1/recommended-production-settings.md +++ b/v2.1/recommended-production-settings.md @@ -250,9 +250,9 @@ Library | Description -----------|------------ [`glibc`](https://www.gnu.org/software/libc/libc.html) | The standard C library.

If you build CockroachDB from source, rather than use the official CockroachDB binary for Linux, you can use any C standard library, including MUSL, the C standard library used on Alpine. `libncurses` | Required by the [built-in SQL shell](use-the-built-in-sql-client.html). -[`tzdata`](https://www.iana.org/time-zones) | Required by certain features of CockroachDB that use time zone data, for example, to support using place names as time zone identifiers. This library is sometimes called `tz` or `zoneinfo`. +[`tzdata`](https://www.iana.org/time-zones) | Required by certain features of CockroachDB that use time zone data, for example, to support using location-based names as time zone identifiers. This library is sometimes called `tz` or `zoneinfo`.

When running CockroachDB on a Windows machine, install the Go toolchain to ensure that location-based time zone names resolve successfully. For more details, see this [known limitation](known-limitations.html#location-based-time-zone-names-on-windows). -These libraries are found by default on nearly all Linux distributions, with Alpine as the notable exception, but it's nevertheless important to confirm that they are installed and kept up-to-date. +These libraries are found by default on nearly all Linux distributions, with Alpine as the notable exception, but it's nevertheless important to confirm that they are installed and kept up-to-date. For the `tzdata` library in particular, it's important for all nodes to have the same version; when updating the library, do so as quickly as possible across all nodes. {{site.data.alerts.callout_info}} In Docker-based deployments of CockroachDB, these dependencies do not need to be manually addressed. The Docker image for CockroachDB includes them and keeps them up to date with each release of CockroachDB.