Windows安装人大金仓数据库保姆级

4. 安装过程 --- KingbaseES产品手册

基于Windows系统的数据库软件安装指南 ¶

1. 前言 ¶

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

前言部分包含以下主题：

1.1. 适用读者 ¶

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

1.2. 相关文档 ¶

有关ksql的更多信息，请参阅《 KingbaseES ksql工具用户指南及参考》
有关initdb的更多信息，请参阅《 KingbaseES服务器应用参考手册》
有关开发管理工具的更多信息，请参阅《 KStudio使用手册》

1.3. 术语 ¶

1.4. 手册约定 ¶

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

注意

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

提示

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

警告

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

另请参阅

用于突出参考、参阅等。

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

符号	说明
[]	表示包含一个或多个可选项。不需要输入中括号本身。
{}	表示包含两个以上（含两个）的候选，必须在其中选取一个。不需要输入花括号本身。
${}	表示{}中间的值为变量，可根据不同情况产生变化。
\|	分割中括号或者花括号中的两个或两个以上选项。不需要输入"\|"本身。
...	表示其之前的元素可以被重复。
斜体	表示占位符或者需要提供特定值的变量。
大写	表示系统提供的元素，以便与用户定义的元素相互区分。除出现在方括号中的元素外，应当按照顺序逐字输入。当然，部分元素在系统中是大小写不敏感的，因此用户可以根据系统说明以小写形式输入。
小写	表示由用户提供的元素。

2. 安装概述 ¶

2.1. 产品简介 ¶

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

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

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

版本	简介
标准版	面向政府部门、中小型企业及互联网应用数据处理需要提供的通用数据库管理系统，具备数据存储、数据处理、数据管理等基本功能。产品支持多用户并发访问，能满足各种中小型应用需要，具有极高的性价比。可部署于Linux及多种国产操作系统，并提供简便易用的图形化管理工具。
[表 1 数据库版本 ¶]

2.2. 安装模式说明 ¶

根据操作习惯的不同，您可以选择图形化安装、控制台安装或静默安装的方式安装部署KingbaseES。推荐使用图形化安装。

安装方式	简介
图形化安装	启用图形化界面进行向导式安装。
控制台安装	使用命令行方式进行向导式安装。
静默安装	通过编写配置文件，执行命令进行安装，安装过程不需要干预。
[表 2 安装方式 ¶]

根据安装数据库服务功能的不同，KingbaseES 可分为完全安装、客户端安装和定制安装三种安装集。您可以可根据自身的需求选择对应的安装集。

安装模式	简介
完全安装	安装KingbaseES所有组件，是默认的安装集。
客户端安装	安装KingbaseES的所有图形化客户端工具、命令行客户端工具和编程接口。
定制安装	根据需要选择安装KingbaseES功能组件，包括服务器组件、客户端组件、接口等。
[表 3 安装集 ¶]

2.3. License说明 ¶

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

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

注意

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

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

3. 安装前准备工作 ¶

3.1. 硬件环境要求 ¶

Windows版本的KingbaseES可以运行在通用X86_64体系结构的CPU上。

版本	要求
标准版	* CPU：x86 * 内存：512MB以上 * 硬盘：11GB以上空闲空间
[表 4 硬件要求 ¶]

3.2. 软件环境要求 ¶

KingbaseES支持微软Windows通用x86_64操作系统。

3.3. 安装包准备 ¶

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

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

假设拿到的安装包文件是KingbaseES_V008R006C009B0014_Win64_install.iso，查看其MD5值：
复制代码
certutil -hashfile C:\KingbaseES_V008R006C009B0014_Win64_install.iso MD5
查看其SHA1值：
复制代码
certutil -hashfile C:\KingbaseES_V008R006C009B0014_Win64_install.iso SHA1

3.4. 检查和配置环境 ¶

3.4.1. 检查操作系统信息 ¶

您可以通过Windows的系统属性查看操作系统和硬件配置信息。在计算机图标上点击右键，选择"属性"菜单项，打开如下窗口：

图 1 查看系统属性 ¶

注意

需要检查环境系统变量 path 内是否包含 C:\Windows\System32\Wbem\; 或同义路径，若无，需手动添加，否则 path 变量值可能会出现问题。

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

