環境介紹
http://aiushtha-mybook.stor.sinaapp.com/xwiki/xwiki%E4%BB%8E%E5%85%A5%E9%97%A8%E5%88%B0%E8%BF%90%E7%94%A8.html xwiki從入門到運用
本文在centos7上使用jdk1.8 ，tomcat容器安裝 xwiki 11.1 版本，並將confluence數據遷移到xwiki中。
在初始化xwiki的時候會安裝flavor，使得xwiki頁面有各種模塊，由於網絡問題，我選擇離線安裝flavor包，若要在線安裝flavor可省去xwiki-platform-distribution-flavor-xip-11.1.xip的相關步驟。
數據庫安裝配置
yum install mariadb-server mariadb mysql-connector-java -y
cp /usr/share/java/mysql-connector-java.jar /usr/local/xwiki-tomcat/webapps/xwiki/WEB-INF/lib
修改mysql路徑（此文將數據庫與xwiki的主目錄放在 /data下，方便以后的備份與恢復）
cat /etc/my.cnf
[mysqld]
datadir=/data/mysql
socket=/data/mysql/mysql.sock
# Disabling symbolic-links is recommended to prevent assorted security risks
symbolic-links=0
# Settings user and group are ignored when systemd is used.
# If you need to run mysqld under a different user or group,
# customize your systemd unit file for mariadb according to the
# instructions in http://fedoraproject.org/wiki/Systemd
[client]
socket=/data/mysql/mysql.sock
[mysqld_safe]
log-error=/var/log/mariadb/mariadb.log
pid-file=/var/run/mariadb/mariadb.pid
#
# include all files from the config directory
#
!includedir /etc/my.cnf.d
創建mysql目錄並授權
mkdir /data/mysql -p
chown mysql. /data/mysql
systemctl start mariadb
建庫授權
create database xwiki default character set utf8 collate utf8_bin;
grant all privileges on xwiki.* to xwiki@'localhost' identified by 'xwiki';
flush privileges;
xwiki安裝配置
首先安裝好jdk1.8與tomcat，與mysql數據庫。
tomcat主目錄為/usr/local/xwiki-tomcat/
xwiki主程序包；flavor包
cd~
wget http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/11.1/xwiki-platform-distribution-war-11.1.war
wget http://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-flavor-xip/11.1/xwiki-platform-distribution-flavor-xip-11.1.xip
mkdir /usr/local/xwiki-tomcat/webapps/xwiki
unzip ~/xwiki-platform-distribution-war-11.1.war -d /usr/local/xwiki-tomcat/webapps/xwiki
數據庫連接配置，注釋掉 Configuration for the default database 默認配置，替換為新的連接信息
vim /usr/local/xwiki-tomcat/webapps/xwiki/WEB-INF/hibernate.cfg.xml
<property name="connection.url">jdbc:mysql://127.0.0.1/xwiki?useSSL=false</property>
<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="hibernate.connection.charSet">UTF-8</property>
<property name="hibernate.connection.characterEncoding">UTF-8</property>
<property name="hibernate.connection.useUnicode">true</property>
<property name="hibernate.connection.characterEncoding">utf8</property>
<property name="dbcp.poolPreparedStatements">true</property>
<property name="dbcp.maxOpenPreparedStatements">20</property>
<mapping resource="xwiki.hbm.xml"/>
<mapping resource="feeds.hbm.xml"/>
<mapping resource="eventstream.hbm.xml"/>
<mapping resource="instance.hbm.xml"/>
<mapping resource="notification-filter-preferences.hbm.xml"/>
<mapping resource="mailsender.hbm.xml"/>
設置字符集，為節省空間還可以開啟壓縮功能。
vim /usr/local/xwiki-tomcat/conf/server.xml
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
URIEncoding="UTF-8"
compression="on"
compressionMinSize="2048"
compressableMimeType="text/html,text/xml,text/css,text/javascript,application/x-javascript"/>
修改xwiki工作目錄
vim /usr/local/xwiki-tomcat/webapps/xwiki/WEB-INF/xwiki.properties
environment.permanentDirectory=/data/local/xwiki/
將xwiki-platform-distribution-flavor-xip-11.1.xip改名為zip后綴，解壓到 ${environment.permanentDirectory}/extension/repository/下
mkdir /data/local/xwiki/extension/repository -p
mv ~/xwiki-platform-distribution-flavor-xip-11.1.xip ~/xwiki-platform-distribution-flavor-xip-11.1.zip
unzip ~/xwiki-platform-distribution-flavor-xip-11.1.zip -d /data/local/xwiki/extension/repository
(此處因為xwiki默認也有一個repositoy，我將flavor包也解壓了一份到/usr/local/xwiki-tomcat/work/Catalina/localhost/xwiki/extension/repository，但是這里應該沒用到，這個目錄應該是environment.permanentDirectory=/data/local/xwiki/參數未打開時的默認目錄)
tomcat起服務
cd /usr/local/xwiki-tomcat/bin
./startup.sh
wiki初始化
訪問url http://ip:8080/xwiki
此處選擇標准安裝，若在線安裝，初始化步驟一樣，就是這里的安裝速度會很慢
到這里就完成了xwiki的安裝
漢化
部分漢化：wiki語言選擇中文
全漢化：https://blog.csdn.net/sunlight96/article/details/82684437
該文件轉碼后，需要編輯該文件，將你需要中文展示的地方翻譯成中文（翻譯量很大，建議部分漢化就可以）之后再轉碼回去。我嘗試了一下，沒成功，應該是我用了網頁轉碼的問題。
導入數據
http://extensions.xwiki.org/xwiki/bin/view/Extension/Filter+Confluence+XML+module
安裝擴展
由於我要導入confluence的數據，需要在xwiki上裝上擴展： Filter Streams Converter Application與 Confluence XML
安裝 Confluence XML
安裝Filter Streams Converter Application
由於安裝版本是11.1的，安裝11.4報錯不兼容，這里我安裝了9.10
怎么安裝舊版本呢？
這里介紹兩種方法：
- 高級搜索
此處輸入擴展id與版本號
擴展id在這里可以找到
- 列表安裝
安裝好此插件
導入數據
我需要將舊環境confluence的數據導入到新的xwiki
confluence數據導出
進入空間頁面左下角的空間管理，點擊內容工具，導出后下載zip包
xwiki導入
將zip數據包放在xwiki服務器的/tmp/下
web頁面配置
配置導入包的格式：我們是confluence的xml，source那里需要file:/$zip_path/$filename.zip
配置數據包需要轉換的格式,點擊最下放的轉換
導入完成后，我們發現文檔是有了，但是嵌套結構沒了，所有頁面都統一為DEV空間下的第一級子頁面，接下來需要恢復嵌套結構
恢復嵌套結構
安裝擴展 Nested Pages Migrator Application
安裝完成后主頁面新增nested pages migration 選項,點入配置
再此查看，嵌套頁面已恢復。
xwiki的備份與恢復
xwiki不能通過導出的方式自動備份，而是拷貝數據庫與xwiki的工作目錄
將 /data壓縮上傳到文件服務器，以后恢復只要數據庫和xwiki路徑一致就可以，我復制了一份鏡像文件，由於/data掛了盤，鏡像文件只包含系統文件，恢復只需解壓data包，起服務即可。
xwiki備份包導入
現我需要將xwiki a (11.1) 的內容遷移到空白的xwiki b (11.6)上，怎么解決？
用以下的方式導入包,會報錯(可能是因為版本的原因，如果版本相同的包導入，應該會成功，小伙伴們在嘗試之前務必要備份鏡像與工作目錄):
wiki a 導出包:
wiki b 導入包:
我嘗試將不同空間（Blog為技術文章，Xwiki為用戶資料）分開導入：
導出包：
導入包：
另一個用戶空間的包只需要選擇用戶的頁面，其他頁面不要導入
導入后需要給每一個用戶加權限。但是這樣導入的文章作者就都變成導入者了。