CentOS 7.9 安装 KingbaseES ISO 包指南

1.5 ISO 安装包准备与校验

1.5.1 下载 ISO 包

从金仓官网获取 ISO 包，本文以 KingbaseES_V009R001C010_Lin64_install.iso 为例。KingbaseES 安装包可以通过官方渠道获取。

可以选择下载版本，本次要下载的是最新兼容版 V9R1C10。

然后选择安装包，选择 X64_Linux 版本。

1.5.2 上传 ISO 包到服务器

用工具（如 Xshell、WinSCP）将 ISO 包上传到 CentOS 7.9 的 /opt/software 目录（需先创建该目录）：

# 用 root 用户创建软件存放目录
mkdir -p /opt/software
# 上传后，查看文件是否存在
ls -l /opt/software

1.5.3 校验 ISO 包完整性（避免文件损坏）

官方会提供 ISO 包的 MD5/SHA1 值，需校验确保文件完整：

# 计算 ISO 包的 MD5 值
md5sum /opt/software/KingbaseES_V009R001C010B0004_Lin64_install.iso
# 计算 ISO 包的 SHA1 值
sha1sum /opt/software/KingbaseES_V009R001C010B0004_Lin64_install.iso

将计算结果与官方提供的校验值对比。一致则文件正常；不一致需重新下载。

二、ISO 包挂载（必做步骤）

ISO 包要经过挂载才可执行安装脚本，其步骤如下，请以 root 用户来执行：

# 1. 创建挂载目录（如/opt/software/KingbaseESV9）
mkdir -p /opt/software/KingbaseESV9
# 2. 挂载 ISO 包到挂载目录
mount /opt/software/KingbaseES_V009R001C010_Lin64_install.iso /opt/software/KingbaseESV9
# 3. 验证挂载是否成功（应显示 setup.sh 和 setup 目录）
ls -l /opt/software/KingbaseESV9

注意：挂载之后，目录会变成只读状态，如果想要修改像静默安装所对应的'silent.cfg'这样的设置文件时，一定要事先把它复制到别的目录里面才行。

三、三种安装方式详细步骤

KingbaseES 在 CentOS 7.9 中包含三种安装方式，分别是 图形化安装，命令行安装 以及 静默安装。其中图形化安装适合存在界面的服务器，命令行安装适合没有界面的服务器，静默安装则适合大批量部署场景，下面将针对这三种安装方式进行详细介绍。

3.1 图形化安装（适合新手）

图形化安装依靠可视化界面执行操作，其步骤较为明晰，很适合初次使用 KingbaseES 的用户。

3.1.1 设置图形化环境

如果服务器具备图形界面（比如 GNOME），就直接切换成 kingbase 用户，要是服务器属于无界面类型，则必要经由 VNC 或 Xmanager 建立联系，并且要保证图形转发功能运行正常。

3.1.2 启动图形化安装脚本

# 1. 切换到 kingbase 用户（必须！）
su - kingbase
# 2. 进入 ISO 挂载目录
cd /opt/software/KingbaseESV9
# 3. 启动图形化安装脚本（-i swing 指定图形界面）
sh setup.sh -i swing

执行后会弹出安装向导窗口，按以下步骤操作：

3.1.3 安装向导步骤如下：

1. 选择安装类型：首次安装时，请选择'安装新实例'，然后点击'下一步'。如果已有安装，则可选择'修改现存实例'来增减组件。
2. 接受许可协议：接受许可协议：勾选'我接受许可协议条款'，未勾选时'下一步'为灰色，点击'下一步'。
3. 选择授权文件：官方授权文件可在安装包下载界面获取。KingbaseES 数据库存在开发版，标准版，专业版以及企业版这四种版本，它们依照版本定位有所区别，从数据库初次启动之日算起。开发版时长限制为 365 天，标准版、专业版、企业版时长限制为 90 天。根据需要选择相应的授权文件，这里选择开发版，点击 开发版 -365 天 进行下载，将刚刚下载好的授权文件添加。
4. 选择安装路径：默认路径为 /opt/Kingbase/ES/V9（这与前面创建的目录相同），如果想要自定义，则点击'浏览'来选择别的目录（要保证 kingbase 用户具备读写权限），之后再点击'下一步'。
5. 选择安装集：给出三个安装集，按需求挑选：
   • 完全安装：其中含数据库服务器，高可用组件，开发工具（KStudio），迁移工具（KDTS）等，建议新手选用；
   • 服务器安装：只安装数据库服务器，合适只需数据库服务的情况；
