CentOS 上 SQL Admin 升级操作指南
一 升级前准备
- 明确工具类型:常见的“SQL Admin”在 CentOS 上多为 phpMyAdmin(Web 管理 MySQL/MariaDB 的工具),也可能是 Microsoft SQL Server 的 mssql-tools/sqlcmd 组件。两者的升级路径完全不同。
- 备份与变更窗口:
- 备份网站目录(如 /usr/share/phpMyAdmin 或自定义目录)、Web 配置(如 Nginx/Apache 虚拟主机)、数据库(建议全量逻辑备份)。
- 选择低峰时段操作,准备回滚方案(保留旧版本目录与配置)。
- 依赖与兼容性核对:确认 PHP 版本与将要安装的 phpMyAdmin 版本兼容;如使用 EPEL/Remi 仓库,先确认可用版本。
- 权限与安全:全程使用具有 sudo 权限的账号;升级期间限制对外访问或启用维护页。
二 升级 phpMyAdmin(Web 管理 MySQL/MariaDB)
- 方式 A 使用系统包管理器(推荐,便于回滚)
- 查看当前与可用版本:
- 查看已装包:rpm -q phpMyAdmin
- 查看可用版本:yum list phpMyAdmin --disablerepo=‘’ --enablerepo='epel,remi’
- 执行升级:sudo yum update -y phpMyAdmin
- 重启 Web 服务:sudo systemctl restart httpd 或 sudo systemctl restart nginx
- 验证:访问 http://服务器/phpmyadmin,检查版本号与登录可用性。
- 方式 B 手动覆盖升级(适用于官网 tar 包)
- 备份旧目录与配置:
- mv /usr/share/phpMyAdmin /usr/share/phpMyAdmin.bak_$(date +%F)
- cp /usr/share/phpMyAdmin/config.inc.php /root/phpMyAdmin_config.inc.php.bak
- 下载并解压新版本(示例):
- wget https://files.phpmyadmin.net/phpMyAdmin/x.x.x/phpMyAdmin-x.x.x-all-languages.tar.gz
- tar xzf phpMyAdmin-x.x.x-all-languages.tar.gz -C /usr/share/
- ln -sfn /usr/share/phpMyAdmin-x.x.x-all-languages /usr/share/phpMyAdmin
- 恢复配置:cp /root/phpMyAdmin_config.inc.php.bak /usr/share/phpMyAdmin/config.inc.php
- 调整所有权与权限(以 Apache 为例):
- chown -R apache:apache /usr/share/phpMyAdmin
- find /usr/share/phpMyAdmin -type d -exec chmod 755 {} ;
- find /usr/share/phpMyAdmin -type f -exec chmod 644 {} ;
- 重启 Web 服务:sudo systemctl restart httpd 或 sudo systemctl restart nginx
- 验证:登录并检查版本与功能。
- 回滚:
- 包管理:sudo yum downgrade -y phpMyAdmin-<旧版本>
- 手动:将 /usr/share/phpMyAdmin 指回 phpMyAdmin.bak_<日期> 并恢复配置,重启 Web 服务。
- 配置要点提示:phpMyAdmin 的配置文件通常为 config.inc.php,升级覆盖时仅恢复自定义部分(如 $cfg[‘blowfish_secret’]、语言、已保存服务器等)。
三 升级 Microsoft SQL Server 管理工具 mssql-tools(sqlcmd/bcp)
- 适用于在 CentOS 上使用 Microsoft SQL Server 的场景(sqlcmd 属于 mssql-tools 组件)。
- 升级步骤:
- 导入 Microsoft GPG 公钥(若尚未导入):
- sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
- 配置 Microsoft SQL Server 仓库(以 RHEL/CentOS 7/8 为例,选择对应版本):
- 参考微软官方文档添加 msrepo.repo 到 /etc/yum.repos.d/
- 执行升级:sudo yum update -y mssql-tools unixODBC-devel
- 验证:sqlcmd -S localhost -U sa -P ‘<your_password>’ -Q “SELECT @@VERSION;”
- 回滚:sudo yum downgrade -y mssql-tools unixODBC-devel。
四 升级后验证与常见问题
- 功能与连通性验证:
- phpMyAdmin:登录、执行 SHOW DATABASES;、导出/导入小表,检查字符集与错误日志(/var/log/httpd/ 或 /var/log/nginx/)。
- mssql-tools:sqlcmd 连接测试、执行简单查询。
- 常见问题处理:
- 白屏或报错:检查 PHP 错误日志与 session.save_path 可写性;确认 PHP 扩展(如 mysqli、mbstring、openssl)已启用。
- 403/404:核对 Nginx/Apache 虚拟主机根目录与 Alias/DocumentRoot 是否指向新目录;检查 SELinux 与防火墙。
- 插件/主题不兼容:升级后临时切换到默认主题,再逐个恢复。
- 升级失败回滚:按上文回滚方案恢复目录或包版本,确认配置与数据完整性后再尝试升级。