系统安装
一、准备工作
1、下载DocSystem.war和DocSystem.sql
下载地址： https://gitee.com/RainyGao/DocSys/releases
2、DocSystem.war配置文件修改
将DocSystem.war重命名为DocSystem.zip文件，进入zip文件的WEB-INF/classes/目录，修改以下两个配置文件，修改完成后改为DocSystem.war
(1) 数据库配置：jdbc.properties
- 数据库访问地址
- 数据库访问用户
(2) 系统配置：docSysConfig.properties
- 邮件服务配置
- openOffice路径配置
- lucene全文搜索存储路径配置
二、Windows系统安装步骤
1、安装JDK
（1）下载地址
官网：https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
CSND: https://download.csdn.net/download/tomoyuyo/10346023
DocSys:
（2）安装说明
请使用JDK或JRE 1.8版本
2、安装OpenOffice（Office文件预览）
（1）下载地址：
官网：http://www.openoffice.org/zh-cn/download/
CSND: https://download.csdn.net/download/qq_34941558/10291105
DocSys:
（2）安装说明
请将OpenOffice安装在以下目录： C:\Program Files (x86)\OpenOffice 4\，否则需要修改docSysConfig.properties中的openOffice路径配置
3、安装XAMPP（tomcat和mysql）
（1）下载地址：
官网：https://www.apachefriends.org/download.html
CSDN：https://download.csdn.net/download/fu18838928050/10631810
DocSys:
（2）安装说明
- 安装完成后启动Apache、mysql和tomcat
- 点击mysql的admin进入mysql的管理页面，新增数据库docsystem，并导入docsystem.sql以初始化数据库的表结构
- 点击tomcat的config按键，选择“”找到webapps目录，将DocSystem.war放到该目录，点击Start启动
4、访问
本机访问：http://localhost:8080/DocSystem
远程访问：将localhost改为IP地址即可
三、Linux系统安装步骤
1、安装JDK
请使用JDK或JRE 1.8版本
2、安装OpenOffice（Office文件预览）
请将OpenOffice安装在以下目录： "/opt/openoffice.org3"
3、安装mysql并初始化数据库
（1）下载Linux版本的mysql安装包，将其解压到/usr/local/mysql目录即可
（2）启动mysql服务：service mysql start
（3）使用命令行新建docsystem数据库并导入docsystem.sql文件
4、安装tomcat
（1）下载Linux版本的tomcat7安装包，将其解压到以下目录/usr/local/tomcat目录即可
（2）将DocSytem.war复制到tomcat的webapps目录
（3）启动tomcat: service tomcat7 start
5、访问
本机访问：http://localhost:8080/DocSystem
远程访问：将localhost改为IP地址即可
三、常见问题
1、Tomcat链接无法访问
(1) Tomcat版本不正确
无论是xampp还是手动安装tomcat，请务必使用tomcat7
(2) Java版本不正确
由于系统中可能存在多个Java版本，需要确定tomcat7使用了正确的Java版本（1.8.0_1.5.1以上版本）
- Windows系统下，xampp 里 tomcat 使用的是注册表里指定的java版本，请使用 regedit 命令打开注册表，查看HKEY_LOCAL_MACHINE -> SOFTWARE -> JavaSoft -> Java Runtime Enviornment 里的信息，如有特殊需求可以修改启动脚本： catalina_start.bat
- Windows系统下，手动安装的tomcat使用的是当前配置在环境变量里的java版本（也就是java -version 命令看到的版本），使用 echo %path%命令可以查看产看环境变量的设置
- Linux 系统下，xampp 里 tomcat 使用的java版本在自动脚步 catalina_start.sh 里指定的，如有特殊需求可以自行修改，宝塔Linux系统可以指定java版本是同样的原理
- Linux系统下，手动安装的tomcat使用的是环境变量里设置的java版本（也就是java -version 命令看到的版本），使用 echo $PAHT 可以查看环境变量设置
(3) java版本冲突（Windows）
如果通过以上设置，tomcat 启动仍然时提示java版本错误的话，可能系统中Java版本信息已经混乱，建议彻底删除所有Java版本（包括注册表里的信息），然后全新安装JDK8
2、Tomcat链接无法访问DocSys链接无法访问，但tomcat链接可以访问
(1) mysql未安装或未启动
(2) mysql存在anyuser用户 （任意用户的存在将导致其他用户无法通过连接mysql）
(3) DocSystem.war的数据库配置不正确
可以通过以下命令来导出docsystem数据库的所有数据来确认配置是否正确（如果不需要密码则把-p选项去掉，-p和密码不要有空格）：
mysqldump -u root -p123456 DocSystem > DocSystemAll.sql
(4) mysql链接区分大小
有些mysql链接的数据库名区分大小写，那么务必保证DocSystem.war中的数据库配置文件的数据库名字和你创建的数据库名字大小写相同
db.url=jdbc:mysql://localhost:3306/DocSystem?zeroDateTimeBehavior=convertToNull&characterEncoding=utf8
3、文件无法预览
（1）文件类型不支持（目前只支持word、excel、ppt）
（2）OpenOffice未安装
（3） DocSystem.war包中的docSysConfig.properties里的配置的OpenOffice与实际安装的路径不一致
4、不支持全文搜索
（1） Java版本低于1.8.0_1.5.1版本
（2） DocSystem.war包中的docSysConfig.properties里的配置的全文搜索索引存储路径没有访问权限
5、文件无法新建或上传
（1）仓库指定的目录没有访问权限