升级前注意事项

       1、若从V4.0.006之前版本升级至V4.0.012及以上版本，请先阅读：https://vip.kingdee.com/article/220630904162086144

      2、若从V4.0.006之后版本升级至V4.0.012及以上版本，直接阅读本篇说明

      3、本次版本升级后，monitor首次生路需要修改密码，具体可参考：首次登录修改初始密码操作手册

V4.0.012版本苍穹&星瀚变化较大，其中涉及到第三方Jar升级，对二开影响较大，请关注！

第3方包升级明细如附件《V4.0.012版本第三方包升级明细》所示。

一、二开兼容性

        1、由于软件版权，标准产品中的第三方jar包xmlworker-5.5.13.1.jar、itext-asian.jar、itextpdf-5.5.13.1.jar彻底删除，如果有继续使用xmlworker-5.5.13.1.jar、itext-asian.jar、itextpdf-5.5.13.1.jar的二开代码，需要客户将该jar包放入苍穹二开包目录，其使用所引起的任何法律风险，由客户自行承担。

       2、由于安全漏洞，标准产品中的第三方jar包itext-2.1.7-kd.bos.jar 彻底删除，使用openpdf-1.0.5.jar替代，如果有使用itext-2.1.7-kd.bos.jar的工程，需要修改maven或gradle依赖新jar包。

      3、标准产品中第三方jar包commons-httpclient-3.1.jar、hbase-*.jar和htrace-core4-*.jar已经删除，其中commons-httpclient使用httpclient-*.jar替代，两个包的package名字不同；而hbase-*.jar和htrace-core4-*.jar已经删除。如果二开有使用到commons-httpclient-3.1.jar、hbase-*.jar和htrace-core4-*.jar，会报错。

      解决方案一：从安全考虑，建议二开代码进行修改，不用已删除的包，同步升级到新版本。（建议使用这种方案）

      解决方案二：补丁中把commons-httpclient-3.1.jar、hbase-*.jar和htrace-core4-*.jar放到了trd-legacy.zip，客户可以在环境变量中TRDLIBS加上trd-legacy，如下图所示，就可以兼容现有代码。

     如果是用虚机部署的，修改TRDLIBS环境变量：

     export TRDLIBS=trd.xml,trd-qing,trd-legacy

     温馨提示：trd-legacy.zip中的jar包将在发版后3个月后进行删除，请提前做好适配工作，感谢！

二、其他

        1、本次版本升级时，【分应用补丁选择】列表中，请注意勾选“轻分析_COSMIC_QING" 同步升级，否则会导致轻分析无法正常使用。