```
# GoldenDB (V6.1.02.10SP8P2) 单机部署指南 (基于 Kylin Linux V10)


本指南记录了在物理机 (Kylin Linux V10) 系统上成功部署 GoldenDB V6.1.02.10SP8P2 单节点（Single-Node）配置的完整排坑与安装流程。

> [!NOTE]
> 本文档聚焦解决由于安装包目录层级、强密码安全校验以及大数据组件极高内存限制要求所导致的一键安装失败问题。

## 1. 硬件资源需求 (必读)

GoldenDB 的“全家桶”单机部署（`install_type=0`，包含完整的管理节点、数据节点、代理节点以及 Insight 大数据监控底座）对硬件资源有硬性下限要求。

> [!CAUTION]
> **最低内存要求：32GB 物理内存**
> 
> 在安装后期（Insight 和集群配置阶段），安装程序会同时拉起 Elasticsearch、Kafka、Zookeeper 等重型 JVM 进程以及 GoldenDB OMM 服务。
> - 如果你的物理机内存只有 16GB，机器将会在安装尾声发生严重的内存交换（Thrashing）和 OOM (Out-of-Memory) 崩溃，导致 SSH 失联和系统死机。
> - 如果仅用于功能验证，确保系统可用内存（`MemAvailable`）至少在 21GB 以上方可平稳运行。

## 2. 基础环境准备

### 2.1 系统软件包与 Python 2 依赖安装
GoldenDB 的安装脚本强依赖于 Python 2.7 环境及其特定库。在进行安装前，我们需要确保系统环境已补充相应的底层依赖（如果系统未预装）：

```bash
# 安装基础库
yum install -y python2 python2-devel numactl perl-Time-HiRes bind-chroot java-1.8.0-openjdk gcc unixODBC bind-libs tar expect

# 配置 pip 源并安装必须的 python 依赖
pip2 install PyMySQL==0.9.3 xlrd==1.2.0 kazoo==2.6.1 PyYAML==5.4.1 requests tqdm==4.64.1 -i https://mirrors.aliyun.com/pypi/simple/
```


## 3. 安装包目录结构处理

为绕过安装脚本 `install_control.py` 内部对于顶级 `.zip` 文件强制解压并在内部寻找子 `.zip` 文件的僵化逻辑，我们需要伪造一个同名的 Zip 文件并将真实文件放置在同名目录下。

```bash
# 假设安装包存放在 /home 目录下
# 1. 将解压后的安装目录命名为与压缩包主名一致的名称
mv /home/goldendb_install /home/ZXCLOUD-GoldenDB-ALL-X86-KYLIN10V6.1.02.10SP8P2

