[原创]OpenEuler20.03安装配置PostgreSQL13.4详细图文版
OpenEuler安装配置PostgreSQL
编写时间:2021年9月18日
作者:liupp
邮箱:liupp@88.com
序号 | 更新内容 | 更新日期 | 更新人 |
---|---|---|---|
1 | 完成第一至三章内容编辑; | 2021年9月18日 | liupp |
2 | 增加PostgreSQL服务开机自动启动; | 2021年10月25日 | liupp |
3 |
一、准备条件
OpenEuler(Hyper-V虚拟机):
- 版本:20.03 LTS SP2
- 下载地址:https://www.openeuler.org/zh/download/
PostgreSQL:
版本:13.4源码版
因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服务开机自动启动”;