综合档案管理系统神通版本地部署与基础功能配置实操指南
一、前期环境准备
综合档案管理系统神通版原生适配神通数据库，部署前需要准备以下环境组件与硬件条件：
- 硬件要求：CPU≥2核，内存≥4G，剩余硬盘空间≥50G
- 软件要求：JDK 1.8、神通数据库7.0、Tomcat 8.5，各软件官方直接下载地址如下：
- JDK1.8存档版：https://www.oracle.com/cn/java/technologies/javase/javase8-archive-downloads.html
- 神通数据库官方下载：https://www.kingbase.com.cn/download/oscar
- Tomcat 8.5官方下载：https://archive.apache.org/dist/tomcat/tomcat-8/v8.5.82/bin/apache-tomcat-8.5.82.zip
二、基础环境安装配置
1. JDK环境配置
Windows系统：下载exe安装包完成安装后，右键「此电脑」→「属性」→「高级系统设置」→「环境变量」，新建系统变量JAVA_HOME，变量值填写你的JDK安装路径，示例：C:\Program Files\Java\jdk1.8.0_301；编辑系统变量Path，新增两条记录：%JAVA_HOME%\bin、%JAVA_HOME%\jre\bin，保存后打开cmd，输入java -version，输出版本信息即配置成功。
Linux系统：将下载的tar.gz压缩包解压到/usr/local/java目录，编辑/etc/profile文件，在文件末尾添加以下配置：
``` export JAVA_HOME=/usr/local/java/jdk1.8.0_301 export PATH=$JAVA_HOME/bin:$PATH export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar ```保存后执行命令source /etc/profile，输入java -version输出版本信息即成功。
2. 神通数据库安装初始化
运行安装包一路下一步完成安装，Windows系统默认自动启动数据库服务，默认配置信息如下：端口：2003，管理员账号：sysdba，默认密码：szoscar55。
安装完成后打开神通数据库管理工具，点击「新建实例」，设置实例名为archive，字符集必须选择UTF-8，否则会出现中文乱码，其余配置保持默认，完成创建后启动实例。然后打开SQL查询工具，连接新建的archive实例，导入系统自带的init_archive.sql初始脚本，执行完成后即可生成系统需要的初始表结构与数据。
3. Tomcat配置
解压下载的Tomcat压缩包，打开conf/server.xml文件，找到HTTP连接器配置项，修改为以下完整配置（若8080端口被占用，可将port改为其他未使用端口如8081）：
保存后启动Tomcat，Windows执行bin/startup.bat，Linux执行./bin/startup.sh，浏览器访问http://localhost:8080，出现Tomcat默认欢迎页即配置成功。
三、系统部署与参数配置
1. 部署工程包
将获取到的综合档案管理系统神通版工程war包重命名为archive.war，放入Tomcat的webapps目录下，启动Tomcat后会自动解压工程。
2. 修改核心配置
解压完成后，打开webapps/archive/WEB-INF/classes/jdbc.properties文件，修改数据库连接配置，直接复制替换为以下内容（若你的数据库配置有修改，对应替换即可）：
接着打开同目录下的application.yml文件，找到文件存储路径配置项，修改为你提前创建好的存储目录：
- Windows示例：
file.store.path=D:/archive_files - Linux示例：
file.store.path=/opt/archive_files
四、启动验证与基础初始化
1. 部署验证
重启Tomcat，等待1-2分钟让系统完成启动，浏览器访问地址http://你的服务器IP:8080/archive，出现登录页即说明部署成功，默认登录信息：账号admin，密码123456。
2. 基础初始化操作
登录后按照以下步骤完成基础配置，即可正常使用：
- 修改管理员密码：进入「系统管理」→「用户管理」，找到admin用户，点击修改密码，设置符合安全要求的新密码保存。
- 配置档案分类：进入「档案管理」→「分类管理」，点击新增分类，按照实际需求添加一级、二级档案分类，保存即可。
- 配置用户权限：进入「系统管理」→「角色管理」，新建角色（如档案管理员、普通查阅用户），对应勾选可操作的权限，再给新建用户分配对应角色即可。
五、常见问题排查
1. 登录报数据库连接失败：检查神通数据库服务和实例是否启动，jdbc.properties配置是否正确，服务器防火墙是否开放2003和8080端口，Linux开放端口命令： ``` firewall-cmd --add-port=2003/tcp --permanent firewall-cmd --add-port=8080/tcp --permanent firewall-cmd --reload ```
2. 上传档案后无法预览：检查存储路径是否存在，路径斜杠是否正确，Windows不能使用单个反斜杠\，必须使用正斜杠/或双反斜杠\\。
3. 页面中文乱码：检查数据库实例字符集是否为UTF-8，Tomcat的server.xml中Connector是否添加了URIEncoding="UTF-8"配置。
相关文章
