当前位置： 首页 > news >正文

【金仓数据库产品体验官】_KingbaseES（SQLServer兼容版）保姆级安装教程

news 2025/7/22 21:38:46

文档说明

本文档主要针对 KingbaseES V9（SQLServer兼容版） 的命令行安装过程进行详细讲解，帮助用户通过命令行完成从环境配置到数据库安装的各项操作。文中所述的步骤基于实际操作环境，并适用于以下环境配置：

实验环境：CentOS Linux release 7.9.2009 (Core)

一、安装前准备工作

1.1 硬件环境要求

  • KingbaseES支持通用X86_64、飞腾、鲲鹏等国产CPU硬件体系架构。
  • 本次实验环境：CentOS Linux release 7.9.2009 (Core)

1.2 软件环境要求

  • KingbaseES支持各种主流的Linux操作系统64位发行版本，包括CentOS、中标麒麟、银河麒麟、统信UOS、Deepin、凝思、中科方德、欧拉等操作系统。

1.3 安装包准备

  • 下载页面：https://www.kingbase.com.cn/download.html

二、检查和配置环境

2.1 检查操作系统信息

cat /etc/*release

2.2 检查系统内存与存储空间

free -m

注意： /tmp目录需要至少10G空间。如果安装过程中出现存储空间不足，请先释放足够磁盘空间，或更换满足要求的硬件设备再进行安装。

2.3 配置内核参数

编辑 /etc/sysctl.conf 文件，修改以下参数：

kernel.sem=5010 64128000 50100 1280             # 设置信号量
kernel.shmmni=8192                              # 设置系统级信号资源
fs.file-max=7672460                             # 文件句柄数量上限（系统级）
vm.overcommit_memory=2                          # 设置内存分配策略
vm.overcommit_ratio=90                          # 设置内存分配时的比例
net.ipv4.ip_local_port_range=9000 65500        # 对外连接端口范围

修改后，重启Linux系统并验证：

/sbin/sysctl -p
/sbin/sysctl -a

2.4 资源使用参数配置

编辑 /etc/security/limits.conf 文件，设置如下：

* soft nofile 65536
# 注意：设置nofile的hard limit不能大于/proc/sys/fs/nr_open，否则注销后无法正常登录
* hard nofile 65535
* soft nproc 65536
* hard nproc 65535
* soft core unlimited
* hard core unlimited

2.5 RemoveIPC参数设置

  • systemd-logind服务默认可能开启RemoveIPC=yes，会导致用户退出后删除IPC对象，造成程序信号丢失等问题。
  • 编辑 /etc/systemd/logind.conf 文件，将 RemoveIPC=no，然后重启服务：
systemctl daemon-reload
systemctl restart systemd-logind.service

三、预安装工作

3.1 创建安装用户

useradd -m kingbase
passwd kingbase

之后默认使用kingbase用户进行操作。

3.2 安装目录准备

mkdir -p /opt/Kingbase/ES/V9
chmod o+rwx /opt/Kingbase/ES/V9
mkdir -p /opt/Kingbase/ES/V9/data

（可自定义安装目录，本文不展开）

3.3 挂载安装包

mount KingbaseES_V009R004C012B0006_Lin64_install.iso /mnt
# 安装完毕后取消挂载
umount /mnt

四、命令行安装流程

4.1 启动安装程序

echo $LANG
export LANG=zh_CN.UTF-8
cd /mnt
sh setup.sh -i console

4.2 安装交互步骤

Now launch installer...
Preparing to install
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...........
Launching installer...===============================================================================
KingbaseES V9                                           (使用 InstallAnywhere 创建)
-------------------------------------------------------------------------------正在准备控制台模式安装...===============================================================================请稍候
---===============================================================================
简介
--本安装程序将指导您完成 KingbaseES V9 的安装。建议您在继续本次安装前，退出所有程序。
如果要回到前一屏幕进行更改，可输入“back”。如果要取消本次安装，可随时输入“quit”。KingbaseES Version: V9
Kingbase Type:BMJ-NO
Installer Version: V009R004C012
Install DATE:202507010151Kingbase Inc.http://www.kingbase.com.cn请按 <ENTER> 键继续: 
......

是否接受此许可协议条款？ (Y/N): Y===============================================================================
选择安装集
-----请选择将由本安装程序安装的“安装集”。->1- 完全安装2- 客户端安装3- 定制安装输入“安装集”的号码，或按 <ENTER> 键以接受缺省值: 3===============================================================================
选择产品功能组件
--------输入表示要选择或取消选择的功能部件的号码（用逗号分隔
）。要查看某功能部件的说明，请输入“?<号码>”。
完成后按 <RETURN> 键。1- [X] 接口2- [X] 数据库开发管理工具3- [X] 数据库部署工具4- [X] 数据库服务器5- [X] 数据迁移工具请选择取消安装的功能部件或按<Enter>键继续。: ===============================================================================请稍候
---

===============================================================================
选择授权文件
------不选择授权文件，则使用软件自带试用版授权
提示：请在有效期内及时更换正式授权文件。文件路径 : ===============================================================================
选择安装目录
------请选择一个安装目录。您想在哪一位置安装？缺省安装文件夹： /opt/Kingbase/ES/V9输入一个绝对路径，或按 <ENTER> 键以接受缺省路径: 对于所选安装目的地，您没有写入权。
请选择一个不同的安装位置输入一个绝对路径，或按 <ENTER> 键以接受缺省路径: ===============================================================================
确定：覆盖非空目录
---------选择的目录已经有内容，确定是否覆盖？->1- 确定2- 取消输入要选择的号码，或按 <ENTER> 键接受缺省值: 1===============================================================================
预安装摘要
-----在继续执行前请检查以下信息：产品名：KingbaseES V9安装文件夹：/opt/Kingbase/ES/V9产品功能部件：接口,数据库开发管理工具,数据库部署工具,数据库服务器,数据迁移工具安装空间磁盘信息所需磁盘空间： 5112 MB           空闲磁盘空间： 38238 MB请按 <ENTER> 键继续: ===============================================================================
准备就绪，可以安装
---------本安装程序已准备完毕，可在下列位置安装 KingbaseES V9：/opt/Kingbase/ES/V9按 <ENTER> 键进行安装: ===============================================================================
正在安装...
-------[==================|==================|==================|==================][------------------|------------------|------------------|------------------]

===============================================================================
选择存储数据的文件夹
----------请选择一个文件夹，该文件夹必须为空。Data folder (默认﹕ /opt/Kingbase/ES/V9/data): ===============================================================================请稍候
---===============================================================================请稍候
---===============================================================================
数据库端口
-----请输入数据库服务监听端口，默认54321。端口 (默认﹕ 54321): ===============================================================================
数据库管理员
------请输入数据库管理员用户名。User (默认﹕ system): ===============================================================================
输入密码
----本次安装需输入密码才能继续。请输入密码: 请输入密码:*    
*请输入密码，以便继续。请输入密码: 请输入密码:*********  ===============================================================================
再次输入密码
------本次安装需再次输入密码才能继续。请再次输入密码: 请再次输入密码:*k*******
*===============================================================================
数据库服务字符集
--------请输入服务端字符集编码。1- default->2- UTF83- GBK4- GB23125- GB18030输入您选择的号码，或按 <ENTER> 键以接受缺省值: ===============================================================================
区域
--请输入数据库区域。1- C->2- zh_CN.UTF-83- en_US.UTF-8输入您选择的号码，或按 <ENTER> 键以接受缺省值: ===============================================================================
数据库兼容模式
-------请输入数据库兼容模式。->1- SQL Server输入您选择的号码，或按 <ENTER> 键以接受缺省值: ===============================================================================
存储块大小
-----请输入存储块大小。->1- 8k2- 16k3- 32k输入您选择的号码，或按 <ENTER> 键以接受缺省值: ===============================================================================
身份认证方法
------请选择身份认证方法。->1- scram-sha-2562- scram-sm33- sm44- sm3输入您选择的号码，或按 <ENTER> 键以接受缺省值: ===============================================================================
自定义参数
-----请输入自定义初始化数据库参数。Custom (默认﹕  ): ===============================================================================
提示
--数据库即将被安装，需要花费一些时间，请耐心等待。请按 <ENTER> 键继续: ===============================================================================请稍候
---===============================================================================请稍候
---===============================================================================请稍候
---===============================================================================请稍候
---===============================================================================请稍候
---===============================================================================请稍候
---===============================================================================
安装完成
----恭喜！KingbaseES V9 已成功地安装到：/opt/Kingbase/ES/V9如果您需要将 KingbaseES V9 注册为系统服务，请运行/opt/Kingbase/ES/V9/install/script/root.sh按 <ENTER> 键以退出安装程序: 
Complete.

安装小结：

  • 接受许可协议：输入Y
  • 选择安装集：选择3（定制安装）或者1（完全安装）
  • 选择功能组件，默认全部勾选，直接回车继续
  • 选择授权文件，留空使用试用版授权
  • 选择安装目录，默认 /opt/Kingbase/ES/V9，按需修改
  • 如果目录非空，选择覆盖
  • 确认预安装摘要信息，按回车继续
  • 选择数据存储目录，默认 /opt/Kingbase/ES/V9/data
  • 设置数据库端口，默认54321
  • 输入数据库管理员用户名，默认system
  • 设置数据库管理员密码
  • 选择字符集，推荐UTF8
  • 选择区域，推荐zh_CN.UTF-8
  • 选择数据库兼容模式，选择SQL Server
  • 选择存储块大小，默认8k
  • 选择身份认证方法，默认scram-sha-256
  • 自定义参数，留空即可
  • 确认安装，等待完成

五、安装后操作

5.1 注册系统服务

如果想注册数据库服务为系统服务，您可以在安装并初始化数据库成功后，执行root.sh脚本来注册并启动数据库服务，具体步骤如下：

  1. 打开新终端；
  2. 切换到root用户；
  3. 运行${安装目录}/install/script/root.sh 。

如果想启动或停止数据库服务，进入${安装目录}/Server/bin目录执行如下命令：

[root@node ~]# /opt/Kingbase/ES/V9/install/script/root.sh
Starting KingbaseES V9: waiting for server to start..... done
server started
KingbaseES V9 started successfully

六、安装后检查

6.1 查看安装文件

[root@node ~]# cd /opt/Kingbase/ES/V9/install/
[root@node install]# ls
desktops  jre  LICENSE_EN  LICENSE_ZH  Logs  script  xulrunner
[root@node install]# cd Logs/
[root@node Logs]# ls
KingbaseES_V9_安装_07_01_2025_02_02_30.log  ln.log  postinstaller_debug.txt  preinstaller_debug.txt
[root@node Logs]# more KingbaseES_V9_安装_07_01_2025_02_02_30.log                              
#选择存储数据的文件夹
#--------------------
USER_SELECTED_DATA_FOLDER=/opt/Kingbase/ES/V9/data#数据库端口
#----------
DB_PORT=54321#数据库管理员
#------------
DB_USER=system#输入密码
#--------
DB_PASS=
INDEX_OF_MATCHING_PASSWORD=0#再次输入密码
#------------
DB_PASS2=
INDEX_OF_MATCHING_PASSWORD=0#数据库服务字符集
#----------------
ENCODING_PARAM=\"\",\"UTF8\",\"\",\"\",\"\"#区域
#----
LOCALE_PARAM=\"\",\"zh_CN.UTF-8\",\"\"#数据库兼容模式
#--------------
DATABASE_MODE_PARAM=\"SQL Server\"#存储块大小
#----------
BLOCK_SIZE_PARAM=\"8k\",\"\",\"\"#身份认证方法
#------------
AUTHENTICATION_METHOD_PARAM=\"scram-sha-256\",\"\",\"\",\"\"#自定义参数
#----------
INITCUSTOM= 摘要
----安装： 成功 null4284 成功
1 警告
0 无致命错误
0 致命错误操作注释：无

6.2 验证数据库连接

[kingbase@node bin]$ ./ksql -p 54321 -U system test
Password for user system: 
Licesen Type: SALES-企业版.
Type "help" for help.test=#

6.3 查询版本信息

test=# select version();version         
-------------------------KingbaseES V009R004C012
(1 row)test=# exit
[kingbase@node bin]$ ./kingbase -V;
kingbase (KingbaseES) V009R004C012

七、总结

KingbaseES V9 的安装过程涵盖了硬件环境确认、操作系统配置、内核及资源限制调优、安装用户和目录准备，以及安装程序的交互操作。通过规范的预安装检查和系统参数调整，可以有效保障数据库的稳定运行和性能表现。

官方文档中有些地方还没有改过来，大家可以参考我这篇针对SQLServer兼容版的文档进行安装。

更多参考资料请见：KingbaseES V9 安装指南

八、建议

1、目录创建命令优化建议：
在官方安装文档中，执行 mkdir /opt/Kingbase/ES/V9 的命令时，建议修改为 mkdir -p /opt/Kingbase/ES/V9。因为 mkdir -p 会自动创建多级目录，而不会出现目录不存在的错误。如果目标路径中有部分目录不存在，-p 参数能确保创建所有必要的目录层级。
优化建议：在官方文档中明确建议使用 mkdir -p /opt/Kingbase/ES/V9 或者添加相关说明，避免用户在操作时遇到路径不存在的情况。

2、安装后日志文件路径问题：
在安装后的检查步骤中，提到日志文件 “KingbaseES_V9_安装_*.log” 位于 ${安装目录}/Logs 目录下。但实际操作中，日志文件并没有在 ${安装目录}/Logs 目录下生成。日志文件位于安装目录下的install/Logs 目录中。
优化建议：建议官方安装文档中修正日志路径，或者在相关位置添加明确的说明，以避免用户在安装后找不到日志文件。

http://www.xdnf.cn/news/1165285.html

相关文章：

  • AC身份认证实验之AAA服务器
  • Linux中ELF区域与文件偏移量的关系
  • 【牛客算法】小美的排列询问
  • DL00691-基于深度学习的轴承表面缺陷目标检测含源码python
  • Python可迭代归约函数深度解析：从all到sorted的进阶指南
  • scratch音乐会开幕倒计时 2025年6月中国电子学会图形化编程 少儿编程 scratch编程等级考试一级真题和答案解析
  • docker 软件bug 误导他人 笔记
  • Linux网络信息（含ssh服务和rsync）
  • 微信二维码扫描登录流程详解
  • 网络编程之 UDP：用户数据报协议详解与实战
  • 嵌入式八股文之 struct 和 union 的区别、大厂真题1、头文件中的#ifdef/#define/#endif作用是什么？
  • React探索高性能Tree树组件实现——react-window、react-vtree
  • Kafka 如何优雅实现 Varint 和 ZigZag 编码
  • AXI接口学习
  • 在github上搭建自己主页
  • Spring Boot 3核心技术面试指南：从迁移升级到云原生实战，9轮技术攻防（含架构解析）
  • 添加状态信息
  • Linux find命令：强大的文件搜索工具
  • 代码审计Tabby安装教程
  • 神经网络——归一化层
  • nextjs编程式跳转
  • LinkedList的模拟实现（双向链表Java）
  • Java注解家族--`@ResponseBody`
  • 神经网络——线性层
  • 【c++】leetcode5 最长回文子串
  • 蚂蚁数科AI数据产业基地正式投产，携手苏州推进AI产业落地
  • 奥比中光深度相机开发
  • 感知机-梯度下降法
  • 141 个 LangChain4j Maven 组件分类解析、多场景实战攻略
  • 一个月掌握数据结构与算法：高效学习计划