[原创]OpenEuler20.03安装配置PostgreSQL13.4详细图文版

OpenEuler安装配置PostgreSQL

编写时间：2021年9月18日

作者：liupp

邮箱：liupp@88.com

一、准备条件

OpenEuler(Hyper-V虚拟机)：

• 版本：20.03 LTS SP2
• 下载地址：https://www.openeuler.org/zh/download/

PostgreSQL：

• 版本：13.4源码版

• 下载地址：https://www.postgresql.org/download/

• 因PostgreSQL并未对OpenEuler发行版发布打包安装版本，需要我们自己下载源码进行编译安装，其他linux发行版如果有打包版，可以自行下载安装。

  源码下载位置：

*选择当前稳定版的最新版的tar.gz压缩文件，可以复制右键复制下载链接，保存备用。

下载链接：https://ftp.postgresql.org/pub/source/v13.4/postgresql-13.4.tar.gz

二、安装OpenEuler

2.1 安装提示

操作系统的安装按照提示进行即可，在进行软件包选择的时候，本次选择了Server模式，右侧的软件包保持默认未选择。

按照提示安装完毕后重启即可进入到登录界面(命令行模式)，本次安装未安装图形界面。

注意：系统启动后，默认DHCP自动分配IP，需要先配置网络。

2.2网络配置

登录成功后，输入以下命令获取当前主机的网络配置文件：

/** 1.切换到网络配置文件目录 **/
cd /etc/sysconfig/network-scripts/

/** 2.查看配置文件名称 **/
ls 

获取到配置文件名称如下：

配置文件名称为“ifcfg-eth0”,此时可以使用 “vi 文件名”来编辑该文件，如果对vi工具熟悉的情况下，以上操作可以通过一条命令来处理：

vi /etc/sysconfig/network-scripts/ifcfg-eth0

默认配置如下：

需要修改的配置项如下：

• BOOTPROTO：将dhcp 修改为 none，代表将采用静态分配IP地址；
• ONBOOT：将no 修改为 yes，代表在启动时自动启用该设备；
• 新增：iPadDR=192.168.12.132 //代表分配的IP地址，这里根据情况自行设定；
• 新增：GATEWAY=192.168.12.254 //默认网关
• 新增：PREFIX=24 //掩码
• 新增：DNS1=202.102.224.68 //默认DNS，多个DNS按序号自行增加；

修改后的配置文件如下：

修改完成后保存退出vi编辑模式。

• vi 打开文件后，进入编辑模式 需要按下 “i”键，编辑完成后，先按下“Esc”键，然后输入“:wq”为保存退出。

输入以下命令重启网络服务：

  systemctl restart NetworkManager

没有错误提示即代表重启成功，可通过ifconfig命令或者"ip a"命令查看当前网络情况，通过ping命令来查看网络是否通畅。

如果此时重启网络后仍提示服务不可用，且无法ping通各个网站的话，可以停用当前网卡然后重启启用即可。(经测试发现采用Hyper-V创建的OpenEuler虚拟机偶尔出现这种情况，VM配置后直接成功联网。)命令如下：

# 查看 网卡信息
nmcli con show

# 停用 指定网卡 (eth0为查询到的配置网卡信息)
nmcli con down eth0

# 启用 指定网卡
nmcli con up eth0

此时网络已通畅，ssh默认是打开的，此时可以通过ssh连接来管理该系统，后续说明均通过ssh来处理。ssh登录成功后如图所示：

三、安装PostgreSQL

3.1安装步骤

• 阅读官方源码安装说明；

• 下载源码包；

• 根据官方说明安装必须依赖；

• 根据官方说明编译安装PostgreSQL；

• 配置、启动PostgreSQL；

如无特殊说明，本说明是以root账号登录安装，所以特殊需要系统权限命令不再需要sudo前缀，如实际安装过程未采用root账号导致安装出现错误，可尝试在命令前增加sudo。

3.2官方安装说明

官方源码安装说明文档地址：https://www.postgresql.org/docs/current/installation.html

入口寻找方法：

打开文档后，16.1Short Version章节给了基本安装的命令，其他相关配置的说明见其他章节，16.2Requirements章节说明与之相关的依赖，建议阅读。

3.3下载源码包

1.首先ssh连接上服务器，连接命令：

ssh root@192.168.12.132

回车后输入root密码然后回车：看到如下截图代表登录成功：

2.在使用ssh登录后，默认在root用户的根目录，我们可以创建一个tools文件，将下载的源码包放置在该文件夹下，命令如下：

mkdir tools
cd tools
wget https://ftp.postgresql.org/pub/source/v13.4/postgresql-13.4.tar.gz

下载完成见下图：

3.4安装依赖

根据文档说明必要的依赖如下：

• make 需要版本3.80+

• gcc

• tar

• Readline

• zlib

其他可选依赖根据自身需要选装。

3.4.1make

检查当前系统make 版本，可通过如下命令：

make --version

得到版本号为4.3，符合安装要求，无需再安装；

