基于Linux体系安装金仓数据库KingbaseES

1. 关于金仓数据库KingbaseES

金仓数据库KingbaseES是中电科金仓信息技能股份有限公司自主研发的、具有自主知识产权的商用关系型数据库管理体系（DBMS）。该产品面向事件处置惩罚类应用，分身各类数据分析类应用，可用做信息管理体系、业务及生产体系、决议支持体系、全文检索、地理信息体系等的承载数据库。
KingbaseES支持多种利用体系和硬件平台:支持Linux、Windows、国产Kylin等数十个利用体系产品版本，支持通用x86_64及国产龙芯、飞腾、申威等CPU硬件体系架构。
针对不同范例的客户需求，KingbaseES提供标准版、企业版、专业版、开发版等多种版本。这些版本构建于同一数据库引擎上，不同平台版本完全兼容。
KingbaseES软件能够提供一主一备以及一主多备的高可用集群架构，实现数据及实例级 (异地) 故障容灾，也能够提供多节点并行服务，内存融合及存储共享，实现高并发性能使用最大化，联合读写分离或备份使用同步实现数据掩护最大化。
本文章重要介绍如安在Linux环境安装金仓数据库KingbaseES。
2. 安装包预备

可以通过金仓官网（电科金仓-成为世界良好的数据库产品与服务提供商）下载对应平台的安装程序。
在得到安装程序（iso文件）的同时，应该会得到一个MD5值或SHA1值。
建议先通过以下命令查看安装程序文件对应的MD5值或SHA1值，再和拿到的MD5值或SHA1值进行比对。
如果划一，说明安装文件正常；如果不划一，说明安装文件可能不完整，安装过程可能无法正常完成。
   假设拿到的安装包文件是KingbaseES_V009R001C002B0014_Lin64_install.iso，查看其MD5值：

1. md5sum KingbaseES_V009R001C002B0014_Lin64_install.iso

复制代码

查看其SHA1值：

1. sha1sum KingbaseES_V009R001C002B0014_Lin64_install.iso

复制代码

3. 检查和配置环境

3.1. 检查利用体系信息

通过以下命令查看利用体系信息：
  

