Linux 系统下 LibreOffice 升级操作指南

本文适用于

HCL Connections Docs 2.0.2

介绍

在 Linux 环境运维 HCL Connections Docs 时，有时需要将 LibreOffice 升级至更高版本。

安装程序默认内置固定的旧版 LibreOffice（例如 7.2、7.6）。若企业安全规范要求使用更高版本，需手动卸载旧版本、全新安装 RPM 安装包，并重新配置 Symphony 实例，使其指向新版 LibreOffice 程序路径。

说明

升级核心流程：替换服务器二进制程序，并修改应用配置文件识别新路径。

注意：下方命令中的 $version 请替换为你下载的 LibreOffice 实际版本号。

第一阶段：卸载现有旧版本

执行以下命令卸载旧版 LibreOffice，并完整删除安装目录：

sudo yum remove libreoffice\*

rm -rf /opt/libreoffice

第二阶段：安装新版本

1. 解压已下载的 LibreOffice 压缩包：

tar zxvf LibreOffice_$version_Linux_x86-rpm.tar.gz

2. 进入解压目录，安装全部 RPM 安装包：

sudo yum localinstall *.rpm

第三阶段：配置 HCL Connections Docs

1. 编辑 IBMDocs 配置目录下的 conversion-config.json 文件，修改为新版路径（将 CellName 替换为你的环境单元名）：

vi /opt/IBM/Websphere/AppServer/profiles/Dmgr01/config/cells/CellName/IBMDocs-config/conversion-config.json

2. 找到 libreOffice 配置项，更新路径内的版本号：

"libreOffice":{

   "path":"/opt/libreoffice$version/program",

3. 修改前先备份 Symphony 目录：

cp -a /opt/HCL/DocsConversion/symphony /opt/HCL/DocsConversion/symphony-backup

4. 将新版 LibreOffice 目录复制到所有 Symphony 实例目录（instX）：

for dir in /opt/HCL/DocsConversion/symphony/inst*/; do cp -r /opt/libreoffice$version "$dir"; done

5.（可选但推荐）清理 Symphony 目录内旧版 LibreOffice 文件：

for dir in /opt/HCL/DocsConversion/symphony/inst*/; do find "$dir" -mindepth 1 -maxdepth 1 ! -name libreoffice$version -exec rm -rf {} +; done

6. 校验每个instX文件夹均已存放新版程序：

ls /opt/HCL/DocsConversion/symphony/inst*/libreoffice$version

7. 强制终止所有正在运行的 LibreOffice 进程：

pkill -9 soffice.bin

第四阶段：更新监控脚本与实例配置

1. 检查监控脚本 template.sh（路径 /opt/HCL/DocsConversion/symphony/sym_monitor/template.sh），确认启动参数无误：

userInstallationPath=file://$(dirname $(dirname $(dirname "$1")))

"$1" --headless --nofirststartwizard "--accept=socket,host=0.0.0.0,port=${2};urp;StarOffice.ServiceManager" -env:UserInstallation="$userInstallationPath" &

2. 使用 sed 批量替换 instances.cfg 内旧版本路径（示例：将 libreoffice7.6 替换为新版号）：

sed -i 's|libreoffice7.6|libreoffice$version|g' /opt/HCL/DocsConversion/symphony/sym_monitor/instances.cfg

第五阶段：收尾验证

重启 HCL Connections Docs 服务，使全部配置生效并验证升级结果