第一章 引言
1.1 背景
本文档介绍金仓 KingbaseES V009R001C001B0030 最新版本数据库的安装、配置等相关内容,并对安装部署过程出现的问题进行描述说明。
1.2 参考资料
1)基于Linux系统的数据库软件安装指南 链接地址:https://help.kingbase.com.cn/v9/index.html
该文档主要涵盖了 KingbaseES V9 数据库安装与升级、应用开发及迁移、安全、性能、可用性等内容。
2)基于Linux系统的数据库软件安装指南 链接地址:https://help.kingbase.com.cn/v9/install-updata/install-linux/index.html
该文档主要介绍在各种 Linux 系统下如何安装部署 KingbaseES V9 数据库 (环境检查、参数设置、图形/命令/静默等方式)。
3)KingbaseES服务器应用参考手册 链接地址:https://help.kingbase.com.cn/v9/admin/reference/ref-server/index.html#kingbasees
第二章 安装前准备工作
在安装部署前,需对软硬件环境进行检查以满足官网安装部署需求,以免影响到后面的实际安装部署,下面列举一些需要注意的地方。
2.1 硬件环境要求
KingbaseES V9 支持通用 X86_64、(龙芯、飞腾、鲲鹏)等主流国产CPU硬件体系架构。
测试环境内存不低于 512MB、硬盘应不低于 11GB (生产环境应更高配置,硬盘建议使用 SSD 等更高配置,建议将数据库安装在使用 SSD 存储盘制定目录)。
生产环境为提高网络安全及稳定,建议采用多网卡绑定。
| 项目名称 | 配置描述 | 备注信息 |
|---|---|---|
| 服务器数量 | 1(台) | 安装单机版 KingbaseES V9 数据库 |
| 内存 | >=512(MB) | 性能测试及商业部署建议更高配置 |
| CPU | >= 1 *2(核),2.0(GHz) | 性能测试及商业部署建议更高配置 支持超线程和非超线程两种模式 |
| 硬盘 | > 1(GB) 存放 tmp 目录 >= 11(GB) 存放数据安装目录 |
系统盘建议配置RAID1,系统和 tmp 目录应留有更大空间 数据盘建议配置RAID5(规划4组RAID5数据盘安装 KingbaseES V9 ) |
| 网络 | 性能测试及商业部署建议设置双网卡冗余bond |
2.2 软件环境要求
KingbaseES V9 支持当前主流 Linux X86_64 操作系统,包括CentOS、中标麒麟、银河麒麟、统信UOS、Deepin、凝思、中科方德、欧拉等操作系统。
| 软件类型 | 配置描述 | 备注信息 |
|---|---|---|
| 操作系统 | x86操作系统 CentOS 7.6及以上 |
生产建议选择CentOS 7系列 |
| inode个数 | 剩余inode个数>15(亿) |
2.3 安装包准备
可通过金仓官网 及 金仓销售或指定代理商获取 KingbaseES V9 软件安装包,切勿通过其它渠道获取软件包,以免浸染病毒。
如下演示通过金仓官网下载 KingbaseES V009R001C001B0030 最新版本安装包。
1)注册并登录金仓官网
首次登录金仓官网需注册账号,注册账号后使用该账号登录金仓官网 https://www.kingbase.com.cn/
2)下载数据库安装包
登录官网,一个便捷下载数据库安装包的方式如下。
登录网站首页,下拉到页面最下端,找到 “下载中心”,如下所示

点击 “下载中心”,进入下载页面,首先选择 “KingbaseES" 数据库产品,选择最新的 ”V009R001C001B0030“ 补丁版本 ,点击左侧 **“软件版本”**折叠菜单,选择 “数据库”,选择 “X86” 架构,然后选择 “Linux” 对应操作系统,再选择 “完整版”,,如下所示:

