MC V6.0非容器部署说明
变更记录
产品版本 | 更新内容 | 更新日期 |
V6.0.1 | 初始版本 | 2023年10月25日 |
1 简介
1.1 功能介绍
MC从6.0版本开始,自升级方式有两种:镜像更新(容器)及补丁上传升级(非容器)。
本文将介绍非容器部署的MC环境如何通过MC补丁升级到V6.0版本。
1.2 应用场景
非容器部署场景,包含通过Linux部署工具搭建及通过Windows轻量级安装工具搭建的MC。
通过安装器部署的环境不推荐使用该方式操作升级。
2 操作过程概述
官网下载6.0最新MC补丁包(或其他传输途径,云之家等),补丁名称通常为:mc-patch-latest.zip;
在MC服务运行时目录下创建补丁文件目录:mc-self-patch,并把补丁内容解压至此;
从补丁内容中拷贝jar包至MC应用仓库路径,完成MC应用仓库更新;
新增MC自升级依赖参数:KFilterConfigFiles.config=kd.bos.mc.filter.selfUpdateFilter.xml;
新增MC6.0运行依赖参数:workflow.engine.start=true;
新增MC6.0外部访问依赖参数:login_api_support_anonymous=true;
重启MC,访问MC服务地址,自动跳转至新版本MC自升级向导;
确认补丁描述信息,并开始自升级;
升级成功,则通过“登录MC”按钮回到登录页面;
升级失败,则通过失败详情定位升级失败原因。
3 补丁上传
3.1 补丁获取
从官网地址下载:https://download.kdcloud.com/
下方MC补丁选择“非镜像MC”
3.2 补丁上传——Linux
1. 进入MC运行时目录。(命令参考:cd /kingdee/cosmic/mc/mservice/bin)
若已注册MC服务,可通过服务状态查看运行路径:systemctl status mc
2. 上传补丁资源包中的mc-self-patch.zip,并解压。
解压后目录结构如图:
3.3 补丁上传——Windows
1. 进入MC运行时目录,路径参考:X://cosmic/mservice/bin
2. 上传6.0补丁资源包中的mc-self-patch.zip,并解压。
解压后目录结构如图:
4 应用仓库更新
4.1 应用仓库更新——Linux
1. 进入MC应用仓库,命令参考:cd /var/apppackage/appstore/mc
应用仓库路径可在MC首页——系统管理——管理中心配置下方查看;
2. 备份(复制)原目录,命令参考:
cp -R /var/apppackage/appstore/mc /var/apppackage/appstore/mc-bak
3. 上传6.0补丁资源包中的apppackage.zip,把全量内容解压至应用仓库目录中。命令参考:
cd /var/apppackage/appstore/mc
unzip -o ../apppackage.zip
4. 解压完成后,应用仓库目录结构与原结构保持一致,如图:
4.2 应用仓库更新——Windows
1. 进入MC应用仓库,路径参考:X://cosmic/apppackage
应用仓库路径可在MC首页——系统管理——管理中心配置下方查看;
2. 备份(复制)原目录,如图:
3. 上传6.0补丁资源包中的apppackage.zip,把全量内容解压至应用仓库目录中。解压完成后,其目录结构与原结构一致,如图:
5 MC参数配置
5.1 参数配置——Linux
1. 进入运行时目录,打开环境变量配置文件。命令参考:
cd /kingdee/cosmic/mc/mservice/bin
vi setappenv.sh
2. 在JVM_OPTS参数中,新增自升级参数,以-D前缀形式拼接:KFilterConfigFiles.config=kd.bos.mc.filter.selfUpdateFilter.xml
注意与前一参数保持空格分隔,如图:
3. 在JVM_OPTS参数中,新增以下服务依赖参数,以-D前缀形式拼接:
workflow.engine.start=true
login_api_support_anonymous=true
appstarter.config=MCAppStarter=kd.bos.mc.core.starter.MCAppStarter
4. 确认已存在文件服务器依赖参数,若未配置则:
在JVM_OPTS参数中,新增以下参数,以-D前缀形式拼接:(具体参数值可按现场文件服务地址调整)
attachmentServer.url=http://127.0.0.1:8100/fileserver/
imageServer.url=http://127.0.0.1:8100/fileserver/
5.2 参数配置——Windows
1. 进入运行时目录,打开环境变量配置文件。
路径参考:X:\cosmic\start-mc.bat
2. 新增自升级参数,以set命令开头: KFilterConfigFiles.config=kd.bos.mc.filter.selfUpdateFilter.xml
3. 新增以下服务依赖参数,以set命令开头:
workflow.engine.start=true
login_api_support_anonymous=true
appstarter.config=MCAppStarter=kd.bos.mc.core.starter.MCAppStarter
4. 确认已存在文件服务器依赖参数,若未配置则新增以下参数:
attachmentServer.url=http://127.0.0.1:8100/fileserver/
imageServer.url=http://127.0.0.1:8100/fileserver/
6 触发升级
6.1 跳转自升级页面
MC应用仓库更新完成后,重启MC。
等待重启完成后,访问MC服务地址,自动跳转触发升级。
6.2 查看升级详情
MC6.0版本,自升级流程包括静态资源更新及数据中心升级。
通过操作列中的查看详情可分别查看升级过程产生的详细日志反馈。
7 升级常见问题
7.1 应用仓库更新后,MC服务重启失败
现象:jar包更新后重启MC,首页访问50x,8080及20880端口未监听等。
原因:部分环境无redis相关配置,由于6.0版本对redis服务产生强依赖,服务启动需保证redis相关参数存在。(mc日志mc.log中可见明显redis字眼的异常堆栈)
解决方案:新增redis参数,配置方式参照第4步【MC参数配置】,具体参数值可按现场文件服务地址调整:
redis.serversForSession=redis:127.0.0.1:6379
redis.serversForCache=redis:127.0.0.1:6379
7.2 MC服务重启后,访问首页不跳转自升级页面
现象:jar包更新后重启MC,通过服务地址访问跳转登录页或首页,未触发升级。
原因:部分环境的配置文件setappenv.sh中,存在其他JVM参数JAVA_APP_OPTS,此时若另外新增JVM_OPTS则新增部分参数不生效。
解决方案:第4步【MC参数配置】中,不新增/编辑JVM_OPTS,调整为在原JAVA_APP_OPTS参数中完成参数配置,如图:
MC V6.0非容器部署说明
本文2024-09-23 01:12:34发表“云苍穹知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-cangqiong-144473.html