GBase 8s UNIX 环境关键环境变量小结，部署容易踩坑

最近在学习 GBase 8s 部署，发现很多人安装完数据库，执行命令报错、工具无法正常运行，很多时候是环境变量没有配置到位，整理下文档里的核心环境变量，和大家交流。

GBase 8s 有一整套环境变量，完整清单可以查阅官方《GBase 8s SQL 指南：参考》文档。有几个变量，执行数据库管理操作的时候是必须配置的，配置不对 onstat 这类工具直接无法使用。

**GBASEDBTDIR**
这个是数据库的安装根目录，指向 GBase8s 的安装路径，几乎所有其他变量都依赖这个路径，属于基础变量。

**GBASEDBTSERVER**
用来指定默认数据库实例名称，要和 onconfig 里面 DBSERVERNAME 参数保持一致，连接数据库时会默认读取这个变量。

**ONCONFIG**
这个变量很容易踩坑！注意：**数据库管理员使用 onstat 等服务端工具，必须配置 ONCONFIG；普通客户端访问数据库，不需要设置它**。
如果不手动配置，系统会默认读取`$GBASEDBTDIR/etc/onconfig`，如果你的 onconfig 文件名做了修改，就必须手动指定该变量，否则管理工具会读取错误配置文件。

**PATH**
需要把`$GBASEDBTDIR/bin`加入系统 PATH，这样可以直接执行 onstat、onmode 等命令，不用每次敲完整绝对路径。

如果用到 J/Foundation JDBC 驱动开发，还需要配置 JVPHOME、CLASSPATH，指定驱动 jar 包所在目录。

还有终端相关变量 TERM、TERMCAP、TERMINFO、GBASEDBTTERM，用于 DB‑Access 工具识别终端。终端变量和操作系统强相关，配置异常会出现 DB‑Access 界面乱码，必要时需要系统管理员协助调整。

## 现场实操小经验

1. gbasedbt 用户的`.bash_profile`里把这些环境变量写好，登录自动加载，避免每次手动 export。
2. 区分管理员账号和普通业务账号：管理员需要完整配置 ONCONFIG，业务客户端账号不用配置 ONCONFIG。
3. 部署完可以执行`env`检查环境变量，onstat 命令报找不到实例，优先排查 GBASEDBTSERVER、ONCONFIG。

大家部署 GBase8s 的时候，有没有遇到过环境变量导致的奇怪问题？欢迎留言一起交流。