开源知识库软件xwiki在Windows下的安装

文章目录

  • 开源知识库软件-xwiki在windows上的部署
    • 0、参考文档
    • 1、前置环境准备
      • 1.1、Windows版本及系统配置
      • 1.2、JDK11安装
      • 1.3、Tomcat9安装
      • 1.4、MySQL5.7数据库的安装
    • 2、xwiki安装
    • 3、配置
      • 3.1、修改配置支持对文档内容进行搜索
    • 4、问题解决
      • 4.1、附件无法上传问题
      • 4.1、附件无法下载和删除问题

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

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

0、参考文档

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

XWiKi 部分汉化

1、前置环境准备

1.1、Windows版本及系统配置

Windows10专业版,32GB内存
开源知识库软件xwiki在Windows下的安装_第1张图片

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:mysql://IP地址:端口号/xwiki?useUnicode=true&characterEncoding=utf-8property>
 <property name="hibernate.connection.username">xwikiproperty>
<property name="hibernate.connection.password">xwiki用户的密码property>
<property name="hibernate.connection.driver_class">com.mysql.jdbc.Driverproperty>

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

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

  3. 运行startup.bat启动Tomcat

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

3、配置

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

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

  1. 点击右上角如下图标
    开源知识库软件xwiki在Windows下的安装_第2张图片

  2. 点击“管理wiki”
    开源知识库软件xwiki在Windows下的安装_第3张图片

  3. 点击“查询”
    开源知识库软件xwiki在Windows下的安装_第4张图片

  4. 点击“查询”
    开源知识库软件xwiki在Windows下的安装_第5张图片

  5. 将“缺省的搜索引擎”由Solr改为Database即可。
    开源知识库软件xwiki在Windows下的安装_第6张图片

4、问题解决

4.1、附件无法上传问题

一般这种问题是由于配置了nginx作为负载均衡,需要在nginx的http那里增加一句话:client_max_body size 1024m;如下所示:
开源知识库软件xwiki在Windows下的安装_第7张图片

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的问题。

你可能感兴趣的:(知识管理,知识管理)