部署手册

# MC配置

以下以现有租户和数据中心为例，否则选择现有租户和数据中心即可

# 新建分库标识

路径：基础数据维护-分库标识维护, 点击【新增】

img

# 新建数据中心分库模板

路径：基础数据维护-数据中心分库模板

image-20221205164123006

增加其他需要的库：系统库sys，流程服务库wfs，扩展开发库secd，日志库log

image-20221205164211840

# 新增/当前租户，创建数据中心

路径：点击【租户列表】，点击新增

image-20221205164302548

保存后，点击增加数据中心

image-20221205164343859

按照步骤提交建库，除以上5个库外（amdm，sys，wfs，log，secd），还需要在元数据库下，填写元数据库的实例名和所属数据库

image-20221205170448485

# 主数据产品安装与升级

# 苍穹平台许可申请

（1） 苍穹平台许可申请参见xxx许可申请文档；

（2） 许可申请后，在MC导入许可文件；

image-20221206144127768

（3） 苍穹平台端管理员用户administrator登录，为许可组中用户增加许可，并同步许可，同步状态=已同步后，该用户具有许可组权限。

image-20221206142637698

# 苍穹平台许可异常排查

（1）在MC（即：金蝶云苍穹管理中心）中，主数据管理的许可导入成功，但许可信息不能正常显示时，可按以下方法排查 。

​ 在MC部署的数据库实例中执行以下查询脚本，查询T_MC_LICENSEGROUP和T_MC_LICENSEGROUP_L表，查询语句及正确的查询结果如下。 a) SELECT * FROM T_MC_LICENSEGROUP WHERE FID in (105217430774612701,105217430774612702,105217430774612703);image-20230116111922336

b) SELECT * FROM T_MC_LICENSEGROUP_L WHERE FPKID in ('1067215530277996501','106721553027799602','106721553027799603');image-20230118143427617

执行以上查询脚本后，数据库中没有相应记录，可使用以下语句插入相关许可记录。

--新增许可的管理分组：主数据管理分组
DELETE FROM T_MC_LICENSEGROUP WHERE FID = 105217430774612701;
INSERT INTO T_MC_LICENSEGROUP (FID,  FNUMBER, FTYPE, FSTATUS) VALUES (105217430774612701,'GOV_DATA','1','1');  
DELETE FROM T_MC_LICENSEGROUP_L WHERE FPKID = '1067215530277996501'; 
INSERT INTO T_MC_LICENSEGROUP_L  (FPKID, FID, FLocaleID, FName, FDescription) VALUES  ('1067215530277996501',105217430774612701,'zh_CN','主数据管理分组','主数据管理');  

--新增许可的特性：主数据特征项
DELETE FROM T_MC_LICENSEGROUP WHERE FID = 105217430774612702;
INSERT INTO T_MC_LICENSEGROUP (FID, fnumber, ftype, fstatus) VALUES (105217430774612702, 'gov_mspc_feat ', '1 ', '1');
DELETE FROM T_MC_LICENSEGROUP_L WHERE FPKID = '106721553027799602';
INSERT INTO T_MC_LICENSEGROUP_L (FPKID, FID, FLocaleID, fname, fdescription) VALUES ('106721553027799602', 105217430774612702, 'zh_CN', '主数据特征项', '主数据特征项');

--新增许可的特性：主数据外部核验
DELETE FROM T_MC_LICENSEGROUP WHERE FID = 105217430774612703;
INSERT INTO T_MC_LICENSEGROUP (FID, fnumber, ftype, fstatus) VALUES (105217430774612703, 'gov_mspc_verify', '1 ', '1');
DELETE FROM T_MC_LICENSEGROUP_L WHERE FPKID = '106721553027799603';
INSERT INTO T_MC_LICENSEGROUP_L (FPKID, FID, FLocaleID, fname, fdescription) VALUES ('106721553027799603', 105217430774612703, 'zh_CN', '主数据外部核验', '主数据外部核验');
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

（2） 登录苍穹平台-系统服务云-基础服务-许可管理-许可分组明细查询，当主数据管理许可分组许可显示不正确时，可在苍穹数据中心的系统库（假设部署时实例命名为sys）中排查以下脚本是否执行成功生成相应记录。

​ 在部署的系统库数据库实例（假设实例名为sys）中执行以下查询脚本，查询T_LIC_ISVProd，T_LIC_Group，T_LIC_Group_L表，查询语句及正确的查询结果如下。