您可以通过Windows的任务管理器查看内存和磁盘存储的使用情况。

首先在桌面任务栏上点击右键，选择"启动任务管理器"菜单，打开任务管理器窗口；

然后选择"性能"页签下部"资源监视器"按钮，打开资源监视器窗口，选择"内存"和"磁盘"页签，显示如下：

图 2 查看内存使用情况 ¶

图 3 查看磁盘使用情况 ¶

如果C盘空间不够，会提示如下图信息：

图 4 磁盘空间不足 ¶

如果出现以上提示，请您清理C盘空间，保证有足够的空余空间，再次执行安装程序。

3.5. 预安装工作 ¶

3.5.1. 安装用户 ¶

在安装KingbaseES时，安装用户对于安装路径需有"读"、"写"、"执行"的权限。

Windows 7操作系统，Windows 10及以上的操作系统，需要使用管理员身份安装。

3.5.2. 安装目录 ¶

KingbaseES安装过程中有默认的安装目录 C:\Program Files\Kingbase\ES\V8。

3.5.3. 数据目录 ¶

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

默认数据目录是安装目录下的data目录。如果使用默认安装目录，则数据目录默认为 C:\Program Files\Kingbase\ES\V8\data。

注意

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

4. 安装过程 ¶

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

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

图 5 安装流程 ¶

4.1. 图形化安装 ¶

4.1.1. 启动安装程序 ¶

右键以管理员身份运行KingbaseES安装程序，将弹出安装程序窗口，如图所示。

图 6 启动 ¶

选择语言（默认<简体中文>，可选<English>），并点击"确定"按钮，继续安装。

如果之前已经安装过，则会出现如图所示窗口。

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

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

图 7 实例管理 ¶

图 8 安装简介 ¶

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

4.1.2. 许可协议 ¶

图 9 许可协议 ¶

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

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

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

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

图 10 取消 ¶

4.1.3. 选择安装集 ¶

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

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

注意

数据库开发管理工具KStudio ，详见《 KStudio使用手册》和《 KStudio快速开发指南》。
数据库迁移工具KDTS ，详见《 KDTS 迁移工具使用指南》。
数据库部署工具DEPLOY ，详见《 KingbaseES数据库部署工具使用指南》。

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

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

选择"定制安装"安装集，可根据需求选择安装所需功能部件，点击【下一步】，至 选择产品功能组件。

图 11 选择安装集 ¶

4.1.4. 选择产品功能组件 ¶

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

图 12 选择产品功能组件 ¶

4.1.5. 选择授权文件 ¶

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

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

图 13 选择授权文件 ¶

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

注意

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

4.1.6. 选择安装文件夹 ¶

此步骤用于选择安装路径。默认安装路径为: C:\Program Files\Kingbase\ES\V8。

图 14 选择安装文件夹 ¶

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

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

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

4.1.7. 预安装摘要 ¶

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

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

图 15 预安装摘要 ¶

4.1.8. 正在安装 ¶

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

图 16 正在安装 ¶

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

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

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

4.1.9. 初始化数据库 ¶

首先选择数据库数据目录，默认数据目录为安装目录下的data目录。如使用默认安装目录，则数据目录默认为C:\Program Files\Kingbase\ES\V8\data。

图 17 选择数据目录 ¶

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

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

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

默认端口为:54321（可自定义）
默认账户为:system（可自定义）
密码（自定义）
默认字符集编码为：GBK（可选 default、UTF8、GB2312、GB18030）
默认数据库兼容模式为：ORACLE（可选 PG、MySQL）
默认大小写敏感为：是（可选否）
默认数据块大小为：8k（可选16k、32k）
默认身份认证方法为scram-sha-256（可选 scram-sm3，sm4，sm3）
自定义参数（自定义），可自由输入任何值，作为初始化数据库的参数

有关数据库初始化参数，详情可见《KingbaseES服务器应用参考手册》第2章

自定义特殊参数：（如果输入值包含以下某一项，请注意特殊情况）

-c：初始化生成的配置文件会被加密，此时设置的端口值不会在初始化阶段进行修改，启动KingbaseES服务时将使用默认端口值54321。

