人大金仓数据库基于Linux系统的数据库软件安装指南

人大金仓数据库基于Linux系统的数据库软件安装指南

• 1. 前言
  • 1.1. 适用读者
  • 1.2. 相关文档
  • 1.3. 术语
  • 1.4. 手册约定
• 2. 安装概述
  • 2.1. 产品简介
  • 2.2. 安装模式说明
  • 2.3. License说明
• 3. 安装前准备工作
  • 3.1. 硬件环境要求
  • 3.2. 软件环境要求
  • 3.3. 安装包准备
  • 3.4. 检查和配置环境
    • 3.4.1. 检查操作系统信息
    • 3.4.2. 检查系统内存与存储空间
    • 3.4.3. 配置内核参数
  • 3.5. 预安装工作
    • 3.5.1. 创建安装用户
    • 3.5.2. 安装目录
    • 3.5.3. 数据目录
    • 3.5.4. 安装包的挂载与取消
• 4. 安装KingbaseES
  • 4.1. 图形化安装
    • 4.1.1. 启动安装程序
    • 4.1.2. 许可协议
    • 4.1.3. 选择安装集
    • 4.1.4. 选择产品功能组件
    • 4.1.5. 选择授权文件
    • 4.1.6. 选择安装文件夹
    • 4.1.7. 预安装摘要
    • 4.1.8. 正在安装
    • 4.1.9. 初始化数据库
    • 4.1.10. 安装完成
    • 4.1.11. 执行root.sh
  • 4.2. 命令行安装
    • 4.2.1. 启动安装程序
    • 4.2.2. 简介
    • 4.2.3. 许可协议
    • 4.2.4. 选择安装集
    • 4.2.5. 选择产品功能组件
    • 4.2.6. 选择授权文件
    • 4.2.7. 选择安装文件夹
    • 4.2.8. 预安装摘要
    • 4.2.9. 安装确认
    • 4.2.10. 正在安装
    • 4.2.11. 初始化数据库
    • 4.2.12. 安装完成
    • 4.2.13. 执行root.sh
  • 4.3. 静默安装
    • 4.3.1. 静默安装注意事项
    • 4.3.2. 启动安装
    • 4.3.3. 查看安装结果
• 5. 安装后检查
• 6. 卸载KingbaseES
  • 6.1. 删除数据库服务
  • 6.2. 图形化卸载
    • 6.2.1. 启动卸载
    • 6.2.2. 确认卸载
    • 6.2.3. 正在卸载
    • 6.2.4. 完成卸载
  • 6.3. 控制台卸载
    • 6.3.1. 启动卸载
    • 6.3.2. 准备卸载
    • 6.3.3. 正在卸载
    • 6.3.4. 完成卸载
  • 6.4. 静默卸载
• 7. 增删组件
  • 7.1. 图形化增删组件
    • 7.1.1. 增加组件
      • 7.1.1.1. 启动入口
      • 7.1.1.2. 添加功能
      • 7.1.1.3. 确认
      • 7.1.1.4. 选择功能组件
      • 7.1.1.5. 安装进度
      • 7.1.1.6. 完成安装
    • 7.1.2. 删除组件
      • 7.1.2.1. 启动入口
      • 7.1.2.2. 准备卸载
      • 7.1.2.3. 确认
      • 7.1.2.4. 选择功能组件
      • 7.1.2.5. 正在移除
      • 7.1.2.6. 卸载完成
  • 7.2. 命令行增删组件
    • 7.2.1. 增加组件
      • 7.2.1.1. 启动入口
      • 7.2.1.2. 选择功能组件
      • 7.2.1.3. 安装进度
      • 7.2.1.4. 完成安装
    • 7.2.2. 删除组件
      • 7.2.2.1. 启动入口
      • 7.2.2.2. 选择功能组件
      • 7.2.2.3. 删除及完成
• 8. 附录
  • 8.1. 目录一览表
  • 8.2. 安装卸载常见问题
    • 8.2.1. 开始菜单没有数据库快捷工具图标
    • 8.2.2. 缺少操作系统GUI组件
    • 8.2.3. 无法打开客户端工具图形化界面
    • 8.2.4. 不能正确显示中英文
    • 8.2.5. 不支持用户图形化模式安装程序，安装失败
    • 8.2.6. 部分环境不支持图形化安装
    • 8.2.7. 安装大目录时出现卡顿、迟缓情况
    • 8.2.8. Linux平台在默认安装路径下安装会提示没有权限
    • 8.2.9. 从安装根目录进入Server/bin目录后，通过相对路径../../data/kingbase.conf无法找到文件
    • 8.2.10. 执行安装时系统提示不能创建Java Virtual Machine
    • 8.2.11. 【申威UOS】安装包进行安装，提示初始化数据库错误

