CentOS上SQLAdmin升级操作指南

一升级前准备

明确工具类型:常见的“SQLAdmin”在CentOS上多为phpMyAdmin(Web管理MySQL/MariaDB的工具),也可能是MicrosoftSQLServer的mssql-tools/sqlcmd组件。两者的升级路径完全不同。

备份与变更窗口:

备份网站目录(如/usr/share/phpMyAdmin或自定义目录)、Web配置(如Nginx/Apache虚拟主机)、数据库(建议全量逻辑备份)。

选择低峰时段操作,准备回滚方案(保留旧版本目录与配置)。

依赖与兼容性核对:确认PHP版本与将要安装的phpMyAdmin版本兼容;如使用EPEL/Remi仓库,先确认可用版本。

权限与安全:全程使用具有sudo权限的账号;升级期间限制对外访问或启用维护页。

二升级phpMyAdmin(Web管理MySQL/MariaDB)

方式A使用系统包管理器(推荐,便于回滚)

    查看当前与可用版本:

    查看已装包:rpm-qphpMyAdmin

    查看可用版本:yumlistphpMyAdmin--disablerepo=‘’--enablerepo='epel,remi

    执行升级:sudoyumupdate-yphpMyAdmin

    重启Web服务:sudosystemctlrestarthttpd或sudosystemctlrestartnginx

    验证:访问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

    下载并解压新版本(示例):

    wgethttps://files.phpmyadmin.net/phpMyAdmin/x.x.x/phpMyAdmin-x.x.x-all-languages.tar.gz

    tarxzfphpMyAdmin-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-Rapache:apache/usr/share/phpMyAdmin

    find/usr/share/phpMyAdmin-typed-execchmod755{};

    find/usr/share/phpMyAdmin-typef-execchmod644{};

    重启Web服务:sudosystemctlrestarthttpd或sudosystemctlrestartnginx

    验证:登录并检查版本与功能。

回滚:

包管理:sudoyumdowngrade-yphpMyAdmin-<旧版本>

手动:将/usr/share/phpMyAdmin指回phpMyAdmin.bak_<日期>并恢复配置,重启Web服务。

配置要点提示:phpMyAdmin的配置文件通常为config.inc.php,升级覆盖时仅恢复自定义部分(如$cfg[‘blowfish_secret’]、语言、已保存服务器等)。

三升级MicrosoftSQLServer管理工具mssql-tools(sqlcmd/bcp)

适用于在CentOS上使用MicrosoftSQLServer的场景(sqlcmd属于mssql-tools组件)。

升级步骤:

    导入MicrosoftGPG公钥(若尚未导入):

    sudorpm--importhttps://packages.microsoft.com/keys/microsoft.asc

    配置MicrosoftSQLServer仓库(以RHEL/CentOS7/8为例,选择对应版本):

    参考微软官方文档添加msrepo.repo到/etc/yum.repos.d/

    执行升级:sudoyumupdate-ymssql-toolsunixODBC-devel

    验证:sqlcmd-Slocalhost-Usa-P‘’-Q“SELECT@@VERSION;”

回滚:sudoyumdowngrade-ymssql-toolsunixODBC-devel。

四升级后验证与常见问题

功能与连通性验证:

phpMyAdmin:登录、执行SHOWDATABASES;、导出/导入小表,检查字符集与错误日志(/var/log/httpd/或/var/log/nginx/)。

mssql-tools:sqlcmd连接测试、执行简单查询。

常见问题处理:

白屏或报错:检查PHP错误日志与session.save_path可写性;确认PHP扩展(如mysqli、mbstring、openssl)已启用。

403/404:核对Nginx/Apache虚拟主机根目录与Alias/DocumentRoot是否指向新目录;检查SELinux与防火墙。

插件/主题不兼容:升级后临时切换到默认主题,再逐个恢复。

升级失败回滚:按上文回滚方案恢复目录或包版本,确认配置与数据完整性后再尝试升级。