CentOS系统pgAdmin版本升级指南

一、升级前准备工作

1. 备份关键数据

升级前务必备份pgAdmin的所有重要数据（如用户账号、配置文件、数据库连接信息）及配置文件（通常位于/etc/pgadmin/或/opt/pgadmin/目录下），防止升级过程中出现数据丢失或配置损坏。

2. 检查当前系统与pgAdmin版本

查看CentOS系统版本：cat /etc/redhat-release（确认系统兼容性，如CentOS 7/8/Stream）；
查看当前pgAdmin版本：pgadmin4 --version（或通过Web界面登录后查看“关于”选项）。

3. 更新系统软件包

确保系统软件包为最新状态，避免依赖冲突：

sudo yum update -y  # CentOS 7
sudo dnf update -y  # CentOS 8/Stream

二、卸载旧版本pgAdmin

使用yum包管理器卸载现有pgAdmin 4安装：

sudo yum remove pgadmin4 -y

三、添加pgAdmin官方Yum仓库（可选但推荐）

为确保获取最新稳定版本，建议添加pgAdmin官方Yum仓库：

sudo vi /etc/yum.repos.d/pgadmin4.repo

写入以下内容（根据CentOS版本调整$releasever，如CentOS 7用7，CentOS 8用8）：

[pgadmin4]
name=pgAdmin 4 Repository
baseurl=https://ftp.postgresql.org/pub/pgadmin/pgadmin4/yum/repo/centos/$releasever/$basearch/
enabled=1
gpgcheck=1
gpgkey=https://www.pgadmin.org/static/packages_pgadmin_org.pub

四、安装新版本pgAdmin

方法1：通过Yum包管理器安装（推荐）

更新Yum缓存并安装最新版本：

sudo yum clean all
sudo yum update
sudo yum install pgadmin4 -y

方法2：手动下载安装（适用于特定版本）

若需安装特定版本，可通过wget下载对应RPM包并安装：

# 下载最新版本（替换X.X.X为实际版本号，如6.18）
wget https://download.pgadmin.org/pub/pgadmin/pgadmin4/vX.X.X/pgadmin4-X.X.X-1.el7.noarch.rpm
# 安装下载的RPM包
sudo yum install ./pgadmin4-X.X.X-1.el7.noarch.rpm -y

五、配置与启动pgAdmin

1. 配置pgAdmin（可选）

若手动安装，需检查配置文件路径（通常为/opt/pgadmin/pgadmin4.conf或/etc/pgadmin/pgadmin4.conf），确保以下关键配置正确：

SERVER_MODE=True（启用服务器模式）；
DEFAULT_SERVER_PORT=5050（默认端口，可根据需求修改）。

2. 创建系统服务（可选但推荐）

若未通过Yum自动创建服务，可手动添加systemd服务：

sudo nano /etc/systemd/system/pgadmin4.service

写入以下内容（根据安装路径调整ExecStart）：

[Unit]
Description=pgAdmin 4
After=network.target

[Service]
Type=simple
User=pgadmin
ExecStart=/usr/pgadmin4/bin/pgadmin4
Restart=always

[Install]
WantedBy=multi-user.target

保存后启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable pgadmin4
sudo systemctl start pgadmin4

六、验证升级结果

检查pgAdmin服务状态：sudo systemctl status pgadmin4（确保状态为“active (running)”）；
登录Web界面：通过浏览器访问http://<服务器IP>:5050（默认端口），使用原有账号密码登录；
查看版本信息：登录后点击右上角“用户菜单”→“关于”，确认显示为新版本号。

注意事项

兼容性检查：确保新版本pgAdmin与CentOS系统版本、PostgreSQL服务器版本兼容（如pgAdmin 6.18支持PostgreSQL 12及以上版本）；
依赖问题：若安装过程中提示依赖缺失，可使用sudo yum install <缺失包名>安装对应依赖；
回滚方案：若升级失败，可通过备份恢复旧版本配置文件，并重新安装旧版本pgAdmin。

centos中pgadmin版本升级指南