xwiki管理指南-升级

约定不等于承诺〃 2022-05-24 04:46 480阅读 0赞

XWiki有不同方式的安装，你可能需要分以下几种情况进行升级：

# 升级标准版的XWiki #

如果你下载并已经安装了标准版的XWiki（exe, zip 或者 jar 版本）然后想得到升级，那么最简单的方式是下载一个新的版本然后像第一次安装XWiki一样再安装一次。并请注意新的版本不要覆盖旧的版本（两个版本必须同时保留）。

安装完新版本后你需要从旧版本的XWiki复制相关配置文件和目录到新版本的XWiki，请注意不要完全覆盖新版本的配置文件，因为新版本XWiki的文件可能已经加了新的条目，所以你应该合并新旧版本XWiki的配置文件。另一种可行的方法是你可以手动修改新版本XWiki的配置文件然后加上你之前在旧版本XWiki上做的配置。

需要注意的是，在需要时候database schema会进行自动升级。在执行迁移，你需要做的是确保你的xwiki.cfg文件配置正确。下面是来自xwiki.cfg文件相关的摘录：

#-# Whether migrations are enabled or not. Should be enabled when upgrading, but for a better startup time it is better to
    #-# disable them in production.
    xwiki.store.migration=1
    
    #-# Whether to exit after migration. Useful when a server should handle migrations for a large database, without going
    #-# live afterwards.
    # xwiki.store.migration.exitAfterEnd=0
    
    #-# Indicate the list of databases to migrate.
    #-# to upgrade all wikis database set xwiki.store.migration.databases=all
    #-# to upgrade just some wikis databases set xwiki.store.migration.databases=xwiki,wiki1,wiki2
    #-# Note: the main wiki is always migrated whatever the configuration.
    # xwiki.store.migration.databases=

迁移失败的情况下，数据库表**DATABASECHANGELOG**和**DATABASECHANGELOGLOCK**会保留下来。  
确保这些表在重新启动迁移之前被丢弃。

# 升级Debian软件包版的XWiki #

sudo apt-get update  
sudo apt-get upgrade

如果你想避免更新所有包，只更新XWiki，尝试sudo apt-get -s upgrade列出可以升级的所有软件包，然后运行（而不是升级）xwiki-enterprise- 开头的包;即sudo apt-get install xwiki-enterprise-tomcat8-mysql。

但是在升级之后，你还需要安装新的用户界面;查看下文“升级wiki文件”了解更多。

# 升级webapp #

一般来讲，你可以下载新版本的WAR文件然后替换你旧版本的WAR文件，但是请注意不要直接覆盖文件，因为这样做的话会遗留一些旧文件，这会使你的XWiki工作不正常（例如在WEB-INF/lib下旧的JAR文件）。此外你可以替换XWiki中WEB-INF/lib下的部分文件（如xwiki.properties 和 xwiki.cfg）。

因此在你替换你现有的WAR文件的时候请备你的相关文件包括配置文件和数据文件。

再者请保证你用的是一样的XWiki Permanent目录（WEB-INF/xwiki.properties 文件中的 environment.permanentDirectory属性）。

在你升级的过程中也许需要做其他的操作，但是这些操作将在你所升级的新版本的XWiki中的[release notes][]有详细说明，所以升级新版本之前请查阅。release notes中可能包含了新版本的新特性的信息和配置文件需要改动的信息，所有有关新版本的改动和更新将在release notes中公布。

迁移失败的情况下，数据库表**DATABASECHANGELOG**和**DATABASECHANGELOGLOCK**会保留下来。  
确保这些表在重新启动迁移之前被丢弃。

## 无效的插件 ##

在你升级完之后可能有些之前可以工作的插件会出现失效的情况（原因可能是插件的名字已经更改，或者这个插件已经被移除，或者与你安装的WAR文件版本不匹配，例如你看到的下面的情况）。在这种情况下，你将会在控制台看到下面的错误信息:

