关键字：

KingbaseES、Java、Register、服务注册

一、安装前准备

1.1 软件环境要求

金仓数据库管理系统KingbaseES V8.0支持微软Windows 7、Windows XP、Windows 2003、 Windows 2008等32位及64位发行版本。

1.2 安装包准备

准备需要安装的金仓数据库管理系统KingbaseES安装程序和jdk1.8及以上的jdk环境。

1.3 注意事项

1.3.1 安装用户

在安装金仓数据库管理系统KingbaseES
V8.0时，安装用户对于安装路径需有“读”、“写”、“执行”的权限。Windows 10及以上的操作系统，需要使用管理员身份安装。

1.3.2 安装目录

金仓数据库管理系统KingbaseES安装过程中有默认的安装目录C:\Program Files\Kingbase\ES\V8。

二、注册数据库服务

数据库服务需要托管至服务开机自启动、监听服务等功能。

图2-1
数据库数据文件存储路径

图2-2
注册数据库服务失败界面

参数说明：

1） N: 指定注册的服务名，由管理员指定，不能与先前的服务名重名。

2） D: 数据库数据存储路径。

3） U: 注册服务的用户名

4） P: 注册服务用户的口令

三、分析注册失败原因

3.1 查看服务注册命令帮助

图3-1
服务注册帮助信息

3.2 分析报错信息“error code”

从图2-2获取错误代码“error code 1057”，查找《Windows Error Code(windows错误代码详解)》有关文档，获取到“error code 1057”的故障原因。如下图3-2所示，“error code 1057”的故障原因是“错误的账号或密码”

图3-2 Windows error code

3.3 确定故障原因

根据服务注册和错误代码的信息，可以判断，是在执行sys_ctl register注册时“-U”指定的用户名错误，在上一个案例中使用的是数据库的用户名，应该使用系统的用户名。如图3-3所示，通过系统用户administrator注册服务成功。

图3-3 服务注册成功界面

3.4 通过Windows事件查看器获取注册结果

图3-4 服务注册结果

四、总结

对于Windows环境操作，执行出现错误时，可以通过事件查看器获取相关的日志信息；如果查询不到相关的日志，可以通过“error code”，获取官方的错误代码对应的故障原因。

参考文档：

《[安装与升级]基于Windows系统的数据库软件安装指南》

《Windows Error
Code(windows错误代码详解)》

巴特西

KingbaseES 数据库Windows环境下注册失败分析