Linux pgAdmin怎样进行迁移

Linux 上 pgAdmin 迁移指南

迁移目标与准备

• 明确迁移对象：
  • 迁移 pgAdmin 4 的配置与元数据（服务器列表、用户、偏好等）。
  • 迁移 被管理的 PostgreSQL 数据库（业务数据）。
• 版本与目录要点：
  • 常见安装方式及关键目录（以实际环境为准）：
    • RPM/YUM（httpd/Wsgi）：配置 /etc/httpd/conf.d/pgadmin4.conf，数据 /var/lib/pgadmin4/，日志 /var/log/pgadmin4/。
    • DEB/APT（桌面版）：配置与数据常在用户目录 ~/.pgadmin/。
  • 建议先停服务再迁移，避免运行时文件变更导致不一致：例如 systemctl stop httpd 或停止桌面会话。
  • 预估空间并准备传输工具（如 rsync/scp），确保目标机器磁盘与权限满足要求。

迁移 pgAdmin 4 的配置与元数据

• 方式一（同版本直拷，适用于 RPM/YUM 与 DEB/APT）
  1. 停服务：systemctl stop httpd（或暂停桌面会话）。
  2. 打包并复制关键目录：
     • RPM/YUM：
       tar czf pgadmin4-data.tar.gz /var/lib/pgadmin4 /var/log/pgadmin4 /etc/httpd/conf.d/pgadmin4.conf
       scp pgadmin4-data.tar.gz user@new:/tmp
       在目标机：tar xzf /tmp/pgadmin4-data.tar.gz -C /
     • DEB/APT：
       tar czf pgadmin4-home.tar.gz ~/.pgadmin
       scp pgadmin4-home.tar.gz user@new:~
       在目标机：tar xzf ~/pgadmin4-home.tar.gz -C ~
  3. 如目录或 SELinux 标签变更，修正所有权与上下文：
     chown -R apache:apache /var/lib/pgadmin4 /var/log/pgadmin4（RPM/YUM）
     chcon -R -t httpd_sys_rw_content_t /var/lib/pgadmin4 /var/log/pgadmin4（RHEL/CentOS SELinux）
  4. 启动服务：systemctl start httpd；或在桌面版重新登录。
  5. 登录验证服务器列表、登录账号与偏好是否完整。
• 方式二（跨版本或无法直拷）
  • 在新环境全新安装同版本 pgAdmin 4，首次登录后导出连接/服务器定义为 JSON（若界面提供），或手动在新环境重新添加服务器连接；偏好设置按需重新配置。

迁移被管理的 PostgreSQL 数据库

• 逻辑迁移（推荐，跨版本/跨平台通用）
  1. 在源库导出：
     • 自定义格式（便于后续选择性恢复与并行）：
       pg_dump -U username -h hostname -p port -F c -b -v -f backup.dump database_name
     • 纯 SQL 脚本：
       pg_dump -U username -h hostname -p port database_name > backup.sql
  2. 将备份传至目标机：scp backup.* user@new:/path/
  3. 在目标库恢复：
     • 自定义格式：
       pg_restore -U username -h hostname -p port -d database_name -v backup.dump
     • SQL 脚本：
       psql -U username -h hostname -p port -d database_name -f backup.sql
  4. 校验对象数量、数据一致性（如行数、重要表抽样）。
• 物理迁移（仅限同版本、同平台、停机窗口充足）
  1. 源库停写：pg_ctl stop 或 systemctl stop postgresql
  2. 拷贝数据目录（Data Directory）到目标机相同路径或配置到新路径
  3. 目标库启动并校验：pg_ctl start；检查日志与数据库可用性。

验证与常见问题

• 验证清单
  • pgAdmin 能正常登录，服务器树、登录角色、驱动与偏好设置完整。
  • 各业务库可连接，关键表数据一致（数量、抽样校验）。
  • 日志无异常：/var/log/pgadmin4/*.log、PostgreSQL 服务日志。
• 常见问题与处理
  • 版本不一致导致元数据或恢复失败：尽量保持 pgAdmin 4 与目标 PostgreSQL 的版本一致或做充分演练。
  • 权限/所有权错误：RPM/YUM 下确保 apache:apache 拥有 /var/lib/pgadmin4 与 /var/log/pgadmin4；必要时 restorecon/chcon 修正 SELinux。
  • 直拷后 pgAdmin 页面 403/500：检查 WSGI 配置、目录权限与 SELinux 上下文，必要时重启 httpd。
  • 大对象（BLOB）未恢复：导出时使用 -b，恢复时使用 pg_restore 的相应选项。