1. 前言 ¶

本文档描述了如何在Linux操作系统上安装和卸载KingbaseES以及常见问题。

前言部分包含以下主题：

• 适用读者

• 相关文档

• 术语

• 手册约定

1.1. 适用读者 ¶

本文档面向所有使用KingbaseES的用户，主要是数据库管理员和应用程序开发人员。

在开始阅读本文档之前，您需要了解以下内容：

• Linux常用操作命令

1.2. 相关文档 ¶

• 有关ksql的更多信息，请参阅《 KingbaseES ksql工具用户指南及参考 》

• 有关initdb的更多信息，请参阅《 KingbaseES服务器应用参考手册 》

• 有关开发管理工具的更多信息，请参阅《 KStudio使用手册 》

• 有关对象管理工具的更多信息，请参阅《对象管理工具使用手册》

1.3. 术语 ¶

1.4. 手册约定 ¶

本文档中可能出现 “注意、提示、警告、另请参阅” 等标志，它们所代表的含义如下：

注意

用于突出重要/关键信息、最佳实践等。

提示

用于突出小窍门、捷径等。

警告

用于传递设备或环境安全警示信息，若不避免，可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。

另请参阅

用于突出参考、参阅等。

以下程序代码书写约定适用于本文档：

2. 安装概述 ¶

• 产品简介

• 安装模式说明

• License说明

2.1. 产品简介 ¶

金仓数据库管理系统[简称:KingbaseES]是北京人大金仓信息技术股份有限公司（简称人大金仓）自主研发的、具有自主知识产权的商用关系型数据库管理系统（DBMS）。该产品面向事务处理类应用，兼顾各类数据分析类应用，可用做信息管理系统、业务及生产系统、决策支持系统、全文检索、地理信息系统等的承载数据库。

KingbaseES支持多种操作系统和硬件平台:支持Linux、Windows、国产Kylin等数十个操作系统产品版本，支持通用x86_64及国产龙芯、飞腾、申威等CPU硬件体系架构。

针对不同类型的客户需求，KingbaseES提供标准版、企业版、专业版、开发版等多种版本。这些版本构建于同一数据库引擎上，不同平台版本完全兼容。

KingbaseES软件能够提供一主一备以及一主多备的高可用集群架构，实现数据及实例级 (异地) 故障容灾，也能够提供多节点并行服务，内存融合及存储共享，实现高并发性能利用最大化，结合读写分离或备份使用同步实现数据保护最大化。

2.2. 安装模式说明 ¶

您可以选择图形化安装,启用图形化界面进行向导式安装。

2.3. License说明 ¶

数据库license是KingbaseES提供的授权文件，其中会对数据库有效日期、发布类型、最大并发连接数、mac地址、ip等信息进行设置。

如果在license文件中信息与安装环境中相关信息不匹配，数据库将无法启动。

注意

如果未选择license文件，则会使用软件自带试用版授权，请在有效期内及时更换正式授权文件。

更多license信息，详见《 KingbaseES License信息手册 》。

3. 安装前准备工作 ¶

• 硬件环境要求

• 软件环境要求

• 安装包准备

• 检查和配置环境

• 预安装工作

3.1. 硬件环境要求 ¶

KingbaseES支持通用X86_64、龙芯、飞腾、鲲鹏等国产CPU硬件体系架构。

3.2. 软件环境要求 ¶

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

3.3. 安装包准备 ¶

您可以通过人大金仓官网下载对应平台的安装程序，也可以通过人大金仓的销售人员、售后支持人员或代理商获取安装程序。

您在获得安装程序（iso文件）的同时，应该会获得一个MD5值或SHA1值。建议先通过以下命令查看安装程序文件对应的MD5值或SHA1值，再和拿到的MD5值或SHA1值进行比对。如果一致，说明安装文件正常；如果不一致，说明安装文件可能不完整，安装过程可能无法正常完成。

假设拿到的安装包文件是KingbaseES_V008R006C009B0014_Lin64_install.iso，查看其MD5值：

md5sum KingbaseES_V008R006C009B0014_Lin64_install.iso

查看其SHA1值：

sha1sum KingbaseES_V008R006C009B0014_Lin64_install.iso

3.4. 检查和配置环境 ¶

3.4.1. 检查操作系统信息 ¶

您可以通过以下命令查看操作系统信息：

