金仓数据库KingbaseES V8R6静默安装、卸载方法及常见问题

关键字：

KingbaseES、静默安装、安装配置

内容正文

1.静默安装介绍

静默安装、卸载是Kingbase安装程序提供的一种能力，不需要人机交互过程，以配置文件的方式提供安装过程中需要的参数值，通过执行安装命令完成安装过程和卸载过程，全程不需要人员干预。

静默安装需要的参数：在执行安装程序时，-i silent是指定使用静默安装方式安装，-f是指定配置文件路径（需要绝对路径）；例：./setup.sh –i silent –f /home/kingbase/installer.properties

2.静默安装准备

   （1）准备与当前硬件平台相匹配的KingbaseES V8R6通用机安装包（iso格式）

   （2）准备静默安装配置文件installer.properties（文本文件），配置文件内容说明如下（完整配置文件见附录）：

#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=（license文件绝对路径 Linux如：/home/kingbase/license_1309_0-sales.dat   windows如：C:\\license_1309_0-sales.dat 注意windows平台分隔符为两个反斜杠）

#install set, options are Full, Client, Custom

CHOSEN_INSTALL_SET=（安装集 支持Full完全安装，Client客户端安装，Custom定制安装。完全安装包含全部组件；客户端安装不包含服务器也不会初始化data，不需要认证license文件；定制安装可以自定义安装组件，具体组件介绍见下一个参数）

#component list, options are SERVER, MANAGER, DTS, INTERFACE, DEPLOY，KINGBASEHA

CHOSEN_FEATURE_LIST=SERVER,MANAGER,DTS,INTERFACE,DEPLOY,KINGBASEHA

(当安装集选择为定制安装时，组件选择参数才生效，组件包含Server（服务器）、MANAGER（对象管理工具）、DTS（数据迁移工具）、INTERFACE（接口）、DEPLOY（集群部署工具）、KINGBASEHA（高可用组件）；其中KINGBASEHA组件仅Linux平台有)

#install dir path, for example /home/kingbase/es/v8 for linux or C:\\Program Files\\Kingbase\\ES\\V8 for linux

USER_INSTALL_DIR=（安装目录绝对路径 必须指定，否则安装失败。Windows系统路径分隔符使用“\\”,Linux系统路径分隔符使用“/”.）

#data dir path, for example /home/kingbase/es/v8/data for linux or C:\\Program Files\\Kingbase\\ES\\V8\\data for windows

USER_SELECTED_DATA_FOLDER=（数据目录绝对路径，必须为空目录，否则报错退出安装程序。如果不指定数据目录，完成正常安装后不执行初始化数据库过程。Windows系统路径分隔符使用“\\”,Linux系统路径分隔符使用“/”.）

#init db params

#server port, requied, between 1 and 65535

DB_PORT=54321（数据库服务端口，必填，否则初始化失败。端口取值范围为1-65535，超过范围初始化失败。默认54321）

#user name, required, length less than 63 bytes

DB_USER=system（数据库超级用户用户名，必填，否则初始化失败。用户名长度不超过63字节。默认system）

#password, required

DB_PASS=（数据库初始密码，必填，否则初始化失败）

#password confirm, required

DB_PASS2=（数据库初始密码，必填，需要和DB_PASS，否则初始化失败）

#encoding, required, options are UTF8, GBK, GB18030

ENCODING_PARAM=GBK（数据库编码格式，必填，必须大写，否则初始化失败。可选值UTF8、GBK、GB18030。Linux平台默认UTF8，Windows平台默认GBK）

#compatibility mode, required, options are ORACLE, PG

DATABASE_MODE_PARAM=ORACLE（数据库兼容模式，必填，必须大写，否则初始化失败，可选值ORACLE、PG。默认ORACLE模式）

#case sensitivity, required, options are YES, NO

CASE_SENSITIVE_PARAM=YES（数据库是否区分大小写，必填，必须大写，否则初始化失败，可选值YES、NO，默认YES。）

#block size, required, options are 8k, 16k, 32k

BLOCK_SIZE_PARAM=8k（数据库存储块大小，必填，k必须小写，可选值8k、16k、32k。默认8k。）

#uninstall whether restart

RESTART_NEEDED=NO（重启选项，必须大写。仅Windows平台生效，非必填选项，可选值YES、NO，默认NO）

3.静默安装

       （1）Linux平台静默安装

              （a）手动创建配置文件installer.propities，将配置文件内容复制到installer.propities中，自定义配置文件中各配置参数。

        （b）挂载Kingbase安装包，执行安装程序 如挂载目录为mnt,配置文件路径为/home/kingbase/installer.properties.则执行./mnt/setup.sh –i silent –f  /home/kingbase/installer.properties等待安装完成。

              （c）安装程序退出之后，可以在执行安装脚本的终端或命令行中执行如下命令以查看退出码   echo $?   

若退出码为 0，表示“安装成功，没有任何错误和警告”；

若退出码为 1，表示“安装成功，出现警告或非致命错误”

              （d）若安装失败可以查看安装目录下KESrealPro/版本号/install/Logs下安装日志中报错信息

       （2）Windows平台静默安装

              （a）手动创建配置文件installer.propities或使用默认配置文件（默认配置文件位于安装包内），若手动创建配置文件则将配置文件内容复制到installer.propities中，自定义配置文件中各配置参数；若使用默认配置文件则直接修改配置文件中各参数即可。         

            （b）解压安装包，若使用手动创建的配置文件，则在安装程序目录打开cmd窗口，执行KINGBASE.exe –i silent –f D:\kingbase\installer.propities ； 若使用默认配置文件，则可以直接在cmd窗口执行KINGBASE.exe –i silent 。等待安装完成

             （c）若安装失败可以查看安装目录下KESrealPro/版本号/install/Logs下安装日志中报错信息

4.静默卸载

       不论以何种安装方式安装的Kingbase，都可以使用静默卸载，过程不需要人工干预。

       使用方法：在安装目录下执行./Uninstall/Uninstaller –i silent.等待卸载完成即可。卸载日志在安装目录下KESrealPro/版本号/install/Logs下

5.静默安装常见问题

       （1）问题描述：Kingbase安装失败

               问题分析：具体原因查看安装日志中报错信息，常见情况有安装目录配置为无权限的目录、data目录配置为无权限的目录或data目录不为空等。

               解决方案：修改配置文件中报错的参数为为符合规则的参数后重新安装。规则见2节中配置文件说明。

       （2）问题描述：Kingbase安装成功，但未初始化data

               问题分析：具体原因查看安装日志中报错信息，常见情况有数据库端口配置错误、数据库用户名配置错误、数据库密码配置错误、编码格式配置错误、数据库模式、大小写敏感配置错误、存储块大小配置错误

               解决方案：可以手动初始化（使用initdb工具）一个data，与安装时初始化无差异。

附录：KingbaseV8R6静默安装标准模板

# Mon Jan 10 11:06:56 CST 2022
# Replay feature output
# ---------------------
# This file was built by the Replay feature of InstallAnywhere.
# It contains variables that were set by Panels, Consoles or Custom Code.

#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,KINGBASEHA
CHOSEN_FEATURE_LIST=SERVER,MANAGER,DTS,INTERFACE,DEPLOY,KINGBASEHA

#install dir path, for example /opt/Kingbase/ES/V8 for linux or C:\\Program Files\\Kingbase\\ES\\V8 for windows
USER_INSTALL_DIR=

#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=UTF8
#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