6. 选择功能组件（只有定制安装才需执行此步骤）：如果选择了'定制安装'，就要勾选想要的功能组件，比如'数据库服务器'或者'数据库迁移工具'，然后点击'下一步'。
7. 安装预览：安装预览环节要查看安装目录，组件列表以及磁盘空间情况（确保'可用空间≥所需空间'），确认无误后再点击'安装'。
8. 等待安装完成：等待安装结束时，安装过程会有进度显示，比如'解压数据库服务器''设置组件'等，耗时大约 5 到 10 分钟（这与硬件性能相关），在此期间请不要停止安装。
9. 创建快捷方式：需选定用户范围，其选项为'当前用户'或者'所有用户'，其中'当前用户'仅 kingbase 可见，'所有用户'则为服务器上全体用户所见。程序组名默认为'KingbaseESV009R001'，也可自行修改，之后点击'下一步'。
10. 安装完成：安装完毕时，若出现'恭喜您！安装完成'的提示，表明安装过程已结束，此时可以选择是否要'初始化数据库'（此步骤为可选，日后仍可执行人工操作来执行初始化），选定之后，点击'完成'即可退出当前向导界面。

定制安装：可自行选定组件（譬如只安装服务器 + 迁移工具），适合进阶用户。选定之后点击'下一步'。

3.2 命令行安装（无界面服务器推荐）

若服务器无图形界面（如生产环境服务器），可通过命令行安装，全程通过文字交互操作。

3.2.1 启动命令行安装脚本

# 1. 切换到 kingbase 用户
su - kingbase
# 2. 进入 ISO 挂载目录
cd /opt/software/KingbaseESV9
# 3. 启动命令行安装（-i console 指定命令行模式）
sh setup.sh -i console

3.2.2 命令行交互步骤

1. 接受许可协议：连续按'空格'翻页阅读协议，直到末尾。
2. 选择授权文件：将刚刚下载好的授权文件，输入文件绝对路径（如/opt/llicense_V009R001C-开发版.dat），按 Enter；若无，直接按 Enter（使用试用版授权）。
3. 选择安装路径：直接按 Enter 使用默认路径（/opt/Kingbase/ES/V9）。
4. 选择安装集：输入 1（完全安装，默认），2（服务器安装）或者 3（定制安装），然后按 Enter 键。
5. 创建快捷方式：按下 Y 键来创建（这是默认设置），然后按 Enter 键。输入 1 选取'当前用户'（这也是默认选项），或者输入 2 选取'全部用户'，之后再按 Enter 键。程序组名默认为'KingbaseESV009R001'，只需直接按 Enter 键即可。
6. 安装预览：查看安装目录、组件、磁盘空间，确认无误后输入 N 开始安装。
7. 等待安装完成：屏幕会随时显示安装进程（比如'Processing package: Server (4/9) '），安装完毕后会提示'创建快捷方式'。
8. 定制安装：如果选择了 3（定制安装），就要进一步选定组件：输入 +数字 来增加组件（比如输入 +4 就增加数据库服务器），把要增加的多个组件用空格隔开，等全部选定之后再输入 N 进入下一步。若自定义，输入绝对路径（如/home/kingbase/kdb），按 Enter。输入 1 接受协议（输入 2 拒绝，3 重新查看），按 Enter。

安装完成：提示'恭喜您！安装完成'，按 Enter 退出命令行。

3.3 静默安装（批量部署推荐）

静默安装依靠配置文件自动运行，不需要人工参与交互，很合适在众多服务器上实施批量部署。

3.3.1 复制静默配置文件并执行修改

ISO 挂载目录中的 setup/silent.cfg 属于模板文件，为只读性质，应当首先将其复制到可写目录（譬如/home/kingbase）之后才实施修改操作。