a) SELECT * FROM T_LIC_ISVProd WHERE FID = '1052174307746120401';

​ image-20230116120152293

b) SELECT * FROM T_LIC_Group WHERE FID in (105217430774612701,105217430774612702,105217430774612703);

image-20230116120221653

c) SELECT * FROM T_LIC_Group_L WHERE FPKID in ('1067215530277996501','1067215530277996502','1067215530277996503');

image-20230116120248617

执行以上查询脚本后，数据库中没有相应记录，可使用以下语句插入相关许可记录。

-- sys库，主数据管理分组
DELETE FROM T_LIC_ISVProd WHERE FID = '1052174307746120401';
INSERT INTO T_LIC_ISVProd(FID,FVERSION,FISVNUMBER,FISVNAME,FPRODNAME,FPRODNUMBER) VALUES ('1052174307746120401','7.0','gov','金蝶天燕','主数据管理','AMDM'); 
DELETE FROM T_LIC_Group WHERE FID = 105217430774612701;
INSERT INTO T_LIC_Group(FID,FTYPE,FISVPRODNUMBER,FSTATUS,FNUMBER) VALUES (105217430774612701,'1','AMDM','1','GOV_DATA'); 
DELETE FROM T_LIC_Group_L WHERE FPKID = '1067215530277996501';
INSERT INTO T_LIC_Group_L(FID,FPKID,FLOCALEID,FDESCRIPTION,FNAME) VALUES (105217430774612701,'1067215530277996501','zh_CN','主数据管理','主数据管理分组'); 

-- sys库，主数据管理特性-主数据特征项	
DELETE FROM T_LIC_Group WHERE FID = 105217430774612702;
INSERT INTO T_LIC_Group (FID, FNUMBER, FTYPE, FSTATUS, FISVPRODNUMBER) VALUES (105217430774612702, 'gov_mspc_feat', '2', '1', 'AMDM');
DELETE FROM T_LIC_Group_L WHERE FPKID = '1067215530277996502';
INSERT INTO T_LIC_Group_L (FPKID, FID, FLOCALEID, FNAME, FDESCRIPTION) VALUES ('1067215530277996502', 105217430774612702, 'zh_CN', '主数据特征项', '主数据特征项');

-- sys库，主数据管理特性-主数据外部核验	
DELETE FROM T_LIC_Group WHERE FID = 105217430774612703;
INSERT INTO T_LIC_Group (FID, FNUMBER, FTYPE, FSTATUS, FISVPRODNUMBER) VALUES (105217430774612703, 'gov_mspc_verify', '2', '1', 'AMDM');
DELETE FROM T_LIC_Group_L WHERE FPKID = '1067215530277996503';
INSERT INTO T_LIC_Group_L (FPKID, FID, FLOCALEID, FNAME, FDESCRIPTION) VALUES ('1067215530277996503', 105217430774612703, 'zh_CN', '主数据外部核验', '主数据外部核验');
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# 主数据领域许可申请

（1） 在主数据部署完成后，按照以下内容复制填写，发给主数据实施或研发团队。制作主数据领域的许可文件amdm_domainl.zip。

主数据管理V7.4领域许可申请模板

1、申请类型：A 、依赖苍穹许可用户组与有效期，领域许可无时间限制 B、不依赖苍穹许可，主数据领域许可有时间限制，30/60/90天

2、用途(例如：售前（测试） / 售后（测试，生产，准生产）)：

3、客户名称：

4、模块及特性：

5、软件特征码：

6、数据中心： 说明：主数据模块申请包括（主数据管理、主数据集团管控、主数据质量），主数据特性申请包括：主数据外部核验、主数据特征项。

（2） 获取文件后，导入许可文件，路径:开发平台->主数据管理->实施工具->主数据许可上传；

image-20221206142412797

成功后重启mservice。

# 苍穹平台升级

苍穹平台升级补丁安装（如果需要对平台支撑环境升级时）

在MC-集群管理-上传【苍穹官网下载平台升级包】，点击升级（指升级全部数据中心）或升级（数据中心）（指升级指定数据中心）

选择【分应用补丁选择】页签，选择【开发平台、流程服务云、公共基础云】进行升级，根据升级过程的日志判断升级是否成功，如果升级失败，将日志信息反馈实施交付或研发部门。

image-20221206143311349

image-20221206143348513

