Vastbase 3.0 数据库安装完全指南

对于数据库入门学习而言，数据库安装往往是第一道门槛。在过往授课中，赵老师接触频次最高的问题始终绕不开安装环节的卡壳：或是系统版本不匹配，或是配置疏漏，或是命令输入细节出错。让初学者原本高涨的学习热情骤然降温。

基于众多学员这一常见痛点，本文立足零基础视角，摒弃复杂晦涩的专业术语，手把手带着大家完成Vastbase数据库的安装部署。从硬件规划到安装验证，帮助初学者成功跨过数据库学习的第一道难关。

一、硬件与操作系统要求

1. 1 确认安装要求

安装 Vastbase 之前，首先需要确认硬件与操作系统是否满足安装要求。根据Vastbase官方文档，硬件和操作系统要求如下：

硬件适配列表

目前Vastbase支持X86（包括海光C86）、龙芯、鲲鹏920、飞腾S2500、飞腾D2000、飞腾5000C、飞腾2000+等不同架构的硬件。

硬件最低要求

硬件项目	要求
内存	单机4G+，主从8G+
CPU	2核以上
存储	800MB软件+750MB元数据
网络	千兆以上

操作系统要求

从Vastbase 2.2 Build 15 (Patch No.8)版本开始海量数据提供通用打穿包，针对不同CPU架构进行适配。这意味不再区分操作系统，只要硬件满足要求即可。为了确保操作系统与数据库之间良好适配，建议使用CentOS、Redhat、openEuler、Kylin、UOS等常见的操作系统。

演示环境说明

本文演示环境配置如下：

CPU：Intel X86_64 i7-11700 @ 2.50GHz

内存：16GB

操作系统：openEuler 22.03 SP3

主机名：oevb1501

1. 2 检查硬件

正式安装之前建议对cpu、内存、网络、存储空间进行仔细检查，确保各项都符合安装要求。

1. 检查cpu可以使用lscpu、cat /proc/cpuinfo等命令：

[root@oevb1501 ~]# cat /proc/cpuinfo | grep "model name"model name      : 11th Gen Intel(R) Core(TM) i7-11700 @ 2.50GHzmodel name      : 11th Gen Intel(R) Core(TM) i7-11700 @ 2.50GHz

2. 检查内存可使用free、cat /proc/meminfo等命令：

[root@oevb1501 ~]# free -m               total        used        free      shared  buff/cache   availableMem:           15487         403       15160           8         180       15083Swap:          16382           0       16382

3. 使用ifconfig命令检查网卡，确认IP地址已经正确配置：

[root@oevb1501 ~]# ifconfigenp0s3: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500        inet 192.168.1.105  netmask 255.255.255.0  broadcast 192.168.1.255        inet6 fe80::a00:27ff:fedf:9ea4  prefixlen 64  scopeid 0x20<link>        ether 08:00:27:df:9e:a4  txqueuelen 1000  (Ethernet)        RX packets 1792346  bytes 2002392295 (1.8 GiB)        RX errors 0  dropped 162  overruns 0  frame 0        TX packets 709907  bytes 52778565 (50.3 MiB)        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

4. 检查是否有足够的存储空间，使用df命令检查

[root@oevb1501 ~]# df -hFilesystem      Size  Used Avail Use% Mounted ondevtmpfs        4.0M     0  4.0M   0% /devtmpfs           3.7G   12K  3.7G   1% /dev/shmtmpfs           1.5G   57M  1.4G   4% /runtmpfs           4.0M     0  4.0M   0% /sys/fs/cgroup/dev/sda1        50G  3.5G   47G   7% /tmpfs           3.7G     0  3.7G   0% /tmp/dev/sdc1       100G  2.4G   98G   3% /vastdata/app/dev/sdd1       100G  2.5G   98G   3% /vastdata/data

1. 3 检查操作系统

操作系统不同，检查命令也有所不同。一般可以使用cat /etc/os-release命令：

[root@oevb1501 ~]# cat /etc/os-releaseNAME="openEuler"VERSION="22.03 (LTS-SP3)"ID="openEuler"VERSION_ID="22.03"PRETTY_NAME="openEuler 22.03 (LTS-SP3)"ANSI_COLOR="0;31"

从上面的输出可知当前操作系统为openEuler，版本为22.03 SP3。麒麟操作系统可以使用nkvers命令查看其版本号。

二、安装前系统配置（必选）

2.1 关闭系统防火墙

为确保 Vastbase 正常使用，需禁用防火墙或将数据库端口加入白名单，使用root用户依次执行下面的命令关闭并禁用防火墙：

