MENU

人大金仓KDMS数据迁移评估系统部署指南

• July 1, 2026 • Read: 2 • 编码👨🏻‍💻

一、安装前须知

1.1 名词解释

KDMS：金仓数据库迁移评估系统（Kingbase Database MigrationService）

1.2 安装包及其重要组件

系统架构系统架构其他
x86KDMS-V004R001C001-x86.tar.gz链接：https://pan.quark.cn/s/faed431d1fb3
提取码：2PuF

1.3 环境要求

1.3.1 操作系统环境说明

系统备注
麒麟Kylin V10 sp3带 GUI 桌面

1.3.2 内存要求

  • 内存要求：16GB

1.3.3 磁盘要求

  • 软件包的磁盘空间要求：2GB
  • 安装路径中的磁盘空间要求：5GB

1.3.4 Java 环境要求

  • Oracle JVM/JDK8 及以上 or Open JDK8 及以上

二、准备安装环境

2.1 检查操作系统版本

请用户根据KDMS的环境支持列表检查并确定操作系统版本符合要求。

2.2 检查网络环境和网络端口

KDMS默认使用的端口：

端口备注
19007KDMS 访问端口

为了使程序可以正常使用，请确认以上端口检查配置打开，若部署环境存在防火墙配置，需要确保以上端口通信的畅通。

2.3 物理机器配置

  • 创建 kdms 运行的账号
useradd kdms && echo "srebro@sre2026" | passwd --stdin "kdms" &>/dev/null

2.4 配置用户环境

2.4.1 系统属性检查及配置

  • 系统参数调优 (文件描述符与进程数)
# 修改 /etc/security/limits.conf
cat >> /etc/security/limits.conf << eof
root soft nofile 65535
root hard nofile 65535
root soft nproc 65535
root hard nproc 65535
root soft core unlimited
root hard core unlimited
* soft nofile 65535
* hard nofile 65535
* soft nproc 65535
* hard nproc 65535
* soft core unlimited
* hard core unlimited
eof

# 清理旧的 nproc 限制
cd /etc/security/limits.d/
rm -rf  *-nproc.conf

2.4.2 检查和设置系统编码

·检查当前系统的编码类型：

在安装前需要检查当前系统的编码类型设置当前系统的编码为UTF-8。

locale

会看到类似以下的输出

LANG=zh_CN.UTF-8
LC_CTYPE="zh_CN.UTF-8"
LC_NUMERIC="zh_CN.UTF-8"
LC_TIME="zh_CN.UTF-8"
LC_COLLATE="zh_CN.UTF-8"
LC_MONETARY="zh_CN.UTF-8"
LC_MESSAGES="zh_CN.UTF-8"
LC_PAPER="zh_CN.UTF-8"
LC_NAME="zh_CN.UTF-8"
LC_ADDRESS="zh_CN.UTF-8"
LC_TELEPHONE="zh_CN.UTF-8"
LC_MEASUREMENT="zh_CN.UTF-8"
LC_IDENTIFICATION="zh_CN.UTF-8"
LC_ALL=

如果 LANG 和 LC_* 变量中包含“UTF-8”，则说明当前系统的字符编码为 UTF-8。

  • 修改当前系统编码类型

如果当前系统的字符编码不为 UTF-8，可尝试如下方式修改：

localectl set-locale LANG=zh_CN.UTF-8

运行成功后可再进行检查，验证操作是否生效。

2.5 时钟检查/时间同步

查看程序部署所在机器的当前系统时间，需要保证与现实时间一致，否则可能会造成程序工作异常。

  • 检查当前系统时间
date
timedatectl set-timezone Asia/Shanghai

# 设置 24 小时制显示
echo "export LC_TIME=zh_CN.UTF-8" >> /etc/profile

# 配置时间同步 (Crontab 方式)
# 注意：生产环境推荐配置 Chrony 服务指向内网 NTP 服务器地址
echo "0 */1 * * * /usr/sbin/ntpdate -u ntp.aliyun.com" >> /var/spool/cron/root

2.6 系统部署依赖软件检查

系统安装部署依赖软件检查表（根据实际情况参照）：

软件版本备注
jdk8若不使用动态程序采集，也可以使用jdk11
  • 可通过运行如下命令，检查当前系统java环境与版本：
java -version
openjdk version "1.8.0_482"
OpenJDK Runtime Environment BiSheng (build 1.8.0_482-b08)
OpenJDK 64-Bit Server VM BiSheng (build 25.482-b08, mixed mode)

三、安装KDMS

3.1 Linux平台图形化安装

3.1.1 安装前准备

执行安装程序前注意事项如下：

  • 安装用户(kdms)对于安装路径需要有“读”、“写”、“执行”的权限。
3.1.1.1 上传软件包
  • 使用root用户，创建安装目录，软件包目录，上传安装包并解压，并赋权kdms 用户权限；
#创建工作目录
mkdir -p /home/application/kdms
#创建软件包目录
mkdir -p /home/application/kdms/soft