注意

输入的参数值不能包含-W，--pwprompt，%和$。

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

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

4.1.10. 安装完成 ¶

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

图 19 安装完成 ¶

4.2. 命令行安装 ¶

4.2.1. 启动安装程序 ¶

命令行安装需要在cmd终端下操作。您首先要打开cmd终端，进入安装包（iso文件）解压后目录，执行如下命令：

复制代码

KingbaseES_V008R006C009B0014_Win64_install.exe -i console

选择语言（默认<简体中文>，可选<English>），输入选项编号并按<ENTER>（默认值可直接按<ENTER>）继续下一步。

图 20 选择语言 ¶

继续进入实例管理部分。

图 21 实例管理 ¶

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

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

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

4.2.2. 简介 ¶

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

图 22 简介 ¶

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

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

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

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

4.2.3. 许可协议 ¶

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

图 23 许可协议 ¶

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

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

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

4.2.4. 选择安装集 ¶

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

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

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

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

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

图 24 选择安装集 ¶

4.2.5. 选择产品功能组件 ¶

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

图 25 选择产品功能部件 ¶

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

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

注意

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

4.2.6. 选择授权文件 ¶

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

图 26 选择授权文件 ¶

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

注意

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

4.2.7. 选择安装文件夹 ¶

此步骤用于选择安装路径。默认安装路径:C:\Program Files\Kingbase\ES\V8。

图 27 选择安装文件夹 ¶

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

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

4.2.8. 预安装摘要 ¶

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

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

图 28 预安装摘要 ¶

4.2.9. 安装确认 ¶

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

图 29 安装确认 ¶

4.2.10. 正在安装 ¶

安装过程中会不断显示安装进度。

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

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

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

图 30 正在安装 ¶

4.2.11. 初始化数据库 ¶

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

图 31 选择数据库目录 ¶

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

默认端口为:54321（可自定义）
默认账户为:system（可自定义）
密码（自定义）
默认字符集编码为：GBK（可选 default、UTF8、GB2312、GB18030）
默认数据库兼容模式为：ORACLE（可选 PG、MySQL）
默认大小写敏感为：是（可选否）
默认数据块大小为：8k（可选16k、32k）
默认身份认证方法为scram-sha-256（可选 scram-sm3，sm4，sm3）
自定义参数（自定义），可自由输入任何值，作为初始化数据库的参数

有关数据库初始化参数，详情可见《KingbaseES服务器应用参考手册》第2章

自定义特殊参数：（如果输入值包含以下某一项，请注意特殊情况）

-c：初始化生成的配置文件会被加密，此时设置的端口值不会在初始化阶段进行修改，启动KingbaseES服务时将使用默认端口值54321。

注意

输入的参数值不能包含-W，--pwprompt，%和$。

图 32 端口 ¶

图 33 账户 ¶

图 34 密码 ¶

图 35 字符集 ¶

图 36 兼容模式 ¶

图 37 身份认证方法 ¶

图 38 大小写敏感 ¶

图 39 存储块 ¶

图 40 初始化 ¶

图 41 自定义参数 ¶

4.2.12. 安装完成 ¶

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

图 42 安装完成 ¶

按<ENTER>键退出安装程序。

4.3. 静默安装 ¶

4.3.1. 静默安装注意事项 ¶

静默安装模式下，安装程序通过读取配置文件来安装数据库。安装包iso文件解压缩后，已存在silent.cfg模板文件，根据实际安装机器的情况修改参数值。

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