主数据管理依赖平台的分应用补丁只需依次升级：开发平台，流程服务云，公共基础云

image-20221206143411594

# 主数据升级

(1) 在MC-集群管理-上传【主数据升级包】，选择【全量补丁选择】页签下的《金蝶云苍穹二开》升级包，点击查看可看到补丁说明，选中后。

image-20221206143500869

a) 点击【升级】：升级全部数据中心。

image-20221206143550085

关于“重启环境”（即重启mservice）：如果升级包中包含后台代码（即jar包，包含在升级补丁zip包中），则升级需要重启环境。否则不需要重启环境。

# 升级异常处理

如果主数据升级包在升级过程中，遇到重建元数据失败提示，检查主数据升级压缩包中的文件kdpkgs.xml第二行 < kdpkgs isv="gov"> ，如果缺乏版本号，则改写为< kdpkgs isv="gov" ver="4.0.122"> ，其中ver="4.0.122"指当前文件中的版本号，在文件的其它行可以找到，本文ver="4.0.122"只是举例。

# 问题记录

# 升级MC，导入补丁包5%卡死

需要1-【系统管理】中【管理中心配置】

检查临时文件路径是否存在，若不存在则增加该路径

# 许可导入失败：需要升级MC

# 苍穹平台加载不上jar包

许可同步报错，启动mservice服务失败，主数据应用包升级成功，但苍穹平台加载不上jar包可能原因：

image-20221206144702582

1、苍穹平台加载不上jar包的可能原因：

（1）没有更新软件仓库

（2）/opt/kingdee/cosmic/mservice/mservice/bin路径setappenv.sh中的lib变量未指定，内容如下：

export CUSLIBS=amdm.xml

image-20221206144758808

（3）在目录

(/opt/kingdee/nginx-appstatic/store/appstatic/appstore/cosmic/cus)

下增加与zip文件同名xml文件，以amdm.zip为例，增加amdm.xml文件，内容如下：

image-20221206144915473

image-20221206144950750

# 新建数据中心行政组织没有根节点

参考：https://vip.kingdee.com/article/123807552999096064

场景：在配置管理员或者其他与业务单元相关的配置时报错，去行政组织页面查看根节点发现并无组织，只有个全部显示，这些都可以证明行为政组织根节点丢失

image-20221206145104652

分析：这种问题多半是在操作时，操作者误删了数据库org数据，或者mc数据中心新建时，同步有误导致

解决方案：重新取MC同步根组织数据

操作步骤：

  1. 进入mc，找到租户-有问题的数据中心，停用-保存

image-20221206145155890

  1. 找到mc数据库的t_mc_datacenter表，找到这个数据中心对应FID数据，将fhasynchronized字段改为0，保存数据

image-20221206145229359

  1. 去mc，数据中心里面保存，然后，同步，如果没有同步按钮建议升级mc，或者直接点租户的保存，会弹出建数据的日志

  2. 有延迟的，因为缓存问题，重启苍穹在查看，应该就可以了

# MC升级补丁，需要重复执行已经执行过的脚本

针对MC中安装包升级时，如果需要重复执行--已经成功执行过的脚本，需要在meta库中，按照以下条件检索，并删除检索出的记录后，可重复执行补丁中的脚本 select * from t_bas_deployinfodetail where FFILENAME like '%.sql%' and FFILENAME like '%gov_dqm%'; （这里like 条件是指脚本文件名） 需要详细检查查询出的记录，确定是要重复执行的脚本，再删除记录，最好先做待删除记录的备份。

# MC升级上传补丁超过2048M

l 问题：MC-集群管理-上传升级包，补丁文件超过2048M时，报文件过大的错误，上传失败。

l 解决办法：

(1) 通过FTP工具上传脚本sepPatchParser.sh到软件仓库，同时上传升级包相同路径，FTP上传路径如下

/kingdee/nginx-appstatic/store/appstatic/patchwarehouse

(2) 上传完成后，在命令行执行sepPatchParser.sh

image-20221206145330648

(3) 完成以上步骤后，执行MC升级或升级数据中心操作。

# 首次安装主数据，报字段不存在异常

登录苍穹平台，进入【主数据管理】-【系统配置】-【更新实体表】，选择全部实体表，执行"更新"，看到成功的提示后，建表或更新表结构完成，可以重复执行，不会影响已经生成的表和表中的数据。参见下图：

image-20221206143937087

编辑页面 (opens new window)

← 发版说明→