服务器安装

openGauss支持以脚本方式进行极简安装，极简安装包括单节点安装和一主一备节点安装。

单节点安装

前提条件

• 已完成用户组和普通用户的创建。
• 所有服务器操作系统和网络均正常运行。
• 普通用户必须有数据库包解压路径、安装路径的读、写和执行操作权限，并且安装路径必须为空。
• 普通用户对下载的openGauss压缩包有执行权限。
• 安装前请检查指定的openGauss端口是否被占用，如果被占用请更改端口或者停止当前使用端口进程。

操作步骤

1.使用普通用户登录到openGauss包安装的主机，解压openGauss压缩包到安装目录（假定安装目录为/opt/software/openGauss，请用实际值替换）。

tar -jxf openGauss-x.x.x-openEuler-64bit.tar.bz2 -C /opt/software/openGauss 

2.假定解压包的路径为/opt/software/openGauss，进入解压后目录下的simpleInstall。

cd /opt/software/openGauss/simpleInstall 

3.执行install.sh脚本安装openGauss。

sh install.sh  -w "xxxx" &&source ~/.bashrc 

 说明：

• -w：初始化数据库密码（gs_initdb指定），因安全需要，此项必须设置。

• -p：指定openGauss端口号，如不指定，默认为5432。

• -h|--help：打印使用说明。

• 安装后，该数据库部署节点的名称为sgnode（gs_initdb指定）。

• 执行时，如果出现报错“the maximum number of SEMMNI is not correct, the current SEMMNI is xxx. Please check it.”，请使用有root权限的用户执行如下命令。

sysctl -w kernel.sem="250 85000 250 330"  

• 安装后，数据库目录安装路径/opt/software/openGauss/data/single_node，其中/opt/software/openGauss为解压包路径，data/single_node为新创建的数据库节点目录。

• 安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。

4.安装执行完成后，使用ps和gs_ctl查看进程是否正常。

ps ux | grep gaussdb gs_ctl query -D /opt/software/openGauss/data/single_node 

执行ps命令，显示类似如下信息：

omm      24209 11.9  1.0 1852000 355816 pts/0  Sl   01:54   0:33 /opt/software/openGauss/bin/gaussdb -D /opt/software/openGauss/single_node omm      20377  0.0  0.0 119880  1216 pts/0    S+   15:37   0:00 grep --color=auto gaussdb 

执行gs_ctl命令，显示类似如下信息：

gs_ctl query ,datadir is /opt/software/openGauss/data/single_node HA state:     local_role                     : Normal     static_connections             : 0     db_state                       : Normal     detail_information             : Normal  Senders info:     No information       Receiver info: No information  

一主一备节点安装

前提条件：

• 已完成用户组和普通用户的创建。
• 所有服务器操作系统和网络均正常运行。
• 普通用户必须有数据库包解压路径、安装路径的读、写和执行操作权限，并且安装路径必须为空。
• 普通用户对下载的openGauss压缩包有执行权限。
• 安装前请检查指定的openGauss端口矩阵中所有端口是否被占用，如果被占用请更改端口或者停止当前使用端口进程。端口号请参考下方步骤三参数说明。

操作步骤

1. 创建用户组dbgroup。

   groupadd dbgroup 

2. 创建用户组dbgroup下的普通用户omm，并设置密码为Gauss_234 。

   useradd -g dbgroup omm passwd Gauss_234 

3. 使用omm登录到包安装的主机，解压openGauss压缩包到安装目录（假定安装目录为/opt/software/openGauss，请用实际值替换）。

   tar -jxf openGauss-x.x.x-openEuler-64bit.tar.bz2 -C /opt/software/openGauss 

4. 假定解压包的路径为/opt/software/openGauss，进入解压后目录下的simpleInstall。

   cd /opt/software/openGauss/simpleInstall 

5. 执行install.sh脚本安装openGauss。

   sh install.sh  -w xxxx  --multinode 

   

    说明：

   • -w：初始化数据库密码（gs_initdb指定），安全需要必须设置。
   • -p：指定的openGauss主节点端口号，默认5432。备节点端口号会使用主端口号+200，默认5632。
   • --multinode：用来区分是单节点还是一主一备安装。
   • -h|--help：打印使用说明。
   • 安装后，数据库的主节点名称为nodename1，备节点名称为nodename2。
   • 安装后，数据库主节点目录安装路径/opt/software/openGauss/data/master，备节点目录安装路径为/opt/software/openGauss/data/slave，其中/opt/software/openGauss为解压包路径，data/master(slave)为新创建的数据库节点目录。

6. 安装执行完成后，使用ps和gs_ctl查看进程是否正常。

   ps ux | grep gaussdb gs_ctl query -D /opt/software/openGauss/data/master 

   执行ps命令，显示类似如下信息：

   omm  4879 11.8 1.1 2082452 373832 pts/0  Sl   14:26   8:29 /opt/software/openGauss/bin/gaussdb -D /opt/software/openGauss/data/master -M primary  omm  5083  1.1  0.9 1819988 327200 pts/0  Sl   14:26   0:49 /opt/software/openGauss/bin/gaussdb -D /opt/software/openGauss/data/slave -M standby  omm      20377  0.0  0.0 119880  1216 pts/0    S+   15:37   0:00 grep --color=auto gaussdb 

   执行gs_ctl命令，显示类似如下信息：

   gs_ctl query ,datadir is /opt/software/openGauss/data/master HA state:     local_role                     : Primary     static_connections             : 1     db_state                       : Normal     detail_information             : Normal  Senders info:     sender_pid                     : 5165     local_role                     : Primary     peer_role                      : Standby     peer_state                     : Normal     state                          : Streaming     sender_sent_location           : 0/4005148     sender_write_location          : 0/4005148     sender_flush_location          : 0/4005148     sender_replay_location         : 0/4005148     receiver_received_location     : 0/4005148     receiver_write_location        : 0/4005148     receiver_flush_location        : 0/4005148     receiver_replay_location       : 0/4005148     sync_percent                   : 100%     sync_state                     : Sync     sync_priority                  : 1     sync_most_available            : Off     channel                        : 10.244.44.52:27001-->10.244.44.52:35912   Receiver info: No information