VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

静默安装

静默安装简化了字符安装,省去了程序与用户的交互过程。用户可预先将安装参数配置到参数文件db_install.rsp中,并指定参数文件的路径,则在安装时程序自动读取文件以获取安装参数,完成数据库安装。

安装步骤

前置条件 参见系统和环境配置安装前准备完成准备工作。

步骤1 以root用户登录操作系统。

步骤2 创建目录(/soft/vb),解压安装包,以root用户赋予数据库安装用户vastbase操作的权限。

  • 将获取的安装包(本安装以Vastbase-G100-installer-2.2_Build_10-12635-centos_7-x86_64-2023**.tar.gz为例,实际安装以获取安装包名称为准)和license文件上传到/soft/vb(路径可自定义,本安装步骤以/soft/vb为例)。

  • 将root用户对soft目录的权限至少设置为755,否则切换到其他用户后,无法访问soft目录。

mkdir -p /soft/vb
cd /soft/vb
tar -xvf Vastbase-G100-installer-2.2_Build_5.39-centos_7-x86_64-2021**.tar.gz
chown -R vastbase:vastbase /soft/vb/
chmod -R 775 /soft/vb/

步骤3 新增并编辑静默安装参数文件。

  • 参数文件所在路径可自定义,本文以参数文件路径取/soft/vb/、进行实例化安装为例。用户需根据实际安装情况修改参数文件取值。

  • 静默安装参数文件中各参数说明参见参数文件说明

  • 注意参数文件的末尾不能有空行。

  • 参数文件名必须为db_install.rsp。

cd /soft/vb/
vi db_install.rsp

vastbase_password=Aa123456
encryption_key=Aa123456
vastbase_home=/home/vastbase/local/vbinstall
vastbase_data=/home/vastbase/data/vbinstall
port=15432
max_connections=100
shared_buffers=200
db_compatibility=A
isinitdb=true

步骤4 切换到数据库安装用户vastbase。

su - vastbase

步骤5 执行安装程序,程序流程参见安装过程

cd /soft/vb/vastbase-installer/
./vastbase_installer --silent -responseFile /soft/vb/db_install.rsp
  • ./vastbase_installer后不指定参数时,即默认为交互式安装,用户可选择在交互过程中选择实例化数据库安装非实例化数据库安装

  • ./vastbase_installer后指定参数时,可指定卸载数据库、静默安装。

  • 若指定了--silent,则必须通过-responseFile指定静默安装的参数文件,且必须是绝对路径。

  • 执行./vastbase_installer --help可以得知如下参数说明:

    无参数        : 默认安装数据库(手动交互式)
    --uninstall   : 卸载数据库(不可与其他参数同时使用)
    --silent      : 静默安装数据库
    -responseFile : 指定静默安装的参数文件,与静默安装一起使用, 参数后需紧跟参数文件的完整路径
    

步骤6 初始化数据库运行环境

1、以vastbase用户登录操作系统。

2、执行如下命令初始化数据库。

source ~/.bashrc

步骤7 (可选)初始化数据库,非实例化安装(即isinitdb=false)时需要进行本步骤。

vb_initdb -D /home/vastbase/data/vastbase --nodename vastbase -w vbase@123
  • -D指定数据目录,后跟的/home/vastbase/data/vastbase为数据库目录,可自定义,需存在且在vastbase用户下,需要0700权限。

  • --nodename指定初始化的节点名称。

  • -w指定管理员用户的密码。

提示如下信息,表示正确。

安装数据库过程会生成随机口令作为管理员初始口令,示例显示信息如下:

当用户首次登录数据库执行sql命令时系统会强制要求修改用户密码,修改方法如下:

ALTER ROLE vastbase IDENTIFIED BY 'Mypwd123' REPLACE 'XuanYuan@2012';

步骤8 (可选)将license路径写入postgresql.conf配置文件,以确定license文件的位置(license文件路径为绝对路径,且需要指定到文件名级别,可自定义路径,但需要确保vastbase用户对license文件目录有读权限)。

echo "license_path='/soft/vb/vastbase_license' " >> /home/vastbase/data/postgresql.conf

数据库安装后会自动生成临时许可文件,当没有license文件时,可直接启动数据库。临时许可文件有效期90天。

