1. 首页
  2. 技术博客
  3. UXDB Linux 快速部署与使用指南

UXDB Linux 快速部署与使用指南

  • Steven
  • 发布于 2026-02-10
  • 39 次阅读

本文将引导您完成从零开始在Linux服务器上安装、初始化并连接到UXDB的完整过程。以最常用的 命令行交互安装 方式为例。

一：安装前准备

在开始安装前，请以 root 用户身份完成以下系统配置。

  1. 创建专用系统用户 (uxdb) 为安全起见，不建议使用 root 运行数据库。创建一个专用用户。

    useradd uxdb
passwd uxdb  # 为 uxdb 用户设置密码

  2. 配置 Sudo 权限 (可选，方便维护)

    visudo

    在文件中添加一行：

    uxdb ALL=(ALL) ALL

  3. 开放数据库端口 UXDB 默认使用端口 52025。确保防火墙放行。

    firewall-cmd --zone=public --add-port=52025/tcp --permanent
firewall-cmd --reload
firewall-cmd --zone=public --query-port=52025/tcp  # 验证

二：安装 UXDB

将安装包上传至服务器（例如 /opt 目录），我们假设安装包名为 uxdb-std-x86_64-v2.1.2.2.run。

  1. 赋予执行权限并启动安装

    chmod a+x uxdb-std-x86_64-v2.1.2.2.run
./uxdb-std-x86_64-v2.1.2.2.run

  2. 跟随命令行向导 安装过程是交互式的，根据提示输入即可。关键选择如下：

    • 选择语言： 默认中文，回车。

    • 许可协议： 输入 1 接受。

    • 系统账户： 默认使用我们创建好的 uxdb 用户，直接回车。

    • 安装目录： 默认 /opt/uxdbinstall，可自定义。

    • 安装方式： 选择 1 (完整安装)。

    • 环境检测： 程序会检查依赖。如有警告（如缺少某些 Oracle FDW 库），只要不是错误项，可以输入 Y 继续。

    • 加载 License： 首次安装可跳过，直接回车。（注意：无 License 安装后，数据库实例无法自动启动，需导入License后才能正常使用）

    • 数据库初始化： 关键步骤！ 选择 0 (是)，进行初始化配置。

  3. 初始化数据库实例配置 这是配置数据库核心参数的地方，请仔细填写：

    数据库目录： [/opt/uxdbinstall/dbsql/data/dbhome_1] # 默认即可
数据库模式： 0-Standard模式 / 1-Oracle模式 / 2-MySQL模式 # 按需选择，通常选0
是否开启安全功能： 0-是 / 1-否 # 测试可选1（否），生产环境建议0（是）
是否开启全库加密： 同上，按需选择
注册服务： 0-是 # 建议是，便于用 systemctl 管理
注册服务名称：[uxdbServer] # 默认即可
实例初始化后是否启动： 1-否 # 因无License，此处务必选“否”！
数据库编码： 0-UTF8 # 强烈建议选择 UTF8

    根据是否开启安全功能，系统会提示你为超级用户（如 uxdb）或三个安全用户 (uxsmo, uxsso, uxsao) 设置密码。请牢记密码。

  4. 完成安装 安装程序执行完毕后，会提示安装成功。

三：获取并导入许可证 (License)

没有许可证，数据库服务无法启动。

  1. 生成机器信息文件

    cd /opt/uxdbinstall/license
./GetUserInfo.sh

    执行后会在当前目录生成 UxdbLicense.json 文件。

  2. 申请 License 将此 UxdbLicense.json 文件发送给优炫的技术支持人员(或拨打400-650-7837 )，他们核实后，会为您生成一个 uxdb.lic 许可证文件。

  3. 导入 License 将收到的 uxdb.lic 文件上传到 /opt/uxdbinstall/license/ 目录下。

四：启动数据库并使用

  1. 启动数据库服务 由于初始化时我们注册了名为 uxdbServer 的系统服务，现在可以方便地启动它。

    systemctl start uxdbServer
systemctl status uxdbServer # 检查状态，确认 Active: active (running)

  2. 连接到数据库 切换到 uxdb 用户，使用命令行客户端 uxsql 进行连接。

    su - uxdb
cd /opt/uxdbinstall/dbsql/bin
./uxsql -d uxdb -U uxdb -p  # -d 指定数据库，-U 指定用户，-p 会提示输入密码

    输入您在初始化时设置的密码。

  3. 执行基本 SQL 命令 连接成功后，您将看到 uxdb=# 提示符。可以执行一些命令测试：

    -- 查看数据库版本
SELECT version();
​
-- 列出所有数据库
\l
​
-- 创建一个测试表
CREATE TABLE test (id INT, name VARCHAR(50));
​
-- 插入数据
INSERT INTO test VALUES (1, 'Hello UXDB');
​
-- 查询数据
SELECT * FROM test;
​
-- 退出 uxsql
\q

五：关键管理命令

  • 启停服务：

    systemctl start/stop/restart uxdbServer

  • 连接数据库：

    /opt/uxdbinstall/dbsql/bin/uxsql -d uxdb -U uxdb -h localhost -p 52025

  • 查看集群状态 (使用绝对路径)：

    /opt/uxdbinstall/dbsql/bin/ux_ctl -D /opt/uxdbinstall/dbsql/data/dbhome_1 status

总结

至此，您已经完成了 UXDB 的单机版安装、初始化和基本连接。接下来您可以：

  1. 配置远程访问：修改 hx_hba.conf 和 uxsinodb.conf 文件（位于数据目录 /opt/uxdbinstall/dbsql/data/dbhome_1 下）。

  2. 进行数据迁移：使用 /opt/uxdbinstall/UXDBMigrator 工具从其他数据库迁移数据。

遇到问题怎么办？

  1. 首先检查 /opt/uxdbinstall/installer/checkEnvResult.log 中的环境检测日志。

  2. 查看数据库日志 /opt/uxdbinstall/dbsql/data/dbhome_1/pg_log/。

  3. 联系优炫技术支持：400-650-7837