综合档案管理系统搭建与版本升级实操落地全指南
一、实操准备工作
1. 环境要求
需要CentOS 7.6+服务器、CPU≥2核、内存≥4G，已安装的软件包需满足：Apache HTTP Server 2.4、MySQL 5.7、PHP 7.4及对应扩展。
2. 安装依赖软件包
执行以下命令一键安装所需环境： ``` yum install httpd mariadb-server php php-mysqlnd php-gd php-json php-xml php-mbstring php-curl -y ```
安装完成后启动并设置开机自启： ``` systemctl start httpd mariadb systemctl enable httpd mariadb ```
3. 下载系统源码
使用wget下载指定稳定版本的综合档案管理系统（OpenDocMan v1.5.0）： ``` wget https://github.com/OpenDocMan/OpenDocMan/archive/refs/tags/v1.5.0.zip unzip v1.5.0.zip mv OpenDocMan-1.5.0 /var/www/html/archivenew ```
将源码移动到Web根目录，命名为archivenew便于后续操作。
二、系统搭建实操步骤
1. 数据库创建与授权
登录MySQL（默认root密码为空，直接回车）： ``` mysql -u root -p ```
依次执行以下SQL语句，创建数据库、授权专属用户： ``` CREATE DATABASE archivenew CHARACTER SET utf8mb4; CREATE USER 'archivenew'@'localhost' IDENTIFIED BY 'ArchPass@2024'; GRANT ALL PRIVILEGES ON archivenew. TO 'archivenew'@'localhost'; FLUSH PRIVILEGES; EXIT; ```
注意：密码需包含大小写、数字、特殊字符，符合安全规则。
2. Web目录权限配置
设置Apache对档案目录的访问权限： ``` chown -R apache:apache /var/www/html/archivenew ```
3. 系统初始化安装
在浏览器访问服务器地址：http://你的服务器IP/archivenew/install，按页面提示填写信息：
- 数据库类型：MySQL
- 数据库地址：localhost
- 数据库名：archivenew
- 数据库用户：archivenew
- 数据库密码：ArchPass@2024
- 管理员账号：admin
- 管理员密码：AdminPass@2024
- 管理员邮箱：admin@local.com
点击「安装」，等待5-10秒，系统提示安装完成后，必须删除安装目录消除安全隐患： ``` rm -rf /var/www/html/archivenew/install ```
三、系统升级实操步骤（从v1.5.0升级到v1.6.0）
1. 升级前备份（必做）
1.1 备份数据库（确保备份文件存在可恢复的位置）： ``` mysqldump -u archivenew -p'ArchPass@2024' archivenew > /root/archivenew_backup_$(date +%Y%m%d).sql ```
1.2 备份档案文件（含已上传的文档、附件）： ``` tar -zcvf /root/archivenew_files_backup_$(date +%Y%m%d).tar.gz /var/www/html/archivenew/files /var/www/html/archivenew/uploads ```
1.3 停止Web服务，避免升级过程中写入文件： ``` systemctl stop httpd ```
2. 替换系统核心文件
2.1 下载新版本源码并解压： ``` wget https://github.com/OpenDocMan/OpenDocMan/archive/refs/tags/v1.6.0.zip unzip v1.6.0.zip ```
2.2 复制旧版核心配置文件（避免覆盖原有设置）： ``` cp /var/www/html/archivenew/config.php /root/archivenew_old_config.php ```
2.3 同步新版本核心文件，排除无需替换的目录和配置： ``` rsync -av --exclude='config.php' --exclude='files' --exclude='uploads' OpenDocMan-1.6.0/ /var/www/html/archivenew/ ```
2.4 恢复旧版配置文件： ``` cp /root/archivenew_old_config.php /var/www/html/archivenew/config.php ```
3. 升级数据库与验证
3.1 启动Web服务： ``` systemctl start httpd ```
3.2 访问升级页面：http://你的服务器IP/archivenew/upgrade，输入数据库密码ArchPass@2024，点击「升级数据库」。
3.3 升级完成后，登录系统后台，进入「系统设置-关于」，确认版本为v1.6.0；测试上传1份档案、搜索功能，验证升级有效性。
四、常见问题快速排查
1. 访问出现403错误
检查SELinux权限，临时关闭验证： ``` setenforce 0 ```
若问题解决，执行永久配置： ``` chcon -R -t httpd_sys_content_t /var/www/html/archivenew ```
2. 数据库连接失败
查看MySQL服务状态： ``` systemctl status mariadb ```
确认config.php中数据库地址、用户名、密码与实际设置一致，无拼写错误。
3. 升级后功能异常
检查rsync命令是否正确排除了config.php、files、uploads目录，验证config.php是否为旧版未被覆盖的文件，重新设置目录权限： ``` chown -R apache:apache /var/www/html/archivenew ```
相关文章