然后点击 **“点击下载”**按钮,下载对应数据库软件包。
获取到 KingbaseES V9 ISO 安装包后,应通过 MD5 | SHA1 对软件包进行校验,避免软件存在不完整情况,以下是展示查看 MD5 和 SHA1 值方式。
-- 如查看 MD5 值 [root@testingdb /]# md5sum KingbaseES_V009R001C001B0030_Lin64_install.iso 3adf56122ea7d407bc43138ab8b11f84 KingbaseES_V009R001C001B0030_Lin64_install.iso -- 如查看 SHA1 值 [root@testingdb /]# sha1sum KingbaseES_V009R001C001B0030_Lin64_install.iso 2e2633319bafcf53d8bc4439cb6f52d730ad207d KingbaseES_V009R001C001B0030_Lin64_install.iso
3) 选择授权文件
数据库授权文件是数据库的使用凭证,授权文件记录了软件的 PRIVATE KEY、MD5SUM、License序列号、产品名称、有效期等等详细内容,可通过 vi 命令编辑查看授权文件详细内容,如下是 V009R001-license-企业版-90天授权文件完整内容。
-------------------BEGIN KINGASE.LICENSE.3.0 PRIVATE KEY------------------- C2jEV4qxkPiL106gQ3qln8tjay+HPa5fJpaq01bfY8x8a8ClD0AbpZu9Yx6rN3UksMFybE vye7qLXGRoXTgSEL7I/zqAJH4Pgjtz103k73urgqL+hLlqzhMArlDLAIfg7iPk+A3sfw4P ATodyPr5mkmLkxc3q+NAYCroVi8x8Z8vga73Wq5SD7g+YZd6uoTxmkOxWPRytYpeHcwDxY uS1RVBvaN+34D0Oft0nwRB+mLn8yYwmtwMeWA161C2LjPxT+JX0CyuLNPuEBE4rsYbyOe2 hEDwazhy8A+0fi32YJeeDylidhEnnC6gpiOEgZzruEDdwrMI2tz46xiP6CoOXouJZ9DsDI LWlBbdMxwxWAqAUo/R1J8OqcfIOKujwd+QUyRa3SEhft9iQX2zBSxwuqHNuPwIAj4pwkXn c+PzF/vDN9Agd1y+icWlo1yYnv/39l4MP6VxmyyIVl7O3//XPy7eItnrEC0rqoTIEdEhoR 5Kx/EA9C2vNBqg6/CrONYQTJ4Mi5xzoWWfn/lbmkd/L1HOFxJQCHvpi19Gq5A4G7kIQ/FS MhuTgIux4jpTeiu2Vf7uHzi7rBrdqYz7K4bI7b6cE5MxNlNBKQyQIBXLKDA7ZibGki2WZh rD6mYRbDfcEZfF3ZT48G1MGSjzTXs0b12YGLp/SV9Dea/xg3Cbxj0Rk0fP+su9xv7acssj pYhAO81PCybQ3rEMZbHvG+bLjecxh+8MCRaDhN413T3fiAfcAOHIbiJGRA0DA8AkVgGe8B zs5EWlFuF9VutmcqE/0IDwYuImVAbVfd99MQ1M2sLG8OS7mg1gAZtuScPWCy0Zc3JEQawS m3MAEctRQofRHC6FN/spcxr8RuT/MhChrkGor4jkNOb/x5wNdwob9QfL02D3iMaWBJdzbJ nUQa6uSej660pOGq4rfXMdM3JvnprEd+9Wo9jSUka+eF0uGnMmoRjj5Tbhn0slOpdK+/M/ /LRPHgJRh8vUAZKjZgqp4s6XUybzFM6PnstRW65KxYypif1xBC5qwVoodcnmkn1jOgWlqV oQNotO6LDf5I6ZUeD4ufNzkUjmsiKbdQxMrD4I9UwOt96u2fIp9C4uVraIfqUw/qc6COBi Fl4ULdTQN7wSpTbzev+09/jIOAysqatRVcox1yhezRo9PbZvjoMZMW84sI9Qz7pVFSkz64 fd8dhePfxAcFNC7o5HRaBTtXHmiZedJlS7gr61fbB3HhgdTnbQUOH9MqbzIcJ1gISQHGqc 3DHfALtoQpX/hSrUGYTamfvQzunE5h/FFw9o6jzFlpC6Izo/cUbV9gsv8pZRvS1K0+YOoZ LJBVPBZM5cLtDnfG0XbtBKFrHn/lfqrZNQBOMgQqhh8Nz38YQuX5lrxi6BKnhYtRQkJgu3 IWTruiZWWqaAmlEQfT7njekBqB5r+XoHCy2up1pQ2ToHORjQwjcGaiuRcXQ2yjevDYaJ6B p2mWrKXa073mStMkeg7n0WfUaWSGyponKDZzshN4lrC+eigZvZkmiiLHN+t5kwSjQyq1eL UGGmqZgtOirCPisqIh9j/fO0VskDIhDCzMoyThCbIHXsibkeTgEGYoEcl2QmTZeAW/XNxA dCD6AYD1SLWzDfw7Y3R3TemRC43X44159f13wKCy2nL8jG6lLpk1cW1nN3ZaiA+yYFsTjv zvhwfZvIKEexCtDXSSSbaACYYICzTgQjFTgDrGwGduRgnd9ep+UeJbUc6gr/G7WWfS3yr/ wYV+JF84z2f9LWCkO/JiE3/BT2bSjERxK6rmiyg1lzHJQ3m3pHKbLrIhMtT1g2XA== ----------------------------------MD5SUM----------------------------------- 56240d1c34ecb6e4a1bf3b712bcebe91 -------------------END KINGASE.LICENSE.3.0 PRIVATE KEY--------------------- License --- --- 197C9F62-3209-11EF-AACD-000C29CBE49F --- --- 2024-06-24 --- --- KingbaseES V8 --- --- SALES- V9R1 --- --- V009R001C ------ --- --- 90 --- --- --- --- --- --- 0 --- --- 0 --- --- 00:00:00:00:00:00 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 ) --- --- 0 ) --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 --- --- 0 ----------------------------------MD5SUM----------------------------------- 56240d1c34ecb6e4a1bf3b712bcebe91 -------------------END KINGASE.LICENSE.3.0 PRIVATE KEY--------------------- License序列号 --- 启用 --- 197C9F62-3209-11EF-AACD-000C29CBE49F 生产日期 --- 启用 --- 2024-06-24 产品名称 --- 启用 --- KingbaseES V8 细分版本模板名 --- 启用 --- SALES-企业版 V9R1 产品版本号 --- 启用 --- V009R001C 浮动基准日期 ------ 启用 有效期间 --- 启用 --- 90 用户名称 --- 启用 --- 官方网站试用授权 项目名称 --- 启用 --- 官方网站试用授权 CPU检查 --- 启用 --- 0 容器名称 --- 禁用 --- 0 MAC地址 --- 启用 --- 00:00:00:00:00:00 最大连接数 --- 启用 --- 0 分区 --- 启用 --- 0 物理同步 --- 启用 --- 0 读写分离模块 --- 启用 --- 0 恢复到指定时间点 --- 启用 --- 0 集群对网络故障的容错 --- 启用 --- 0 快速加载 --- 启用 --- 0 日志压缩 --- 启用 --- 0 全文检索 --- 启用 --- 0 性能优化包(性能诊断) --- 启用 --- 0 性能优化包(性能调优) --- 启用 --- 0 保密通讯协议 --- 启用 --- 0 审计 --- 启用 --- 0 三权分立 --- 启用 --- 0 透明加密 --- 启用 --- 0 强制访问控制 --- 启用 --- 0 列加密 --- 启用 --- 0 密码复杂度 --- 启用 --- 0 用户锁定 --- 启用 --- 0 集群管理软件 --- 启用 --- 0 集群配置工具 --- 启用 --- 0 集群高级管理包 --- 启用 --- 0 并行查询 --- 启用 --- 0 并行备份还原 --- 启用 --- 0 异构数据源 --- 启用 --- 0 日志解析 --- 启用 --- 0 GIS --- 启用 --- 0 日志解析为SQL --- 启用 --- 0 操作系统类型 --- 启用 --- 0 数据守护集群 --- 启用 --- 0 多活共享存储集群 --- 启用 --- 0
测试和开发环境可通过如下方式下载数据库授权文件。

