xwiki安装部署

时间：2019-06-20 19:54:48 阅读：188 评论：0 收藏：0 [点我收藏+]

环境介绍

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的相关步骤。

安装部署

首先安装好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://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.34/mysql-connector-java-5.1.34.jar 
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
cp ~/mysql-connector-java-5.1.34.jar  /usr/local/xwiki-tomcat/webapps/xwiki/WEB-INF/lib

建库授权

create database xwiki default character set utf8 collate utf8_bin;
grant all privileges on xwiki.* to xwiki@127.0.0.1 identified by 'xwiki';
flush privileges;

数据库连接配置，注释掉 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=/var/local/xwiki/

将xwiki-platform-distribution-flavor-xip-11.1.xip改名为zip后缀，解压到 ${environment.permanentDirectory}/extension/repository/下

mkdir /var/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 /var/local/xwiki/extension/repository
(此处因为xwiki默认也有一个repositoy，我将flavor包也解压了一份到/usr/local/xwiki-tomcat/work/Catalina/localhost/xwiki/extension/repository，但是这里应该没用到，这个目录应该是environment.permanentDirectory=/var/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

配置数据包需要转换的格式,点击最下放的转换

导入进去，文档是有了，但是我的树形结构没了，文章都乱了。