# 2. 在同级目录创建一个空的同名 zip 文件，用来“欺骗”安装程序的解压检查
touch /home/ZXCLOUD-GoldenDB-ALL-X86-KYLIN10V6.1.02.10SP8P2.zip
```

## 4. 核心配置文件修改 (install_senior.ini)

进入安装目录 `/home/ZXCLOUD-GoldenDB-ALL-X86-KYLIN10V6.1.02.10SP8P2/oneKeyInstallUpdate/install/config`，修改 `install_senior.ini` 文件。

> [!IMPORTANT]
> - **严格的密码策略**：GoldenDB v6.1 版本强制要求所有的数据库超管、复制用户、代理用户等十几个内置账号的初始密码**必须是包含数字、大小写字母及特定特殊符号（如 `[!#$&+-?@^_~]`）的高强度密码**。
> - **必须全局替换默认密码**：切勿遗留任何 `******` 占位符，否则安装程序将在“步骤4: 生成安装配置文件”时因为密码格式校验不合规而强行阻断并报错（`parse_insight_config_file failed`）。
> - 必须指定一个系统中尚未被占用的 `user_group_id`（如 `1100`），**千万不要在安装前手工创建该用户或用户组**，否则安装程序也会将其判定为环境不纯净而报错退出。

关键配置项示例：

```ini
[GENERAL]
# 单机部署必须指定为 0
install_type=0
# 物理机直装载体指定为 0 (非 Docker)
install_carrier=0

# 设置将被自动创建的用户组 GID (确保该 ID 未被占用)
user_group_id=1100

# 密码修改 (此处仅列举部分，需将全量 ****** 替换)
rdb_super_pwvalue=GoldenDB@123
root_pwvalue=123456  # OS 服务器 root 密码
omm_domain_name=192.168.44.5

# 将 [MANAGER_SINGLE], [GTM], [DBPROXY], [CLUSTER], [LOADSERVER] 中默认的 10.0.0.1x 均替换为本机的实际 IP: 192.168.44.5
```

> [!TIP]
> 快捷替换所有默认密码及 IP 的完整防坑 sed 命令（假设目标 IP 为 192.168.44.5）：
> ```bash
> # 1. 替换默认弱密码
> sed -i 's/pwvalue=\*\*\*\*\*\*/pwvalue=GoldenDB@123/g' install_senior.ini
> sed -i 's/gdb_normal_user_pwd=\*\*\*\*\*\*/gdb_normal_user_pwd=GoldenDB@123/g' install_senior.ini
> 
> # 2. 替换各个组件的默认 IP
> sed -i 's/10.0.0.10/192.168.44.5/g' install_senior.ini
> sed -i 's/10.0.0.11/192.168.44.5/g' install_senior.ini
> 
> # 3. [关键防坑] 自动去重 HA 管理节点 IP
> # 因为全局替换会把原本的 local_room_ip=10.0.0.10,10.0.0.11 变成 192.168.44.5,192.168.44.5
> # 这会误导 GoldenDB 认为有两个管理节点，从而导致 DB 通信端口从 6016 漂移到 6017 引发 Step 13 注册失败。
> # 执行以下命令，将双拼 IP 强制压平为单 IP：
> sed -i 's/192.168.44.5,192.168.44.5/192.168.44.5/g' install_senior.ini
> ```

## 5. 绕过 Insight 组件的单机内存限制

在单机部署全套组件时，`Insight` 监控分析底座（包含 ElasticSearch）的安装脚本中有一处硬编码，强制要求服务器拥有大于 16GB 的 **可用内存** (`MemAvailable`)，否则会直接报环境检查失败而终止安装。若测试机器总内存较小（如 16GB 或 32GB），可用内存极大概率无法达标。

可以通过直接修改 Insight 安装包内的校验脚本来绕过此限制（例如将门槛从 16GB 降至 1GB）。

> [!WARNING]
> **极其重要的“解压缓存”机制避坑指南**：
> 安装脚本在部署组件时包含了一个性能优化逻辑（`unzip_all_file` 函数）：**如果目标解压目录已经存在，它将跳过 `unzip` 命令，直接使用磁盘上已有的旧脚本执行安装！**
> 这意味着，如果你的首次安装因为内存不足报错中断，此时原生的 16GB 检测脚本已经被解压并残留在磁盘上了。此时即使你去修改 `.zip` 压缩包，安装程序也不会去重新解压它！

因此，**最直接且万无一失的做法是，直接对磁盘上已经解压出来的安装脚本当场打补丁**，而不是去改压缩包：

```bash
# 假设主安装包已被解压到 /home 目录下
cd /home/ZXCLOUD-GoldenDB-ALL-X86-KYLIN10V6.1.02.10SP8P2/ZXCLOUD-GoldenDB-ALL-INSIGHTV6.1.02.10SP8P2/install

# 使用 find 找出所有安装与校验脚本，并强行将其中的 16777216 (16GB) 替换为 1024000 (1GB)
find . -name 'check.sh' -o -name 'install.sh' | xargs sed -i 's/16777216/1024000/g'
```

> [!CAUTION]
> 这是针对测试环境或资源受限机器的折中方案。降低限制只为了让安装脚本通过，如果服务器实际内存过低，即使安装成功，运行 ElasticSearch 及各个节点服务时仍可能会发生 OOM。

## 6. 执行安装

完成上述配置后，分别执行前置环境检查和最终安装：

```bash
cd /home/ZXCLOUD-GoldenDB-ALL-X86-KYLIN10V6.1.02.10SP8P2/oneKeyInstallUpdate/install

# 1. 运行环境检查，确保所有系统依赖通过
sh setup.sh -check

# 2. 开始后台自动化一键安装，并指定虚拟的根 ZIP 文件路径
sh setup.sh -a "" "/home/ZXCLOUD-GoldenDB-ALL-X86-KYLIN10V6.1.02.10SP8P2.zip"
```

> [!NOTE]
> 安装流程分为 15 步，包含 Insight、OMM、集群配置及节点管理等，全程约需 30~60 分钟。期间可在 `install/log/` 目录下跟踪最新的安装日志。
> 安装成功后，原本的解压目录会被自动清理，最终的全量安装日志将归档保存在 `/home/log/onekey_install.log` 中。

## 7. 访问与使用 GoldenDB

安装完成后，所有的核心组件都已在服务器上成功拉起，您可以直接通过以下方式访问和使用您的分布式数据库。

### 7.1 统一运维与监控平台 (Insight)
在 GoldenDB V6 版本中，原有的 OMM 图形界面已与 Insight 监控平台深度整合，所有的集群节点管理、资源分配、租户管理以及日常监控均在此统一平台完成。
*   **访问地址**: `https://192.168.44.5:8444/` (注意必须使用 https)
*   **默认账号**: `admin`
*   **默认密码**: `Insight@2020` *(此为官方出厂硬编码密码，不受安装脚本中的全局密码影响)*
*   >  **提示**：首次登录可能要求强制修改密码。如果浏览器提示“连接不安全/证书无效”，请点击“高级 -> 继续访问”。

### 7.2 后端管控服务 (OMM)
*   OMM (8443 端口) 在 V6 中已转为纯后端 RESTful API 服务，主要供 Insight 平台及底层 Agent 组件内部调用，**不再提供面向用户的 Web 访问**（直接访问会报 404 File Not Found）。

### 7.3 业务数据库直连 (应用层入口)
当您需要使用客户端工具（如 Navicat、DBeaver、DataGrip 等）或业务系统代码连接数据库执行 SQL 时，**请不要使用 `root` 账户直连底层节点或者 DBProxy 代理网关**（分布式架构下极高安全限制，使用 `root` 直连 8880 会触发 `1045 Access denied` 报错）。

要建立正常的数据库连接，请遵循以下规范的租户分配与建库流程：
1. **进入实例详情**: 登录 **Insight 统一运维平台** (`https://192.168.44.5:8444/`)。在页面的**最左侧实例树**中，单击对应的租户实例名称（如 `cluster1`），进入该实例的专属信息界面。
2. **创建数据库账号**: 
   - 切换到页面顶部的 **【账号管理】** 页签。
   - 单击 **【创建账号】**，填写业务账号名（如 `dbuser_test`）和密码（客户端 IP 填 `%`）。
   - 创建完成后，系统会弹出权限配置窗口，为该账号赋予相应的读写权限。
3. **新建逻辑数据库 (DDL)**:
   - *注意：GoldenDB V6 取消了可视化的“新建库”按钮，强制通过 SQL 语句建库。*
   - 切换到页面顶部的 **【业务管理】** 页签，然后在下方次级菜单中切换到 **【DDL执行】** 页签。
   - 新增方式选择 **“人工输入”**，在执行语句框中直接输入 `CREATE DATABASE testdb;`，然后单击 **【提交】**。
4. **验证连接**: 
   - 打开 Navicat 或 DBeaver，主机填 `192.168.44.5`，端口填 `8880`。
   - 使用上述步骤中创建的 `dbuser_test` 和对应密码进行连接测试。

> [!TIP]
> **快速连通性验证快捷通道 (super)**
> 如果您仅仅为了验证 8880 代理端口的网络连通性，而不想繁琐地走完上述建库建号流程，可以直接使用 GoldenDB 内置的最高维护账号进行快速登录：
> *   **Username**: `super`
> *   **Password**: `GoldenDB@123` *(此密码由安装脚本自动配置生成)*
> *(警告：在实际生产或代码开发中，严禁直接使用 super 账号配置业务数据源)*
```

为绕过安装脚本 install_control.py 内部对于顶级 .zip 文件强制解压并在内部寻找子 .zip 文件的僵化逻辑，我们需要伪造一个同名的 Zip 文件并将真实文件放置在同名目录下。

GoldenDB (V6.1.02.10SP8P2) 单机部署指南 (基于 Kylin Linux V10)

goldendb基于麒麟操作系统的部署步骤

数据库

运维

操作系统

GoldenDB V6.1单机部署指南，详细讲解在Kylin Linux V10系统上的安装流程与排坑技巧。重点包括32GB内存要求、Python2依赖安装、密码策略配置、IP地址修改、Insight组件内存限制绕过等关键步骤，帮助用户顺利完成GoldenDB分布式数据库的安装与配置。

分布式数据库

数据监控

代码解释

大数据

服务器

Kafka

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

GoldenDB (V6.1.02.10SP8P2) 单机部署指南 (基于 Kylin Linux V10)-腾讯云开发者社区-腾讯云

GoldenDB (V6.1.02.10SP8P2) 单机部署指南 (基于 Kylin Linux V10)

GoldenDB (V6.1.02.10SP8P2) 单机部署指南 (基于 Kylin Linux V10)

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