[root@oevb1501 ~]# systemctl stop firewalld.service[root@oevb1501 ~]# systemctl disable firewalld.service

2. 2 禁用 SELinux

修改配置文件 /etc/selinux/config，将 SELINUX=enforcing 改为SELINUX=disabled并重启生效：

# This file controls the state of SELinux on the system.# SELINUX= can take one of these three values:#     enforcing - SELinux security policy is enforced.#     permissive - SELinux prints warnings instead of enforcing.#     disabled - No SELinux policy is loaded.SELINUX=disabled# SELINUXTYPE= can take one of these three values:#     targeted - Targeted processes are protected,#     minimum - Modification of targeted policy. Only selected processes are protected.#     mls - Multi Level Security protection.SELINUXTYPE=targeted

注：selinux可以使用root用户执行setenforce 0临时禁用，也可以临时禁用安装完成后再安排重启。

2.3 关闭 RemoveIPC

从 Linux 7.2 开始，systemd-logind 服务会在用户完全退出后 remove 所有 IPC 对象，这会导致数据库实例crash，建议在安装前将其关闭。步骤如下：

1. 修改配置文件/etc/systemd/logind.conf，在其尾部添加RemoveIPC=no。

2. 修改配置文件/usr/lib/systemd/system/systemd-logind.service，在其尾部添加RemoveIPC=no。

3. 使用root用户依次执行下面的命令：

[root@oevb1501 ~]# systemctl daemon-reload [root@oevb1501 ~]# systemctl restart systemd-logind

2.4 调整内核参数

1. 参数介绍

安装之前需要对操作系统内核参数进行调整，本文不作为性能调优的推荐方案，仅为满足安装要求，建议调整参数如下：

分类	参数	推荐值
文件系统	fs.aio-max-nr	1048576
fs.file-max	76724600
信号量	`kernel.sem`	`4096 2097152000 4096 512000`
共享内存	kernel.shmall	4194304
kernel.shmmax	8589934592
kernel.shmmni	1024

💡 tips

kernel.shmall用于设置系统范围内共享内存段的总大小，是所有共享内存段相加的上限。单位为page，一般Linux操作系统一个page的大小为4K。一般推荐为总内存的80%。
kernel.shmmax用于设置系统范围内最大的共享内存段的上限，单位为字节。一般推荐为总内存的50%。
kernel.shmmni用于设置系统范围内共享内存段的总个数。保持默认即可。

2. 修改参数

以root用户身份创建新的配置文件/etc/sysctl.d/98-vastbase-sysctl.conf,内容如下：

fs.file-max = 76724600fs.aio-max-nr = 1048576kernel.sem = 4096 2097152000 4096 512000kernel.shmmax = 8589934592kernel.shmall = 4194304

然后执行sysctl --system使新修改的参数生效。

💡 tips

修改内核参数常见的两种方式：

修改配置文件/etc/sysctl.conf，执行sysctl -p生效。
自定义配置文件/etc/sysctl.d/xx-yy-sysctl.conf，执行sysctl --system生效。

2.5 安装必要依赖包

通用环境安装 Vastbase 数据库的基础依赖包如下：

zlib-devel、libaio、libuuid、readline-devel、krb5-libs、libicu、libxslt、tcl、perl、openldap、pam、openssl-devel、libxml2、bzip2

麒麟环境安装 Vastbase 数据库的基础依赖包如下：

readline、python2、libicu、cracklib、libxslt、tcl、perl、openldap、pam、systemd-libs、bzip2、gettext、libaio、ncurses-libs

以openEuler为例，可以使用下面的命令检查缺失的依赖包：

rpm -q --qf '%{NAME}-%{VERSION}-%{RELEASE} (%{ARCH})\n' zlib-devel \libaio \libuuid \readline-devel \krb5-libs \libicu \libxslt \tcl \perl \openldap \pam \openssl-devel \libaio-devel \bzip2 \libxml2 |grep "not installed"

如有缺失，配置好yum源后进行安装，以libaio-devel为例,安装命令如下：

[root@oevb1501 ~]# yum -y install libaio-devel

三、安装规划

3.1 用户与组

安装前需要为Vastbase创建单独的用户组和用户，为了后期维护方便推荐组和用户都以vastbase命名：

[root@oevb1501 ~]# groupadd vastbase[root@oevb1501 ~]# useradd -m -g vastbase vastbase

3.2 目录规划

默认情况下，Vastbase软件将被安装在/home/vastbase/local/vastbase

下，数据库将创建于/home/vastbase/data/vastbase目录下。建议为Vastbase软件和数据库规划单独的目录。

创建软件目录：

[root@oevb1501 ~]# mkdir -p /vastdata/app/vastbase/3.0.9

