目录
Liferay补丁概览
为了修复Liferay的产品相关的问题,Liferay会定期/按需提供补丁。Liferay提供的补丁分以下两种形式:
Fix Pack
Fix Pack是Liferay定期发布的补丁集合。关于Fix Pack,
- Fix Pack下载地址。
- 在Release Notes Tool中可以查看每个Fix Pack的发布日志。其中包括当前Fix Pack中包含的所有修复列表,重要改变,注意事项,安全修复等。
- 新发布的Fix Pack会包含之前发布的Fix Pack中的所有修复。
Hotfix
在修复对应问题的补丁未被包含到Fix Pack之前,Liferay的技术支持团队会创建一个Hotfix来修复对应的问题。
安装补丁
- 在安装补丁前,请做好环境相关备份。
- 关闭应用服务器。
- 将要安装的补丁(Fix Pack 或 Hotfix)放到
{PATCHING_TOOL_HOME}/patches
文件夹下(请不要解压缩zip文件)。 - 在
{PATCHING_TOOL_HOME}
打开命令行。执行patching-tool install
(Windows) 或./patching-tool.sh install
(Unix/Linux)命令来安装补丁。 - 运行
patching-tool info
(Windows) 或./patching-tool.sh info
(Unix/Linux)查看补丁是否安装成功。 - 清理缓存文件
- 删除
$LIFERAY_HOME/osgi/state
文件夹。 - 清空
$LIFERAY_HOME/Work
文件夹。 - 清空
$LIFERAY_HOME/tomcat-version/temp
文件夹。 - 清空
$LIFERAY_HOME/tomcat-version/work
文件夹。
- 删除
- 启动应用服务器。
注:在安装补丁的过程中会在/ROOT/WEB-INF 文件夹中生成patching-backup-deps.zip 和 patching-backup.zip两个文件。这两个文件在后续安装和卸载补丁的过程中是必不可少的。请不要删除或更改这两个文件。
卸载补丁
- 在卸载补丁前,请做好环境相关备份。
- 从
{PATCHING_TOOL_HOME}/patches
文件夹下删除想要卸载的补丁。
注:确保文件夹中只有想要安装的补丁。 - 在
{PATCHING_TOOL_HOME}
打开命令行。执行patching-tool revert
(Windows) 或./patching-tool.sh revert
(Unix/Linux)命令来卸载所有补丁。
注:执行patching-tool revert
会将当前系统的所有补丁统一卸载,相当于回退到当前dxp版本初始发布的状态。如果只是想卸载特定补丁,请继续执行下面的步骤来安装剩余补丁。 - 在
{PATCHING_TOOL_HOME}
打开命令行。执行patching-tool install
(Windows) 或./patching-tool.sh install
(Unix/Linux)命令来安装剩余的补丁。 - 运行
patching-tool info
(Windows) 或./patching-tool.sh info
(Unix/Linux)查看补丁是否卸载成功。
清理缓存文件
- 删除
$LIFERAY_HOME/osgi/state
文件夹。 - 清空
$LIFERAY_HOME/Work
文件夹。 - 清空
$LIFERAY_HOME/tomcat-version/temp
文件夹。 - 清空
$LIFERAY_HOME/tomcat-version/work
文件夹。
- 删除
- 启动应用服务器。
注:部分Fix Pack(例如包含module升级或数据库更改的修复)不能回退到之前的版本。具体的信息可以查看对应版本的Important Fix Pack Changes页面。例如:Liferay DXP 7.0 Important Fix Pack Changes
更新Patching Tool版本
在安装补丁的过程中,可能会要求更新Patching Tool的版本。具体的更新Patching Tool的步骤如下:
- 在Patching Tool页面下载最新的Patching Tool。
- 将下载的文件解压缩到$LIFERAY_HOME路径下(覆盖原有的patching-tool文件夹)。
- 在
{PATCHING_TOOL_HOME}
打开命令行。执行patching-tool auto-discovery
(Windows) 或./patching-tool.sh patching-tool auto-discovery
(Unix/Linux)命令来配置Patching Tool。
技术支持相关的Patching Tool命令
- 查看补丁版本:
patching-tool info
- 输出当前环境的补丁版本到文本文件中:
patching-tool info > patchinfo.txt
- 输出详细的系统/环境信息到文本文件中。相当于同时执行patching-tool info, modules-info, list-plugins, list-customizations, list-collisions, and system-info 命令。
patching-tool support-info