(gluten) branch main updated: [MINOR][DOC] Document TZDIR override for Velox timezone database (#13241)

[yu...@apache.org]

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 <pr...@gmail.com>
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: commits-unsubscribe@gluten.apache.org
For additional commands, e-mail: commits-help@gluten.apache.org