序号	参数名	默认值	说明
1	CHOSEN_INSTALL _SET	Full	选择安装集，可选值包括： 1）Full，完全安装 2）Client，客户端安装 3）Custom，定制安装
2	CHOSEN_FEATURE _LIST	SERVER,KSTUDIO, KDTS,DEPLOY, INTERFACE	选择安装特性，CHOSEN_INSTALL_SET=Custom起作用。可选值： 1）SERVER，服务器。 2）KSTUDIO，数据库开发管理工具。 3）KDTS，数据库迁移工具。 4）DEPLOY，数据库部署工具。 5）INTERFACE，接口。多值用逗号分隔。大小写不敏感。如果是错误的组件名称则忽略。
3	KB_LICENSE_PATH		授权文件的绝对路径，如果指定该参数，就会选择用户指定的 license文件；如果未指定，则会使用软件自带试用版授权，请在有效期内及时更换正式授权文件。
4	USER_INSTALL_DIR	C:\Program Files\ Kingbase\ES\V8	安装目录绝对路径，必须指定，否则报错退出安装过程。路径分隔符使用'\'。
5	USER_SELECTED _DATA_FOLDER		数据目录绝对路径，必须为空目录，否则报错退出安装过程。如果不指定数据目录，默认为安装路径下data目录。
6	DB_PORT	54321	数据库服务端口，必填，端口取值范围为1-65535。否则报错退出安装过程。
7	DB_USER	system	数据库默认用户名，必填，长度不超过63个字符。否则报错退出安装过程。
8	DB_PASS		数据库初始密码，必填，否则报错退出安装过程。无长度限制。
9	DB_PASS2		确认数据库初始密码，需要和DB_PASS一致，否则报错退出安装过程。
10	ENCODING_PARAM	GBK	数据库字符集，必填，大小写敏感，否则报错退出安装过程。可选值 1) default 2）UTF8 3）GBK 4）GB2312 5）GB18030
11	DATABASE_MODE _PARAM	ORACLE	数据库兼容模式，必填，大小写敏感，否则报错退出安装过程。可选值1）ORACLE 2）PG 3) MySQL
12	CASE_SENSITIVE _PARAM	YES	数据库是否区分大小写，必填，大小写敏感，否则报错退出安装过程。可选值1）YES 2）NO
13	BLOCK_SIZE_PARAM	8k	存储块大小，必填，大小写敏感，否则报错退出安装过程。可选值 1）8k 2）16k 3）32k
14	RESTART_NEEDED	NO	重启选项，大小写敏感。可选值 1）YES 2）NO
15	AUTHENTICATION_METHOD_PARAM	scram-sha-256	默认身份认证方法为scram-sha-256（可选 scram-sm3，sm4，sm3）
16	INITCUSTOM		自定义参数，作为初始化数据库的参数，选填注意：输入的参数值不能包含-W，--pwprompt，%和$。如果输入的参数值包含-c，则启动数据库将使用默认端口值54321。
[表 5 配置文件参数说明 ¶]

4.3.2. 启动安装 ¶

打开cmd终端，进入iso安装程序包解压目录，执行如下命令：

复制代码

.\KingbaseES_V008R006C009B0014_Win64.exe -i silent -f ${配置文件路径}

-f参数指定修改后配置文件的相对或绝对路径。相对路径是指相对安装exe文件的相对路径。

注意

exe可执行程序名以实际解压后的文件名为准，中间版本号可能会有所不同。

4.3.3. 查看安装结果 ¶

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

图 43 安装日志排查错误 ¶

4.4. 服务管理 ¶

以上3种方式安装完成后，Windows会自动注册数据库服务，可以通过任务管理器中服务界面启动或停止服务。

图 44 任务管理器进程服务界面 ¶

点击右下角【服务】按钮，即可跳转到进程服务（本地）窗口，找到数据库服务kingbase8_R6_instance，双击进入服务器属性界面，在此界面即可启动或停止数据库服务。

图 45 数据库服务属性界面 ¶

5. 安装后检查 ¶

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

查看安装日志

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

图 46 安装日志 ¶

查看开始菜单

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

KingbaseES

帮助

数据库开发管理工具

数据迁移工具

数据库部署工具

卸载

查看安装目录（参考目录一览表）
验证工具是否能连接数据库。

您可以使用交互式终端工具（ksql）连接数据库。进入${安装目录}\Server\bin目录，执行如下命令：
复制代码
.\ksql.exe -p 54321 -U system test
-p参数指定初始化数据库时设置的端口。-U参数指定初始化数据库时设置的管理员用户，也可以是其他用户。更详细的ksql工具使用可参考《 KingbaseES ksql工具用户指南及参考》。

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

您也可以使用图形化客户端工具连接数据库。具体使用可参考《 KStudio使用手册》。

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

