最近需要做一個(gè)wiki系統(tǒng)农猬，于是接觸到了XWiki這個(gè)開(kāi)源項(xiàng)目「穆眨總而言之矢炼，xwiki對(duì)各個(gè)軟件的版本要求比較高，很多必須嚴(yán)格一致阿纤。
在開(kāi)始之前句灌，先列出所有必需項(xiàng)：
- apache-tomcat
- mysql-5.7
- mysql-connector-java-5.1
- xwiki-platform-distribution-flavor-xip-11.5
- xwiki-platform-distribution-war-11.5
- vc++ 2013（mysql運(yùn)行必需）
- jdk11
- chrome/firefox等
好了，廢話不多說(shuō)欠拾，開(kāi)始安裝胰锌。
-
首先，進(jìn)入XWiki官網(wǎng)藐窄，進(jìn)入右上角的DOWNLOAD资昧，選擇Stable版本，在這里有多種安裝方式：
xwiki-download.png
選擇前記得先根據(jù)對(duì)應(yīng)的jdk版本進(jìn)行匹配（具體請(qǐng)查看System Requirements)荆忍，如下圖所示：
系統(tǒng)要求.PNG
我選擇的是war包部署格带，版本號(hào)11.5，jdk11刹枉，Docker和Linux的安裝略過(guò)践惑。
- 在該頁(yè)面下載war包和下方的XIP Package，后面要用到嘶卧。
-
安裝Tomcat：
Tomcat的版本注意官網(wǎng)上的說(shuō)明尔觉，不要用到下列版本，會(huì)出問(wèn)題：
xwiki-tomcat-select.png
具體安裝很簡(jiǎn)單芥吟，到官網(wǎng)下載zip包解壓即可侦铜。
- 配置xwiki存儲(chǔ)用的永久目錄（permanent directory)
首先把下載的xwiki的war包全部解壓到tomcat\webapps\xwiki下，進(jìn)入WEB-INF 目錄钟鸵，編輯xwiki.properties文件钉稍，在空白處添加environment.permanentDirectory=D:\xwiki，目錄可以自己定棺耍。 - 激活超級(jí)管理員模式
編輯xwiki.cfg贡未，找到#xwiki.superadminpassword=system，把#去掉，激活超級(jí)管理員模式（實(shí)測(cè)不打開(kāi)超級(jí)管理員模式而自己創(chuàng)建用戶(hù)進(jìn)行安裝俊卤，會(huì)出現(xiàn)bug）嫩挤，system是密碼。 - 配置Tomcat最大內(nèi)存限制
編輯tomcat/conf/context.xml消恍，在<context></context>中添加
<Resources cachingAllowed="true" cacheMaxSize="100000" />即可岂昭。
最后記得把XIP包解壓到永久目錄下的extension\repository里，供離線安裝standard flavor使用狠怨，因?yàn)槟J(rèn)在線安裝跟蝸牛一樣慢
-
配置MySQL：
MySQL官方推薦mysql-5.7和mysql-connector-java-5.1约啊，8.x版本有bug。
到官網(wǎng)下載mysql后佣赖，解壓恰矩，在根目錄新建my.ini文件和Data文件夾：
[mysqld]
# 設(shè)置3306端口
port=3306
# 設(shè)置mysql的安裝目錄
basedir=D:\\mysql-5.7.27-winx64
# 設(shè)置mysql數(shù)據(jù)庫(kù)的數(shù)據(jù)的存放目錄
datadir=D:\\mysql-5.7.27-winx64\\Data
# 允許最大連接數(shù)
max_connections=200
# 允許連接失敗的次數(shù)。這是為了防止有人從該主機(jī)試圖攻擊數(shù)據(jù)庫(kù)系統(tǒng)
max_connect_errors=10
# 服務(wù)端使用的字符集默認(rèn)為UTF8
character-set-server=utf8
# 創(chuàng)建新表時(shí)將使用的默認(rèn)存儲(chǔ)引擎
default-storage-engine=INNODB
# 默認(rèn)使用“mysql_native_password”插件認(rèn)證
default_authentication_plugin=mysql_native_password
[mysql]
# 設(shè)置mysql客戶(hù)端默認(rèn)字符集
default-character-set=utf8
[client]
# 設(shè)置mysql客戶(hù)端連接服務(wù)端時(shí)默認(rèn)使用的端口
port=3306
default-character-set=utf8
編輯保存.
- 添加mysql-5.7\bin到環(huán)境變量
- 接著打開(kāi)PowerShell（必須管理員模式）憎蛤，逐步輸入：
#初始化數(shù)據(jù)庫(kù)外傅，切記要記住打印出來(lái)的root初始密碼
mysqld --initialize --console
mysqld install
#啟動(dòng)服務(wù)
net start mysql
mysql -u root -p
#輸入初始密碼，進(jìn)入后更改密碼方便以后操作
#創(chuàng)建數(shù)據(jù)庫(kù)和用戶(hù)
create database xwiki default character set utf8 collate utf8_bin;
create user 'xwiki'@'localhost' identified by 'xwiki';
#給與權(quán)限
grant all privileges on *.* to xwiki@localhost identified by 'xwiki';
mysql配置完了蹂午？還沒(méi)完栏豺，再次進(jìn)入到tomcat\webapps\xwiki\WEB-INF，打開(kāi)hibernate.cfg.xml豆胸，找到類(lèi)似下方的默認(rèn)數(shù)據(jù)庫(kù)連接配置奥洼，修改為：
<property name="connection.url">jdbc:mysql://localhost/xwiki?serverTimezone=UTC</property>
<!--serverTimezone=UTC必加，否則報(bào)錯(cuò)500-->
<property name="connection.username">xwiki</property>
<property name="connection.password">xwiki</property>
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property>
<property name="connection.useUnicode">true</property>
<property name="connection.characterEncoding">UTF-8</property>
- 最后把之前下的mysql-connector-java-5.1放到WEB-INF\lib中晚胡。
- 添加tomcat\bin到環(huán)境變量Path中灵奖，打開(kāi)cmd窗口輸入startup.bat，啟動(dòng)后瀏覽器輸入localhost:8080/xwiki即可進(jìn)入xwiki界面
TIPS:
- 若是tomcat啟動(dòng)亂碼估盘，可以修改tomcat目錄下conf\logging.properties瓷患，找到：
java.util.logging.ConsoleHandler.encoding = UTF-8
把UTF-8改為GBK即可。 - 第一次進(jìn)入可能會(huì)讓你注冊(cè)遣妥，不用管擅编，直接點(diǎn)Later跳過(guò)，在主界面點(diǎn)右上角Log in箫踩，用superadmin登錄爱态，退出后重啟tomcat再進(jìn)入即可直接用superadmin安裝。