1. cat /etc/*release

复制代码

注意:为制止安装失败，或安装结束后文件发生非常，请在安装前关闭利用体系的应用掩护，或于安装时在利用体系界面手动点击允许程序执行。
3.2. 检查体系内存与存储空间

通过以下命令查看内存信息（以MB单位表现）：
  

1. free -m

复制代码

通过以下命令查看磁盘存储信息（以GB单位表现）：
  

1. df -hl

复制代码

注意: /tmp目次需要至少10G空间。如果安装过程中出现存储空间不足的情况，请先释放足够的磁盘空间，再执行安装程序。如果硬件配置不满足要求，需要更换满足要求的硬件设备再进行安装。
3.3. 配置内核参数

为了制止在KingbaseES安装和使用过程中出现问题，需要检查和设置内核参数。

• 内核参数
  

参考内核参数查看命令(最新的体系，需参考体系的用户手册)检查内核参数。
内核参数查看命令   参数
  查看命令
  semmsl, semmns, semopm, and semmni
  # /sbin/sysctl -a | grep sem
  shmall, shmmax, and shmmni
  # /sbin/sysctl -a | grep shm
  file-max
  # /sbin/sysctl -a | grep file-max
  ip_local_port_range
  # /sbin/sysctl -a | grep ip_local_port_range
  rmem_default
  # /sbin/sysctl -a | grep rmem_default
  rmem_max
  # /sbin/sysctl -a | grep rmem_max
  wmem_default
  # /sbin/sysctl -a | grep wmem_default
  wmem_max
  # /sbin/sysctl -a | grep wmem_max
  aio-max-nr
  # /sbin/sysctl -a | grep aio-max-nr
  tcp_wmem
  # /sbin/sysctl -a | grep tcp_wmem
  tcp_rmem
  # /sbin/sysctl -a | grep tcp_rmem
  内核参数参考值   参数
  参考值
  所在文件
  semmsl
  250
  /proc/sys/kernel/sem
  semmns
  32000
  semopm
  100
  semmni
  128
  shmall
  2097152
  /proc/sys/kernel/shmall
  shmmax
  最小: 536870912
最大: 物理内存值减去1字节
建议: 大于物理内存的一半
  /proc/sys/kernel/shmmax
  shmmni
  4096
  /proc/sys/kernel/shmmni
  file-max
  6815744
  /proc/sys/fs/file-max
  aio-max-nr
  1048576
注意: 本参数限定并发发出的哀求数量。应该设置以制止IO 子体系的失败。
  /proc/sys/fs/aio-max-nr
  ip_local_port_range
  最小： 9000
最大： 65500
  /proc/sys/net/ipv4/ip_local_port_range
  rmem_default
  262144
  /proc/sys/net/core/rmem_default
  rmem_max
  4194304
  /proc/sys/net/core/rmem_max
  wmem_default
  262144
  /proc/sys/net/core/wmem_default
  wmem_max
  1048576
  /proc/sys/net/core/wmem_max
  若内核参数与参考值不划一，您可通过编辑/etc/sysctl.conf文件修改参数，如下所示：

1. fs.aio-max-nr= 1048576
2. fs.file-max= 6815744
3. kernel.shmall= 2097152
4. kernel.shmmax= 4294967295
5. kernel.shmmni= 4096
6. kernel.sem= 250 32000 100 128
7. net.ipv4.ip_local_port_range= 9000 65500
8. net.core.rmem_default= 262144
9. net.core.rmem_max= 4194304
10. net.core.wmem_default= 262144
11. net.core.wmem_max= 1048576

复制代码

内核参数修改完毕后，重启Linux体系，并输入如下命令查看内核参数的修改是否精确：

1. /sbin/sysctl -p
2. /sbin/sysctl -a

复制代码

• 资源使用参数
  

Linux资源限定配置文件是/etc/security/limits.conf。限定用户可使用的资源数量对体系的稳定性非常重要。您可以通过调整资源限定数量改进体系性能。
limits.conf文件如下所示：

其中soft是一个告诫值，hard是真正意义的阈值，超过体系就会报错，一般情况下两者设为同一个值。一般保持体系安装时的默认值即可。
可配置的资源有如下种类：
  资源项
  寄义
  core
  内核文件大小（KB）
  data
  最大数据大小（KB）
  fsize
  最大文件大小（KB）
  memlock
  最大锁定内存地址空间（KB）
  nofile
  最大打开的文件描述符数量
  rss
  最大恒久设置大小（KB）
  stack
  最大堆栈大小（KB）
  cpu
  最大CPU时间（分钟）
  noproc
  最大进程数量
  as
  地址空间限定（KB）
  maxlogins
  用户最大登录次数
  maxsyslogins
  体系上登录的最大数量
  priority
  运行用户进程的优先级
  locks
  用户可持有的最大文件锁数量
  sigpending
  最大挂起的信号数量
  msgqueue
  POSIX消息队列使用的最大内存（字节）
  nice
  最大可提拔到的符合优先级
  rtprio
  最大实时优先级
  nofile、noproc、core参数可修改为如下值：

1. # *表示所有用户，可只设置root和kingbase用户
2. * soft nofile 65536
3. # 注意：设置nofile的hard limit不能大于/proc/sys/fs/nr_open，否则注销后将无法正常登陆
4. * hard nofile 65535
5. * soft nproc 65536
6. * hard nproc 65535
7. # unlimited表示无限制
8. * soft core unlimited
9. * hard core unlimited

复制代码

• RemoveIPC参数
  

systemd-logind服务中引入的一个特性，是当一个用户退出体系后，会删除全部有关的IPC对象。该特性由/etc/systemd/logind.conf文件中的RemoveIPC参数控制。某些利用体系会默认打开，会造成程序信号丢失等问题（只有redhat7及以上和一些特殊的国产Linux的版本需要修改，改之前可先查看此项是否为默认yes)。设置RemoveIPC=no。设置后重启服务：

1. systemctl daemon-reload
2. systemctl restart systemd-logind.service

复制代码

4. 预安装工作

4.1. 创建安装用户

在安装KingbaseES时，安装用户对于安装路径需有“读”、“写”、“执行”的权限。在Linux体系中，需要以非root用户执行安装程序，且该用户要有标准的home目次。
因此，在正式安装前，新建kingbase用户作为KingbaseES专用的体系用户，可以先使用root用户运行如下命令创建kingbase用户：

1. useradd -m kingbase

复制代码

注意:创建安装体系用户kingbase之后，如无特殊说明，本指南后续的利用默认使用kingbase用户进行利用。该命令会同时创建同名用户组kingbase以及用户根目次/home/kingbase。继承运行如下命令设置kingbase用户的暗码：

1. passwd kingbase

复制代码

注意:暗码需要输入两次，包管两次输入的暗码雷同。
4.2. 安装目次

KingbaseES默认的安装目次是 /opt/Kingbase/ES/V9 。
如果不存在，需要使用root用户先创建该目次，并赋予kingbase用户对该目次的读写权限。

1. mkdir /opt/Kingbase/ES/V9
2. chmod o+rwx /opt/Kingbase/ES/V9

复制代码

也可以自定义安装路径。如自定义安装路径为 /home/kingbase/kdb ，使用kingbase用户创建目次的命令如下：

1. su - kingbase
2. mkdir /home/kingbase/kdb

复制代码

4.3. 数据目次

数据目次是KingbaseES中存放数据文件的目次，默认是在安装目次下的data目次。也可以与安装目次分开单独设置。
可以根据业务体系数据量来单独设置数据目次路径，例如将数据目次初始化在本机硬盘或者挂载在盘阵上。
运行如下命令创建数据目次：

1. mkdir /opt/Kingbase/ES/V9/data

复制代码

注意:数据目次不必事先创建。安装过程中会提示指定数据目次，如果目次不存在安装程序会自动创建。
4.4. 安装包的挂载与取消

iso格式的安装程序包需要先挂载才能使用。挂载iso文件需要使用root用户。好比挂载的目次是iso文件同级目次KingbaseES，可以运行如下命令进行挂载：

1. #cd KingbaseES_V009R001C002B0014_Lin64_install.iso所在目录
2. su
3. mount KingbaseES_V009R001C002B0014_Lin64_install.iso ./KingbaseESV9

复制代码

KingbaseES目次下可以看到setup目次和setup.sh脚本。安装完成后可以运行如下命令取消挂载iso文件：

1. su
2. umount ./KingbaseESV9

复制代码

此时KingbaseES已经和iso文件解除挂载关系，在KingbaseES目次下不会再看到安装相干文件。
5. 安装

5.1. 启动安装程序

命令行安装支持中文和英文的文字提示。根据利用体系的语言设置会表现对应语言的提示信息。您可以执行如下命令查看利用体系的语言设置：

1. echo $LANG

复制代码

如果体系表现值包罗“zh_CN”，则为中文语言，安装程序会表现中文内容。否则，可以执行如下命令修改语言设置为中文：

1. export LANG=zh_CN.UTF-8

复制代码

接下来开始进行命令行安装过程。您起首进入安装程序中setup.sh所在目次，以kingbase用户执行如下命令：

1. sh setup.sh -i console

复制代码

命令执行后，将会启动安装程序。

输入1，再按<ENTER>，选择“安装新的实例”；
输入2，再按<ENTER>，选择“修改存在的实例”。
初次安装，输入1，按<ENTER>，进入“简介”界面。
5.2. 简介

“简介”界面中提供了KingbaseES版本和安装程序版本等信息。

输入quit，按<ENTER>退出安装；
输入back，按<ENTER>返回前一屏幕；
直接按<ENTER>进行下一步利用。
若无特殊说明，以下各步调皆与此雷同。
5.3. 许可协议

在此步调需要阅读完整的许可协议。连续按<ENTER>翻页阅读直到结束。

输入Y（不分大小写）表示接受此许可协议条款。
输入N（不分大小写）表示不接受此许可协议条款，输入其他无效。
若不接受，则会提示告诫信息，无法继承安装，提示用户重新选择。
5.4. 选择安装集

根据安装后数据库服务功能的不同，KingbaseES可分为完全安装、客户端安装和定制安装三种安装集。

• 完全安装：包括数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁徙工具、数据库部署工具。
  
• 客户端安装：包括接口、数据库开发管理工具、数据库迁徙工具、数据库部署工具。
  
• 定制安装：在数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁徙工具、数据库部署工具全部组件中自由选择。
  

输入1，或按<ENTER>接受缺省项，选择“完全安装”安装集，体系将安装KingbaseES全部组件，跳至 选择授权文件 。
输入2，选择“客户端安装”安装集，体系将安装KingbaseES的全部客户端工具、编程接口、扩展插件以及命令行可执行二进制文件，跳至 选择安装文件夹 。
输入3，选择“定制安装”安装集，可根据需求选择安装所需功能组件，将进入下一步 选择产品功能组件 。

5.5. 选择产品功能组件

如选择定制安装的安装集，需要继承选择产品功能组件。

输入 不需要安装 的功能组件的序号，并以逗号分隔。
输入“？<号码>”，可查看该功能部件的说明。
注意:这里选择的是 不需要安装 的组件。
如果全部安装，则不需要输入，点击<ENTER>继承下一步。
5.6. 选择授权文件

此步调用于选择授权文件，若指定的授权文件正当，则将表现授权文件的详细信息。
可以通过中电科金仓官网（电科金仓-成为世界良好的数据库产品与服务提供商）下载试用版授权文件

输入授权文件的绝对路径后，按<ENTER>以检查授权文件，若授权文件有用，则进入下一步调。
注意:在有用期内实时更换正式授权文件，若不选择授权文件，则使用软件自带试用版授权。
5.7. 选择安装文件夹

此步调用于选择安装路径。默认安装路径是/opt/Kingbase/ES/V9。

可自行输入一个绝对路径作为安装目次。缺省直接按<ENTER>键，即为默认路径。
再次确认完整路径，输入Y（不分大小写），按<ENTER>键继承。
5.8. 预安装摘要

此步调会看到即将安装产品的摘要信息。包括：

• 产品名称。
  
• 安装文件夹。
  
• 指定安装的功能组件。
  
• 安装路径所在磁盘空间信息。
  

5.9. 安装确认

此步调进行安装确认。按<ENTER>键体系开始执行安装过程。

5.10. 正在安装

安装过程中会不断革新安装进度。
如选择“完全安装”安装集，安装进度100%之后，将至 初始化数据库 。
如选择“客户端安装”安装集，安装进度100%之后，将至 安装完成 。
如选择“定制安装”安装集，并且选择安装数据库服务器组件，安装进度100%之后，将至 初始化数据库 。

5.11. 初始化数据库

起首选择数据库数据目次，默认数据库数据目次为安装目次下的data目次。

设置如下初始化数据库参数：

• 默认端口为:54321（可自定义）
  
• 默认账户为:system（可自定义）
  
• 暗码（自定义）
  
• 默认字符集编码为：UTF8（可选 default、GBK、GB2312、GB18030）
  
• 区域，可选值将随字符集编码选项发生变更。
  
  
  
  • 当字符集编码为 default 时，默认区域值为：default（可选 C）
    
  • 当字符集编码为 UTF8 时，默认区域值为：zh_CN.UTF-8（可选 en_US.UTF-8、C）
    
  • 当字符集编码为 GBK 时，默认区域值为：zh_CN.GBK（可选 C）
    
  • 当字符集编码为 GB2312 时，默认区域值为：zh_CN.GB2312（可选 C）
    
  • 当字符集编码为 GB18030 时，默认区域值为：zh_CN.GB18030（可选 C）
    
  
  
• 默认数据库兼容模式为：ORACLE（可选 PG、MySQL）
  
• 默认大小写敏感为：是（可选否）
  
• 默认数据块大小为：8k（可选16k、32k）
  
• 默认身份认证方法为scram-sha-256（可选 scram-sm3，sm4，sm3）
  
• 自定义参数（自定义），可自由输入任何值，作为初始化数据库的参数
  有关数据库初始化参数，详情可见《KingbaseES服务器应用参考手册》第2章
  自定义特殊参数：（如果输入值包罗以下某一项，请注意特殊情况）
         -c：初始化生成的配置文件会被加密，此时设置的端口值不会在初始化阶段进行修改，启动KingbaseES服务时将使用默认端口值54321。
      注意:
      输入的参数值不能包罗-W，--pwprompt，%和$。
  

5.12. 安装完成

若安装过程中没有出现任何告诫或错误，将表现如下界面。

按<ENTER>键退出安装程序。最后建议重启以完成全部的安装。
5.13. 执行root.sh

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

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

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

1. #启动服务
2. sys_ctl -w start -D ${Data文件目录} -l "${Data文件目录}/sys_log/startup.log"
3. #停止服务
4. sys_ctl stop -m fast -w -D ${Data文件目录}

复制代码

6. 安装后检查 

在安装完成后，可以通过以下几种方式进行安装精确性验证：
查看安装日志
在${安装目次}/Logs目次下，存在名称为 "install.log" 的日志文件，其中记录了安装过程的全部信息。
可以打开日志文件，查看如下所示安装结果信息判断是否安装精确。

查看开始菜单
   查看应用程序菜单中是否安装了KingbaseES菜单项，并且精确关联到对应的程序。开始菜单布局如下：
     KingbaseES
   

• 帮助
  
• 数据库开发管理工具
  
• 数据迁徙工具
  
• 数据库部署工具
  
• 迁徙评估工具
  
• web版数据库开发管理工具
  
• 异构数据比对工具
  
• 异构数据同步服务
  
• 卸载
  

    查看安装目次
数据库安装完成后，进入安装目次，使用 ll 或者 ls
-l 列出数据库安装后生成的目次和文件，下面列出重要文件和目次清单。由于安装的组件不同，对应生成的文件目次也有所不同，请以现实的安装为准。
KESRealPro目次下按版本号放置不同版本的程序内容。安装根目次下的其他目次和文件都是软连接，现实指向KESRealPro下详细版本的对应目次或文件。

• Server：软连接，对应目次存放了服务器二进制文件，链接文件等。
  
  
  
  • Server/bin：服务器二进制文件，可以在该路径下进行启动服务、连接数据库、物理备份还原、逻辑备份还原等利用。
    
  
  
• ClientTools
  ：软连接，对应目次存放了客户端工具依赖的可执行二进制文件、链接文件等。
  
  
  
  • ClientTools
    /guitools
    /KStudio：开发管理工具，能运行在各种平台的图形工具，用于管理和配置KingbaseES数据库服务器，管理各种KingbaseES数据库对象，进行KingbaseES数据库的安全管理，调用查询分析器执行和测试SQL语句。
    
  • ClientTools
    /guitools
    /KDts：数据库迁徙工具，可以用于跨平台数据互换和迁徙，支持同异构数据源之间的数据迁徙。该目次下存放了迁徙工具的相干程序和配置文件。
    
  • ClientTools
    /guitools
    /DeployTools
    ：集群部署工具，用于远程部署集群节点服务。该目次存放了集群部署工具相干的程序和配置文件。
    
  
  

注意:ClientTools
/guitools
/ManagerTools
：对象管理工具，功能与开发管理工具划一。在申威平台上使用。

• Interface：软连接，对应目次存放了各类应用程序开发接口程序包。
  
• KingbaseHA：软连接，对应目次存放了高可用集群组件相干程序和配置文件。
  
• SupTools
  ：软连接，对应目次下存放了巡检工具相干脚本和配置文件。
  
• install：软连接，对应目次存放了安装过程中依赖和使用的各类文件。
  
  
  
  • install/script：该目次下存放了安装和卸载过程中使用的脚本。
    
  • install/LICENSE.EN：英文许可协议。
    
  • install/LICENSE.ZH：中文许可协议。
    
  
  
• doc：软连接，对应目次包罗各类帮助手册。
  
• Uninstaller：软连接，对应目次包罗卸载程序的相干文件。
  
• license.dat：软连接，执行安装时使用的认证许可证书。
  
• KESRealPro：现实安装目次，下一级为版本号命名的目次，再下一级为Server、doc、ClientTools
  、Interface、install、SupTools
  、Uninstall、license.dat、KingbaseHA，对应上述各软连接的现实目次。
  
• data：初始化数据库生成的数据目次。
  

验证工具是否能连接数据库
   可以使用交互式终端工具（ksql）连接数据库。进入${安装目次}/Server/bin目次，执行如下命令：

1. ./ksql -p 54321 -U system test

复制代码

-p参数指定初始化数据库时设置的端口。-U参数指定初始化数据库时设置的管理员用户，也可以是其他用户。
  查看已安装数据库的版本信息
   进入${安装目次}/Server/bin目次，执行

1. ./kingbase –V;

复制代码

或在交互式终端（ksql）中执行

1. select version();

复制代码

解决缺库问题
   如果安装机器利用体系缺少须要的so库文件，您可通过如下命令查看到有缺少so库文件的情况。在${安装目次}/Server/bin目次下执行：

1. ldd * | grep "not found"

复制代码

在${安装目次}/Server/lib下,执行如下命令检查是否存在缺少的so库文件：

1. ls

复制代码

若检查到${安装目次}/Server/lib下存在缺少的so库文件，则在${安装目次}/Server/lib下,执行

1. export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。