MC V6.0非容器部署说明

栏目:云苍穹知识作者:金蝶来源:金蝶云社区发布:2024-09-23浏览:2

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 操作过程概述

  1. 官网下载6.0最新MC补丁包(或其他传输途径,云之家等),补丁名称通常为:mc-patch-latest.zip

  2. MC服务运行时目录下创建补丁文件目录:mc-self-patch,并把补丁内容解压至此;

  3. 从补丁内容中拷贝jar包至MC应用仓库路径,完成MC应用仓库更新

  4. 新增MC自升级依赖参数:KFilterConfigFiles.config=kd.bos.mc.filter.selfUpdateFilter.xml

  5. 新增MC6.0运行依赖参数:workflow.engine.start=true

  6. 新增MC6.0外部访问依赖参数:login_api_support_anonymous=true

  7. 重启MC,访问MC服务地址,自动跳转至新版本MC自升级向导;

  8. 确认补丁描述信息,并开始自升级;

  9. 升级成功,则通过“登录MC”按钮回到登录页面;

  10. 升级失败,则通过失败详情定位升级失败原因。


3 补丁上传

3.1 补丁获取


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.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非容器部署说明

变更记录产品版本更新内容更新日期V6.0.1初始版本2023年10月25日1 简介1.1 功能介绍MC从6.0版本开始,自升级方式有两种:镜像更新(容器...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息