DELMIA Apriso 升级操作手册

1. 环境信息

客户环境不一样，程序不一样，数据不一样，升级流程和升级遇到的问题都会有差异，因此在给客户升级前，需要以客户环境为标准进行验证和调整，做好充足的准备工作。

1.1软件信息

Windows Server2016

Apriso2020（升级到Apriso2024）

Oracle19c

1.2 硬件信息

VM虚拟机。

1.3部署架构信息

Apriso2020和Oracle19c都在同一环境中，没有高可用部署。

2 旧环境的检查与修复

2.1 检查并修复2020开发环境数据库

1) 启动数据库升级程序

进入程序安装目录，启动Apriso程序安装目录下的DataBase Upgrader工具。

2) 连接检查数据库

默认会显示当期服务端连接的数据库，若有其他服务连接，请删除；若没有任何连接显示，请手动添加对应的数据库连接。点击“下一步”。

3) 选择执行模式和数据库

对于当前主要是用于校验数据完整性，选择“升级准备”和“Apriso执行数据库”。点击下一步。

4) 检查标准数据表结构变化

由于并未进行升级新版本，因此检查不会有任何变化。直接点击“下一步”。

5) 检查执行文件

由于并未进行升级新版本，因此检查不会有任何变化。直接点击“下一步”。

6) 开始执行数据库影响分析

点击“执行分析”按钮后，程序自动开始执行涉及客户定义对象的影响分析。

7) 分析结果的查看与确认

对分析出来的客户定义的一些表与系统业务表之间的关系进行查看和确认。若有需要，也可以导出对应的表格进行分析和查看。

一般情况下默认没有问题，主要是为下一步的导出关系做准备。

点击“下一步”。

8) 检查客户表约束

检查客户表约束相关信息。由于此时属于准备阶段，不需要导出相应的约束文件。直接点击“下一步”。

9) 执行数据库校验

点击左上角“执行校验”按钮，开始执行数据库的自动校验分析。具体分析内容，可进一步查看《Database Upgrader Help》的详细介绍。

10) 数据库校验问题修正

检验完成后，对于校验失败项，点击“Fail”可以展开查看问题失败原因，并按照原因进一步进行问题的修正。修正完成后，重新执行检查。确保所有的检查都必须通过。

所有的检查都通过之后，点击“取消”，完成对应的检查。

2.2 检查并修复2020开发环境软件完整性

1)启动应用程序检查工具

进入程序安装目录，启动Apriso程序安装目录下的Post Upgrader工具。

2)直接点击“下一步”

3)执行检查

点击左上角“执行”，开始进行完整的检查

4)校验问题修正

检验完成后，对于校验失败项，点击“Fail”可以展开查看问题失败原因，并按照原因进一步地进行问题的修正。修正完成后，重新执行检查。确保所有的检查都必须通过。

所有的检查都通过之后，点击“取消”，完成对应的检查。

3 应用程序升级

3.1 2020程序文件备份

1)客户自定义文件备份

拷贝如下路径文件到备份文件夹。如果确定没有修改，可以不用执行该步骤。

a)XML Schema Repository文件

\Program Files\Dassault Systemes\DELMIA Apriso XXX\WebSite\SchemaRepository\

b)所有在ADC上定义的动态表格中修改和增加的动态过滤

\Program Files\Dassault Systemes\DELMIA Apriso XXX \WebSite\Resources\GridConfigurations\

c)报表和标签文件

\Program Files\Dassault Systemes\DELMIA Apriso XXX \Reports Definitions\ (Report_category)\

\Program Files\Dassault Systemes\DELMIA Apriso XXX \Labels Definitions\ (Label_category)\

d)其他手工修改过的文件

\Program Files\Dassault Systemes\DELMIA Apriso XXX \

\Program Files\Dassault Systemes\DELMIA Apriso XXX \WebSite\

e)图片文件

\Program Files\Dassault Systemes\DELMIA Apriso \WebSite\ig_ common\images\TimeManager\Images\

2)使用的一些UI主题框架文件备份

如CSS框架，以便在新版本使用。

3) 文档文件备份

\Program Files\Dassault Systemes\DELMIA Apriso \WebSite\Portal\Documents.

3.2 2020配置文件备份

查找并备份如下路径的所有配置文件。

3.3 卸载2020应用程序

参考《2020_ DELMIA Apriso Installation Guide.pdf》手册进行Apriso程序的卸载。

3.4 安装2024应用程序

参考《2024_ DELMIA Apriso Installation Guide.pdf》手册进行Apriso程序的安装。

3.5 对比并更新2024应用程序配置文件

使用Notepad++等文件对比工具，仔细对比上述备份的配置文件与2024版本的配置文件，按需更新2024配置文件。

警告：禁止直接覆盖配置文件！

3.6 迁移客户定义的报表和标签定义文件

将之前备份的客户自定义的报表和标签定义文件，拷贝到新环境的对应位置。

原旧文件路径：

\Program Files\Dassault Systemes\DELMIA Apriso2020 \ （Report/Label）Definitions\

新文件路径

\Program Files\Dassault Systemes\DELMIA Apriso 2024\ （Report/Label）Definitions\

3.7 重新部署客户自定义组件

将自定义的BC文件拷贝到新环境下

\Program Files\Dassault Systemes\DELMIA Apriso 2024

使用gacutil.exe重新注册对应的自定义BC文件。

4 数据库升级

4.1 备份现有数据库

按照数据库管理原则，使用Oracle原生备份方式备份现有数据库。

//-------------

//-------------

关闭Oracle Archivelog 模式

为了缩短升级时间，可通过如下方式关闭数据库的Archivelog 模式。

注意：若选择关闭后，在数据库完成升级后需要启用。

//-------------

//-------------

4.2 数据库升级前检查