另可通过 “授权文件版本差异” 查看各数据库授权文件差异。
注:以上是开发测试环境数据库授权文件示例,授权文件使用周期都较短,若生产环境可联系金仓销售人员或代理商获取对应授权文件。
2.4 软件介质清单
本次列举了在 CentOS X86_64 位操作系统安装 KingbaseES V9 的介质清单。
| 介质名称 | 用途 | 大小(Byte) |
|---|---|---|
| KingbaseES_V009R001C001B0030_Lin64_install.iso | KingbaseES V9 安装介质 | 2502,940 KB |
| license_41248_0.dat | 数据库授权文件 | 2.67 KB |
2.5 数据库安装规划
以下是本次数据库安装相关信息,性能及生产环境建议更规范设置。
| 参数名 | 参数值 | 说明 |
|---|---|---|
| 数据库名称 | KingbaseES V9 | 金仓通用型数据库 |
| 数据库版本 | V009R001C001B0030 | KingbaseES V9 最新补丁版本 |
| 授权文件 | V009R001-license-企业版 | KingbaseES V9 企业版授权文件 |
| 安装用户 | kingbase | KingbaseES V9 数据库安装用户 |
| 安装目录 | /database/kingbase/ES/V9 | 数据库定制化安装指定目录 |
| 端口号 | 54321 | 生产环境建议更改端口号 |
| 主机名 | testingdb | 生产环境建议采用规范主机名 |
| IP地址 | 192.168.10.13 | |
| 字符集 | zh_CN.UTF-8 | 生产环境参照实际需求设置字符集 |
第三章 操作系统调整
3.1 操作系统选择
参照金仓官网安装需求,选择适配的操作系统,并选择生命周期支持较长的操作系统版本,避免后期的生产维护调整影响生产业务。
使用如下命令确认操作系统及对应版本:
cat /etc/redhat-release && uname -osr
3.2 关闭防火墙
生产环境建议关闭防火墙,若需开启防火墙,需开放对应端口,可通过如下方式关闭和查看防火墙。
-- 使用root用户查看和关闭防火墙 # systemctl status firewalld # systemctl stop firewalld.service # systemctl disable firewalld.service
3.3 关闭 selinux
生产环境建议关闭selinux,可通过如下命令查看和关闭 selinux 。
cp /etc/selinux/config /etc/selinux/config_`date +"%Y%m%d_%H%M%S"`&& sed -i 's/SELINUX\=enforcing/SELINUX\=disabled/g' /etc/selinux/config
3.4 关闭不需要系统服务
安装了 Linux 操作系统后,默认会开启一些系统服务,这些系统服务为为硬件设备、安全、性能、系统诊断等提供了相应的机制和功能,但某些缺省运行的系统服务也会带来诸如占用系统资源、使数据库运行不正常或异常故障等,所以,建议对一些缺省会占用资源或影响数据库性能的服务进行关闭。
可通过 chkconfig | grep on 来检查开启了哪些系统服务,并将不必要的系统服务进行关闭。
3.5 设置 hosts 文件
主机名设置不能含有下划线 ‘_’,可以使用中划线’-’,建议将服务器 IP 和主机名写入 /etc/hosts 文件。
3.6 配置 YUM 源
在安装一些软件包时,经常会有一些依赖包需要安装,为避免安装时带来的 dependencies 问题,可配置 YUM 源,根据实际环境情况,选择配置网络 YUM 源或本地 YUM 源,相应配置可参照网络文档。
3.7 检查系统内存与存储空间
-- 可通过以下命令查看内存信息 # free -m -- 可通过以下命令查看磁盘存储信息 # df -hl ## /tmp目录需要至少10G空间
3.8 添加用户和组
创建 kingbase 用户和组,生产环境参照实际需要设置。
# useradd -m kingbase # passwd kingbase
3.8 创建安装目录
建议将 KingbaseES V9 安装在指定目录,比如 /database/kingbase/ES/V9,为提升性能建议为该目录使用 SSD 盘。
-- 示例,此处 /dev/sdb 是提供的存储盘,使用 root 用户通过如下命令创建文件系统并挂载 # { mkdir -p /database; device="/dev/sdb"; vgname="vgdata01"; lvname="databaselv"; [[ -e "${device}1" || $(pvs "${device}" 2>/dev/null) ]] && { echo "${device} contains partitions or is already used by LVM."; exit 1; }; mount -l | grep -q "${device}" && { echo "${device} contains a filesystem."; exit 1; }; lsblk; sleep 2; echo -e "\n"; pvcreate "${device}" || { echo "Failed to create PV for ${device}."; exit 1; }; vgcreate "${vgname}" "${device}" || { echo "Failed to extend VG for ${device}."; exit 1; }; lvcreate -l +100%FREE -n ${lvname} ${vgname} || { echo "Failed to extend LV for ${device}."; exit 1; }; mkfs.xfs /dev/mapper/"${vgname}"-"${lvname}" || { echo "Failed to mkfs for ${device}."; exit 1; }; mount /dev/mapper/"${vgname}"-"${lvname}" /database || { echo "Failed to mount LV to /database."; exit 1; }; sleep 2; echo -e "\n"; lsblk; df -h; echo "###Adding ${device} to /database is successful."; } -- 将挂载命令写入 /etc/fstab 文件 # echo "/dev/mapper/vgdata01-databaselv /database xfs defaults,nofail 0 0" | tee -a /etc/fstab -- 创建 /database/kingbase/ES/V9 目录 # mkdir -p /database/kingbase/ES/V9 -- 设置属组 chown -R /database
3.9 挂载 ISO 安装包
下载的 kingbase V9 软件包为 ISO 格式文件,需挂载才能使用,应使用 root 用户挂载,且需 kingbase 用户可有权限访问该挂载目录。
-- 如将下载的 KingbaseES_V009R001C001B0030_Lin64_install.iso 上传至 / 根目录。 # cd / # mkdir KingbaseESV9 # chown kingbase:kingbase KingbaseES_V009R001C001B0030_Lin64_install.iso KingbaseESV9 # mount KingbaseES_V009R001C001B0030_Lin64_install.iso ./KingbaseESV9
[root@testingdb ~]# mount KingbaseES_V009R001C001B0030_Lin64_install.iso ./KingbaseESV9 mount: /dev/loop0 is write-protected, mounting read-only [root@testingdb ~]# df -h Filesystem Size Used Avail Use% Mounted on devtmpfs 2.4G 0 2.4G 0% /dev tmpfs 2.4G 0 2.4G 0% /dev/shm tmpfs 2.4G 12M 2.4G 1% /run tmpfs 2.4G 0 2.4G 0% /sys/fs/cgroup /dev/mapper/vgdata-root 31G 6.1G 25G 20% / /dev/mapper/vgdata01-databaselv 40G 33M 40G 1% /database /dev/sda2 497M 143M 354M 29% /boot tmpfs 478M 0 478M 0% /run/user/0 /dev/loop0 2.4G 2.4G 0 100% /root/KingbaseESV9