3.4.2gcc

gcc -v

查询到gcc已安装，且版本为7.3.0，符合安装条件；

3.4.3tar

tar为解压软件，系统已内置，无需安装；

3.4.4readline

Readline库：它允许psql记住你输入的每个命令，这样就可以通过上下方向键快速输入之前的命令，默认开启，也可以通过编译参数--without-readline来禁止它，建议保留默认。

readline 库系统已经内置，但OpenEuler安装PostgreSQL还要安装readline-devel库。

安装命令：

dnf install readline-devel

或

yum install readline-devel

3.4.5zlib

zlib为默认的压缩库，同readline，zlib系统已默认内置，但需要额外安装zlib-devel库。

安装命令：

dnf install zlib-devel

或

yum install zlib-devel

3.4.6 其他

缺少的库也可以一个命令统一安装：

dnf install readline-devel zlib-devel

或

yum install readline-devel zlib-devel

3.5编译安装

步骤：

• 解压源码包
• 根据官方简单版本安装命令编译安装
• 补充操作

3.5.1解压源码包

回到tools文件夹下，通过tar工具解压源码包到当前目录下，命令如下：

tar -xvf postgresql-13.4.tar.gz

解压后在当前tools下生成一个 postgresql-13.4的文件夹。

3.5.2解释官方提供的安装命令

官方提供的简单版本的安装命令如下：

./configure                       ##配置
make                              ##编译
su                                ##切换管理员权限
make install                      ##安装
adduser postgres                  ##添加postgres用户
mkdir /usr/local/pgsql/data       ##创建data存放目录
chown postgres /usr/local/pgsql/data   ##给postgres用户授权
su - postgres                     ##切换到postgres用户(数据库的操作不允许使用root用户)
/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data  ##初始化数据库
/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data -l logfile start   ##启动数据库
/usr/local/pgsql/bin/createdb test  ##创建test数据库
/usr/local/pgsql/bin/psql test      ##连接test数据库

官方提供的命令相对简单，这里需要解释一下，部分操作将会修改官方的命令：

configure文件是一个可执行的脚本文件，它有很多选项，在待安装的源码目录下使用命令./configure –help可以输出详细的选项列表。

其中--prefix选项是配置安装目录，如果不配置该选项，安装后可执行文件默认放在/usr /local/bin，库文件默认放在/usr/local/lib，配置文件默认放在/usr/local/etc，其它的资源文件放在/usr /local/share，比较凌乱。

如果配置了--prefix，如：

./configure --prefix=/usr/local/test

安装后的所有资源文件都会被放在/usr/local/test目录中，不会分散到其他目录。

*这里我们配置的路径为：

 ./configure --prefix=/usr/local/postgresql	

其他有修改命令将会在编译安装章节单独说明。

3.5.3编译安装

现在我们逐项进行执行。

请保证当前所在目录为：/tools/ postgresql-13.4/

3.5.3.1 configure

执行命令

./configure --prefix=/usr/local/postgresql

正确执行完毕应未报错：

3.5.3.2 make

命令输入make后回车，编译过程耗时较长，请耐心等待编译结束。

命令：

make

编译过程未出现Error错误字样，代表编译正常结束。

3.5.3.3 su

该命令为切换root管理权限，但当前操作我们采用的是root账号，所以该命令无需执行，如果您使用的是非root账号，请先执行su命令。

3.5.3.4 make install

命令：

make install

编译过程未出现Error错误字样，代表编译正常结束。

3.5.3.5 adduser postgres

命令：

adduser postgres

创建postgres用户和用户组，默认密码随机,回车后无任何错误提示代表创建成功；

3.5.3.6 mkdir /usr/local/pgsql/data

上面 我们将安装地址修改为了我们自定义的地址，该条命令需要修改一下：

mkdir /usr/local/postgresql/data

3.5.3.7 chown postgres /usr/local/pgsql/data

同样该命令修改为：

chown postgres /usr/local/postgresql/data

3.5.3.8 su - postgres

切换到postgres用户

3.5.3.8 数据库操作

因为我们修改了安装位置，所以如下命令都要根据实际安装位置修改。

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data  ##初始化数据库

修改为：

/usr/local/postgresql/bin/initdb -D /usr/local/postgresql/data  ##初始化数据库

/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data -l logfile start   ##启动数据库

修改为：

/usr/local/postgresql/bin/pg_ctl -D /usr/local/postgresql/data -l logfile start   ##启动数据库

启动成功。

/usr/local/pgsql/bin/createdb test  ##创建test数据库

修改为：

/usr/local/postgresql/bin/createdb test  ##创建test数据库

/usr/local/pgsql/bin/psql test      ##连接test数据库

修改为：

/usr/local/postgresql/bin/psql test      ##连接test数据库

出现“test=#”代表已经成功连接test数据库，可以进行相关sql操作了。

3.5.4.补充操作

3.5.4.1配置数据库远程连接