步骤9 (可选)如数据库版本号 ≥ V2.2 Build 5(Patch No.75)且 < V2.2 Build 11,则建议执行如下命令,使普通用户首次登录或连接不强制要求修改密码。

echo "password_force_alter= off" >> $PGDATA/postgresql.conf

步骤10 设置Core_Pattern

为记录数据库异常停机信息,执行如下命令设定Core_pattern路径为Vastbase组用户可写的路径。

1、以root用户登录操作系统。

2、执行如下操作完成设置。

echo "/home/vastbase/data/vdb_coredump/core-%e-%p-%t" > /proc/sys/kernel/core_pattern
  • 本语句中/home/vastbase/data/vdb_coredump/目录为用户手动创建的coredump目录。

  • 若用户未提前创建coredump目录,则系统创建的默认coredump目录为/omTmp/corefile/,此时需要进行如下配置:

    echo "/omTmp/corefile/core-%e-%p-%t" > /proc/sys/kernel/core_pattern
    

安装过程

在安装过程中,包括如下流程:

1、程序检查安装包完整性。

2、检查静默安装参数是否正确,当参数取值不正确或不属于允许修改的参数时,程序会做出相应提醒。

3、显示系统配置信息、依赖检查结果和安装环境准备结果。

4、检查IPC参数、CPU指令。

5、安装数据库并检查磁盘IO调度算法。(本图片结果以实例化安装的数据目录为例,若为非实例化安装则无磁盘IO调度算法检查这一步骤)

6、显示安装概要信息。

7、安装完成。(本图片以实例化安装结果为例)

参数文件说明

  • 参数文件名必须为db_install.rsp。

  • 参数配置文件格式以步骤4配置示例为准,若格式不对,则将出现报错并退出静默安装。

  • 以下列出了静默安装支持修改的参数,如果用户在参数文件中配置了其他参数,为无效值。

  • vastbase_password

    指定实例化数据库时默认用户的密码。

    必填项,如果未配置则将报错并退出静默安装。

    密码有效值必须满足如下条件:

    • 包含大写字母、小写字母和数字。

    • 长度不能小于8。

    • 不能与用户名相同。

  • encryption_key

    指定数据库加密密钥。

    选填项,未配置时则默认使用vastbase_password的值。

    密码有效值必须满足如下条件:

    • 包含大写字母、小写字母和数字。

    • 长度不能小于8。

    • 不能与用户名相同。

  • vastbase_home

    指定数据库安装目录。

    选填项。若配置的目录不是绝对路径,则在安装程序(即vastbase_installer)当前所在的目录新建该目录。未配置时默认值为/home/用户名/local/vastbase。

    用户指定配置的目录或默认目录/home/用户名/local/vastbase,需满足如下条件:

    • 若目录存在则必须为空。

    • 该目录必须为安装用户有读写权限的目录。

  • vastbase_data

    指定数据库安装目录。

    选填项。若配置的目录不是绝对路径,则在安装程序当前所在的目录新建该目录。未配置时默认值为/home/用户名/data/vastbase。

    用户指定配置的目录或默认目录/home/用户名/data/vastbase,需满足如下条件:

    • 若目录存在则必须为空。

    • 该目录必须为安装用户有读写权限的目录。

  • port

    指定数据库端口号。

    选填项。默认值为5432。

    该参数值必须是大于0,小于65535的整数。

  • max_connections

    指定数据库最大连接数。

    选填项,默认值为500.

    该参数值必须是大于0的整数。

  • shared_buffers

    指定共享内存大小,单位为MB。

    选填项,默认为安装数据库的机器内存的四分之一。

    该参数值不能小于0。

  • db_compatibility

    指定实例的数据库兼容模式。

    选填项,可取值为A、B、C、PG、MSSQL。分别表示兼容Oracle、MySQL、Teradata、PostgreSQL和SQL Server。

    当未在文件中填入本参数时,默认实例的数据库兼容模式为Oracle。

    • 指定该选项会影响所创建实例的数据库兼容模式,初始化成功后则不可修改。

    • 同一个实例中不能存在不同兼容模式的数据库。

  • isinitdb

    指定是否初始化数据库实例。

    必填项,如果未配置则将报错并退出静默安装。

    取值包括如下两种:

    • true:表示进行实例化安装。

    • false:表示进行非实例化安装。