cat /etc/*release

注意

为避免安装失败，或安装结束后文件发生异常，请在安装前关闭操作系统的应用保护，或于安装时在操作系统界面手动点击允许程序执行。

3.4.2. 检查系统内存与存储空间 ¶

您可以通过以下命令查看内存信息（以MB单位显示）：

free -m

您可以通过以下命令查看磁盘存储信息（以GB单位显示）：

df -hl

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

3.4.3. 配置内核参数 ¶

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

• 内核参数

您可以参考内核参数查看命令(最新的系统，需参考系统的用户手册)检查内核参数。

若内核参数与参考值不一致，您可通过编辑/etc/sysctl.conf文件修改参数，如下所示：

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

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

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

• 资源使用参数

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

图 73 limits.conf配置文件 ¶

其中soft是一个警告值，hard是真正意义的阈值，超过系统就会报错，一般情况下两者设为同一个值。一般保持系统安装时的默认值即可。可配置的资源有如下种类：

nofile、noproc、core参数可修改为如下值：

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

• RemoveIPC参数

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

systemctl daemon-reload
systemctl restart systemd-logind.service

3.5. 预安装工作 ¶

3.5.1. 创建安装用户 ¶

在安装KingbaseES时，安装用户对于安装路径需有“读”、“写”、“执行”的权限。在Linux系统中，需要以非root用户执行安装程序，且该用户要有标准的home目录。

因此，建议在正式安装前，新建kingbase用户作为KingbaseES专用的系统用户，您可以先使用root用户运行如下命令创建kingbase用户：

useradd -m kingbase

注意

创建安装系统用户kingbase之后，如无特殊说明，本指南后续的操作默认使用kingbase用户进行操作。

该命令会同时创建同名用户组kingbase以及用户根目录/home/kingbase。继续运行如下命令设置kingbase用户的密码：

passwd kingbase

注意

密码需要输入两次，保证两次输入的密码相同。

3.5.2. 安装目录 ¶

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

mkdir /opt/Kingbase/ES/V8
chmod o+rwx /opt/Kingbase/ES/V8

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

su - kingbase
mkdir /home/kingbase/kdb

3.5.3. 数据目录 ¶

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

mkdir /opt/Kingbase/ES/V8/data

注意

数据目录不必事先创建。安装过程中会提示指定数据目录，如果目录不存在安装程序会自动创建。

3.5.4. 安装包的挂载与取消 ¶

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

#cd KingbaseES_V008R006C009B0014_Lin64_install.iso所在目录
su
mount KingbaseES_V008R006C009B0014_Lin64_install.iso ./KingbaseESV8

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

su
umount ./KingbaseESV8

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

4. 安装KingbaseES ¶

本节将详细讲解如何基于 图形化安装 、 命令行安装 和 静默安装 方式在Linux系统中安装KingbaseES。

不论何种方式安装，整体的安装流程如下图所示。

图 74 安装流程 ¶

• 图形化安装

• 命令行安装

• 静默安装

4.1. 图形化安装 ¶

4.1.1. 启动安装程序 ¶

图形化安装支持中文和英文的安装界面。根据操作系统的语言设置会显示对应语言的安装界面。您可以执行如下命令查看操作系统的语言设置：

echo $LANG

如果系统显示值包含“zh_CN”，则为中文语言，安装程序会使用中文界面。否则，您可以执行如下命令修改语言设置为中文：

export LANG=zh_CN.UTF-8

接下来您就可以开始进行KingbaseES的安装了。首先切换为安装用户kingbase，进入安装程序setup.sh所在目录，执行如下命令：

sh setup.sh

或

sh setup.sh -i swing

如果当前操作系统中已存在KingbaseES，执行启动命令后将弹出KingbaseES安装程序窗口【实例管理页】。

选择【安装新的实例】，点击【确认】，开始安装KingbaseES。点击【取消】按钮则退出本次安装。

如果您想在已安装实例上增加或删除功能，则可以选择【修改存在的实例】，具体参见 图形化增删组件 。

图 75 实例管理页 ¶

图 76 安装简介 ¶

点击【下一步】按钮，继续本次安装。

4.1.2. 许可协议 ¶

图 77 许可协议 ¶

默认“我接受许可协议条款”的选择框未选中，【下一步】按钮置灰。

当且仅当选择“我接受许可协议条款”后，【下一步】按钮有效。

若点击【取消】按钮，将弹出取消安装提示窗口，点击【退出】按钮，退出安装程序。

若点击【继续】，则回到安装界面，继续安装。

图 78 取消 ¶

4.1.3. 选择安装集 ¶

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

• 完全安装：包括数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。

• 客户端安装：包括接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。

• 定制安装：在数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具所有组件中自由选择。

您如果选择“完全安装”安装集，系统将安装KingbaseES所有组件，点击【下一步】，至 选择授权文件 。

您如果选择“客户端安装”安装集，系统将安装KingbaseES的所有客户端工具和编程接口，点击【下一步】，至 选择安装文件夹 。

您如果选择“定制安装”安装集，则根据需求选择安装所需功能部件，点击【下一步】，至 选择产品功能组件 。

图 79 选择安装集 ¶

4.1.4. 选择产品功能组件 ¶

如选择“定制安装”的安装集，您通过点击功能组件项选择或去除对应的组件。如果要安装集群节点上的数据库服务，必须要安装“数据库部署工具”。点击【下一步】，继续安装。

图 80 选择产品功能组件 ¶

4.1.5. 选择授权文件 ¶

您在本步骤需要选择授权文件，点击【选择】按钮以选择本机上的授权文件。

若指定的授权文件合法，则将显示授权文件的详细信息。

图 81 选择授权文件 ¶

进入该步骤【下一步】按钮默认置灰，若授权文件通过验证，则【下一步】按钮有效。

注意

请在有效期内及时更换正式授权文件，若不选择授权文件，则使用软件自带试用版授权。

4.1.6. 选择安装文件夹 ¶

此步骤用于选择安装路径。默认安装路径为: /opt/Kingbase/ES/V8。

图 82 选择安装文件夹 ¶

您点击【选择】按钮，弹出文件选择对话框，可选择其他安装路径。

点击【恢复缺省文件夹】按钮，将安装路径恢复为默认安装路径。

点击【下一步】按钮，继续安装。

4.1.7. 预安装摘要 ¶

您在此步骤会看到即将安装产品的摘要信息，包括：

• 产品名称。

• 安装文件夹。

• 指定安装的功能组件。

• 安装路径所在磁盘空间信息。

图 83 预安装摘要 ¶

4.1.8. 正在安装 ¶

您点击【安装】按钮后，系统开始安装KingbaseES，安装过程不断刷新安装进度。

图 84 正在安装 ¶

如选择“完全安装”安装集，安装进度100%之后，将至 初始化数据库 。

如选择“客户端安装”安装集，安装进度100%之后，将至 安装完成 。

如选择“定制安装”安装集，并选择安装了数据库服务器组件，安装进度100%之后，将至 初始化数据库 。

4.1.9. 初始化数据库 ¶

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

图 85 选择数据目录 ¶

您点击【选择】按钮，弹出文件选择对话框，选择自定义数据目录。

您点击【恢复缺省文件夹】按钮，将数据目录恢复为默认的数据目录。

点击【下一步】按钮，继续设置如下初始化数据库参数：

• 默认端口为: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，%和$。

图 86 设置初始化数据库参考 ¶

您输入服务器监听端口、用户名、密码、编码、模式、大小写敏感、数据块大小等数据库初始化参数后，点击【下一步】，系统进行初始化数据库过程。

4.1.10. 安装完成 ¶

若安装过程中没有出现任何警告或错误，将显示如下界面。单击【完成】以退出安装程序。若安装过程中出现任何警告或错误，则窗口中显示日志文件位置，您可以打开日志文件查看具体错误信息。

图 87 安装完成 ¶

最后建议重启以完成全部的安装。

4.1.11. 执行root.sh ¶

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

1. 打开新终端；

2. 切换到root用户；

3. 运行${安装目录}/install/script/root.sh 。

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

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

4.2. 命令行安装 ¶

4.2.1. 启动安装程序 ¶

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

echo $LANG

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

export LANG=zh_CN.UTF-8

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

sh setup.sh -i console

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

图 88 启动安装程序 ¶

您输入1，再按<ENTER>，选择“安装新的实例”；

您输入2，再按<ENTER>，选择“修改存在的实例”。

初次安装，输入1，按<ENTER>，进入“简介”界面。修改存在的实例请参考 命令行增删组件 。

4.2.2. 简介 ¶

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

图 89 简介 ¶

输入quit，按<ENTER>退出安装；

输入back，按<ENTER>返回前一屏幕；

直接按<ENTER>进行下一步操作。

若无特殊说明，以下各步骤皆与此相同。

4.2.3. 许可协议 ¶

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

图 90 许可协议 ¶

您输入Y（不分大小写）表示接受此许可协议条款。

您输入N（不分大小写）表示不接受此许可协议条款，输入其他无效。

若不接受，则会提示警告信息，无法继续安装，提示用户重新选择。

4.2.4. 选择安装集 ¶

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

• 完全安装：包括数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。

• 客户端安装：包括接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。

• 定制安装：在数据库服务器、高可用组件、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具所有组件中自由选择。

您输入1，或按<ENTER>接受缺省项，选择“完全安装”安装集，系统将安装KingbaseES所有组件，跳至 选择授权文件 。

您输入2，选择“客户端安装”安装集，系统将安装KingbaseES的所有客户端工具、编程接口、扩展插件以及命令行可执行二进制文件，跳至 选择安装文件夹 。

您输入3，选择“定制安装”安装集，可根据需求选择安装所需功能组件，将进入下一步 选择产品功能组件 。

图 91 选择安装集 ¶

4.2.5. 选择产品功能组件 ¶

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

图 92 选择产品功能部件 ¶

输入 不需要安装 的功能组件的序号，并以逗号分隔。

输入“？<号码>”，可查看该功能部件的说明。

注意

这里选择的是 不需要安装 的组件。如果全部安装，则不需要输入，点击<ENTER>继续下一步。

4.2.6. 选择授权文件 ¶

此步骤用于选择授权文件，若指定的授权文件合法，则将显示授权文件的详细信息。

图 93 选择授权文件 ¶

您输入授权文件的绝对路径后，按<ENTER>以检查授权文件，若授权文件有效，则进入下一步骤。

注意

请在有效期内及时更换正式授权文件，若不选择授权文件，则使用软件自带试用版授权。

4.2.7. 选择安装文件夹 ¶

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

图 94 选择安装文件夹 ¶

您可自行输入一个绝对路径作为安装目录。缺省直接按<ENTER>键，即为默认路径。

再次确认完整路径，输入Y（不分大小写），按<ENTER>键继续。

4.2.8. 预安装摘要 ¶

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

• 产品名称。

• 安装文件夹。

• 指定安装的功能组件。

• 安装路径所在磁盘空间信息。

图 95 预安装摘要 ¶

4.2.9. 安装确认 ¶

您在此步骤进行安装确认。按<ENTER>键系统开始执行安装过程。

图 96 安装确认 ¶

4.2.10. 正在安装 ¶

安装过程中会不断刷新安装进度。

如选择“完全安装”安装集，安装进度100%之后，将至 初始化数据库 。

如选择“客户端安装”安装集，安装进度100%之后，将至 安装完成 。

如选择“定制安装”安装集，并且选择安装数据库服务器组件，安装进度100%之后，将至 初始化数据库 。

图 97 正在安装 ¶

4.2.11. 初始化数据库 ¶

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

图 98 选择数据库目录 ¶

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

• 默认端口为: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，%和$。

图 99 端口 ¶

图 100 账户 ¶

图 101 密码 ¶

图 102 区域 ¶

图 103 字符集 ¶

图 104 兼容模式 ¶

图 105 身份认证方法 ¶

图 106 大小写敏感 ¶

图 107 存储块 ¶

图 108 初始化 ¶

图 109 自定义参数 ¶

4.2.12. 安装完成 ¶

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

图 110 安装完成 ¶

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

4.2.13. 执行root.sh ¶

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

1. 打开新终端；

2. 切换到root用户；

3. 运行${安装目录}/install/script/root.sh 。

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

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

4.3. 静默安装 ¶

4.3.1. 静默安装注意事项 ¶

静默安装模式下，安装程序通过读取配置文件来安装数据库。安装包iso文件挂载后，setup目录下已存在silent.cfg模板文件，您需要根据实际安装机器的情况修改参数值。因为Linux挂载iso目录为只读，需要拷贝setup/silent.cfg文件到另外的目录进行修改。

配置文件的参数可参考下表修改。

4.3.2. 启动安装 ¶

您修改完配置文件后，进入安装程序所在目录，以kingbase用户执行如下命令：

./setup.sh -i silent -f ${配置文件路径}

-f参数指定修改后配置文件的相对或绝对路径。相对路径是指相对setup/install.bin的相对路径。

4.3.3. 查看安装结果 ¶

安装程序退出之后，如果没有正确安装，您可在${安装目录}/install/Logs下打开文件名如KingbaseES_V8_安装_*.log的日志文件排查错误原因。如果有如下信息，则silent.cfg文件中参数取值有错误，未完成安装过程。需要修改后重新执行。

图 111 安装日志排查错误 ¶

注意

本章中出现的数据库开发管理工具，在申威版本中替换为数据库对象管理工具。

5. 安装后检查 ¶

在安装完成后，您可以通过以下几种方式进行安装正确性验证：

1. 查看安装日志

在${安装目录}/Logs目录下，存在名称为 "install.log" 的日志文件，其中记录了安装过程的所有信息。您可以打开日志文件，查看如下所示安装结果信息判断是否安装正确。

图 112 安装日志 ¶

1. 查看开始菜单

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

KingbaseES

• 帮助

• 数据库开发管理工具

• 数据迁移工具

• 数据库部署工具

• 迁移评估工具

• web版数据库开发管理工具

• 异构数据比对工具

• 异构数据同步服务

• 卸载

1. 查看安装目录（参考 目录一览表 ）

2. 验证工具是否能连接数据库。

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

./ksql -p 54321 -U system test

-p参数指定初始化数据库时设置的端口。-U参数指定初始化数据库时设置的管理员用户，也可以是其他用户。更详细的ksql工具使用可参考《 KingbaseES ksql工具用户指南及参考 》。

如果ksql能够正常连接数据库服务，则说明数据库安装正常。

您也可以使用数据库开发管理工具连接数据库，具体使用可参考《 KStudio使用手册 》。

1. 查看已安装数据库的版本信息

进入${安装目录}/Server/bin目录，执行

./kingbase –V;

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

select version();

1. 解决缺库问题

如果安装机器操作系统缺少必要的so库文件，您可通过如下命令查看到有缺少so库文件的情况。在${安装目录}/Server/bin目录下执行：

ldd * | grep "not found"

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

ls

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

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`

若在${安装目录}/Server/lib下,未找到缺少的so库文件，请联系客服人员。

此外，完成安装KingbaseES软件后，可继续参考《数据库部署工具使用说明》，学习如何通过数据库部署工具安装部署集群、启停集群服务、修改配置、查看日志。

注意

本章中出现的数据库开发管理工具在申威平台版本替换为数据库对象管理工具，具体使用可参考《对象管理工具使用说明》。

6. 卸载KingbaseES ¶

• 图形化卸载

• 控制台卸载

• 静默卸载

6.1. 删除数据库服务 ¶

如果在安装后执行root.sh脚本在系统中注册了数据库服务，需要在卸载前执行rootuninstall.sh脚本删除已注册的数据库服务。具体步骤如下：

1. 打开新终端；

2. 切换到root用户；

3. 运行${安装目录}/install/script/rootuninstall.sh 。

6.2. 图形化卸载 ¶

6.2.1. 启动卸载 ¶

您以kingbase用户登录系统后，进入${安装目录}/Uninstall目录，执行如下命令，启动卸载程序。

sh Uninstaller -i swing

图 113 启动卸载 ¶

选择“卸载产品”，点击【下一步】按钮，准备卸载；点击【取消】按钮，取消卸载。

6.2.2. 确认卸载 ¶

图 114 确认卸载 ¶

点击【下一步】按钮，开始卸载；点击【取消】按钮，取消卸载。

6.2.3. 正在卸载 ¶

此步骤用于显示卸载进度。

图 115 正在卸载 ¶

6.2.4. 完成卸载 ¶

对于初始化生成的文件或程序运行中生成的文件，卸载过程当中无法自动删除，请退出卸载程序后手动删除。

图 116 完成卸载 ¶

6.3. 控制台卸载 ¶

6.3.1. 启动卸载 ¶

您以kingbase用户登录系统后，进入${安装目录}/Uninstall目录，执行如下命令，启动卸载程序。

sh Uninstaller -i console

6.3.2. 准备卸载 ¶

图 117 准备卸载 ¶

输入quit再按<ENTER>退出卸载过程；直接按<ENTER>继续进行下一步。若无特殊说明，以下各步骤皆与此相同。

6.3.3. 正在卸载 ¶

此步骤用于显示卸载进度。

图 118 正在卸载 ¶

6.3.4. 完成卸载 ¶

对于初始化生成的文件或程序运行中生成的文件，卸载过程当中无法自动删除，请退出卸载程序后手动删除。

图 119 完成卸载 ¶

6.4. 静默卸载 ¶

您以kingbase用户登录系统后，进入${安装目录}/Uninstall目录，执行以下命令：

sh Uninstaller -i silent

如果是通过静默安装方式安装的，可以不加-i参数，否则必须附加-i参数。

卸载过程没有提示信息，等待卸载过程完成即可。

7. 增删组件 ¶

本节将介绍如何基于 图形化安装 和 命令行安装 方式在Linux系统中增加或移除KingbaseES某些功能组件。整体操作流程如下图所示。

图 120 增删组件流程 ¶

• 图形化增删组件

• 命令行增删组件

7.1. 图形化增删组件 ¶

7.1.1. 增加组件 ¶

对于选择客户端安装集或定制安装集的数据库，您后续可根据需要增加其他未安装的功能组件。

7.1.1.1. 启动入口 ¶

以kingbase用户登录系统后，进入安装程序setup.sh所在目录，执行setup.sh。选择“修改存在的实例”并选中安装目录，点击“确定”按钮。

图 121 修改实例 ¶

7.1.1.2. 添加功能 ¶

图 122 添加功能 ¶

您选择【添加功能】选项，点击【下一步】。

点击【取消】按钮，可以退出添加过程，若无特殊说明，以下各步骤皆与此相同。

7.1.1.3. 确认 ¶

图 123 确认 ¶

点击【下一步】按钮，继续安装；点击【取消】按钮，取消安装。

7.1.1.4. 选择功能组件 ¶

图 124 选择功能组件 ¶

您可以选中需要添加的功能组件，置灰无法选择的组件是已经安装的组件。点击【安装】按钮，继续安装。

7.1.1.5. 安装进度 ¶

图 125 安装进度 ¶

此步骤用于显示安装进度。如果选择的组件包含数据库服务器，则后续会继续选择授权文件、初始化数据库步骤。

7.1.1.6. 完成安装 ¶

若安装过程中没有出现任何警告或错误，安装进度到100%后将自动退出安装程序。

7.1.2. 删除组件 ¶

当需要删除数据库某项组件而非数据库系统时，您可以通过数据库删除功能来进行维护。

7.1.2.1. 启动入口 ¶

以kingbase用户登录系统后，进入安装程序setup目录，执行如下命令，启动卸载程序。

sh setup.sh -i swing

7.1.2.2. 准备卸载 ¶

图 126 准备卸载 ¶

您选择【删除功能】选项，点击【下一步】。

点击【取消】按钮，可以退出卸载过程，若无特殊说明，以下各步骤皆与此相同。

7.1.2.3. 确认 ¶

图 127 确认 ¶

点击【下一步】按钮，继续卸载；点击【取消】按钮，取消卸载。

7.1.2.4. 选择功能组件 ¶

图 128 选择功能组件 ¶

选择需要卸载的功能组件，取消其勾选状态；点击【卸载】按钮，开始删除操作。点击【取消】按钮，取消卸载。

7.1.2.5. 正在移除 ¶

图 129 正在移除 ¶

此步骤用于显示卸载进度。

7.1.2.6. 卸载完成 ¶

图 130 卸载完成 ¶

您需要点击【完成】按钮确认完成删除过程。

7.2. 命令行增删组件 ¶

7.2.1. 增加组件 ¶

对于选择客户端安装集或定制安装集的数据库，您后续可根据需要增加其他未安装的功能组件。

7.2.1.1. 启动入口 ¶

首先您要进入安装程序中setup.sh所在目录，以kingbase用户执行如下命令：

sh setup.sh -i console

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

图 131 启动安装程序 ¶

输入2，选择“修改存在的实例”，按<ENTER>继续；

选择要修改的实例，按回车键；

输入1，选择“添加功能”，按<ENTER>继续添加功能的操作。

7.2.1.2. 选择功能组件 ¶

图 132 选择功能组件 ¶

按照提示按<ENTER>，显示可以添加的组件列表。输入 不需要安装 的组件编号，多个编号用逗号隔开。按<ENTER>开始安装。

注意

这里选择的是 不需要安装 的组件。如果全部安装，则不需要输入，按回车键继续下一步。

7.2.1.3. 安装进度 ¶

图 133 安装进度 ¶

此步骤用于显示安装进度。如果选择的组件包含数据库服务器，则后续会继续选择授权文件、初始化数据库步骤。

7.2.1.4. 完成安装 ¶

图 134 安装进度 ¶

若安装过程中没有出现任何警告或错误，安装完成后提示按<ENTER>退出安装程序。

7.2.2. 删除组件 ¶

当需要删除数据库某项组件而非数据库系统时，您可以通过数据库删除功能来进行维护。

7.2.2.1. 启动入口 ¶

以kingbase用户登录系统后，进入${安装目录}/Uninstall目录，执行如下命令，启动卸载程序。

./Uninstaller

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

图 135 启动安装程序 ¶

输入2，按回车键，选择“修改存在的实例”；

选择要修改的实例，按回车键；

输入2，选择“删除功能”，按<ENTER>继续删除功能的操作。

7.2.2.2. 选择功能组件 ¶

图 136 选择功能组件 ¶

显示已经安装的组件列表。输入需要删除的组件编号，多个编号用逗号隔开。按<ENTER>开始删除。

7.2.2.3. 删除及完成 ¶

图 137 正在移除 ¶

此步骤用于显示删除进度。删除完成后自动退出安装程序。

8. 附录 ¶

• 目录一览表

• 安装卸载常见问题

8.1. 目录一览表 ¶

数据库安装完成后，进入安装目录，使用 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：初始化数据库生成的数据目录。

8.2. 安装卸载常见问题 ¶

8.2.1. 开始菜单没有数据库快捷工具图标 ¶

问题描述：正确安装数据库后，切换到kingbase用户，开始菜单没有数据库快捷工具图标。/home/kingbase/.local/share/applications/目录下也没有快捷方式。

解决方式：

把安装路径下/home/kingbase/ES/V8/install/desktops下的文件拷贝到/home/kingbase/.local/share/applications/目录。

部分版本的操作系统，在安装完数据库软件后，需要注销，重新登录，才能看到开始菜单。

8.2.2. 缺少操作系统GUI组件 ¶

问题描述：数据库以console模式安装时报错，unable to load and prepare the installer in console

解决方式：可能的原因是操作系统图形组件的缺失，需要安装如下相关组件。

yum install gui
yum install gnome
yum install xorg

8.2.3. 无法打开客户端工具图形化界面 ¶

问题描述：正常安装KingbaseES数据库后，无法打开开发管理工具等客户端工具，报错“MobaXterm X11 proxy ：Unsupported authorisation protocol”

解决方式：

1、检查系统自带浏览器是否可以正常打开。查看能否正常打开浏览器图形化界面，若不能则说明可能为系统配置问题，进行步骤二检查配置。

2、检查系统配置，vim /etc/ssh/sshd_config修改参数： XLLForwarding yes

然后重启服务：

service sshd restart

重新ssh登录服务器后，再次检查系统浏览器与KingbaseES开发管理工具是否能正常打开图形化界面。若仍无法启动则进行步骤三检查。

3、确认是否存在su切换用户操作。su切换用户会出现无法打开图形化界面的问题。应直接ssh登录服务器后启动客户端工具。

8.2.4. 不能正确显示中英文 ¶

问题描述：Linux环境下，数据库安装后出现中英文显示效果，如下截图：

图 138 用户界面混合显示中英文 ¶

解决方式：

统一 MobaXterm 工具的字符集与Linux系统环境语言（ 建议修改为中文格式，目前全英文格式不具备较好的兼容性）。

LANG=zh_CN.UTF-8

临时修改办法对当前用户有效。

8.2.5. 不支持用户图形化模式安装程序，安装失败 ¶

问题描述：su切换指定非root用户，安装KingbaseES时提示不支持用户图形化模式安装程序，安装失败。

解决方式：直接用所需安装KingbaseES的用户ssh 登录到虚拟机后执行sh setup.sh 。

注意

不要用root登录后su去切换，su切换会出现上述安装不成功的问题。

8.2.6. 部分环境不支持图形化安装 ¶

问题描述：在Uos操作系统Hygon环境下，不支持图形化安装，且命令行安装时用户输入密码会出现卡顿现象。

解决方式：可通过调整安装命令为：./setup/install.bin （也可增加-l参数来指定zh（中文）en（英文）安装模式）来完成安装。

注意

通过这种方式安装，在输入密码时每输入一个字符在终端并不会出现‘*’提示符，但终端是会读取到用户的输入的，安装结束后也可通过进入数据库时再次验证密码是否设置成功。

8.2.7. 安装大目录时出现卡顿、迟缓情况 ¶

问题描述：用户安装过程中，在安装大目录时出现卡顿、迟缓情况。

解决方式：通过安装时增加参数-jvmxmx（上限）及-jvmxms（下限）来调整安装时占用java堆栈内存空间（目前默认设置为-jvmxmx500331648 -jvmxms268435456）。

8.2.8. Linux平台在默认安装路径下安装会提示没有权限 ¶

问题描述：用户安装过程中，如使用默认安装路径，会提示没有权限。

解决方式：Linux平台默认安装路径为 /opt/Kingbase/ES/V8 ，普通用户对此目录无权限。选择其他有权限的目录作为安装路径。

8.2.9. 从安装根目录进入Server/bin目录后，通过相对路径../../data/kingbase.conf无法找到文件 ¶

问题描述：从安装根目录进入Server/bin目录或其他目录，再通过相对路径如../../data/kingbase.conf访问或编辑文件，提示找不到文件错误。

解决方式：因为安装目录下除KESRealPro目录其他都是软连接，Server/bin实际指向KESRealPro/${版本号}/Server/bin目录。如果通过相对路径访问安装根目录下的data目录下文件，需要向上寻址4级，即../../../../data/kingbase.conf才能正常访问到相应文件。或者使用绝对路径定位kingbase.conf文件。

8.2.10. 执行安装时系统提示不能创建Java Virtual Machine ¶

问题描述：在执行setup脚本时，系统提示 Error：Could not create the Java Virtual Machine。

解决方式：需要调整系统分配的Java虚拟机内存大小，可执行

export _JAVA_OPTIONS=-Xmx512M

重新启动安装程序查看结果，如果仍存在问题，则可以将内存大小由-Xmx512M增加到-Xmx1024M，以此类推。

8.2.11. 【申威UOS】安装包进行安装，提示初始化数据库错误 ¶

问题描述：申威平台执行常规数据库安装，提示初始化数据库错误。

图 139 初始化数据库错误 ¶

解决方式：如果遇到共享库缺失的问题，请设置LD_LIBRARY_PATH系统变量，值为"${安装目录}/Server/lib"。尤其对于麒麟和申威系统要特别注意。