创建数据库目录：

[root@oevb1501 ~]# mkdir -p /vastdata/data/vastbase

将以上两个目录的用户和属组修改为vastbase:vastbase:

[root@oevb1501 ~]# chown -R vastbase:vastbase /vastdata/app[root@oevb1501 ~]# chown -R vastbase:vastbase /vastdata/data

四、安装 Vastbase

4.1 解压软件包

将软件包上传至服务器，登录vastbase用户，使用tar命令解压缩：

[root@oevb1501 ~]# su - vastbase[vastbase@oevb1501 ~]$ cd /vastdata/disks[vastbase@oevb1501 disks]$ tar -xzvf Vastbase-G100-3.0_Build9_31338-Linux-x86_64-no_mot-202603311153.tar.gzvastbase-installer/vastbase-installer/vastbase_installervastbase-installer/locales/vastbase-installer/locales/messages.en-US.jsonvastbase-installer/locales/messages.zh-CN.jsonvastbase-installer/Vastbase-G100-3.0_Build9_31338-Linux-x86_64-no_mot.tar.gzvastbase-installer/.checksum

解压后将生成一个新的目录vastbase-installer，安装程序位于其中。

4.2 执行安装

使用vastbase用户进入vastbase-installer，执行vastbase_installer，开始安装：

[vastbase@oevb1501 disks]$ cd vastbase-installer[vastbase@oevb1501 vastbase-installer]$ ./vastbase_installer

4.3 关键步骤说明

1. Dependency check阶段，安装程序会检查缺失的软件包，如果缺失了必须的软件包安装程序会跳出，按2.5节介绍的方法安装完后重启安装即可。

Dependency check---------------  readline : 8.1    libicu : 72.1  cracklib : 2.9.8   libxslt : 1.1.37       tcl : 8.6.12      perl : 5.34.0  openldap : 2.6.0       pam : 1.5.2systemd-libs : 249     bzip2 : 1.0.8   gettext : 0.21.1    libaio : 0.3.113ncurses-libs : 6.3   python2 : lineType <Enter> to continue:

2. IPC parameter check阶段，如果没有提前禁用RemoveIPC，会提示下面的告警：

IPC parameter check---------------The IPC parameter check is complete===============================================================================WARNING: The SELinux module of the current machine is enabled, which may cause subsequent database running errors due to permission issues. You are advised to disable SELinux         You can run the following command as user root to temporarily or permanently change the password: -------> 1.Temporary change: setenforce 0-------> 2.Permanent modification: Modify the /etc/selinux/config file and change "SELINUX=enforcing" to "SELINUX=disabled"(restart the machine to take effect)

按提示，可以执行setenforce 0临时禁用，然后忽略告警继续安装。

3. 是否在安装过程中初始化实例（也就是创建数据库），输入Y继续：

Install database---------------Whether to instantiate the database (Y/N):

4. 安装方式，保持默认1-Typical installation继续：

Select installation typeTypical installation    : Use default parameters to init databaseCustom installation  : Configure installation parameters and functions manually  -> 1- Typical installation     2- Custom installationSelect the installation type, or type <Enter> to select the default (1):

5. 为初始用户设置密码，然后继续：

Database Initialization User Password (Press the backspace key to go back)---------------Enter the password of database initialization user (vastbase): *************Please enter your password again: *************

6. 接下来根据提示，输入规划好的安装路径，然后继续：

Vastbase installation directory---------------Vastbase installation directory Default location: /home/vastbase/local/vastbaseType the absolute path (ctrl+ backspace to backspace), or type <Enter> to use the default path :/vastdata/app/vastdata/3.0.9===============================================================================Database initialization directory---------------Select the database initialization directory Default location: /home/vastbase/data/vastbaseType the absolute path (ctrl+ backspace to backspace), or type <Enter> to use the default path :/vastdata/data/vastbase

7. 选择数据库兼容模式，Vastbase支持Oracle（A）、MySQL（B）、SQL Server（MSSQL）、PostgreSQL（PG）等兼容模式，默认为Oracle。请根据自己的使用选择：

Database compatibility mode---------------Specify the database compatibility mode (A|B|PG|MSSQL)Default compatibility:AType compatibility above or <Enter> to use the default value

8. 接下来是一个安装摘要，确认无误后回车开始安装：

Installation summary---------------Vastbase installation directory:    /vastdata/app/vastdata/3.0.9Vastbase directory:    /vastdata/data/vastbaseDatabase initialization user :    vastbaseDatabase initialization parameter :   listen_addresses='*'   max_connections=500   shared_buffers=1858MB   max_process_memory=4944MB   work_mem=4MBType <Enter> to continue:

9. 安装完成后，会出现加载授权文件的提示，如果没有授权文件可以输入N回车：

Loading an Official license---------------Whether to load an official license (Y/N): N

⚠️ 注意：

Vastbase默认自带三个月的试用授权，不加载授权文件也可以使用三个月。但如果商用请务必获得正式授权。

10. 最后根据界面提示：

To initialize the database running environment:    source ~/.bashrcTo start, stop, and restart the database:    vb_ctl <start/stop/restart>

先执行source ~/.bashrc初始化环境变量，然后执行vb_ctl start启动数据库：

[vastbase@oevb1501 ~]$ source ~/.bashrc[vastbase@oevb1501 ~]$ vb_ctl start[2026-06-12 13:40:50.064][2650693][][vb_ctl]: vb_ctl started,datadir is /vastdata/data/vastbase [2026-06-12 13:40:50.122][2650693][][vb_ctl]: waiting for server to start................[2026-06-12 13:40:51.129][2650693][][vb_ctl]:  done[2026-06-12 13:40:51.129][2650693][][vb_ctl]: server started (/vastdata/data/vastbase)

启动成功，至此整个安装过程结束。

如果没有看到done和server started字样，说明启动失败。请详细阅读启动日志，并尝试解决问题。常问题问题及解决方案见第六节。

五、登录与验证

使用 vsql 客户端连接数据库：

[vastbase@oevb1501 ~]$ vsql -r -d vastbasevsql ((Vastbase G100 V3.0 (Build 9) Release) compiled at 2026-03-31 11:59:25 commit 31338 last mr  )Non-SSL connection (SSL connection is recommended when requiring high-security)Type "help" for help.vastbase=#

出现上面的提示符，说明安装登录成功。

2. 查询当前版本：

vastbase=# select vb_version();                                           vb_version                                           ------------------------------------------------------------------------------------------------ (Vastbase G100 V3.0 (Build 9) Release) compiled at 2026-03-31 11:59:25 commit 31338 last mr   +  product name:Vastbase G100                                                                   +  version:V3.0 (Build 9) Release                                                               +  patch:1                                                                                      +  commit:31338                                                                                 +  openGauss version:6.0.0                                                                      +  host:x86_64-pc-linux-gnu                                                                     +  support module:BASIC, VECTOR(1 row)

✅ 成功标志

恭喜！Vastbase 数据库安装完成且功能正常，已可正常使用了。

六、常见问题排查

1. 安装成功后，数据库启动失败，报错如下：

2026-06-12 13:39:32.058 [unknown] [unknown] localhost 140696288820608 0[0:0#0]  0 [BACKEND] FATAL:  the values of memory out of limit, the database failed to be started, max_process_memory (4944MB) must greater than 2GB + cstore_buffers(512MB) + (udf_memory_limit(200MB) - UDF_DEFAULT_MEMORY(200MB)) + shared_buffers(1858MB) + preserved memory(3737MB) = 8155MB, reduce the value of shared_buffers, max_pred_locks_per_transaction, max_connection, wal_buffers..etc will help reduce the size of preserved memory2026-06-12 13:39:32.100 [unknown] [unknown] localhost 140696288820608 0[0:0#0]  0 [BACKEND] LOG:  FiniNuma allocIndex: 0.

当主机内存小于16G时这个问题较为常见。这是因为系统内存不足，满足不了数据库默认参数的启动要求。根据提示数据库参数max_process_memory当前值是4944，该参数的值需要大于：2GB + cstore_buffers(512MB) + (udf_memory_limit(200MB) - UDF_DEFAULT_MEMORY(200MB)) + shared_buffers(1858MB) + preserved memory(3737MB) = 8155MB。

一方面可以适当增加max_process_memory的值，另一方面可能调低shared_buffers、max_connection、wal_buffers、cstore_buffers等参数，减少总需求。特别地针对8G内存的配置，编辑参数文件/vastdata/data/vastbase/postgresql.conf，修改(手工编辑)参数如下：

max_process_memory = 6144MBcstore_buffers = 16MBshared_buffers = 512MBwal_buffers = 64MBmax_connection = 200

然后再次启动。

📋 结束语

数据库的安装没有想象中那么复杂。Vastbase 提供的 vastbase_installer 安装程序，通过交互式引导大幅降低了安装门槛。关键在于：安装前的系统配置一定要做到位，这是所有踩坑的根源。按照本文的步骤操作，一台全新的 Linux 服务器，一个小时内可以跑通第一条 SQL。

后续我们将在本号持续更新Vastbase数据库相关文章，带领初学者一步步全面掌握相关技能。敬请关注。