开源知识库软件xwiki在Windows下的安装-CSDN博客

开源知识库软件-xwiki在windows上的部署

xwiki是java语言开发的开源知识库

0、参考文档

开源知识库软件-xwiki在windows下的安装基本参考这个安装即可。

XWiKi 部分汉化

1、前置环境准备

1.1、Windows版本及系统配置

Windows10专业版32GB内存

1.2、JDK11安装

1、xwiki15版本要求至少JDK11。
2、到oracle官网系在JDK11安装。
3、Java11安装以后在Windows的环境变量里配置JAVA_HOME值就是JDK11的安装地址。如果不配置JAVA_HOME接下来的Tomcat运行会报错。

1.3、Tomcat9安装

1、xwiki15版本要求至少Tomcat9及以上。
2、到Tomcat官网下载Tomcat9解压缩即可。

1.4、MySQL5.7数据库的安装

1、xwiki15需要MySQL5.7版本注意5.1.7不可以会报错。
2、安装了MySQL5.7后创建一个数据库xwiki并创建一个用户xwiki将数据xwiki的所有权限除了Grant外均授权给xwiki用户。

2、xwiki安装

1. 到xwiki官网下载war包将war包解压缩重命名为xwiki放到Tomcat9的webapps目录下。
2. 修改配置文件xwiki\WEB-INF\hibernate.cfg.xml注释掉默认的hsqldb数据库配置使用MySQL的数据库配置如下所示

<!-- <property name="hibernate.connection.url">jdbc:hsqldb:file:${environment.permanentDirectory}/database/xwiki_db;shutdown=true</property>
<property name="hibernate.connection.username">sa</property>
<property name="hibernate.connection.password"></property>
<property name="hibernate.connection.driver_class">org.hsqldb.jdbcDriver</property>-->

<property name="hibernate.connection.url">jdbc:mysql://IP地址:端口号/xwiki?useUnicode=true&amp;characterEncoding=utf-8</property>
 <property name="hibernate.connection.username">xwiki</property>
<property name="hibernate.connection.password">xwiki用户的密码</property>
<property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>

3. 将MySQL的jdbc驱动 mysql-connector-java-5.1.49.jar复制到xwiki\WEB-INF\lib目录下。

4. 修改XWiki的默认工作路径修改配置文xwiki/WEB-INF/xwiki.properties的environment.permanentDirectory=D:\apache-tomcat-9.0.73\webapps\wiki\data也可以改为其他目录。

5. 运行startup.bat启动Tomcat

6. 访问http://localhost:8080/xwiki/根据指引逐步初始化xwiki

3、配置

3.1、修改配置支持对文档内容进行搜索

默认的配置只支持对文档标题进行搜索因此需要做如下配置实现对内容的搜索

1. 点击右上角如下图标
   

2. 点击“管理wiki”
   

3. 点击“查询”
   

4. 点击“查询”
   

5. 将“缺省的搜索引擎”由Solr改为Database即可。
   

4、问题解决

4.1、附件无法上传问题

一般这种问题是由于配置了nginx作为负载均衡需要在nginx的http那里增加一句话client_max_body size 1024m;如下所示

4.1、附件无法下载和删除问题

1、查了下官方FAQ宣称无法下载现象基本上都是环境问题。网络带宽、负载均衡配置、网络安全限制都可能造成附件无法下载,其中负载均衡节点可能会限制响应体大小。详见https://kkxwiki.seeyoncloud.com/bin/viewrev/maintenance/%E5%B9%B3%E5%8F%B0%E5%AE%A2%E6%88%B7BUG_FAQ/WebHome?rev=2.1
2、然后我试了下不经过nginx果然可以下载和删除。所以应该是nginx的问题。