xwiki部署
官方文档，比较详细。
https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/InstallationWAR/
xwiki是基于java的开源知识库，可以替代Confluence。有多种部署方式，本文使用war方式部署在tomca下，需要提供jdbc驱动jar包，修改WEB-INF/hibernate.cfg.xml，解压xip包，按向导一步步部署即可。xwiki会自动建表。
使用war部署
下载使用最新的tomat9.x
wget https://dlcdn.apache.org/tomcat/tomcat-9/v9.0.100/bin/apache-tomcat-9.0.100.tar.gz
下载xwiki的war部署包及XIP页面风格包
https://www.xwiki.org/xwiki/bin/view/Download/DownloadVersion/?projectVersion=16.10.4
wget https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/16.10.4/xwiki-platform-distribution-war-16.10.4.war
wget https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-flavor-xip/16.10.4/xwiki-platform-distribution-flavor-xip-16.10.4.xip
下载jdk17
wget https://download.java.net/java/GA/jdk17.0.1/2a2082e5a09d4267845be086888add4f/12/GPL/openjdk-17.0.1_linux-x64_bin.tar.gz
tar -zxvf openjdk-17.0.1_linux-x64_bin.tar.gz
mv jdk-17.0.1 /usr/lib/jvm/
/usr/lib/jvm/jdk-17.0.1/bin/java -version
部署及修改配置
tomat修改
-
修改tomat规则文件
vi catalina.policy
grant codeBase "file:<full-path-here>/webapps/xwiki/WEB-INF/lib/-" {permission java.util.PropertyPermission "file.encoding", "read"; // Needed by Hibernate -> antlrpermission java.util.PropertyPermission "ANTLR_DO_NOT_EXIT", "read";permission java.util.PropertyPermission "ANTLR_USE_DIRECT_CLASS_LOADING", "read"; // Needed by Hibernate and otherspermission java.lang.reflect.ReflectPermission "suppressAccessChecks";permission java.lang.RuntimePermission "createClassLoader";permission java.lang.RuntimePermission "setContextClassLoader"; // Needed by commons-loggingpermission java.util.PropertyPermission "org.apache.commons.logging.LogFactory.HashtableImpl", "read"; // Needed for connecting to the databasepermission java.net.SocketPermission "127.0.0.1:3306", "connect,resolve"; // Needed by the scheduler plugin -> quartz, but works without (maybe except scheduling? should be checked) // permission java.util.PropertyPermission "org.quartz.properties", "read";//Allow file storage directory reading - for directory and everything underneath //This is dependent on the setting of environment.permanentDirectory in xwiki.properties permission java.io.FilePermission "${catalina.home}${file.separator}xwikidata${file.separator}", "read,write,delete"; permission java.io.FilePermission "${catalina.home}${file.separator}xwikidata${file.separator}-", "read,write,delete"; //Allow file storage directory reading - temporary directory and everything underneath //This is dependent on the setting of environment.temporaryDirectory in xwiki.properties. permission java.io.FilePermission "${catalina.home}${file.separator}temp${file.separator}", "read,write,delete"; permission java.io.FilePermission "${catalina.home}${file.separator}temp${file.separator}-", "read,write,delete"; }; -
conf/server.xml没设置编码的增加编码设置URIEncoding=“UTF-8”
<Connector port="8080" protocol="HTTP/1.1"connectionTimeout="20000"redirectPort="8443"maxParameterCount="1000"URIEncoding="UTF-8"/>
-
修改启动脚本startup.sh和catalina.sh增加JAVA_HOME
vi startup.sh #o JAVA_HOME=/usr/lib/jvm/jdk-17.0.1 PATH=/usr/lib/jvm/jdk-17.0.1/bin:$PATH -
重命名war为xwiki.war复制到webapp目录，手工解压war。
-
下载xip包后解压后的文件全部移动到到永久数据目录下的extension/repository
修改配置文件
WEB-INF/xwiki.properties
设置永久目录environment.permanentDirectory及
mkdir -p /iflytek/xwiki/data
vi xwiki.properties
#o
environment.permanentDirectory = /iflytek/xwiki/data/
extension.repositories=https://nexus.xwiki.org/nexus/content/groups/public/
WEB-INF/hibernate.cfg.xml
- 准备xwiki数据库
create database xwiki default character set utf8 collate utf8_bin;
编辑你的 MySQL 配置文件 my.cnf（通常位于 /etc/mysql/my.cnf 或 /etc/my.cnf）。
在 [mysqld] 部分添加以下行：
max_allowed_packet = 100M
-
修改WEB-INF/hibernate.cfg.xml,注释默认数据并放开mysql数据库的注释，修改改数据库信息ip端口，用户名密码等。
-
复制mysql的jdbc驱动包mysql-connector-java-8.0.29.jar到xwiki的lib目录。
上传Flavor拓展包到拓展目录
https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-flavor-xip/16.10.4/xwiki-platform-distribution-flavor-xip-16.10.4.xip
下载对应版本的xip包解压后的文件复制到永久数据目录下的extension/repository
unzip -q xwiki-platform-distribution-flavor-xip-16.10.4.xip
重启tomcat后，浏览器访问http://localhost:8080/xwiki
/iflytek/server/apache-tomcat-9.0.100/bin/shutdown.sh
/iflytek/server/apache-tomcat-9.0.100/bin/startup.sh
首次访问会开始初始化，自动在数据库建表（需要后续手工创建索引提升性能），等待初始化完成开始进入安装向导。
Continue注册admin用户
会有显示xip解压后的Flavor，选中点击Install，等待安装。
安装失败时注意分析日志,solr在有其他wiki服务启动的时候会被锁定，停止其他wiki服务后删除锁文件，自动重试通过，完成安装。
配置
国际化
右侧点击Administer Wiki
Content(内容)–Locailzation(国际化)–设置language默认语言为中文
隐藏左侧应用面板：
管理Wiki–外观–
- 以管理员身份登录 XWiki。
- 点击右上角图标打开侧边栏菜单，再点击管理Wiki。
- 点击 “外观”–“面板编辑”。
- 在 "显示在左侧的面板"中删除Panels.Application
- 保存新的布局后刷新查看
“外观”–"显示"下可以修改页头页脚。
不了解的配置可以问问大模型，现在大模型能力还是比较强的。
拓展包安装
右侧点击Administer Wiki
拓展–Extensions，然后从右侧选择需要的拓展包Install即可。