# 1. 切换到 kingbase 用户
su - kingbase
# 2. 复制 silent.cfg 到/home/kingbase
cp /opt/software/KingbaseESV9/setup/silent.cfg /home/kingbase
# 3. 编辑配置文件（用 vi 或 nano）
vi /home/kingbase/silent.cfg

3.3.2 关键参数说明与配置

配置文件参数如下（需根据实际情况修改，注释可删除）：

# 1. 安装目录（必须指定，绝对路径，分隔符用/）
INSTALL_PATH=/opt/Kingbase/ES/V9
# 2. 授权文件路径（可选，无则用试用版）
LICENSE_PATH=/opt/license.dat
# 3. 安装组件（多组件用逗号分隔，大小写不敏感，错误组件会忽略）
# 可选组件：Server（服务器）、Interface（接口）、KingbaseHA（高可用）、KStudio（开发工具）、KDTS（迁移工具）、DeployTool（部署工具）
COMPONENTS=Server,Interface,KStudio,KDTS
# 4. 是否创建快捷方式（yes/no，默认 yes）
CREATE_SHORTCUT=yes
# 5. 快捷方式用户范围（1=当前用户，2=所有用户，默认 1）
SHORTCUT_USER=1
# 6. 快捷方式程序组名（默认 KingbaseESV009R001）
SHORTCUT_GROUP_NAME=KingbaseESV009R001

修改后保存退出（vi 编辑器按 Esc，输入 :wq）。

3.3.3 启动静默安装

# 进入 ISO 挂载目录
cd /opt/software/KingbaseESV9
# 执行静默安装（-f 指定配置文件路径）
sh setup.sh -i silent -f /home/kingbase/silent.cfg

注意：静默安装无实时进度，需等待 5-10 分钟，可通过查看日志确认进度：

tail -f /opt/Kingbase/ES/V9/install/Logs/KES_install.log

当日志显示'安装完成'时，说明安装成功。

四、安装后检查（确认安装有效性）

安装完成后，需通过以下步骤验证数据库是否正常：

4.1 查看安装日志

日志文件记录安装全过程，若安装失败可通过日志定位问题：

# 切换到 kingbase 用户
su - kingbase
# 查看安装日志（末尾若有'Install success'说明成功）
cat /opt/Kingbase/ES/V9/install/Logs/KES_install.log | grep -i success

4.2 检查数据库版本

# 进入数据库二进制文件目录
cd /opt/Kingbase/ES/V9/Server/bin
# 查看版本（应显示 KingbaseES V009R001C010...）
./kingbase -V

4.3 启动并检查数据库服务

若安装时未勾选'初始化数据库'，需先初始化数据目录，再启动服务：

# 1. 初始化数据目录（-D 指定数据目录，-U 指定管理员用户 system）
./initdb -D /data/kingbase -U system -W
# 执行后会提示输入 system 用户密码（如 Kingbase@2024），重复输入确认
# 2. 启动数据库服务
./sys_ctl -D /data/kingbase start
# 3. 检查服务状态（显示'server is running'说明正常）
./sys_ctl -D /data/kingbase status

4.4 连接数据库验证

通过 ksql 工具（KingbaseES 自带）连接数据库，确认可正常操作：

# 连接数据库（-U 指定用户，-d 指定默认数据库 test，-p 指定端口 54321）
./ksql -U system -d test -p 54321
# 输入密码后，若显示'test=#'，说明连接成功
# 执行 SQL 查询版本（应返回 KingbaseES 版本信息）
select version();
# 退出连接：输入\q，按 Enter

五、常见问题与解决方法

1. 挂载 ISO 时提示'mount: /dev/loop0 is write-protected, mounting read-only'：这是正常提示，ISO 包默认只读挂载，无需处理。
2. 启动数据库时提示'permission denied'：原因：数据目录权限不足，重新赋予 kingbase 用户权限：

   chown -R kingbase:kingbase /data/kingbase
   chmod -R 755 /data/kingbase
   

3. 安装时提示'/tmp 空间不足'：解决方案：删除 /tmp 下无用文件，或临时挂载更大空间到 /tmp：

   # 用 root 用户执行，将/opt/tmp 挂载到/tmp（需先创建/opt/tmp）
   

mkdir -p /opt/tmp mount --bind /opt/tmp /tmp ```