进入${安装目录}\Server\bin目录，执行
复制代码
.\kingbase.exe –V;
或在交互式终端（ksql）中执行
复制代码
select version();

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

6. 卸载 ¶

6.1. 图形化卸载 ¶

6.1.1. 启动卸载 ¶

您在应用程序菜单中找到KingbaseES菜单项中"卸载"项，或直接执行Uninstall目录下的Uninstaller.exe文件，以管理员身份运行卸载程序。

图 47 启动卸载 ¶

选择"卸载产品"，点击【下一步】按钮，准备卸载；

点击【取消】按钮，取消卸载。

6.1.2. 确认卸载 ¶

图 48 确认卸载 ¶

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

6.1.3. 正在卸载 ¶

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

图 49 正在卸载 ¶

6.1.4. 完成卸载 ¶

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

图 50 完成卸载 ¶

6.2. 命令行卸载 ¶

6.2.1. 启动卸载 ¶

您打开cmd终端，进入 ${安装目录}\\KESRealPro$ {V8R6}\Uninstall目录，执行如下命令，启动卸载程序。

复制代码

Uninstaller.exe -i console -DRESTART_NEEDED=NO

提示

-DRESTART_NEEDED=NO属性表示卸载完不自动重启操作系统，如果不加此参数卸载完成后会重启操作系统。

6.2.2. 准备卸载 ¶

图 51 准备卸载 ¶

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

6.2.3. 正在卸载 ¶

此步骤用于显示卸载进度。卸载完成后窗口自动关闭。

图 52 正在卸载 ¶

6.2.4. 完成卸载 ¶

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

6.3. 静默卸载 ¶

您打开cmd终端，进入 ${安装目录}\\KESRealPro$ {V8R6}\Uninstall目录，执行以下命令：

复制代码

Uninstaller.exe -i silent -DRESTART_NEEDED=NO

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

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

7. 增删组件 ¶

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

图 53 增删组件流程 ¶

7.1. 图形化增删组件 ¶

7.1.1. 增加组件 ¶

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

7.1.1.1. 启动 ¶

运行安装程序KingbaseES_V008R006C009B0014_Win64_install.exe，以管理员身份运行。选择"修改存在的实例"并选中安装目录，点击"确定"按钮。

图 54 修改实例 ¶

7.1.1.2. 添加功能 ¶

图 55 添加功能 ¶

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

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

7.1.1.3. 确认 ¶

图 56 确认 ¶

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

7.1.1.4. 选择功能组件 ¶

图 57 选择功能组件 ¶

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

7.1.1.5. 安装进度 ¶

图 58 安装进度 ¶

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

7.1.1.6. 完成安装 ¶

图 59 完成安装 ¶

若安装过程中没有出现任何警告或错误，将显示如下界面。单击【完成】退出安装程序。

7.1.2. 删除组件 ¶

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

7.1.2.1. 启动 ¶

您可以通过两种方式进入删除组件的操作界面。

在应用程序菜单中找到KingbaseES菜单项中"卸载"项，以管理员身份运行。
运行执行 ${安装目录}\\KESRealPro$ {V8R6}\Uninstall\Uninstaller.exe，以管理员身份运行。

图 60 修改实例 ¶

7.1.2.2. 删除功能 ¶

图 61 删除功能 ¶

您选择【删除功能】选项，点击【下一步】。点击【取消】按钮，可以退出卸载过程，若无特殊说明，以下各步骤皆与此相同。

7.1.2.3. 确认 ¶

图 62 确认 ¶

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

7.1.2.4. 选择功能组件 ¶

图 63 选择功能组件 ¶

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

点击【取消】按钮，取消卸载。

7.1.2.5. 正在移除 ¶

图 64 正在移除 ¶

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

7.1.2.6. 卸载完成 ¶

图 65 卸载完成 ¶

7.2. 命令行增删组件 ¶

7.2.1. 增加组件 ¶

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

7.2.1.1. 启动入口 ¶

命令行安装需要在cmd终端下操作。您首先要打开cmd终端，进入安装包（iso文件）解压后目录，执行如下命令：

复制代码

KingbaseES_V008R006C009B0014_Win64_install.exe -i console

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

