20250221_kingbase数据库单机安装手册(图形_命令行_静默)

数据库介绍

中电科金仓（北京）科技股份有限公司（以下简称“电科金仓”）成立于1999年，是成立最早的拥有自主知识产权的国产数据库企业，也是中国电子科技集团（CETC）成员企业。电科金仓以“提供卓越的数据库产品助力企业级应用高质量发展”为使命，致力于“成为世界卓越的数据库产品与服务提供商”。

电科金仓自成立起始终坚持自主创新，专注数据库领域二十余载，具备出色的数据库产品研发及服务能力，核心产品金仓数据库管理系统KingbaseES（简称“KES”）是面向全行业、全客户关键应用的企业级大型通用数据库。KES产品V9版本已通过国家权威机构认证，产品核心源代码自主率达到100%。2018年，电科金仓申报的“数据库管理系统核心技术的创新与金仓数据库产业化”项目荣获国家科学技术进步二等奖。金仓数据库管理系统KES于2022年入选国务院国资委发布的十项国有企业数字技术典型成果，再次彰显数据库领域国家队的实力。

金仓数据库管理系统[简称:KingbaseES]是北京人大金仓信息技术股份有限公司[简称人大金仓]的核心产品，具有大型通用、"三高"（高可靠、高性能、高安全）、"三易"（易管理、易使用、易扩展）、运行稳定等特点，是入选国家自主创新产品目录的数据库产品，也是国家级、省部级实际项目中应用最广泛的国产数据库产品。
复制

安装前准备

本文档使用vmware+centsos7.9,旨在使用图形界面、命令行、静默三种方式快速搭建KingbaseES V9.
软件及license下载：https://download.kingbase.com.cn/xzzx/index.htm

### 上传 数据库安装文件/OS安装文件/授权文件
1. mkdir -p /soft
[root@kingbase ~]# ls -ltr /soft
total 7271304
-rw-r--r--. 1 root root 4712300544 Feb 21 22:44 CentOS7.9.iso  <--yum安装java环境，否则图形界面不支持
-rw-r--r--. 1 root root 2733508608 Feb 21 22:44 KingbaseES_V009R001C002B0014_Lin64_install.iso
-rw-r--r--. 1 root root       3676 Feb 21 22:44 license_41248_0.dat
[root@kingbase ~]#

mv CentOS7.9.iso yum.iso
复制

环境变量配置

### 关闭防火墙及selinux
systemctl status firewalld
systemctl stop firewalld
systemctl disable firewalld
systemctl is-enabled firewalld
/bin/sed -i s/SELINUX=enforcing/SELINUX=disabled/ /etc/selinux/config
cat /etc/selinux/config|grep SELINUX=

### 修改sysctl.conf文件
cat >> /etc/sysctl.conf <<-EOF
fs.aio-max-nr= 1048576
fs.file-max= 6815744
kernel.shmall= $(expr `free |grep Mem|awk '{print $2 *1024}'` / `getconf PAGE_SIZE`)
kernel.shmmax= `free |grep Mem|awk '{print $2 *1024}'`
kernel.shmmni= 4096
kernel.sem= 250 32000 100 128
net.ipv4.ip_local_port_range= 9000 65500
net.core.rmem_default= 262144
net.core.rmem_max= 4194304
net.core.wmem_default= 262144
net.core.wmem_max= 1048576
EOF
sysctl -p


### 修改limits.conf文件
cat >> /etc/security/limits.conf <<-EOF
# *表示所有用户，可只设置root和kingbase用户
* soft nofile 65536
# 注意：设置nofile的hard limit不能大于/proc/sys/fs/nr_open，否则注销后将无法正常登陆
* hard nofile 65535
* soft nproc 65536
* hard nproc 65535
# unlimited表示无限制
* soft core unlimited
* hard core unlimited
EOF


### 关闭RemoveIPC
cat >> /etc/systemd/logind.conf <<-EOF
RemoveIPC=no
EOF
systemctl daemon-reload
systemctl restart systemd-logind.service

### 创建用户
/usr/sbin/useradd -m kingbase
/bin/echo "Abcd_1234" |/usr/bin/passwd --stdin kingbase


### 创建安装目录
mkdir -p /KingbaseES/V9 /data /backup /archive /install
ls -l / | grep -i kingbase