2013-12-02 11:43:01,688 \[localhost-startStop-1\] WARN  ltInstalledExtensionRepository - Invalid extension \[org.xwiki.enterprise:xwiki-enterprise-ui-common-5.2.1\] on namespace \[wiki:xwiki\]  
2013-12-02 11:43:01,688 \[localhost-startStop-1\] WARN  ltInstalledExtensionRepository - Invalid extension \[org.xwiki.platform:xwiki-platform-workspace-ui-5.2.1\] on namespace \[wiki:xwiki\]  
2013-12-02 11:43:01,688 \[localhost-startStop-1\] WARN  ltInstalledExtensionRepository - Invalid extension \[org.xwiki.enterprise:xwiki-enterprise-ui-mainwiki-5.2.1\] on namespace \[wiki:xwiki\]  
2013-12-02 11:43:01,689 \[localhost-startStop-1\] WARN  ltInstalledExtensionRepository - Invalid extension \[org.xwiki.enterprise:xwiki-enterprise-ui-wiki-all-5.2.1\] on namespace \[wiki:workspacetemplate\]

这些仅仅是警告但不影响实例的稳定性，在下一节所提到的将提示你升级或移除旧的插件（请参阅下一节的**"升级wiki文件"**）

# 升级wiki文件 #

从XWiki 4.3+开始，推荐升级的方式是使用安装向导。安装向导将在你升级XWiki WAR文件后自动运行，它将提示你升级，合并现有的文件并解决文件冲突问题。

XWiki 4.3之前的版本的升级请参阅以下手动升级的说明。

## 手动升级 ##

当你导入相关页面时必须十分小心，尤其是以下页面：

*  XWiki.XWikiPreferences: 此页面包含wiki的一些配置（此页面将覆盖xwiki.cfg里定义的配置），如果你导入新版本的页面，你将丢失使其你之前做的自定义设置如皮肤的选择，wiki的权限等。
 *  XWiki.WebPreferences, Main.WebPreferences 和其他空间的WebPreferences页面: 与XWiki.XWikiPreferences相同。
 *  XWiki.XWikiAllGroup (注册用户列表) and XWiki.AdminGroup (管理员列表): 如果你已经有现有的用户并导入新版本的此页面，你将发现之前的用户不属于之前的用户组，并且会发生不能修改页面，登录等情况，你需要重新将他们放到正确的用户组中。
 *  XWiki.Admin:此页面包含管理员的默认密码，如果你导入此页面将造成一些安全隐患，因此导入此页面时请谨慎考虑。
 *  \*.\*Config:此类文件是配置文件，因此请不要覆盖。如：
    
     *  XWiki.RegistrationConfig: 包含wiki的注册配置信息。
     *  Invitation.InvitationConfig: [ Invitation Application ][Invitation Application]的配置。
 *  XWiki.XWikiServerXwiki (multi wiki):此页面包含服务器的描述和wiki的属性信息。
 *  其他需要修改的页面例如：Main.WebHome, modified Panel 等。

## 清理 ##

*  解压缩在servlet容器中安装的XWiki WAR文件到新的文件夹，请使用jar xvf xwiki-enterprise-web-X.X.war命令或者使用XWIKI的数据导入/导出功能。
 *  合并旧的和新的配置文件（见上文），请注意已作出更改的配置将会丢失，所以在做此动作的时候请小心。
 *  对于新文件夹像xwiki application一样安装到你的servlet容器（你可以拷贝这些文件夹到servlet或者将其打包成WAR文件部署到容器）。

这些步骤完成后你就可以在新版本的XWiki中浏览旧的wiki中数据了。

# 备选: 导出和重新导入 #

有些时候如果你将[现在的内容导出成XAR][XAR]然后重新导入[新的实例][Link 1]将是一件好事。例如如果你有很旧版本的XWiki然后想升级成新版本的XWiki，此方法将提供很好的支持，因为XWiki项目是注重向后兼容，如果有些内容是在几年前创建的，他还可以在新版本的XWiki上运行，例如我们现在还可以支持XWiki 1.0语法（虽然此版本已经在几年前被XWiki 2.0+语法取代）。

小贴士:

*  当你导入页面是请确保导入的是你自己的内容页面而不是XWiki的默认页面，因为这样你将覆盖新的XWiki提供的页面。
 *  当你导出大的XAR文件时你也许会发现有问题，这时你可以安装能在你的旧的系统上运行的导出插件。

[release notes]: http://www.xwiki.org/xwiki/bin/view/ReleaseNotes/
[Invitation Application]: http://extensions.xwiki.org/xwiki/bin/view/Extension/Invitation+Application
[XAR]: https://blog.csdn.net/qq_33873431/article/details/80388320
[Link 1]: https://blog.csdn.net/qq_33873431/article/details/80388191