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, MANAGER, DTS, INTERFACE, DEPLOY CHOSEN_FEATURE_LIST=SERVER,MANAGER,DTS,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\DtsTools:数据库迁移工具,可以用于跨平台数据交换和迁移,支持同异构数据源之间的数据迁移。该目录下存放了迁移工具的相关程序和配置文件。
-
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服务器应用参考手册》第2章,使用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服务器应用参考手册》第6章。服务名称可自定义为其他名称。
8.3.4. 启动数据库服务失败
问题描述:输入数据库初始化参数后点击【下一步】,提示"启动KingbaseES失败"。
解决方式:
检查license文件是否和当前版本匹配。如果不匹配服务无法启动。
检查数据库端口是否被占用。如果端口已被占用则服务无法启动。
尝试通过Server\bin目录下sys_ctl.exe或kingbase.exe工具启动数据库。工具命令使用参考《KingbaseES服务器应用参考手册》第13章。执行命令过程中如果显示其他错误信息,则参考相关手册进行处理。