系統安裝
一、準備工作
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）倉庫指定的目錄沒有訪問權限