图 66 实例管理 ¶

选择语言后进入实例管理部分。输入2，选择"修改存在的实例"，按<ENTER>。

继续选择已安装实例的安装目录，按<ENTER>。

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

7.2.1.2. 选择功能组件 ¶

图 67 选择功能组件 ¶

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

注意

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

7.2.1.3. 安装进度 ¶

图 68 安装进度 ¶

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

7.2.1.4. 完成安装 ¶

图 69 安装进度 ¶

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

7.2.2. 删除组件 ¶

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

7.2.2.1. 启动入口 ¶

您首先要打开cmd终端，进入 ${安装目录}\\KESRealPro$ {V8R6}\Uninstall\，执行如下命令：

复制代码

Uninstaller.exe -i console

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

图 70 实例管理 ¶

选择语言后进入实例管理部分。输入2，选择"修改存在的实例"，按<ENTER>。

继续选择已安装实例的安装目录，按<ENTER>。

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

7.2.2.2. 选择功能组件 ¶

图 71 选择功能组件 ¶

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

7.2.2.3. 删除及完成 ¶

图 72 正在移除 ¶

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

8. 附录 ¶

8.1. 静默安装配置文件 ¶

复制代码

#license file path, for example /home/kingbase/license_1309_0-sales.dat for linux or C:\\license_1309_0-sales.dat for windows
KB_LICENSE_PATH=
#install set, options are Full, Client, Custom
CHOSEN_INSTALL_SET=Full
#component list, options are SERVER, KSTUDIO, KDTS, INTERFACE, DEPLOY
CHOSEN_FEATURE_LIST=SERVER,KSTUDIO,KDTS,INTERFACE,DEPLOY
#install dir path, for example /opt/Kingbase/ES/V8 for linux or C:\\Program Files\\Kingbase\\ES\\V8 for windows
USER_INSTALL_DIR=C:\\Program Files\\Kingbase\\ES\\V8
#data dir path, for example /opt/Kingbase/ES/V8/data for linux or C:\\Program Files\\Kingbase\\ES\\V8\\data for windows
USER_SELECTED_DATA_FOLDER=
#init db params
#server port, requied, between 1 and 65535
DB_PORT=54321
#user name, required, length less than 63 bytes
DB_USER=system
#password, required
DB_PASS=
#password confirm, required
DB_PASS2=
#encoding, required, options are UTF8, GBK, GB18030
ENCODING_PARAM=GBK
#compatibility mode, required, options are ORACLE, PG
DATABASE_MODE_PARAM=ORACLE
#case sensitivity, required, options are YES, NO
CASE_SENSITIVE_PARAM=YES
#block size, required, options are 8k, 16k, 32k
BLOCK_SIZE_PARAM=8k
#uninstall whether restart
RESTART_NEEDED=NO

8.2. 目录一览表 ¶

数据库安装完成后，进入安装目录，数据库安装后生成的主要目录和文件详见下表。由于完全安装、客户端安装、定制安装安装的服务不同，对应生成的文件目录也有所不同，请以实际的安装为准。

KESRealPro目录下按版本号放置不同版本的程序内容。安装根目录下的其他目录和文件都是快捷方式，实际指向KESRealPro下具体版本的对应目录或文件。

