将Xwiki升级到13.10.3

由于系统规划上的原因,需要将先前部署的Xwiki换到新服务器上重新部署,出于功能性和安全性方面的考虑决定在这次重新部署时顺便进行XWiki的升级。记录一下具体过程供有需求的人参考:

1)备份

  • 用Navicat备份了Mysql上的Xwiki数据库;
  • 备份Tomcat下安装Xwiki的Root目录下所有内容(按Xwiki的安装指导,Xwiki的安装包被重命名为ROOT.war,每次启动Xwiki时ROOT.war会被解压到前面提到的ROOT目录)。这个步骤里比较关键的备份项目:
    • ROOT目录下的hibernate.cfg:跟数据库连接相关的配置;
    • ROOT目录下的xwiki.properties:Xwiki内容存放路径相关的配置(特别是environment.permanentDirectory);
    • ROOT\WEB-INF\lib目录下的mysql-connector-java-8.0.23.jar:Mysql8.x的Java驱动程序/连接器;
  • 备份Xwiki相关的附件、图片等:就是上面environment.permanentDirectory参数指定的目录(我这次因为不记得之前配置过这个参数,忘记备份,导致后来Xwiki重启后页面上的一些附件、图片等找不到,吃亏了);

2)升级:官方的升级指导参见https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Upgrade。按照Xwiki官方的说法,应该是可以从任意Xwiki版本升级到最新版本的,如果升级在原地进行的话,需要的操作也很简单,就是将最新的Xwiki包改名后替换掉原来的ROOT.war,然后重新启动Xwiki。不过升级也会造成一些问题,我碰到的情况(升级测试)如下:

  • 首页被重置成Xwiki的默认页,首页页面内容没有了,其它页面没有受到影响;
  • 我在第一次测试时,升级后页面内容无法修改,也不能新建页面,会卡在那里一直转圈,很怀疑跟跳过Flavor更新相关,因为在后来的测试中更新了Flavor就没有这个问题;
  • 权限分组及配置没有了,虽然账户信息都在,但是除Xwiki默认分组外自建的分组及成员所属分组的信息没有了,连管理员组里的成员也没有了。这个有点烦,我是手动重建的;
  • 暂无发现其它问题;
posted @ 2022-03-11 09:15  RobZH  阅读(291)  评论(0)    收藏  举报