This is an automated email from the ASF dual-hosted git repository.
zhouyuan pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/gluten.git
The following commit(s) were added to refs/heads/main by this push:
new 44640f9290 [MINOR][DOC] Document TZDIR override for Velox timezone
database (#13241)
44640f9290 is described below
commit 44640f9290917d1163f0e78d74bac5896bcab43e
Author: Pratham Manja <[email protected]>
AuthorDate: Mon Oct 12 16:05:43 2026 +0530
[MINOR][DOC] Document TZDIR override for Velox timezone database (#13241)
---
docs/get-started/Velox.md | 21 +++++++++++++++++++++
1 file changed, 21 insertions(+)
diff --git a/docs/get-started/Velox.md b/docs/get-started/Velox.md
index c66d420542..38a2533f4b 100644
--- a/docs/get-started/Velox.md
+++ b/docs/get-started/Velox.md
@@ -257,6 +257,27 @@ Currently there are several ways to access S3 in Spark.
Please refer [Velox S3](
Please refer [GCS](VeloxGCS.md)
+## Timezone database (tzdata) support
+
+Velox resolves timezone names using the IANA timezone database, normally found
at `/usr/share/zoneinfo`. This works out of
+the box on CentOS-based images, which ship `tzdata` at that path, but may fail
on minimal base images (e.g. Red Hat UBI9)
+where `tzdata` is not installed by default. Velox's vendored `tzdb` honors the
`TZDIR` environment variable to override
+this location, which can be set the same way as other native env vars consumed
by Gluten (see `LIBHDFS3_CONF` and
+`KRB5CCNAME` above):
+
+```
+// Spark local mode
+export TZDIR="/path/to/zoneinfo"
+
+// Spark Yarn cluster mode
+--conf spark.executorEnv.TZDIR="/path/to/zoneinfo"
+--conf spark.driverEnv.TZDIR="/path/to/zoneinfo"
+
+// Spark on Kubernetes (driver env uses a different config key)
+--conf spark.executorEnv.TZDIR="/path/to/zoneinfo"
+--conf spark.kubernetes.driverEnv.TZDIR="/path/to/zoneinfo"
+```
+
# Remote Shuffle Service Support
## Celeborn support
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