经过以上操作，数据库已经成功安装完成，可以通过ps命令查看后台进程确认：

但是无法从外部通过数据库工具连接，所以我们需要简单对postgres进行配置。

进入postgrelsql下的data目录，命令及目录结构如下：

base目录是表空间目录，global目录是相关全局变量目录, pg_hba.conf是访问控制配置文件，postgresql.conf是postgresql主配置文件。我们需要修改的配置文件为pg_hba.conf和postgresql.conf文件。

修改pg_hba.conf文件，命令如下：

vi pg_hba.conf	

拉到最下面，找到如下图所示：

修改红框内容，修改为:

保存退出。

修改postgresql.conf文件，命令如下：

vi postgresql.conf

在展开到内容中找到“# - Connection Settings -”配置项：

修改红圈圈中内容，将前面的“#”去掉，修改'localhost'为’*‘，其他配置项保持不变，保存退出。

配置完毕后应在防火墙对5432端口放行，此时使用postgres用户(密码随机，如果自行修改postgres密码知晓的情况下可以直接执行)无法执行，应先退出postgres账号，返回到root账号。执行命令如下：

exit    ##退出postgres账号

##以下命令在root账户下执行
sudo firewall-cmd --zone=public --add-port=5432/tcp --permanent     ##配置防火墙放行5432端口
sudo firewall-cmd --reload       ##防火墙重新加载配置文件

此时切换回postgres账号，停止postgressql服务后，重新启动发现无法启动，报错如下：

报错原因：没有指定启动日志的路径。启动命令和停止命令中的logfile需要指定为具体的log日志的命令。此时我们使用postgres账户在postgresql目录创建log文件夹是没有权限的，在3.5.3.7章节，我们只给postgres账号授权了data目录。我们做如下操作：

• 1.切换回root账号；
• 2.给postgres账号授权/usr/local/postgresql目录的权限；
• 3.再切换回postgres账号进行log文件夹的创建；

在log文件夹下创建server.log文件：

命令如下：

touch log/server.log	

创建成功后修改启动命令为：

/usr/local/postgresql/bin/pg_ctl -D /usr/local/postgresql/data -l /usr/local/postgresql/log/server.log start

执行命令，启动成功。

此时使用外部的sql工具如navicat测试网络是畅通的，但是我们需要修改一下数据库账户postgres的默认密码才能进行连接，先使用本地postgres账号连接默认数据库来修改数据库账户postgres的密码：

/usr/local/postgresql/bin/psql      ##使用postgres用户连接默认postgres数据库；
ALTER USER postgres WITH PASSWORD 'postgres';     #修改数据库用户postgres的密码为postgres；

此时使用Navicat测试数据库连接成功。

3.5.5.2配置环境变量

截止到现在如果我们想在安装postgresql的服务器使用psql或其他提供的工具连接数据库，就必须输入psql的全路径来调用,如：

/usr/local/postgresql/bin/psql 

并不是很方便我们使用，此时我们可以将postgresql配置到系统环境变量里面去，注意：请配置到postgres用户或者其他自定义操作postgresql的用户的bash_profile环境变量中，不要配置到root账号的环境变量中，或者可以配置到etc/profile中，单独配置到root的环境变量中时不能使用的。

配置请以root用户配置：

vi /etc/profile

##将如下内容添加到文件末尾
PATH=/usr/local/postgresql/bin:$PATH
export PATH

##保存退出后执行刷新配置
source /etc/profile

##切换到postgres用户
su - postgres

##此时就可以直接执行psql命令了
psql

3.5.5.3设置PostgreSQL为开机启动

PostgreSQL的开机自动启动脚本位于PostgreSQL源码目录下的contrib/start-scripts目录下：

其中linux文件为linux环境下的开机自启动脚本，将其拷贝到“/etc/init.d”目录下，并改名为postgresql：

cp linux /etc/init.d/postgresql

切换到/etc/init.d目录，使用vi打开postgresql文件修改如下内容：

#修改前：
#Installation prefix
prefix=/usr/local/pgsql

#修改后： 
#Intalllation prefix[2021-10-25]
prefix=/usr/local/postgresql

#修改前：
# Data directory
#PGDATA="/usr/local/pgsql/data"

#修改后：
# Data directory[2021-10-25]
PGDATA="/usr/local/postgresql/data"

# Who to run the postmaster as, usually "postgres".  (NOT "root")
# 将启动用户修改为实际用户，这里使用postgres，所以不变。
PGUSER=postgres

#修改前：
# Where to keep a log file
PGLOG="$PGDATA/serverlog"

#修改后：
# Where to keep a log flie[2021-10-25]
PGLOG="/usr/local/postgresql/log/server.log"

然后保存退出。

然后修改postgresql文件的执行权限：

chmod a+x postgresql

添加开机启动:

chkconfig --add postgresql

然后重启服务器开机验证即可。

后记

此文原创 ，转载请注明出处。谢谢。
2021年10月25日增加“PostgreSQL服务开机自动启动”；