按照要求，通过2024DataBase Upgrader工具在此检查数据问题，并对问题进修修复，检查方式与准备过程完全一直，如下，

1)启动数据库升级程序

进入程序安装目录，启动Apriso程序安装目录下的DataBase Upgrader工具。

2)连接检查数据库

默认会显示当期服务端连接的数据库，若有其他服务连接，请删除；若没有任何连接显示，请手动添加对应的数据库连接。点击“下一步”。

3)选择执行模式和数据库

对于当前主要是用于校验数据完整性，选择“升级准备”和“Apriso执行数据库”。点击下一步。

4)检查标准数据表结构变化

显示当前版本基础上，对对应的每一个版本中出现的一些表结构变化项。仅用于展示变化，并无其他意义。

直接点击“下一步”。

5)检查执行文件

此时会基于当前版本和升级版本，显示将要执行的一些过程文件信息。仅用于展示变化，并无其他意义。

直接点击“下一步”。

6)开始执行数据库影响分析

点击“执行分析”按钮后，程序自动开始执行涉及客户定义对象的影响分析。

7)分析结果的查看与确认

对分析出来的客户定义的一些表与系统业务表之间的关系进行查看和确认。若有需要，也可以导出对应的表格进行分析和查看。

一般情况下默认没有问题，主要是为下一步的导出关系做准备。

点击“下一步”。

8)检查客户表约束

检查客户表约束相关信息。由于此时属于准备阶段，不需要导出相应的约束文件。

注意：此处需要生成并导出对应的文件。

9)生成约束删除脚本

基于上一步操作，点击“创建删除脚本”，生成删除脚本文件，并保存到对应的路径。

默认路径应该为以下路径，如若路径不对，可手工拷贝文件到此处。

DELMIA Apriso 2024\Database Upgrader\CustomBeforeUpdates

10)生成约束增加脚本

基于上一步操作，点击“创建增加脚本”，生成增加脚本文件，并保存到对应的路径。

完成后点击“下一步”。

默认路径应该为以下路径，如若路径不对，可手工拷贝文件到此处。

DELMIA Apriso 2024\Database Upgrader\CustomBeforeUpdates

11)执行数据库校验

点击左上角“执行校验”按钮，开始执行数据库的自动校验分析。具体分析内容，可进一步查看《Database Upgrader Help》的详细介绍。

12)数据库校验问题修正

检验完成后，对于校验失败项，点击“Fail”可以展开查看问题失败原因，并按照原因进一步地进行问题的修正。修正完成后，重新执行检查。确保所有的检查都必须通过。

所有的检查都通过之后，点击“下一步”，完成对应的检查，并开始数据库升级。

4.3 执行数据库升级

在所有的的数据升级准备工作完成后，会进入如下所示的数据升级界面。该界面显示需要执行的升级程序，同时对于升级过程中有失败的，会显示失败原因，以便帮助升级人员快速处理问题。

1)开始升级执行

点击“执行升级”后，程序开始自动对数据库进行升级操作。

2)升级过程异常处理与在此执行

在执行升级过程中，都有可能遇到失败，需要节后失败原因，在数据库层面消除失败原因后，重新点击“执行升级”。

除执行准备的检查程序外，升级程序已执行完成的，在再次执行时会自动跳过。

3)升级完成

升级完成后，将自动提示成功。点击“OK”后再点击“下一步”。

4)查看和导出升级执行报告

如果有需要，可以展开查看升级的执行报告，并导出为Excel文件。

点击“完成”后，完成数据库升级操作。

5 同步应用程序与数据库

进入程序安装目录，启动Apriso2024程序安装目录下的Post Upgrader工具。

1)直接点击“下一步”

2)执行检查

点击左上角“执行”，开始进行完整的检查

3)校验问题修正

检验完成后，对于校验失败项，点击“Fail”可以展开查看问题失败原因，并按照原因进一步地进行问题的修正。修正完成后，重新执行检查。确保所有的检查都必须通过。

所有的检查都通过之后，点击“取消”，完成对应的检查。

6 Database Upgrader常见问题及解决方案

1)数据库连接问题

数据库连接检查失败，详细查看原因如下，按要求去关闭所有的外部数据库连接服务即可。关闭完外部服务后，点击右下角“刷新”后再点击“OK”完成。

2)Operation对象问题

Operation对象前后有空格，大小写不匹配等问题，需要修正数据后重新执行校验。

7 Post Upgrader检查常见问题及解决方案建议

以下是升级验证过程中的一些常见问题以及解决方案建议，

1)BC程序组件问题（Business Components Loader）

在准备检查过程中，对于系统程序组件相关的问题，可以不予解决，再按照新的版本时，将会重新注册为新的版本，可以直接在新版本上执行检查后再进行解决。

2)脚本问题（Action Script Regenerator）

会编译检查PB中目前Action Scripts，只有在激活和原型状态的默认版本才会被编译检查。出现检查问题时，可按照提示修复。若不需要使用，可以直接修改为其他状态。

3)PB 流程和操作问题（Process Regenerator）

Process和Operation对象会在此时重新生成运行时数据和重新编译，只有在激活和原型状态的默认版本才会被编译检查。出现检查问题时，可按照提示修复。若不需要使用，可以直接修改为其他状态。

4)DLL组件问题（Assembly Integrity Verifier）

对组件及其版本进行校验，校验异常时，直接按照提示更新为最新组件即可。

准备时可以不用处理，因为在新的版本安装后，该问题将不存在。

5)Input和Output不一致问题

按照提示，通过PB去修复对应的问题。若判断没有影响，可以不出来。

6)数据库授权问题（Database Security Verifier）

校验用户的授权权限，对于权限不足或不一样的，若判断没有影响，可以不处理，若有影响，需要DBA对用户调整授权。