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

基于 Windows 系统的数据库软件安装指南 金仓数据库管理系统 KingbaseES 文档版本：V9（V009R001C001B0024） 发布日期：2023 年 10 月 12 日 北京人大金仓信息技术股份有限公司 目 目 录 录 第 1 章 前言 1 1.1 适用读者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 相关文档 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.3 术语 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.4 手册约定 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 第 2 章 安装概述 3 2.1 产品简介 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 安装模式说明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.3 License 说明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 第 3 章 安装前准备工作 5 3.1 硬件环境要求 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3.2 软件环境要求 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 3.3 安装包准备 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.4 检查和配置环境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.4.1 检查操作系统信息 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.4.2 检查系统内存与存储空间 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 预安装工作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.5.1 安装用户 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.5.2 安装目录 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.5.3 数据目录 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3.5 第 4 章 安装过程 4.1 10 图形化安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 4.1.1 启动安装程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 4.1.2 许可协议 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 4.1.3 选择安装集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 4.1.4 选择产品功能组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 4.1.5 选择授权文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 4.1.6 选择安装文件夹 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 4.1.7 预安装摘要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 I 4.2 4.3 4.4 目 录 4.1.8 正在安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 4.1.9 初始化数据库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 4.1.10 安装完成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 命令行安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 4.2.1 启动安装程序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 4.2.2 简介 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25 4.2.3 许可协议 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 4.2.4 选择安装集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 4.2.5 选择产品功能组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 4.2.6 选择授权文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 4.2.7 选择安装文件夹 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 4.2.8 预安装摘要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 4.2.9 安装确认 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 4.2.10 正在安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 4.2.11 初始化数据库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 4.2.12 安装完成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 静默安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 4.3.1 静默安装注意事项 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 4.3.2 启动安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 4.3.3 查看安装结果 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 服务管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 第 5 章 安装后检查 41 第 6 章 卸载 43 6.1 6.2 6.3 图形化卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 6.1.1 启动卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 6.1.2 确认卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 6.1.3 正在卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 6.1.4 完成卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 命令行卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 6.2.1 启动卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 6.2.2 准备卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 6.2.3 正在卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 6.2.4 完成卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 静默卸载 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 第 7 章 增删组件 7.1 49 50 图形化增删组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 增加组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 7.1.1.1 启动 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 7.1.1.2 添加功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 7.1.1.3 确认 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 7.1.1 II 目 录 7.1.1.4 选择功能组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 7.1.1.5 安装进度 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 7.1.1.6 完成安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 删除组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 7.1.2.1 启动 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 7.1.2.2 删除功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 7.1.2.3 确认 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 7.1.2.4 选择功能组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 7.1.2.5 正在移除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 7.1.2.6 卸载完成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 命令行增删组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 增加组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 7.2.1.1 启动入口 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 7.2.1.2 选择功能组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 7.2.1.3 安装进度 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 7.2.1.4 完成安装 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 删除组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 7.2.2.1 启动入口 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 7.2.2.2 选择功能组件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 7.2.2.3 删除及完成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69 7.1.2 7.2 7.2.1 7.2.2 第 8 章 附录 70 8.1 静默安装配置文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 8.2 目录一览表 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 8.3 安装卸载常见问题 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 8.3.1 安装后启动报错 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 8.3.2 初始化数据库失败 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 8.3.3 注册数据库服务失败 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 8.3.4 启动数据库服务失败 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 8.3.5 win server 2008 操作系统缺库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 版权声明 75 服务周期承诺 76 III 第 1 章 前言 1 第 章 前言 本文档描述了如何在 Windows 操作系统上安装和卸载 KingbaseES 以及常见问题。 前言部分包含以下主题： • 适用读者 • 相关文档 • 术语 • 手册约定 1.1 适用读者 本文档面向所有使用 KingbaseES 的用户，主要是数据库管理员和应用程序开发人员。 1.2 相关文档 • 有关 ksql 的更多信息，请参阅《KingbaseES ksql 工具用户指南及参考》 • 有关 initdb 的更多信息，请参阅《KingbaseES 服务器应用参考手册》 • 有关开发管理工具的更多信息，请参阅《KStudio 使用手册》 1.3 术语 1.4 手册约定 本文档中可能出现“注意、提示、警告、另请参阅”等标志，它们所代表的含义如下： 1 第 1 章 前言 注意: 用于突出重要/关键信息、最佳实践等。 提示: 用于突出小窍门、捷径等。 警告: 用于传递设备或环境安全警示信息，若不避免，可能会导致设备损坏、数据丢失、设备性能降低或其 它不可预知的结果。 另请参阅: 用于突出参考、参阅等。 以下程序代码书写约定适用于本文档： 符号 说明 [] 表示包含一个或多个可选项。不需要输入中括号本身。 {} 表示包含两个以上（含两个）的候选，必须在其中选取一个。不需要输入花括号本身。 ${} 表示 {} 中间的值为变量，可根据不同情况产生变化。 | 分割中括号或者花括号中的两个或两个以上选项。不需要输入“|”本身。 ... 表示其之前的元素可以被重复。 斜体 表示占位符或者需要提供特定值的变量。 大写 表示系统提供的元素，以便与用户定义的元素相互区分。除出现在方括号中的元素外，应当按 照顺序逐字输入。当然，部分元素在系统中是大小写不敏感的，因此用户可以根据系统说明以 小写形式输入。 小写 表示由用户提供的元素。 2 第2章 安装概述 2 第 章 安装概述 • 产品简介 • 安装模式说明 • License 说明 2.1 产品简介 金仓数据库管理系统 [简称:KingbaseES] 是北京人大金仓信息技术股份有限公司（简称人大金仓）自主研发的、 具有自主知识产权的商用关系型数据库管理系统（DBMS）。该产品面向事务处理类应用，兼顾各类数据分析类应 用，可用做信息管理系统、业务及生产系统、决策支持系统、全文检索、地理信息系统等的承载数据库。 KingbaseES 支持多种操作系统和硬件平台: 支持 Linux、Windows、国产 Kylin 等数十个操作系统产品版本，支 持通用 x86_64 及国产龙芯、飞腾、申威等 CPU 硬件体系架构。Windows 平台的 KingbaseES 提供标准版。 KingbaseES 软件能够提供一主一备以及一主多备的高可用集群架构，实现数据及实例级 (异地) 故障容灾，也能 够提供多节点并行服务，内存融合及存储共享，实现高并发性能利用最大化，结合读写分离或备份使用同步实现数据 保护最大化。 表 2.1.1: 数据库版本 版本 简介 标准版 面向政府部门、中小型企业及互联网应用数据处理需要提供的通用数据库管理系统，具备 数据存储、数据处理、数据管理等基本功能。产品支持多用户并发访问，能满足各种中小 型应用需要，具有极高的性价比。可部署于 Linux 及多种国产操作系统，并提供简便易用 的图形化管理工具。 3 第2章 2.2 安装概述 安装模式说明 根据操作习惯的不同，您可以选择图形化安装、控制台安装或静默安装的方式安装部署 KingbaseES。推荐使用 图形化安装。 表 2.2.1: 安装方式 安装方式 简介 图形化安装 启用图形化界面进行向导式安装。 控制台安装 使用命令行方式进行向导式安装。 静默安装 通过编写配置文件，执行命令进行安装，安装过程不需要干预。 根据安装数据库服务功能的不同，KingbaseES 可分为完全安装、客户端安装和定制安装三种安装集。您可以可 根据自身的需求选择对应的安装集。 表 2.2.2: 安装集 安装模式 简介 完全安装 安装 KingbaseES 所有组件，是默认的安装集。 客户端安装 安装 KingbaseES 的所有图形化客户端工具、命令行客户端工具和编程接口。 定制安装 根据需要选择安装 KingbaseES 功能组件，包括服务器组件、客户端组件、接口等。 2.3 License 说明 数据库 license 是 KingbaseES 提供的授权文件，其中会对数据库有效日期、发布类型、最大并发连接数 mac 地 址、ip 等信息进行设置。 如果在 license 文件中信息与安装环境中相关信息不匹配，数据库将无法启动。 更多 license 信息，详见《License 信息手册》。 4 第 3 章 安装前准备工作 3 第 章 安装前准备工作 • 硬件环境要求 • 软件环境要求 • 安装包准备 • 检查和配置环境 • 预安装工作 3.1 硬件环境要求 Windows 版本的 KingbaseES 可以运行在通用 X86_64 体系结构的 CPU 上。 表 3.1.1: 硬件要求 版本 要求 标准版 • CPU：x86、龙芯、飞腾、鲲鹏 • 内存：512MB 以上 • 硬盘：10GB 以上空闲空间 3.2 软件环境要求 KingbaseES 支持微软 Windows 通用 x86_64 操作系统。 5 第 3 章 安装前准备工作 3.3 安装包准备 您可以通过人大金仓官网下载安装程序 KingbaseES_V9_Win64_install.iso。也可以通过人大金仓的销售人员、 售后支持人员或代理商获取安装程序。 您在获得安装程序（iso 文件）的同时，应该会获得一个 MD5 值或 SHA1 值。建议先通过以下命令查看安装程 序文件对应的 MD5 值或 SHA1 值，再和拿到的 MD5 值或 SHA1 值进行比对。如果一致说明安装文件正常；如果不 一致说明安装文件可能不完整，安装过程可能无法正常完成。 假设拿到的安装包文件是 KingbaseES_V009R001C001B0024_Win64_install.iso，查看其 MD5 值： certutil -hashfile C:\KingbaseES_V009R001C001B0024_Win64_install.iso MD5 查看其 SHA1 值： certutil -hashfile C:\KingbaseES_V009R001C001B0024_Win64_install.iso SHA1 3.4 检查和配置环境 3.4.1 检查操作系统信息 您可以通过 Windows 的系统属性查看操作系统和硬件配置信息。在计算机图标上点击右键，选择“属性”菜单 项，打开如下窗口： 图 3.4.1: 查看系统属性 6 第 3 章 安装前准备工作 3.4.2 检查系统内存与存储空间 您可以通过 Windows 的任务管理器查看内存和磁盘存储的使用情况。 首先在桌面任务栏上点击右键，选择“启动任务管理器”菜单，打开任务管理器窗口； 然后选择“性能”页签下部“资源监视器”按钮，打开资源监视器窗口，选择“内存”和“磁盘”页签，显示如 下： 图 3.4.2: 查看内存使用情况 7 第 3 章 安装前准备工作 图 3.4.3: 查看磁盘使用情况 如果 C 盘空间不够，会提示如下图信息： 图 3.4.4: 磁盘空间不足 8 第 3 章 安装前准备工作 如果出现以上提示，请您清理 C 盘空间，保证有足够的空余空间，再次执行安装程序。 3.5 预安装工作 3.5.1 安装用户 在安装 KingbaseES 时，安装用户对于安装路径需有“读”、“写”、“执行”的权限。 Windows 7 操作系统，Windows 10 及以上的操作系统，需要使用管理员身份安装。 3.5.2 安装目录 KingbaseES 安装过程中有默认的安装目录 C:\Program Files\Kingbase\ES\V9。 3.5.3 数据目录 数据目录是 KingbaseES 中存放数据文件的目录，默认是在安装目录下的 data 目录。也可以与安装目录分开单独 设置。您也可以根据系统的业务数据量来设置数据目录路径，例如将数据目录初始化在本机硬盘或者挂载在盘阵上。 默认数据目录是安装目录下的 data 目 录。 如 果 使 用 默 认 安 装 目 录， 则 数 据 目 录 默 认 为 C: \Program Files\Kingbase\ES\V9\data。 注意: 数据目录不必事先创建。安装过程中会提示指定数据目录，如果目录不存在安装程序会自动创建。 9 第4章 安装过程 4 第 章 安装过程 本节将详细讲解如何基于图形化界面、命令行模式和静默安装模式在 Windows 系统中安装 KingbaseES。 不论何种方式安装，整体的安装流程如下图所示。 10 第4章 安装过程 图 4.1: 安装流程 • 图形化安装 11 第4章 安装过程 • 命令行安装 • 静默安装 4.1 图形化安装 4.1.1 启动安装程序 右键以管理员身份运行 KingbaseES 安装程序，将弹出安装程序窗口，如图所示。 图 4.1.1: 启动 选择语言（默认 < 简体中文 >，可选），并点击“确定”按钮，继续安装。 如果之前已经安装过，则会出现如图所示窗口。 选择【安装新的实例】，点击【确认】，开始安装 KingbaseES。点击【取消】按钮则退出本次安装。 如果您想在已安装实例上增加或删除功能，则可以选择【修改存在的实例】，具体参见图形化增删组件 。 12 第4章 安装过程 图 4.1.2: 实例管理 图 4.1.3: 安装简介 13 第4章 安装过程 点击【下一步】，继续本次安装。 4.1.2 许可协议 图 4.1.4: 许可协议 默认“我接受许可协议条款”的选择框未选中，【下一步】按钮置灰。 当且仅当选择“我接受许可协议条款”后，【下一步】按钮方有效。 若点击【取消】按钮，将弹出取消安装提示窗口，点击【退出】按钮，退出安装程序。 若点击【继续】，则回到安装界面，继续安装。 14 第4章 安装过程 图 4.1.5: 取消 4.1.3 选择安装集 根据安装后数据库服务功能的不同，KingbaseES 可分为完全安装、客户端安装和定制安装三种安装集。 • 完全安装：包括数据库服务器、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。 • 客户端安装：包括接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。 • 定制安装：在数据库服务器、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具所有组件中自由 选择。 注意: • 数据库开发管理工具 KStudio ，详见《KStudio 使用手册》和《KStudio 快速开发手册》。 • 数据库迁移工具 KDTS ，详见《KDTS 迁移工具使用指南》。 • 数据库部署工具 DEPLOY ，详见《数据库部署工具使用说明》。 选择“完全安装”安装集，系统将安装 KingbaseES 所有组件，点击【下一步】，至 选择授权文件。 选择“客户端安装”安装集，系统将安装 KingbaseES 的所有客户端工具和编程接口，点击【下一步】，至 选择 安装文件夹。 选择“定制安装”安装集，可根据需求选择安装所需功能部件，点击【下一步】，至 选择产品功能组件。 15 第4章 安装过程 图 4.1.6: 选择安装集 4.1.4 选择产品功能组件 如选择定制安装的安装集，您通过点击功能组件项选择或去除对应的组件。如果要安装集群节点上的数据库服 务，必须要安装“数据库部署工具”。点击【下一步】，继续安装。 16 第4章 安装过程 图 4.1.7: 选择产品功能组件 4.1.5 选择授权文件 您在本步骤需要选择授权文件，授权文件路径默认为空，点击【选择】按钮以选择本机上的授权文件。 若指定的授权文件合法，则将显示授权文件的详细信息。 17 第4章 安装过程 图 4.1.8: 选择授权文件 进入该步骤【下一步】按钮默认置灰，若授权文件通过验证，则【下一步】按钮有效。 4.1.6 选择安装文件夹 此步骤用于选择安装路径。默认安装路径为: C:\Program Files\Kingbase\ES\V9。 18 第4章 安装过程 图 4.1.9: 选择安装文件夹 您点击【选择】按钮，弹出文件选择对话框，可选择其他安装路径。 点击【恢复缺省文件夹】按钮，将安装路径恢复为默认安装路径。 点击【下一步】按钮，继续安装。 4.1.7 预安装摘要 您在此步骤会看到即将安装产品的摘要信息，包括： • 产品名称。 • 安装文件夹。 • 指定安装的功能组件。 • 安装路径所在磁盘空间信息。 19 第4章 安装过程 图 4.1.10: 预安装摘要 4.1.8 正在安装 您点击【安装】按钮后，系统开始安装 KingbaseES，安装过程不断刷新安装进度。 20 第4章 安装过程 图 4.1.11: 正在安装 如选择“完全安装”安装集，安装进度 100% 之后，将至 初始化数据库。 如选择“客户端安装”安装集，安装进度 100% 之后，将至 安装完成。 如选择“定制安装”安装集，并选择安装了数据库服务器组件，安装进度 100% 之后，将至 初始化数据库。 4.1.9 初始化数据库 首先选择数据库数据目录，默认数据目录为安装目录下的 data 目录。如使用默认安装目录，则数据目录默认为 C:\Program Files\Kingbase\ES\V9\data。 21 第4章 安装过程 图 4.1.12: 选择数据目录 点击【选择】按钮，弹出文件选择对话框，选择自定义数据目录。 您点击【恢复缺省文件夹】按钮，将数据目录恢复为默认的数据目录。 点击【下一步】按钮，继续设置如下初始化数据库参数： • 默认端口为:54321（可自定义） • 默认账户为:system（可自定义） • 密码（自定义） • 默认字符集编码为：GBK（可选 UTF8、GB18030） • 默认数据库兼容模式为：ORACLE（可选 PG、MySQL） • 默认大小写敏感为：是（可选否） • 默认数据块大小为：8k（可选 16k、32k） • 默认加密方法为 sm4（可选 rc4） • 默认身份认证方法为 scram-sha-256（可选 scram-sm3，sm4，sm3） 22 第4章 安装过程 图 4.1.13: 设置初始化数据库参考 输入服务器监听端口、用户名、密码、编码、模式、大小写敏感、数据块大小等数据库初始化参数后，点击【下 一步】，系统进行初始化数据库过程。 4.1.10 安装完成 若安装过程中没有出现任何警告或错误，将显示如下界面。单击【完成】退出安装程序。若安装过程中出现任何 警告或错误，则窗口中显示日志文件位置，您可以打开日志文件查看具体错误信息。 23 第4章 安装过程 图 4.1.14: 安装完成 4.2 命令行安装 4.2.1 启动安装程序 命令行安装需要在 cmd 终端下操作。您首先要打开 cmd 终端，进入安装包（iso 文件）解压后目录，执行如下 命令： KingbaseES_V009R001C001B0024_Win64_install.exe -i console 选择语言（默认 < 简体中文 >，可选），输入选项编号并按（默认值可直接按）继续下一步。 24 第4章 安装过程 图 4.2.1: 选择语言 继续进入实例管理部分。 图 4.2.2: 实例管理 您输入 1，再按 ，选择“安装新的实例”； 您输入 2，再按 ，选择“修改存在的实例”。 初次安装，输入 1，按 ，进入“简介”界面。修改存在的实例请参考命令行增删组件 。 4.2.2 简介 “简介”界面中提供了 KingbaseES 版本和安装程序版本等信息。 25 第4章 安装过程 图 4.2.3: 简介 输入 quit，按 退出安装； 输入 back，按 返回前一屏幕； 直接按 进行下一步操作。 若无特殊说明，以下各步骤皆与此相同。 4.2.3 许可协议 在此步骤您需要阅读完整的许可协议。连续按 翻页阅读直到结束。 26 第4章 安装过程 图 4.2.4: 许可协议 您输入 Y（不分大小写）表示接受此许可协议条款。 您输入 N（不分大小写）表示不接受此许可协议条款，输入其他无效。 若不接受，则会提示警告信息，无法继续安装，提示用户重新选择。 4.2.4 选择安装集 根据安装后数据库服务功能的不同，KingbaseES 可分为完全安装、客户端安装和定制安装三种安装集。 • 完全安装：包括数据库服务器、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。 • 客户端安装：包括接口、数据库开发管理工具、数据库迁移工具、数据库部署工具。 • 定制安装：在数据库服务器、接口、数据库开发管理工具、数据库迁移工具、数据库部署工具所有组件中自由 选择。 27 第4章 安装过程 您输入 1，或按 接受缺省项，选择“完全安装”安装集，系统将安装 KingbaseES 所有组件，跳至 选择授权文件。 您输入 2，选择“客户端安装”安装集，系统将安装 KingbaseES 的所有客户端工具、编程接口、扩展插件以及 命令行可执行二进制文件，跳至选择安装文件夹。 您输入 3，选择“定制安装”安装集，可根据需求选择安装所需功能组件，将进入下一步选择产品功能组件。 图 4.2.5: 选择安装集 4.2.5 选择产品功能组件 如选择定制安装的安装集，您需要继续选择产品功能组件。 28 第4章 安装过程 图 4.2.6: 选择产品功能部件 输入不需要安装的功能组件的序号，并以逗号分隔。 输入“？< 号码 >”，可查看该功能部件的说明。 注意: 这里选择的是不需要安装的组件。如果全部安装，则不需要输入，点击 继续下一步。 4.2.6 选择授权文件 此步骤用于选择授权文件，若指定的授权文件合法，则将显示授权文件的详细信息。 图 4.2.7: 选择授权文件 您输入授权文件的绝对路径后，按 以检查授权文件，若授权文件有效，则进入下一步骤。 4.2.7 选择安装文件夹 此步骤用于选择安装路径。默认安装路径:C:\Program Files\Kingbase\ES\V9。 29 第4章 安装过程 图 4.2.8: 选择安装文件夹 您可自行输入一个绝对路径作为安装目录。缺省直接按 键，即为默认路径。 再次确认完整路径，输入 Y（不分大小写），按 键继续。 4.2.8 预安装摘要 您在此步骤会看到即将安装产品的摘要信息。包括： • 产品名称。 • 安装文件夹。 • 指定安装的功能组件。 • 安装路径所在磁盘空间信息。 30 第4章 安装过程 图 4.2.9: 预安装摘要 4.2.9 安装确认 您在此步骤进行安装确认。按 键系统开始执行安装过程。 图 4.2.10: 安装确认 4.2.10 正在安装 安装过程中会不断显示安装进度。 如选择“完全安装”安装集，安装进度 100% 之后，将至初始化数据库。 如选择“客户端安装”安装集，安装进度 100% 之后，将至安装完成。 31 第4章 安装过程 如选择“定制安装”安装集，并且选择安装数据库服务器组件，安装进度 100% 之后，将至初始化数据库。 图 4.2.11: 正在安装 4.2.11 初始化数据库 首先选择数据库数据目录，默认数据库数据目录为安装目录下的 data 目录。 图 4.2.12: 选择数据库目录 设置如下初始化数据库参数： • 默认端口为:54321（可自定义） • 默认账户为:system（可自定义） • 密码（自定义） • 默认字符集编码为：GBK（可选 UTF8、GB18030） • 默认数据库兼容模式为：ORACLE（可选 PG、MySQL） • 默认大小写敏感为：是（可选否） • 默认数据块大小为：8k（可选 16k、32k） • 默认加密方法为 sm4（可选 rc4） 32 第4章 安装过程 • 默认身份认证方法为 scram-sha-256（可选 scram-sm3，sm4，sm3） 图 4.2.13: 端口 图 4.2.14: 账户 图 4.2.15: 密码 33 第4章 安装过程 图 4.2.16: 编码 图 4.2.17: 模式 图 4.2.18: 大小写敏感 34 第4章 安装过程 图 4.2.19: 存储块 图 4.2.20: 加密方法 图 4.2.21: 身份认证方法 35 第4章 安装过程 图 4.2.22: 初始化 4.2.12 安装完成 若安装过程中没有出现任何警告或错误，将显示如下界面。 图 4.2.23: 安装完成 按 键退出安装程序。 36 第4章 4.3 静默安装 4.3.1 静默安装注意事项 安装过程 静默安装模式下，安装程序通过读取配置文件来安装数据库。安装包 iso 文件解压缩后，已存在 silent.cfg 模板文 件，根据实际安装机器的情况修改参数值。 配置文件的参数可参考下表修改。 表 4.3.1: 配置文件参数说明 序号 参数名 默认值 说明 1 CHOSEN_INSTALL Full 选择安装集，可选值包括： _SET 1）Full，完全安装 2）Client，客户端安装 3）Custom，定制安装 2 CHOSEN_FEATURE SERVER,KSTUDIO, 选 择 安 装 特 性，CHO- _LIST KDTS,DEPLOY, SEN_INSTALL_SET=Custom 起 作 用。 可 INTERFACE 选值： 1）SERVER，服务器。 2）KSTUDIO，数据库开发管理工具。 3）KDTS，数据库迁移工具。 4）DEPLOY，数据库部署工具。 5）INTERFACE，接口。 多值用逗号分隔。大小写不敏感。如果是错误的 组件名称则忽略。 3 授权文件的绝对路径，如果选择安装特性中有 KB_LICENSE_PATH SERVER，则必须指定本参数，否则可以正常安 装，但数据库服务无法正常启动。路径分隔符使 用’\’。 4 USER_INSTALL_DIR C: \Program Kingbase\ES\V9 5 Files\ 安装目录绝对路径，必须指定，否则报错退出安 装过程。路径分隔符使用’\’。 USER_SELECTED 数据目录绝对路径，必须为空目录，否则报错退 _DATA_FOLDER 出安装过程。如果不指定数据目录，默认为安装 路径下 data 目录。 6 DB_PORT 54321 数 据 库 服 务 端 口， 必 填， 端 口 取 值 范 围 为 1- 65535。否则报错退出安装过程。 见续表 37 第4章 安装过程 表 4.3.1 – 续表 序号 参数名 默认值 说明 7 DB_USER system 数据库默认用户名，必填，长度不超过 63 个字 符。否则报错退出安装过程。 8 数据库初始密码，必填，否则报错退出安装过 DB_PASS 程。无长度限制。 9 确认数据库初始密码，需要和 DB_PASS 一致， DB_PASS2 否则报错退出安装过程。 10 ENCODING_PARAM GBK 数据库字符集，必填，大小写敏感，否则报错退 出安装过程。可选值 1）UTF8 2）GBK 3） GB18030 11 DATABASE_MODE ORACLE 退出安装过程。可选值 1）ORACLE 2）PG _PARAM 12 CASE_SENSITIVE 13 数据库兼容模式，必填，大小写敏感，否则报错 YES 数据库是否区分大小写，必填，大小写敏感，否 _PARAM 则报错退出安装过程。可选值 1）YES 2）NO BLOCK_SIZE_PARAM 8k 存储块大小，必填，大小写敏感，否则报错退出 安装过程。可选值 1）8k 2）16k 3）32k NO 重启选项，大小写敏感。可选值 1）YES 2）NO 14 RESTART_NEEDED 15 ENCRYPT_METHOD_PARAM sm4 默认加密方法为 sm4（可选 rc4） 16 AUTHENTICATION_METHOD_PARA scram-sha-256 默认身份认证方法为 scram-sha-256（可 选 scram-sm3，sm4，sm3） 4.3.2 启动安装 打开 cmd 终端，进入 iso 安装程序包解压目录，执行如下命令： .\KingbaseES_V009R001C001B0024_Win64.exe -i silent -f ${配置文件路径} -f 参数指定修改后配置文件的相对或绝对路径。相对路径是指相对安装 exe 文件的相对路径。 注意: exe 可执行程序名以实际解压后的文件名为准，中间版本号可能会有所不同。 38 第4章 4.3.3 安装过程 查看安装结果 安装程序退出之后，如果没有正确安装，可在安装目录下的”install/Logs 目录打开文件名如 KingbaseES_V9_ 安装 _*.log” 的日志文件排查错误原因。如果有如下信息，则 silent.cfg 文件中参数取值有错误，未完成安装过程。 需要修改后重新执行。 图 4.3.1: 安装日志排查错误 4.4 服务管理 以上 3 种方式安装完成后，Windows 会自动注册数据库服务，可以通过任务管理器中服务界面启动或停止服务。 图 4.4.1: 任务管理器进程服务界面 点击右下角【服务】按钮，即可跳转到进程服务（本地）窗口，找到数据库服务 kingbase9_instance，双击进入 服务器属性界面，在此界面即可启动或停止数据库服务。 39 第4章 安装过程 图 4.4.2: 数据库服务属性界面 40 第 5 章 安装后检查 5 第 章 安装后检查 在安装完成后，您可以通过以下几种方式进行安装正确性验证： 1. 查看安装日志 在 ${安装目录}\install\Logs 目录下，存在名称如”KingbaseES_V9_ 安装 _*.log” 的日志文件，其中记录了安 装过程的所有信息。您可以打开日志文件，查看如下所示安装结果信息判断是否安装正确。 图 5.1: 安装日志 41 第 5 章 安装后检查 2. 查看开始菜单 查看应用程序菜单中是否安装了 KingbaseES 菜单项，并且正确关联到对应的程序。开始菜单结构如下： KingbaseES • 帮助 • 数据库开发管理工具 • 数据迁移工具 • 数据库部署工具 • 卸载 3. 查看安装目录（参考目录一览表 ） 4. 验证工具是否能连接数据库。 您可以使用交互式终端工具（ksql）连接数据库。进入 ${安装目录}\Server\bin 目录，执行如下命令： .\ksql.exe -p 54321 -U system test -p 参数指定初始化数据库时设置的端口。-U 参数指定初始化数据库时设置的管理员用户，也可以是其他 用户。更详细的 ksql 工具使用可参考《KingbaseES ksql 工具用户指南及参考》。 如果 ksql 能够正常连接数据库服务，则说明数据库安装正常。 您也可以使用图形化客户端工具连接数据库。具体使用可参考《KStudio 使用手册》。 5. 查看已安装数据库的版本信息 进入 ${安装目录}\Server\bin 目录，执行 .\kingbase.exe –V; 或在交互式终端（ksql）中执行 select version(); 此外，完成安装 KingbaseES 软件后，可继续参考《数据库部署工具使用说明》，学习如何通过数据库部署工具 安装部署集群、启停集群服务、修改配置、查看日志。 42 第 6 章 卸载 6 第 章 卸载 • 图形化卸载 • 命令行卸载 • 静默卸载 6.1 图形化卸载 6.1.1 启动卸载 您在应用程序菜单中找到 KingbaseES 菜单项中“卸载”项，或直接执行 Uninstall 目录下的 Uninstaller.exe 文 件，以管理员身份运行卸载程序。 43 第 6 章 卸载 图 6.1.1: 启动卸载 选择“卸载产品”，点击【下一步】按钮，准备卸载； 点击【取消】按钮，取消卸载。 44 第 6 章 卸载 6.1.2 确认卸载 图 6.1.2: 确认卸载 点击【下一步】按钮，开始卸载；点击【取消】按钮，取消卸载。 6.1.3 正在卸载 此步骤用于显示卸载进度。 45 第 6 章 卸载 图 6.1.3: 正在卸载 6.1.4 完成卸载 对于初始化生成的文件或程序运行中生成的文件，卸载过程当中无法自动删除，请退出卸载程序后手动删除。 46 第 6 章 卸载 图 6.1.4: 完成卸载 6.2 命令行卸载 6.2.1 启动卸载 您打开 cmd 终端，进入 ${安装目录}\KESRealPro${V9}\Uninstall 目录，执行如下命令，启动卸载程序。 Uninstaller.exe -i console -DRESTART_NEEDED=NO 提示: -DRESTART_NEEDED=NO 属性表示卸载完不自动重启操作系统，如果不加此参数卸载完成后会重启操作 系统。 47 第 6 章 卸载 6.2.2 准备卸载 图 6.2.1: 准备卸载 输入 quit 再按 退出卸载过程；直接按 继续进行下一步。若无特殊说明，以下各步骤皆 与此相同。 6.2.3 正在卸载 此步骤用于显示卸载进度。卸载完成后窗口自动关闭。 图 6.2.2: 正在卸载 48 第 6 章 卸载 6.2.4 完成卸载 对于初始化生成的文件或程序运行中生成的文件，卸载过程当中无法自动删除，请退出卸载程序后手动删除。 6.3 静默卸载 您打开 cmd 终端，进入 ${安装目录}\KESRealPro\${V9}\Uninstall 目录，执行以下命令： Uninstaller.exe -i silent -DRESTART_NEEDED=NO 如果是通过静默安装方式安装的，可以不加-i 参数，否则必须附加-i 参数。 卸载过程没有提示信息，等待卸载过程完成即可。 49 第7章 增删组件 7 第 章 增删组件 本节将介绍如何基于图形化安装和命令行安装方式在 Windows 系统中增加或移除 KingbaseES 某些功能组件。 整体操作流程如下图所示。 图 7.1: 增删组件流程 • 图形化增删组件 • 命令行增删组件 50 第7章 7.1 图形化增删组件 7.1.1 增加组件 增删组件 对于选择客户端安装集或定制安装集的数据库，后续可根据需要增加其他未安装的功能组件。 7.1.1.1 启动 运行安装程序 KingbaseES_V009R001C001B0024_Win64_install.exe，以管理员身份运行。选择“修改存在的 实例”并选中安装目录，点击“确定”按钮。 图 7.1.1: 修改实例 51 第7章 7.1.1.2 增删组件 添加功能 图 7.1.2: 添加功能 选择【添加功能】选项，点击【下一步】。 点击【取消】按钮，可以退出，若无特殊说明，以下各步骤皆与此相同。 52 第7章 7.1.1.3 增删组件 确认 图 7.1.3: 确认 点击【下一步】按钮，继续安装；点击【取消】按钮，取消安装。 53 第7章 7.1.1.4 增删组件 选择功能组件 图 7.1.4: 选择功能组件 您可以选中需要添加的功能组件，置灰无法选择的组件是已经安装的组件。点击【下一步】按钮，继续安装。 54 第7章 7.1.1.5 增删组件 安装进度 图 7.1.5: 安装进度 此步骤用于显示安装进度。如果选择的组件包含数据库服务器，则后续会继续选择授权文件、初始化数据库步 骤。 55 第7章 7.1.1.6 增删组件 完成安装 图 7.1.6: 完成安装 若安装过程中没有出现任何警告或错误，将显示如下界面。单击【完成】退出安装程序。 7.1.2 删除组件 当需要删除数据库某项组件而非数据库系统时，可以通过数据库删除功能来进行维护。 7.1.2.1 启动 您可以通过两种方式进入删除组件的操作界面。 1. 在应用程序菜单中找到 KingbaseES 菜单项中“卸载”项，以管理员身份运行。 2. 运行执行 ${安装目录}\KESRealPro\${V9}\Uninstall\Uninstaller.exe，以管理员身份运行。 56 第7章 增删组件 图 7.1.7: 修改实例 57 第7章 7.1.2.2 增删组件 删除功能 图 7.1.8: 删除功能 您选择【删除功能】选项，点击【下一步】。点击【取消】按钮，可以退出卸载过程，若无特殊说明，以下各步 骤皆与此相同。 58 第7章 7.1.2.3 增删组件 确认 图 7.1.9: 确认 点击【下一步】按钮，继续卸载；点击【取消】按钮，取消卸载。 59 第7章 7.1.2.4 增删组件 选择功能组件 图 7.1.10: 选择功能组件 选择需要卸载的功能组件，取消其勾选状态；点击【卸载】按钮，开始卸载操作。 点击【取消】按钮，取消卸载。 60 第7章 7.1.2.5 增删组件 正在移除 图 7.1.11: 正在移除 此步骤用于显示卸载进度。 61 第7章 7.1.2.6 增删组件 卸载完成 图 7.1.12: 卸载完成 7.2 命令行增删组件 7.2.1 增加组件 对于选择客户端安装集或定制安装集的数据库，您后续可根据需要增加其他未安装的功能组件。 7.2.1.1 启动入口 命令行安装需要在 cmd 终端下操作。您首先要打开 cmd 终端，进入安装包（iso 文件）解压后目录，执行如下 命令： KingbaseES_V009R001C001B0024_Win64_install.exe -i console 命令执行后，将会启动安装程序。 62 第7章 增删组件 图 7.2.1: 实例管理 选择语言后进入实例管理部分。输入 2，选择“修改存在的实例”，按 。 继续选择已安装实例的安装目录，按 。 再输入 1，选择“添加功能”，按 继续添加功能的操作。 63 第7章 7.2.1.2 增删组件 选择功能组件 图 7.2.2: 选择功能组件 按照提示按 ，显示可以添加的组件列表。输入不需要安装的组件编号，多个编号用逗号隔开。按 开始安装。 注意: 这里选择的是不需要安装的组件。如果全部安装，则不需要输入，按回车键继续下一步。 64 第7章 7.2.1.3 增删组件 安装进度 图 7.2.3: 安装进度 此步骤用于显示安装进度。如果选择的组件包含数据库服务器，则后续会继续选择授权文件、初始化数据库步 骤。 65 第7章 7.2.1.4 增删组件 完成安装 图 7.2.4: 安装进度 若安装过程中没有出现任何警告或错误，安装完成后提示按 退出安装程序。 7.2.2 删除组件 当需要删除数据库某项组件而非数据库系统时，您可以通过数据库删除功能来进行维护。 7.2.2.1 启动入口 您首先要打开 cmd 终端，进入 ${安装目录}\KESRealPro\${V9}\Uninstall\，执行如下命令： Uninstaller.exe -i console 命令执行后，将会启动安装程序。 66 第7章 增删组件 图 7.2.5: 实例管理 选择语言后进入实例管理部分。输入 2，选择“修改存在的实例”，按 。 继续选择已安装实例的安装目录，按 。 再输入 2，选择“删除功能”，按 继续删除功能的操作。 67 第7章 7.2.2.2 增删组件 选择功能组件 图 7.2.6: 选择功能组件 显示已经安装的组件列表。输入需要删除的组件编号，多个编号用逗号隔开。按 开始删除。 68 第7章 7.2.2.3 增删组件 删除及完成 图 7.2.7: 正在移除 此步骤用于显示删除进度。删除完成后自动退出安装程序。 69 第 8 章 附录 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/V9 for linux or C:\\Program Files\\Kingbase\\ES\\ V9 for windows USER_INSTALL_DIR=C:\\Program Files\\Kingbase\\ES\\V9 #data dir path, for example /opt/Kingbase/ES/V9/data for linux or C:\\Program Files\\Kingbase\\ ES\\V9\\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 70 第 8 章 附录 #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：许可协议（英文） 71 第 8 章 附录 – 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 启动数据 库服务可以启动成功。 72 第 8 章 附录 8.3.2 初始化数据库失败 问题描述：输入数据库初始化参数后点击【下一步】，提示” 初始化数据库错误”。 解决方式： 1. 退出安装程序，到安装目录下的 Server\bin 目录下双击执行 initdb.exe，检查 Windows 系统是否提示” 找不到 MSVCR120.dll”。如果提示找不到 MSVCR120.dll，则是缺少 Microsoft Visual C++ 2013 运行库的原因。 2. 进入到目录下的 install\script 目录，双击执行 vcredist_x64.exe。安装成功后，可卸载后重新安装。 3. 参考《KingbaseES 服务器应用参考手册》initdb ，使用 initdb 命令行工具再次初始化数据库。 8.3.3 注册数据库服务失败 问题描述：输入数据库初始化参数后点击【下一步】，提示” 注册 KingbaseES 失败”。 解决方式： 1. 在任务管理器的服务界面检查是否存在 kingbase9_instance 服务。如果存在，则是之前安装过 KingbaseES，已经存在同名的服务。 2. 确定原 kingbase9_instance 服务是否继续使用。如果不再使用，可使用 sc delete kingbase9_instance 命令删除已存在服务实例。 3. 再通过 Server\bin 目录执行如下命令重新注册新的数据库服务。 sys_ctl.exe register -N "kingbase9_instance" -D ${data 目录} -S auto 工具命令使用参考《KingbaseES 服务器应用参考手册》sys_ctl 。服务名称可自定义为其他名称。 8.3.4 启动数据库服务失败 问题描述：输入数据库初始化参数后点击【下一步】，提示” 启动 KingbaseES 失败”。 解决方式： 1. 检查 license 文件是否和当前版本匹配。如果不匹配服务无法启动。 2. 检查数据库端口是否被占用。如果端口已被占用则服务无法启动。 3. 尝试通过 Server\bin 目录下 sys_ctl.exe 或 kingbase.exe 工具启动数据库。工具命令使用参考《KingbaseES 服 务器应用参考手册》kingbase 。执行命令过程中如果显示其他错误信息，则参考相关手册进行处理。 8.3.5 win server 2008 操作系统缺库 问题描述：windows server2008 安装 vc 运行库时报错，错误如下图： 73 第 8 章 附录 解决方式：检查操作系统版本是否是 SP1 版本。如果不是 SP1 版本，需要下载 SP1 补丁升级后可解决此问题。 74 版权声明 版权声明 北京人大金仓信息技术股份有限公司（简称：人大金仓）版权所有，并保留对本手册及本声明的一切权利。 未得到人大金仓的书面许可，任何人不得以任何方式或形式对本手册内的任何部分进行复制、摘录、备份、修 改、传播、翻译成其他语言、将其全部或部分用于商业用途。 免责声明 本手册内容依据现有信息制作，由于产品版本升级或其他原因，其内容有可能变更。人大金仓保留在没有任何通 知或者提示的情况下对手册内容进行修改的权利。 本手册仅作为使用指导，人大金仓在编写本手册时已尽力保证其内容准确可靠，但并不确保手册内容完全没有错 误或遗漏，本手册中的所有信息也不构成任何明示或暗示的担保。 技术支持 • 人大金仓官方网站：http://www.kingbase.com.cn/ • 人大金仓文档中心：http://help.kingbase.com.cn/ • 全国服务热线：400-601-1188 • 人大金仓技术支持与反馈信箱：support@kingbase.com.cn 75 服务周期承诺 服务周期承诺 由于市场需求在不断变化，技术创新和发展的进程不断加剧，产品的版本更迭不可避免。人大金仓对于产品版本 生命周期的有效管理，有助于您提前规划项目，更好地从产品服务终止上过渡。 表 1: KingbaseES 产品生命周期里程碑 关键里程碑点 定义 产品发布日期 产品正式发布版本，即 GA（general availability）版本的发布日期。 停止销售日期 正式停止销售的日期，版本停止接受订单日。该日之后，产品将不再销售。 停止功能升级日期 在该日期之后，不再提供新特性和新硬件支持。但依旧提供错误修复、安全修复、功 能维护等服务。 停止功能维护日期 在该日期之后，不再维护功能，修复问题。但依旧提供安全修复等服务 停止安全维护日期 在该日期之后，不再发布补丁版本修复中高风险漏洞，仅提供有限的支持。 产品服务终止日期 停止提供产品服务和支持的日期。包括软件维护版本，缺陷修复，以及针对该产品的 所有服务支持（包括服务热线和远程/现场支持）。 服务周期策略 金仓数据库管理系统 KingbaseES 产品确保以下的服务周期： 1）产品自发布之日起至产品停止功能升级（包含新特性、新硬件支持）之日不少于 5 年。 2）产品停止功能升级之日起至产品停止功能维护（主要包括问题修复）之日不少于 4 年。 3）产品功能维护停止之日起至产品停止安全维护（包括中高风险漏洞修复）之日不少于 2 年。 服务终止策略 金仓数据库管理系统 KingbaseES 产品确保在销售后，至少提供 6 年的服务支持。 注意: 人大金仓将会综合各方因素来确定产品服务终止日期。并将在实际产品服务终止日期之前至少 90 天，通过公 76 服务周期承诺 开方式宣布产品服务终止日期。 77