3.10 配置内核参数
1)调整内核参数
为避免 KingbaseES 安装和使用过程中出现问题,需检查和设置相关内核参数。
| 参数名称 | 参数说明 | 参考值 |
|---|---|---|
| semmsl | 每个信号量集中信号量的最大数量 | 250 |
| semmns | 系统范围内可用的信号量总数 | 32000 |
| semopm | 单个 semop系统调用中允许的最大操作数 | 100 |
| semmni | 系统中可用的信号量集数量 | 128 |
| shmall | 系统中所有共享内存段可分配的页数总量 | 2097152 |
| shmmax | 单个共享内存段的最大字节数 | 最小: 536870912 最大: 物理内存值减去1字节 建议: 大于物理内存的一半 |
| shmmni | 系统中可用的共享内存段最大数量 | 4096 |
| file-max | 系统中可以打开的文件句柄的最大数量 | 6815744 |
| aio-max-nr | 异步 I/O 请求的最大数量 | 1048576 |
| ip_local_port_range | 系统中本地端口的可用范围 | 最小: 9000 最大: 65500 |
| rmem_default | 默认的接收缓冲区大小(用于套接字) | 262144 |
| rmem_max | 接收缓冲区的最大值(用于套接字) | 4194304 |
| wmem_default | 默认的发送缓冲区大小(用于套接字) | 262144 |
| wmem_max | 发送缓冲区的最大值(用于套接字) | 1048576 |
可通过如下方式调整系统内核参数
-- 使用 root 用户调整系统内核参数,此处示例,性能及生产请参照服务器配置调整相应参数 # tee -a /etc/sysctl.conf << EOF fs.aio-max-nr= 1048576 fs.file-max= 6815744 kernel.shmall= 2097152 kernel.shmmax= 4294967295 kernel.shmmni= 4096 kernel.sem= 250 32000 100 128 net.ipv4.ip_local_port_range= 9000 65500 net.core.rmem_default= 262144 net.core.rmem_max= 4194304 net.core.wmem_default= 262144 net.core.wmem_max= 1048576 EOF -- 然后执行sysctl -p使修改生效 # sysctl -p
2)调整资源使用参数
Linux 资源限制配置文件为 /etc/security/limits.conf,通过调整用户资源限制可提升系统稳定性和性能。
可通过如下方式调整资源使用参数,因为该环境仅为安装 KingbaseES 数据库,选择使用 root 用户调整资源参数,生产也可单独为 kingbase 用户设置资源参数。
-- 使用 root 用户调整资源使用参数,如下所示 # tee -a /etc/security/limits.conf << EOF * soft nofile 65536 * hard nofile 65535 * soft nproc 65536 * hard nproc 65535 * soft core unlimited * hard core unlimited EOF
第四章 安装KingbaseES
4.1 启动安装程序
使用命令行安装可设置中文或英文字符集,可通过 locale -a 查看当前操作系统安装了哪些字符集。
本次选择设置中文字符集进行安装,设置字符集后,启动安装程序,如下所示:
[kingbase@testingdb KingbaseESV9]$ export LANG=zh_CN.UTF-8 [kingbase@testingdb KingbaseESV9]$ sh setup.sh -i console /usr/bin/fc-cache-64: symbol lookup error: /lib64/libfontconfig.so.1: undefined symbol: FT_Done_MM_Var 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 创建) ------------------------------------------------------------------------------- 正在准备控制台模式安装... =============================================================================== 请稍候 ---
4.2 简介
该部分内容是安装 KingbaseES V9 的简介内容, 直接按
=============================================================================== 简介 -- 本安装程序将指导您完成 KingbaseES V9 的安装。 建议您在继续本次安装前,退出所有程序。 如果要回到前一屏幕进行更改,可输入“back”。 如果要取消本次安装,可随时输入“quit”。 KingbaseES Version: V9 Kingbase Type:BMJ-NO Installer Version: V009R001C001B0030 Install DATE:202410030307 Kingbase Inc. http://www.kingbase.com.cn 请按 <ENTER> 键继续: =============================================================================== 请稍候 ---
4.3 许可协议
在此步骤您需要阅读完整的许可协议。连续按
=============================================================================== 许可协议 ---- 安装和使用 KingbaseES V9 产品之前,您须接受下列许可协议: 北京人大金仓信息技术股份有限公司 “软件最终用户许可协议” 重要须知,请认真阅读:本《最终用户许可协议》(以下 称《协议》)是您(个人或单一实体)与北京人大金仓信息 技术股份有限公司(以下简称“人大金仓”)之间有关上述 人大金仓软件产品的法律协议。 本“软件产品”包括计算机软件,并可能包括相关媒体、 印刷材料和联机文档(“软件产品”)。本“软件产品”还 包括对人大金仓提供给您的原“软件产品”的任何更新和补 充资料。任何与本“软件产品”一同提供给您的并与单独一 份软件许可证相关的软件产品是根据本《协议》中的条款而 授予您。您一旦安装、复制、下载、 访问或以其它方式使用“软件产品”, 即表示您同意接受本《协议》各项条款的约束。 如您不同意本《协议》中的条款,请不要安装、 复制或使用“软件产品”。 软件产品许可证 本“软件产品”受著作权法及国际著作权条约和其它知识 产权法和条约的保护。 请按 <ENTER> 键继续: 本“软件产品”只许可使用,而不出售。 1、许可证的授予。只要您遵守本《协议》, 人大金仓将授予您下列非独占性的不可转让的权利: 应用软件。 本软件的使用应在相应合同上规定的地点上使用。使用应受 到购买的数量和许可种类(如合同中所约定)的使用限制所 制约。如果许可种类没有特殊说明, 则您只能在单一一台计算机、工作站、手持式计算机、 智能电话或其他数字电子仪器(“计算机”)上安装、使用、 访问、显示、运行或以其他方式互相作用于(“运行”)本 “软件产品”的一份副本 保留权利。除本协议中具体的规定外, 未明示授予的一切其它权利均为人大金仓所有。 人大金仓保留对本协议内容的解释权。 2、其它权利和限制的说明。 限制转让。在任何情况下, 没有人大金仓的事先书面同意, 您不得转让本协议或本协议项下授予的任何使用许可。 请按 <ENTER> 键继续: 非再销售性软件。 如果本“软件产品”标明“非再销售品”, 则无论本《协议》其它条款有如何说明, 您对本“软件产品”的使用只限于演示、测试或评价目的, 而您不得再销售或以其它方式有偿转让本“软件产品”。 对反向工程、反向编译、反汇编的限制。 您不得对本“软件产品”进行反向工程、 反向编译或反汇编;尽管有此限制, 但如果适用法律明示允许上述活动, 并仅在适用法律明示允许的范围内从事上述活动, 则不在此限。 商标。本《协议》不授予您任何有关人大金仓商标或服务 商标的权利。 出租限制。不得出租、租赁或出借本“软件产品”。 出口限制。您承认本“软件产品”受中国出口法律管辖。 您同意遵守所有适用于本“软件产品”的国际法和国内法, 包括《中华人民共和国对外贸易法》, 请按 <ENTER> 键继续: 以及中国政府颁布的相关软件出口的限制和规定。 支持服务。人大金仓为您提供与“软件产品”有关的支持 服务(“支持服务”), 但支持服务的具体内容受相关合同的制约, 人大金仓保留对支持服务进行收费的权利。 支持服务的使用受用户手册、联机文档和/或其它人大金仓提 供的材料中所述的各项政策和计划的制约。提供给您作为支 持服务的一部份的任何附加软件代码应被视为本“软件产品 ”的一部分,并须符合本《协议》中的各项条款和条件。 至于您提供给人大金仓作为支持服务的一部分的技术信息, 人大金仓可将其用于商业用途,包括产品支持和开发。 除了在为您提供支持时必须的情况外, 人大金仓在使用这些技术信息时不会以个人形式提及您。 协议终止。如您未遵守本《协议》的各项条款和条件, 在不损害其它权利的情况下,人大金仓可终止本《协议》。 如此类情况发生, 您必须销毁“软件产品”的所有副本及其所有组成部分。 3、升级版本。如本“软件产品”标明为升级版本,您必须获 取由人大金仓标明为合格使用升级版本的产品的许可证方可 请按 <ENTER> 键继续: 使用本“软件产品”。人大金仓公司保留在任何时候为您提 供本“软件产品”的升级版本或升级收取费用的权利。标明 为升级版本的“软件产品”替换和/或补充使您有资格使用升 级版本的基础的产品, 您只可根据本《协议》的条款使用所产生的升级产品。如本 “软件产品”是您获得许可作为单一产品使用的一套软件程 序包中一个组件的升级版本,则本“软件产品”只可作为该 单一产品包的一部分而使用和转让, 并且不可将其分开使用在一台以上的计算机上。 4、知识产权。本“软件产品”(包括但不限于本“软件产品 ”中所含的任何图像、照片、动画、录像、录音、音乐、 文字和附加程序)、随附的印刷材料、 及本“软件产品”的任何副本的产权、 著作权和其他知识产权,均由人大金仓或其供应商拥有。通 过使用“软件产品”可访问的内容的一切所有权和知识产权 均属于各自内容所有者拥有, 并可能受著作权法或其它知识产权法和条约的保护。 本《协议》不授予您使用这些内容的权利。 如果这份“软件产品”包括只以电子形式提供的文档, 您可以打印一份该电子文档。 您不可以从本软件中去掉版权声明,并保证为本“软件产品 请按 <ENTER> 键继续: ”复制品(全部或部分)复制版权声明, 您同意制止以任何形式非法复制本软件及文档。 您不可复制本“软件产品”随附的印刷材料。 5、多重媒体软件。您可以由多种媒体获得“软件产品” 。 无论您收到何种类型或大小的媒体, 您只可使用适用于您单一的计算机的一种媒体。 您不可在另一台计算机上运行另一种媒体。 除作为“软件产品”永久转让的一部分外(如上文所述), 您不得将另一种媒体出借、 出租或租赁或以其他方式转移给另一用户。 6、备份副本。 在按照本《协议》安装一份本“软件产品”副本后, 您可以保留人大金仓用以提供给您本“软件产品”的原媒体, 仅用于备份或存档之用。 如果需要原媒体方可在计算机上使用“软件产品”, 您可以复制一份“软件产品”副本仅用于备份或存档之用。 除本《协议》中明文规定外,您不可复制本“软件产品”或 随附本“软件产品”的印刷材料。 经允许的复制件应以安全的方式予以保存。 请按 <ENTER> 键继续: 7、保密。“保密信息”包括程序(含程序中使用的方法和概 念)和人大金仓识别为专有的或保密的一切信息。 除非本协议明确允许,您不得将保密信息透露或者以其他方 式提供给第三方和您没有必要授权其在业务中使用程序的任 何雇员。您应采取一切合理、必要的步骤,保证不将本软件 产品的程序或任何部分透露或以其他方式提供给第三方。 如您是在中华人民共和国取得此人大金仓产品, 下列有限保证适用于您。 1、有限保证 只要您有有效的许可,人大金仓保证:(1)“软件产品” 自收货之日起九十天内基本符合随附书面材料所述的功能。 (2)人大金仓提供的支持服务应基本与有关书面材料中所述 相符,并且人大金仓支持工程师将在商业所允许的范围内尽 力解决任何问题。如果本产品不符合本保证, 人大金仓将修理、更换本产品或退回您已支付的价款,但您 应将该“软件产品”连同您所持有的发票一同退还给人大金 仓。如果本产品的故障是由事故、滥用或误用所造成, 则本保证无效。退换的产品享受原保证期剩余时间, 或三十天的保证(以时间较长者为准)。 在适用法律允许的最大范围内,并且除上述保证外, 请按 <ENTER> 键继续: 人大金仓否认一切明示或默示的保证、条件和其他条款。不 能予以排除的任何默示保证仅限于九十天或适用法律允许的 最短期间(以时间较长者为准)内有效。 2、有限责任 在适用法律所允许的最大范围内,除上述保证规定者外, 人大金仓或其供应商在任何情况下绝不就因使用或不能使用 “软件产品”或因提供或未提供支持服务所发生的任何特殊 的、意外的、 非直接的或间接的损失(包括但不限于营业利润损失、 营业中断、 商业信息的遗失或任何其他金钱上的损失)承担赔偿责任, 即使人大金仓或其任何供应商事先被告知该损害发生的可能 性。不论任何情况, 人大金仓在本《协议》任何条款下所承担的全部责任, 以您就“软件产品”实际已付的价款或人民币10.00元为限, 以两者之间较高额为准。但是, 如果您已经与人大金仓达成支持服务协议,人大金仓就支持 服务的全部赔偿责任应以该支持服务协议条款为准。 管辖法律 本协议受中华人民共和国法律管辖(包括但不限于《中华 人民共和国著作权法》、 请按 <ENTER> 键继续: 《中华人民共和国计算机软件保护条例》、 《中华人民共和国商标法》、《中华人民共和国专利法》、 《中华人民共和国反不正当竞争法》等法律法规)。 因本协议或其违约引起的或与之有关的任何争论或索赔, 应由人大金仓所在地人民法院管辖。 人大金仓的知识产权如被侵犯,上述规定不限制人大金仓就 此向具有合法管辖权的法院请求做出强制性的补救措施。 人大金仓的联系方式如下: 地址:北京市朝阳区容达路7号中国电科太极信息产业园B座三 层 邮编:100102 电话:86-10-5885 1118 网址:www.kingbase.com.cn 全国服务热线:400-601-1188 技术支持邮箱:support@kingbase.com.cn 是否接受此许可协议条款? (Y/N): Y
4.4 选择安装集
根据安装后数据库服务功能的不同,KingbaseES 可分为完全安装、客户端安装和定制安装三种安装集。
-
完全安装:包含数据库服务器、高可用组件、接口、开发管理工具、迁移工具、部署工具。
-
客户端安装:包含接口、开发管理工具、迁移工具、部署工具。
-
定制安装:可自由选择数据库服务器、高可用组件及其他工具组件。
本次选择定制安装,将数据库安装在指定目录
=============================================================================== 选择安装集 ----- 请选择将由本安装程序安装的“安装集”。 ->1- 完全安装 2- 客户端安装 3- 定制安装 输入“安装集”的号码,或按 <ENTER> 键以接受缺省值 : 3 # 选择 3 使用定制安装 =============================================================================== 选择产品功能组件 -------- 输入表示要选择或取消选择的功能部件的号码(用逗号分隔 )。要查看某功能部件的说明,请输入“?<号码>”。 完成后按 <RETURN> 键。 1- [X] 接口 2- [X] 数据库开发管理工具 3- [X] 高可用组件 4- [X] 数据库部署工具 5- [X] 数据库服务器 6- [X] 数据迁移工具 按<ENTER>以安装以上选定的功能或选择相应的号码以改变功 能选择: =============================================================================== 请稍候 --- =============================================================================== 请稍候 ---
4.5 选择授权文件
输入授权文件的绝对路径后,按
=============================================================================== 选择授权文件 ------ 不选择授权文件,则使用软件自带试用版授权 提示:请在有效期内及时更换正式授权文件。 文件路径 : /home/kingbase/soft/license_41248_0.dat # 选择授权文件所在目录及文件 License序列号 --- 启用 --- 197C9F62-3209-11EF-AACD-000C29CBE49F 生产日期 --- 启用 --- 2024-06-24 产品名称 --- 启用 --- KingbaseES V8 细分版本模板名 --- 启用 --- SALES-企业版 V9R1 产品版本号 --- 启用 --- V009R001C 浮动基准日期 ------ 启用 有效期间 --- 启用 --- 90 用户名称 --- 启用 --- 官方网站试用授权 项目名称 --- 启用 --- 官方网站试用授权 CPU检查 --- 启用 --- 0 容器名称 --- 禁用 --- 0 MAC地址 --- 启用 --- 00:00:00:00:00:00 最大连接数 --- 启用 --- 0 分区 --- 启用 --- 0 物理同步 --- 启用 --- 0 读写分离模块 --- 启用 --- 0 恢复到指定时间点 --- 启用 --- 0 集群对网络故障的容错 --- 启用 --- 0 快速加载 --- 启用 --- 0 日志压缩 --- 启用 --- 0 全文检索 --- 启用 --- 0 性能优化包(性能诊断) --- 启用 --- 0 性能优化包(性能调优) --- 启用 --- 0 保密通讯协议 --- 启用 --- 0 审计 --- 启用 --- 0 三权分立 --- 启用 --- 0 透明加密 --- 启用 --- 0 强制访问控制 --- 启用 --- 0 列加密 --- 启用 --- 0 密码复杂度 --- 启用 --- 0 用户锁定 --- 启用 --- 0 集群管理软件 --- 启用 --- 0 集群配置工具 --- 启用 --- 0 集群高级管理包 --- 启用 --- 0 并行查询 --- 启用 --- 0 并行备份还原 --- 启用 --- 0 异构数据源 --- 启用 --- 0 日志解析 --- 启用 --- 0 GIS --- 启用 --- 0 日志解析为SQL --- 启用 --- 0 操作系统类型 --- 启用 --- 0 数据守护集群 --- 启用 --- 0 多活共享存储集群 --- 启用 --- 0
4.6 选择安装目录
默认安装路径是/opt/Kingbase/ES/V9,此处选择指定的安装路径。
=============================================================================== 选择安装目录 ------ 请选择一个安装目录。 您想在哪一位置安装? 缺省安装文件夹: /opt/Kingbase/ES/V9 License序列号 --- 启用 --- 197C9F62-3209-11EF-AACD-000C29CBE49F 生产日期 --- 启用 --- 2024-06-24 产品名称 --- 启用 --- KingbaseES V8 细分版本模板名 --- 启用 --- SALES-企业版 V9R1 产品版本号 --- 启用 --- V009R001C 浮动基准日期 ------ 启用 有效期间 --- 启用 --- 90 用户名称 --- 启用 --- 官方网站试用授权 项目名称 --- 启用 --- 官方网站试用授权 CPU检查 --- 启用 --- 0 容器名称 --- 禁用 --- 0 MAC地址 --- 启用 --- 00:00:00:00:00:00 最大连接数 --- 启用 --- 0 分区 --- 启用 --- 0 物理同步 --- 启用 --- 0 读写分离模块 --- 启用 --- 0 恢复到指定时间点 --- 启用 --- 0 集群对网络故障的容错 --- 启用 --- 0 快速加载 --- 启用 --- 0 日志压缩 --- 启用 --- 0 全文检索 --- 启用 --- 0 性能优化包(性能诊断) --- 启用 --- 0 性能优化包(性能调优) --- 启用 --- 0 保密通讯协议 --- 启用 --- 0 审计 --- 启用 --- 0 三权分立 --- 启用 --- 0 透明加密 --- 启用 --- 0 强制访问控制 --- 启用 --- 0 列加密 --- 启用 --- 0 密码复杂度 --- 启用 --- 0 用户锁定 --- 启用 --- 0 集群管理软件 --- 启用 --- 0 集群配置工具 --- 启用 --- 0 集群高级管理包 --- 启用 --- 0 并行查询 --- 启用 --- 0 并行备份还原 --- 启用 --- 0 异构数据源 --- 启用 --- 0 日志解析 --- 启用 --- 0 GIS --- 启用 --- 0 日志解析为SQL --- 启用 --- 0 操作系统类型 --- 启用 --- 0 数据守护集群 --- 启用 --- 0 多活共享存储集群 --- 启用 --- 0 =============================================================================== 选择安装目录 ------ 请选择一个安装目录。 您想在哪一位置安装? 缺省安装文件夹: /opt/Kingbase/ES/V9 输入一个绝对路径,或按 <ENTER> 键以接受缺省路径 安装文件夹为: /database/kingbase/ES/V9 # 选择指定安装目录 是否正确? (Y/N): Y # 输入 Y 表示确认 =============================================================================== 确定:覆盖非空目录 --------- 选择的目录已经有内容,确定是否覆盖? ->1- 确定 2- 取消 输入要选择的号码,或按 <ENTER> 键接受缺省值:
4.7 预安装摘要
该部分包含安装产品的摘要信息,包括:
-
产品名称
-
安装文件夹
-
功能组件
-
安装路径的磁盘空间信息
=============================================================================== 预安装摘要 ----- 在继续执行前请检查以下信息: 产品名: KingbaseES V9 安装文件夹: /database/kingbase/ES/V9 产品功能部件: 接口, 数据库开发管理工具, 高可用组件, 数据库部署工具, 数据库服务器, 数据迁移工具 安装空间磁盘信息 所需磁盘空间: 5378 MB 空闲磁盘空间: 40903 MB 请按 <ENTER> 键继续:
4.8 初始化数据库
对预安装的内容表示无异议后,选择存放数据的目录、设置端口号、字符集编码、数据库兼容模式(本次选择 Oracle 兼容模式),输入存储块大小等内容,就可以初始化数据库,如下所示。
=============================================================================== 准备就绪,可以安装 --------- 本安装程序已准备完毕,可在下列位置安装 KingbaseES V9: /database/kingbase/ES/V9 按 <ENTER> 键进行安装: =============================================================================== 正在安装... ------- [==================|==================|==================|==================] [------------------|------------------|------------------|------------------] =============================================================================== 请稍候 --- =============================================================================== 选择存储数据的文件夹 ---------- 请选择一个文件夹,该文件夹必须为空。 Data folder (默认﹕ /database/kingbase/ES/V9/data): =============================================================================== =============================================================================== 数据库端口 ----- 请输入数据库服务监听端口,默认54321。 端口 (默认﹕ 54321): # 本次选择默认端口号 =============================================================================== 数据库管理员 ------ 请输入数据库管理员用户名。 User (默认﹕ system): =============================================================================== 输入密码 ---- 本次安装需输入密码才能继续。 请输入密码: 请输入密码:********* # 为 system 用户设置密码 =============================================================================== 再次输入密码 ------ 本次安装需再次输入密码才能继续。 请再次输入密码: 请再次输入密码:********* # 输入确认密码 =============================================================================== 数据库服务字符集 -------- 请输入服务端字符集编码。 1- default ->2- UTF8 3- GBK 4- GB2312 5- GB18030 输入您选择的号码,或按 <ENTER> 键以接受缺省值: # 选择字符集 =============================================================================== 区域 -- 请输入数据库区域。 1- C ->2- zh_CN.UTF-8 3- en_US.UTF-8 输入您选择的号码,或按 <ENTER> 键以接受缺省值: # 选择区域 =============================================================================== 数据库兼容模式 ------- 请输入数据库兼容模式。 1- PG ->2- ORACLE 3- MySQL 输入您选择的号码,或按 <ENTER> 键以接受缺省值: # 选择兼容模式,一旦确认后续就无法更改 =============================================================================== 字符大小写敏感特性 --------- 请输入字符大小写敏感特性。 ->1- YES 2- NO 输入您选择的号码,或按 <ENTER> 键以接受缺省值: # 是否接受大小写敏感 =============================================================================== 存储块大小 ----- 请输入存储块大小。 ->1- 8k 2- 16k 3- 32k 输入您选择的号码,或按 <ENTER> 键以接受缺省值: # 设置存储块大小 =============================================================================== 身份认证方法 ------ 请选择身份认证方法。 ->1- scram-sha-256 2- scram-sm3 3- sm4 4- sm3 输入您选择的号码,或按 <ENTER> 键以接受缺省值: # 选择身份认证方法,本次选择默认 =============================================================================== 自定义参数 ----- 请输入自定义初始化数据库参数。 Custom (默认﹕ ): # 自定义初始化数据库参数,本次选择默认 =============================================================================== 提示 -- 数据库即将被安装,需要花费一些时间,请耐心等待。 请按 <ENTER> 键继续: =============================================================================== =============================================================================== 安装完成 ---- 恭喜!KingbaseES V9 已成功地安装到: /database/kingbase/ES/V9
4.9 执行 root.sh 脚本
使用 root 用户根据提示执行指定目录的 root.sh 脚本,执行此脚本可将 kingbase 注册为系统服务,通过systemctl 来启停数据库。
如果您需要将 KingbaseES V9 注册为系统服务,请运行 /database/kingbase/ES/V9/install/script/root.sh 按 <ENTER> 键以退出安装程序: Complete.
4.10 设置环境变量
为便于快捷使用数据库相关命令,配置 kingbase 用户环境变量,如下所示。
[root@testingdb kingbase]# cd [root@testingdb ~]# su - kingbase [kingbase@testingdb ~]$ vi .bash_profile # 编辑 .bash_profile 文件,输入如下内容 export PATH=/database/kingbase/ES/V9/Server/bin:$PATH export KINGBASE_HOME=/database/kingbase/ES/V9 export KINGBASE_DATA=/database/kingbase/ES/V9/data -- 保存并退出 [kingbase@testingdb ~]$ source .bash_profile # 生效环境变量
第五章 验证数据库
5.1 查看系统服务和进程
执行了 root.sh 脚本后,即为注册了系统服务,可通过 systemctl 查看服务。
[root@testingdb ~]# systemctl status kingbased.service ● kingbased.service - LSB: Start and stop the kingbase server Loaded: loaded (/etc/rc.d/init.d/kingbased; bad; vendor preset: disabled) Active: active (exited) since Mon 2024-10-07 03:36:43 CST; 1s ago Docs: man:systemd-sysv-generator(8) Process: 3630 ExecStop=/etc/rc.d/init.d/kingbased stop (code=exited, status=0/SUCCESS) Process: 3658 ExecStart=/etc/rc.d/init.d/kingbased start (code=exited, status=0/SUCCESS) Oct 07 03:36:42 testingdb systemd[1]: Starting LSB: Start and stop the kingbase server... Oct 07 03:36:42 testingdb kingbased[3658]: Starting KingbaseES V9: Oct 07 03:36:42 testingdb su[3660]: (to kingbase) root on none Oct 07 03:36:43 testingdb kingbased[3658]: waiting for server to start.... done Oct 07 03:36:43 testingdb kingbased[3658]: server started Oct 07 03:36:43 testingdb kingbased[3658]: KingbaseES V9 started successfully Oct 07 03:36:43 testingdb systemd[1]: Started LSB: Start and stop the kingbase server.
通过 ps -ef 查看数据库进程
[kingbase@testingdb ~]$ ps -ef | grep kingbase | grep -v grep | grep -v -E 'su|bash|tail' kingbase 3841 1 0 04:04 ? 00:00:00 /database/kingbase/ES/V9/KESRealPro/V009R001C001B0030/Server/bin/kingbase -D /database/kingbase/ES/V9/data kingbase 3842 3841 0 04:04 ? 00:00:00 kingbase: logger kingbase 3844 3841 0 04:04 ? 00:00:00 kingbase: checkpointer kingbase 3845 3841 0 04:04 ? 00:00:00 kingbase: background writer kingbase 3846 3841 0 04:04 ? 00:00:00 kingbase: walwriter kingbase 3847 3841 0 04:04 ? 00:00:00 kingbase: autovacuum launcher kingbase 3848 3841 0 04:04 ? 00:00:02 kingbase: stats collector kingbase 3849 3841 0 04:04 ? 00:00:00 kingbase: kwr collector kingbase 3850 3841 0 04:04 ? 00:00:00 kingbase: ksh writer kingbase 3851 3841 0 04:04 ? 00:00:00 kingbase: ksh collector kingbase 3852 3841 0 04:04 ? 00:00:00 kingbase: logical replication launcher
5.2 登录测试
可通过 ksql 命令登录数据库。
[kingbase@testingdb ~]$ ksql -p 54321 -U system test Password for user system: Type "help" for help. test=# select version(); version ---------------------------------------------------------------------------------------------------------------------- KingbaseES V009R001C001B0030 on x86_64-pc-linux-gnu, compiled by gcc (GCC) 4.8.5 20150623 (Red Hat 4.8.5-28), 64-bit (1 row) test=# \l List of databases Name | Owner | Encoding | Collate | Ctype | Access privileges -----------+--------+----------+-------------+-------------+------------------- kingbase | system | UTF8 | zh_CN.UTF-8 | zh_CN.UTF-8 | security | system | UTF8 | zh_CN.UTF-8 | zh_CN.UTF-8 | template0 | system | UTF8 | zh_CN.UTF-8 | zh_CN.UTF-8 | =c/system + | | | | | system=CTc/system template1 | system | UTF8 | zh_CN.UTF-8 | zh_CN.UTF-8 | =c/system + | | | | | system=CTc/system test | system | UTF8 | zh_CN.UTF-8 | zh_CN.UTF-8 | (5 rows) test=#
5.3 启停数据库
可通过两种方式启停数据库服务
- 方式一
执行了 root.sh 后即注册了系统服务,可通过 systemctl 命令启停数据库。
-- 查看数据库服务状态 [root@testingdb ~]# systemctl status kingbased.service -- 启动数据库服务 [root@testingdb ~]# systemctl start kingbased.service -- 停止数据库服务 [root@testingdb ~]# systemctl stop kingbased.service
- 方式二
可通过 sys_ctl 命令来启停数据库
-- 启动数据库 [kingbase@testingdb ~]$ sys_ctl -w start -D /database/kingbase/ES/V9/data -l "/database/kingbase/ES/V9/data/sys_log/startup.log" waiting for server to start.... done server started -- 停止数据库 [kingbase@testingdb ~]$ sys_ctl stop -m fast -w -D /database/kingbase/ES/V9/data waiting for server to shut down.... done server stopped