### 配置yum并安装java环境
mount -o loop /soft/yum.iso /mnt

mkdir -p /etc/yum.repos.d/bak
mv /etc/yum.repos.d/*.repo /etc/yum.repos.d/bak/
cat >> /etc/yum.repos.d/rhel-source.repo <<-EOF
[centos-lib]
name=centos
baseurl=file:///mnt
enabled=1
gpgcheck=0
EOF

yum -y install fontconfig java-1.8.0-openjdk
umount /mnt

### copy安装程序
mount -o loop /soft/KingbaseES_V009R001C002B0014_Lin64_install.iso /mnt

cp -R /mnt/* /install/
ll -l /install/
du -sm /install/
du -sm /mnt
umount /mnt


### 修改安装目录权限
chown -R kingbase:kingbase /KingbaseES
chown -R kingbase:kingbase /backup
chown -R kingbase:kingbase /archive
chown -R kingbase:kingbase /data
chown -R kingbase:kingbase /install
chmod -R 775 /KingbaseES
chmod -R 775 /backup
chmod -R 775 /archive
chmod -R 770 /data
chmod -R 775 /install
复制

图形化安装

su - kingbase

### 配置本地图形界面IP
export DISPLAY=192.168.1.2:0.0
export LANG=zh_CN.UTF-8

sh /install/setup.sh

复制

[root@kingbase ~]#  /KingbaseES/V9/install/script/root.sh
Starting KingbaseES V9:
waiting for server to start.... done
server started
KingbaseES V9 started successfully
[root@kingbase ~]#

cat >> /home/kingbase/.bash_profile <<-EOF
export PATH=/KingbaseES/V9/Server/bin:$PATH
export KINGBASE_DATA=/data
EOF
source /home/kingbase/.bash_profile

[kingbase@kingbase install]$ ksql -Usystem -d kingbase
用户 system 的口令：
输入 "help" 来获取帮助信息.

kingbase=# \l
                                  数据库列表
   名称    | 拥有者 | 字元编码 |  校对规则   |    Ctype    |     存取权限
-----------+--------+----------+-------------+-------------+-------------------
 kingbase  | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |
 security  | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |
 template0 | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | =c/system        +
           |        |          |             |             | system=CTc/system
 template1 | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | =c/system        +
           |        |          |             |             | system=CTc/system
 test      | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |
(5 行记录)

kingbase=#

复制

命令行安装

su - kingbase
sh /install/setup.sh -i console

[root@kingbase ~]# su - kingbase
[kingbase@kingbase ~]$ sh /install/setup.sh -i console
DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y
===============================================================================
Choose Install Set
------------------

Please choose the Install Set to be installed by this installer.

  ->1- Full
    2- Client

    3- Custom

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
   :

Use the Trial license if no license is selected.
Please replace the offical license before expiration.
File Path : /soft/license_41248_0.dat

===============================================================================
Choose Install Folder
---------------------

Please choose a destination folder for this installation.

Where would you like to install?

  Default Install Folder: /opt/Kingbase/ES/V9

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
      : /KingbaseES/V9

INSTALL FOLDER IS: /KingbaseES/V9
   IS THIS CORRECT? (Y/N): y

===============================================================================
Choose a Folder for data directory
----------------------------------

Please choose a folder. The folder must be empty.

Data folder (Default: /KingbaseES/V9/data): /data

===============================================================================
Installation Complete
---------------------

Congratulations. KingbaseES V9 has been successfully installed to:

/KingbaseES/V9

If you want to register KingbaseES V9 as OS service, please run

    /KingbaseES/V9/install/script/root.sh

PRESS <ENTER> TO EXIT THE INSTALLER:
Complete.
[kingbase@kingbase ~]$ exit
logout
[root@kingbase ~]# /KingbaseES/V9/install/script/root.sh
Starting KingbaseES V9:
waiting for server to start.... done
server started
KingbaseES V9 started successfully
[root@kingbase ~]# su - kingbase
Last login: Fri Feb 21 23:59:05 CST 2025 on pts/0

 
cat >> /home/kingbase/.bash_profile <<-EOF
export PATH=/KingbaseES/V9/Server/bin:$PATH
export KINGBASE_DATA=/data
EOF
source /home/kingbase/.bash_profile
[kingbase@kingbase ~]$ ksql -Usystem -d kingbase
Password for user system:
Type "help" for help.

kingbase=# \l
                               List of databases
   Name    | Owner  | Encoding |   Collate   |    Ctype    | Access privileges
-----------+--------+----------+-------------+-------------+-------------------
 kingbase  | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |
 security  | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |
 template0 | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | =c/system        +
           |        |          |             |             | system=CTc/system
 template1 | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 | =c/system        +
           |        |          |             |             | system=CTc/system
 test      | system | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |
(5 rows)

kingbase=# \q
[kingbase@kingbase ~]$

复制

静默安装

su - kingbase
cat >> /install/silent.cfg <<-EOF
KB_LICENSE_PATH=/soft/license_41248_0.dat
CHOSEN_INSTALL_SET=Full
CHOSEN_FEATURE_LIST=SERVER,KSTUDIO,KDTS,INTERFACE,DEPLOY,KINGBASEHA
USER_INSTALL_DIR=/KingbaseES/V9
USER_SELECTED_DATA_FOLDER=/data
DB_PORT=54321
DB_USER=system
DB_PASS=Abcd_1234
DB_PASS2=Abcd_1234
ENCODING_PARAM=UTF8
LOCALE_PARAM=zh_CN.UTF-8
INITCUSTOM=
DATABASE_MODE_PARAM=ORACLE
CASE_SENSITIVE_PARAM=YES
BLOCK_SIZE_PARAM=8k
AUTHENTICATION_METHOD_PARAM=scram-sha-256
EOF

/install/setup.sh -i silent -f /install/silent.cfg

[kingbase@kingbase install]$ /install/setup.sh -i silent -f /install/silent.cfg
Now launch installer...
Complete.
[kingbase@kingbase install]$


cat >> /home/kingbase/.bash_profile <<-EOF
export PATH=/KingbaseES/V9/Server/bin:$PATH
export KINGBASE_DATA=/data
EOF
[kingbase@kingbase ~]$ source /home/kingbase/.bash_profile
[kingbase@kingbase ~]$ ksql -Usystem -d kingbase

复制

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

数据库启停命令

systemctl status kingbased.service
systemctl stop kingbased.service
systemctl start kingbased.service
systemctl restart kingbased.service

sys_ctl status -D /data
sys_ctl stop -D /data
sys_ctl start -D /data
sys_ctl restart -D /data
sys_ctl status -D /data
复制

常见问题

kingbase数据库安装时，图形界面无法打开 <–建议官方文档添加，安装必要的安装包步骤

yum -y install fontconfig java-1.8.0-openjdk，安装后可以正常打开图形界面。
Kingbase 安装程序依赖于 Java 环境。如果 Java 环境配置不正确，可能会导致安装失败。请确保：
系统中已安装正确版本的 Java（通常需要 JDK 或 JRE 1.8 或更高版本）。
可以通过以下命令检查 Java 版本：
bash
复制
java -version
如果未安装 Java，可以通过以下命令安装：
CentOS/RHEL：
bash
复制
sudo yum install java-1.8.0-openjdk
Ubuntu/Debian：
bash
复制
sudo apt-get install openjdk-8-jdk
复制

静默安装后不提示运行root.sh文件 <–建议静默安装完成后，添加必要的提示。

/KingbaseES/V9/install/script/root.sh
这个文件是存在的，静默安装过程及log日志都没有提示，与图形和命令行安装行为不一致，建议提示下。
复制

数据库安装完成后，systemctl无法管理数据库

使用sys_ctl命令关闭数据库后，使用systemctl重启数据库，systemctl按管后正常。
复制

参考文档

https://bbs.kingbase.com.cn/docHtml?recId=d16e9a1be637c8fe4644c2c82fe16444&url=aHR0cHM6Ly9iYnMua2luZ2Jhc2UuY29tLmNuL2tpbmdiYXNlLWRvYy92OS9pbnN0YWxsLXVwZGF0YS9pbnN0YWxsLWxpbnV4L2luZGV4Lmh0bWw
复制

【金仓社区福利】🎉 免费KCA考试培训机会来了！

https://bbs.kingbase.com.cn/forumDetail?articleId=936a6989e957696ed2b03be22029e0b8

注册推荐人：xidoublestar