Server：快捷方式，对应目录存放了服务器二进制文件，链接文件等。
- Server\bin：服务器二进制文件，可以在该路径下进行启动服务,连接数据库，物理备份还原，逻辑备份还原等操作。
ClientTools：快捷方式，对应目录下存放了客户端安装时所需的命令行，可执行二进制文件，链接文件等。
- ClientTools\guitools\KStudio：开发管理工具，能运行在各种平台的图形工具，用于管理和配置KingbaseES数据库服务器，管理各种KingbaseES数据库对象，进行KingbaseES数据库的安全管理，调用查询分析器执行和测试SQL语句。
- ClientTools\guitools\KDts：数据库迁移工具，可以用于跨平台数据交换和迁移，支持同异构数据源之间的数据迁移。该目录下存放了迁移工具的相关程序和配置文件。
- ClientTools\guitools\DeployTools：集群部署工具，用于远程部署集群节点服务。该目录存放了集群部署工具相关的程序和配置文件。
Interface：快捷方式，对应目录存放了各类应用程序开发接口程序包。
SupTools：快捷方式，对应目录下存放了巡检工具相关脚本和配置文件。
install：软连接，对应目录存放了安装过程中依赖和使用的各类文件。
- install\jre：Jre,存放了java工具需要用到的二进制文件。
- install\script：该目录下存放了数据库初始化脚本，包括initdb.bat，register.bat，sysctl.bat,unregister.bat,vcredist_x64.exe等。
- install\Logs：日志目录，存放了数据库安装，卸载，修改实例等日志文件。
- install\LICENSE.EN：许可协议（英文）
- install\LICENSE.ZH：许可协议（中文）
doc：快捷方式，对应目录包含各类帮助手册。
Uninstall：快捷方式，对应目录包含数据库卸载的相关配置文件。
license.dat：快捷方式，指向安装时使用的认证许可证书。
KESRealPro：实际安装目录，下一级为版本号命名的目录，再下一级为Server，doc，ClientTools，Interface，install，SupTools，Uninstall，license.dat，对应上述各快捷方式的实际目录。
Data：初始化生成的data文件，存放了数据库参数配置相关信息。

8.3. 安装卸载常见问题 ¶

8.3.1. 安装后启动报错 ¶

问题描述：正常安装Windows版本数据库后，在cmd命令框中使用sys_ctl启动数据库服务，报错Only one usage of each socket address （protocol/network address/port）is normally permitted，但实际并没有已存在的kingbase进程或端口被占用或存在同名服务在运行中，现象如下：

解决方式：尝试再次启动，若仍然报同样的错误，进入Windows服务管理（任务管理器-服务-右下角服务），找到kingbase8_instance服务，进入其属性，将其启动类型更改为手动并应用，重启该服务，此时再sys_ctl启动数据库服务可以启动成功。

8.3.2. 初始化数据库失败 ¶

问题描述：输入数据库初始化参数后点击【下一步】，提示"初始化数据库错误"。

解决方式：

退出安装程序，到安装目录下的Server\bin目录下双击执行initdb.exe，检查Windows系统是否提示"找不到MSVCR120.dll"。如果提示找不到MSVCR120.dll，则是缺少Microsoft Visual C++ 2013运行库的原因。

进入到目录下的install\script目录，双击执行vcredist_x64.exe。安装成功后，可卸载后重新安装。

参考《 KingbaseES服务器应用参考手册》 initdb，使用initdb命令行工具再次初始化数据库。

8.3.3. 注册数据库服务失败 ¶

问题描述：输入数据库初始化参数后点击【下一步】，提示"注册KingbaseES失败"。

解决方式：

在任务管理器的服务界面检查是否存在kingbase8_R6_instance服务。如果存在，则是之前安装过KingbaseES，已经存在同名的服务。

确定原kingbase8_R6_instance服务是否继续使用。如果不再使用，可使用sc delete kingbase8_R6_instance命令删除已存在服务实例。

再通过Server\bin目录执行如下命令重新注册新的数据库服务。
复制代码
sys_ctl.exe register -N "kingbase8_R6_instance" -D ${data目录} -S auto
工具命令使用参考《 KingbaseES服务器应用参考手册》 sys_ctl。服务名称可自定义为其他名称。

8.3.4. 启动数据库服务失败 ¶

问题描述：输入数据库初始化参数后点击【下一步】，提示"启动KingbaseES失败"。

解决方式：

检查license文件是否和当前版本匹配。如果不匹配服务无法启动。

检查数据库端口是否被占用。如果端口已被占用则服务无法启动。

尝试通过Server\bin目录下sys_ctl.exe或kingbase.exe工具启动数据库。工具命令使用参考《 KingbaseES服务器应用参考手册》 kingbase。执行命令过程中如果显示其他错误信息，则参考相关手册进行处理。

8.3.5. win server 2008操作系统缺库 ¶

问题描述：windows server2008安装vc运行库时报错，错误如下图：

解决方式：检查操作系统版本是否是SP1版本。如果不是SP1版本，需要下载SP1补丁升级后可解决此问题。