Liferay补丁概览

目录

• Liferay补丁概览
  • Fix Pack
  • Hotfix
• 安装补丁
• 卸载补丁
• 更新Patching Tool版本
• 技术支持相关的Patching Tool命令

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来修复对应的问题。

安装补丁

1. 在安装补丁前，请做好环境相关备份。
2. 关闭应用服务器。
3. 将要安装的补丁（Fix Pack 或 Hotfix）放到{PATCHING_TOOL_HOME}/patches文件夹下（请不要解压缩zip文件）。
4. 在{PATCHING_TOOL_HOME}打开命令行。执行patching-tool install (Windows) 或 ./patching-tool.sh install (Unix/Linux)命令来安装补丁。
5. 运行patching-tool info (Windows) 或 ./patching-tool.sh info (Unix/Linux)查看补丁是否安装成功。
6. 清理缓存文件
   
   • 删除 $LIFERAY_HOME/osgi/state 文件夹。
   • 清空 $LIFERAY_HOME/Work 文件夹。
   • 清空 $LIFERAY_HOME/tomcat-version/temp 文件夹。
   • 清空 $LIFERAY_HOME/tomcat-version/work 文件夹。
7. 启动应用服务器。

注：在安装补丁的过程中会在/ROOT/WEB-INF 文件夹中生成patching-backup-deps.zip 和 patching-backup.zip两个文件。这两个文件在后续安装和卸载补丁的过程中是必不可少的。请不要删除或更改这两个文件。

卸载补丁

1. 在卸载补丁前，请做好环境相关备份。
2. 从{PATCHING_TOOL_HOME}/patches文件夹下删除想要卸载的补丁。
   注：确保文件夹中只有想要安装的补丁。
3. 在{PATCHING_TOOL_HOME}打开命令行。执行patching-tool revert (Windows) 或 ./patching-tool.sh revert (Unix/Linux)命令来卸载所有补丁。
   注：执行patching-tool revert会将当前系统的所有补丁统一卸载，相当于回退到当前dxp版本初始发布的状态。如果只是想卸载特定补丁，请继续执行下面的步骤来安装剩余补丁。
4. 在{PATCHING_TOOL_HOME}打开命令行。执行patching-tool install (Windows) 或 ./patching-tool.sh install (Unix/Linux)命令来安装剩余的补丁。
5. 运行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 文件夹。
6. 启动应用服务器。

注：部分Fix Pack（例如包含module升级或数据库更改的修复）不能回退到之前的版本。具体的信息可以查看对应版本的Important Fix Pack Changes页面。例如：Liferay DXP 7.0 Important Fix Pack Changes

更新Patching Tool版本

在安装补丁的过程中，可能会要求更新Patching Tool的版本。具体的更新Patching Tool的步骤如下：

1. 在Patching Tool页面下载最新的Patching Tool。
2. 将下载的文件解压缩到$LIFERAY_HOME路径下（覆盖原有的patching-tool文件夹）。
3. 在{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