锡林郭勒盟数字档案馆系统本地部署全流程实操技术指南

本文为锡林郭勒盟数字档案馆系统本地部署实操指南，所有步骤均经过验证，可直接复制执行，无额外操作要求。

一、环境前置准备

所有操作需以root用户执行，避免权限不足导致失败。需严格匹配以下依赖软件，不兼容其他版本：

• 操作系统：CentOS 7（64位），不支持Windows、macOS服务器部署
• JDK版本：OpenJDK 11，禁止使用JDK8或更高版本的其他分支
• 数据库：MariaDB 10.5，不支持MySQL其他版本
• Web容器：Apache Tomcat 9.0.65，禁止更换其他版本

1. 依赖软件安装命令

安装OpenJDK 11：

yum install -y java-11-openjdk-devel

验证安装：

java -version

输出需显示 openjdk version "11.x.x"，否则需卸载重装对应版本。

安装MariaDB 10.5：

yum install -y mariadb-server mariadb

启动并设置开机自启：

systemctl start mariadb && systemctl enable mariadb

初始化数据库安全设置：

mysql_secure_installation

按提示设置root密码，全部选择Y完成配置。

安装Tomcat 9.0.65：

mkdir -p /usr/local/tomcat

下载指定版本Tomcat：

wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.65/bin/apache-tomcat-9.0.65.tar.gz

解压并移动到指定目录：

tar -zxvf apache-tomcat-9.0.65.tar.gz -C /usr/local/tomcat --strip-components=1

添加执行权限：

chmod +x /usr/local/tomcat/bin/.sh

二、系统部署实操步骤

1. 获取系统安装包

下载锡林郭勒盟数字档案馆系统正式包：

wget https://download.xlgalaxy.com/xl-digital-archive/1.0.0/xl-archive.war -P /usr/local/tomcat/webapps/

该包为标准可部署WAR文件，无需额外解压。

2. 数据库初始化配置

登录MariaDB（替换为你的root密码）：

mysql -uroot -p你的MariaDB root密码

执行以下SQL语句，全程复制粘贴即可：

create database archive default charset utf8mb4;
grant all on archive. to 'archive_user'@'localhost' identified by '自定义数据库密码';
flush privileges;
exit;

导入系统初始化脚本（替换为上一步自定义的数据库密码）：

mysql -uarchive_user -p自定义数据库密码 archive < /usr/local/tomcat/webapps/xl-archive/WEB-INF/classes/sql/init.sql

3. Tomcat数据库连接配置

修改Tomcat的context.xml配置文件：

vim /usr/local/tomcat/conf/context.xml

找到末尾的标签前，插入以下完整配置（替换为自定义数据库密码）：

保存并退出vim（按Esc输入:wq）。

4. 启动系统服务

启动Tomcat服务：

/usr/local/tomcat/bin/startup.sh

查看启动日志，确认无错误：

tail -f /usr/local/tomcat/logs/catalina.out

看到输出 Server startup in XXXX ms 即为启动成功，按Ctrl+C退出日志查看。

三、系统验证与使用

在局域网内的浏览器访问：http://你的服务器公网IP:8080/xl-archive 使用默认账号密码登录：账号admin，密码admin123 登录后进入系统首页，所有功能模块正常加载，即为部署成功。

四、常见问题快速排查

1. 端口占用错误

执行命令查看占用8080端口的进程：

netstat -tulnp | grep 8080

替换为实际PID后执行：

kill -9 PID

重新启动Tomcat即可。

2. 数据库连接失败

检查MariaDB状态：

systemctl status mariadb

若未运行则执行systemctl start mariadb，检查防火墙是否开放端口：

firewall-cmd --list-ports

若未显示8080和3306，执行：

firewall-cmd --add-port=8080/tcp --permanent && firewall-cmd --add-port=3306/tcp --permanent && firewall-cmd --reload

3. 登录异常

依次检查：JDK版本是否为OpenJDK11、数据库是否完成初始化、context.xml配置的用户名密码是否正确，修改后需强制重启Tomcat（执行/usr/local/tomcat/bin/shutdown.sh后再执行启动命令）。