cd /home/application/kdms/soft
#上传软件包到软件包目录下
#解压软件包
tar -zxvf KDMS-COLLECTOR-V004R001C001-x86.tar.gz

#赋权
chown -Rf kdms:kdms /home/application/kdms

注意：其中KDMS-COLLECTOR-V004R001C001-x86.tar.gz是安装包的具体名称，根据实际情况进行调整。

3.1.2 图形界面安装

Linux 安装过程，包含如下步骤：

3.1.2.1 启动安装程序

打开图形化界面，使用 kdms用户登录，打开新终端，进入安装程序中setup.sh所在目录，执行如下命令

image-20260701154837874

image-20260701155015952

bash  /home/application/kdms/soft/setup.sh
3.1.2.2 同意许可

image-20260701155106798

image-20260701155345557

3.1.2.3 安装路径设置
  • 这里我们选择/home/application/kdms

image-20260701155434660

3.1.2.4 端口设置
  • 保持默认

image-20260701155519799

3.1.2.5 确认无误，开始安装

image-20260701155558177

image-20260701155610705

3.1.2.6 安装完成

image-20260701155705122

image-20260701155713051

3.1.3 命令行安装

image-20260701160843309

3.1.4 启动与停止

正常安装完成后，KDMS服务会自行启动。如需手动启动，可使用如下步骤：

  • 启动 KDMS

1．打开新终端；

2．切换到安装用户；

3.cd到＜安装目录＞，执行如下操作；

su - kdms
cd /home/application/kdms
./start.sh
  • 关闭 KDMS

1．打开新终端；

2．切换到安装用户；

3.cd到＜安装目录＞，执行如下操作；

su - kdms
cd /home/application/kdms
./stop.sh

3.2 访问KDMS

image-20260701160340932

启动KDMS后，默认登录地址为

http://KDMS 所在机器 IP 地址：19007

注：若安装过程修改了KDMS端口，请以实际为准。

  • 默认帐号密码为
admin/Kingbase@2024

注：在登录KDMS页面后，请点击右上角用户图标中的“修改密码”修改默认密码。

image-20260701160533518

四、KDMS采集系统使用说明

4.1 MySQL 数据库采集

4.1.1 创建采集用户

  • 使用具有 Root 权限的账号创建临时账号，并配置以下权限（如果用户已有包含下面权限的账号，请忽略此步骤， 直接使用），采集操作完成后，请删除临时账号。
  • 说明：以下权限用于连接 Mysql 数据库系统，仅采集数据库结构信息，不采集用户业务数据。
CREATE USER 'MySQL 用户名'@'host' IDENTIFIED BY 'MySQL 密码';
flush privileges;
GRANT ALL ON *.* TO 'MySQL 用户名'@'host';
flush privileges;

MySQL8 因为密码加密问题还需额外执行

ALTER USER 'MySQL 用户名'@'host' IDENTIFIED WITH mysql_native_password BY 'MySQL 密码';

注意： 1、MySQL5.1 版本数据库，暂不支持采集。 2、请不要将采集数据库指定为 mysql 系统库，例如：mysql、information_schema、performance_schema 等。

4.1.2 采集步骤

1、在数据采集页面点击新建采集，在弹窗中选择采集类型为数据库采集、选择数据库类型为 MySQL、勾选评估类型，数据迁移工作量

image-20260701161451894

2、填写基本信息，填写完毕后点击测试连接

image-20260701161657055

3、测试连接成功后，点击立即创建，即可开始进行数据采集任务

image-20260701161837934

4、当运行状态为“采集完成”时，完成采集任务。点击“下载采集包”按钮，下载压缩包文件

image-20260701161937292

五、kingbase 在线一键数据库迁移评估平台

image-20260701162246139

5.1 在线兼容性评估

5.1.1 创建评估

image-20260701162441582

  • 上传数据文件

image-20260701162521883

image-20260701162555291

5.1.2 下载并查看评估报告

image-20260701162636831

image-20260701162819935

image-20260701162845438

image-20260701162932725

六、总结

KDMS 在数据库迁移流程中承担的是"体检"角色——负责源库的元数据采集、兼容性分析和迁移可行性评估，帮助提前发现不兼容的 SQL 语法、数据类型、存储过程等风险点，输出评估报告指导改造方案。

但评估只是迁移的第一步，完整的数据库迁移还需搭配以下两款金仓工具形成完整工具链：

  • KDTS（金仓数据库迁移工具）：在 KDMS 评估完成后，将源库的表结构、数据、视图、存储过程、触发器等对象批量迁移至金仓数据库，支持库级/表级迁移、断点续传、并行处理。
  • KFS（金仓数据库同步工具）：在迁移切换阶段，实现源库到金仓数据库的实时增量同步（CDC），保障割接时两端数据完全一致，实现业务平滑切换。

最后，希望你迁移一切顺利！

本文是原创文章，采用 CC BY-NC-ND 4.0 协议，完整转载请注明来自 运维小弟

国产数据库
Archives Tip
QR Code for this page
Tipping QR Code