Page tree
Skip to end of metadata
Go to start of metadata

在此页:

目标用户:

CAST AI 管理员

摘要:在启动CAST AIP升级过程之前,需要读取的信息和需要完成的操作。

后台阅读须知

作为筹备工作的一部分,请注意下列资料和操作要点:

发布说明

 Click here to expand...

确保读取及核对以下资料:

请在所有主要、次要或服务包发行版中检查相同的信息(即当从CAST AIP 8.1.x升级到CAST AIP 8.3.x时,应该检查中间的所有版本)

存储主机信息

 Click here to expand...
  • CAST引入CAST存储服务3(基于Postgres 9.6.x),并建议在CAST AIP 8.3.x中的新应用和现有应用中使用。参见CAST 存储服务 - 升级到版本3.x.x获得关于升级到CSS3的更多信息(在CAST AIP升级过程开始之前完成)。

关于64位操作系统兼容性的信息

 Click here to expand...

CAST AIP 8.3.x是一个64位兼容的应用,因此必须只使用支持64位操作系统来托管CAST AIP。还请考虑到下列信息:

  • Visual Basic 分析器(在这个版本中)作为一个32位的“应用”交付。请在Visual Basic - 需要第三方软件阅读Visual Basic分析器和64位兼容性部分。

关于使用自定义插件进行升级的信息

 Click here to expand...

如果当前正在使用自定义插件(即CAST提供的所有非官方插件),并且希望将其升级到当前CAST AIP版本,CAST强烈建议开始升级过程之前导出当前评估模型文件(在CAST管理器中使用File > Export file选项)。如有必要,此评估模型可用于升级过程最后的比较过程

当使用<all users dir>选项安装了传统的自定义UA包时,有关的升级信息

 Click here to expand...

如果使用CAST 服务管理器中的Manage Extensions选项下的<all users dir>选项安装了传统通用分析器(UA)包,那么应该考虑以下问题:

CAST强烈建议在开始升级过程之前:

  • 确保CAST 服务管理器中的Manage Extensions选项下的<all users dir>选项设置为“Do Not Install”(这是它的默认位置,但请检查):

如果在升级之前无法完成此过程,请按照以下步骤进行:

  • <CAST_ALL_USERS_PATH for version before upgrade>\configuration\languages复制自定义传统通用分析器包到<CAST_ALL_USERS_PATH for new release>\configuration\languages,<CAST_ALL_USERS_PATH>的值是在CastGlobalSettings.ini 文件中定义的(默认值是%PROGRAMDATA%\CAST\CAST\<version>)。
  • 确保CAST服务管理器中的Manage Extensions选项下的<all users dir>选项设置为"8.3.0",以确保在升级过程中考虑了语言包(<all users dir>选项只有在<CAST_ALL_USERS_PATH>中存在自定义传统通用分析器语言包时才可见)

已安装自定义UA包“SQL Script”插件时的升级信息           

 Click here to expand...

注意,本节仅适用于那些升级到CAST AIP 8.3.0 - 8.3.4的用户。该问题将在CAST AIP ≥ 8.3.5版本后自动管理。

如果当前正在CAST AIP模式中使用一个非常旧且不受支持的自定义通用分析器名为“SQL Script”的语言包,那么必须确保在升级过程之前执行这里描述的解决方案。这个旧的通用分析器语言包会与默认情况下附带CAST AIP的SQL分析器产生冲突,并会阻止升级完成。

要确定是否需要应用此解决方案,请对管理服务模式运行以下查询。当返回一行数据时,表明安装这个旧的“SQL脚本”语言包。

select * from Cat where IdCat = 2361000

关于从CAST AIP 8.0.x升级的信息

 Click here to expand...

CAST事务配置中心—影响因素配置

CAST AIP 8.1.x存储过程用于配置事务功能的影响因子(有关更多信息,请参见CAST事务配置产品帮助)现在的名称如下:

  • TCC_EFP_USR_IF_DELETED_RULE --> EFP_USR_IF_DEL_TF_RULE
  • TCC_EFP_USR_IF_MODIFIED_RULE --> EFP_USR_IF_MOD_TF_RULE
  • TCC_EFP_USR_IF_ADDED_RULE --> EFP_USR_IF_ADD_TF_RULE

这是为了使名称与CAST AIP 8.1.x中添加的用于为数据功能配置影响因子的存储过程一致。默认情况下,避免配置CAST AIP 8.0.x在升级到CAST AIP 8.3.x之后丢失, CAST在CAST AIP 8.3.x中的存储过程中包含对传统CAST AIP 8.0.x存储过程的调用,例如:

  • EFP_USR_IF_DEL_TF_RULE will call in its code the existing stored procedure from CAST 8.0.x: TCC_EFP_USR_IF_DELETED_RULE

尽管在升级过程中自动处理了这个问题,但是CAST强烈建议复制传统存储过程中的脚本,以便在CAST AIP 8.3.x新的存储过程中开始使用。

当使用Oracle服务器托管CAST AIP模式时有关升级的信息

 Click here to expand...

当使用Oracle服务器作为CAST模式的主机时,必须确保没有使用Oracle“系统”用户连接到管理、分析、仪表盘或测量服务。如果出现则升级过程将失败。为此检查:

  • 启动 CAST 管理器
  • CAST-MS Database connections manager对话框(在启动期间显示)中,将用于连接管理服务(MNGT)的用户从系统更改为MNGT模式用户

点击放大


  • 连接后,更新所有分析仪表盘服务以更改各自的分析服务/仪表盘服务模式用户——需要在各自的分析/仪表盘服务编辑器中启用凭据选项,以覆盖使用“系统”用户的自动定义的连接。下面是仪表盘服务的示例:

点击放大


关于如何防止特定应用升级的信息

 Click here to expand...

如果不想同时升级给定CAST AIC门户/交付文件夹中的所有应用,则不需要这样做

因为交付文件夹“锁定”了一个CAST AIP特定的版本,当升级到CAST AIP的新版本时,所有没有被选为升级的管理服务模式(和管理应用)将不再允许使用交付文件夹,当尝试在未升级的应用上工作时将会在CAST管理器中收到以下错误:

点击放大


如果不想将所有管理服务及其应用升级到CAST AIP的新版本,有两个选择:

  1. 无论如何都继续升级,并确保遵循本文档末尾的说明,从位于交付文件夹根目录的data文件夹中的index.xml文件注释去掉所有未升级的应用(参见部署CAST web 应用)。
  2. 可以创建两个CAST AIC门户两个交付文件夹,每个文件夹包含需要的应用,这取决于是否需要升级到CAST AIP的新版本。说明如下:

创建两个CAST AIC门户和两个交付文件夹

在这个场景中,从CAST AIP 8.1.x迁移到CAST AIP 8.3.x为例(但这同样适用于其它受支持的路径之间的更新):

  • 确保现有8.1.x CAST AIC门户没有运行。
  • CAST AIP 8.3.x部署一个新的CAST AIC门户(参见安装和配置 CAST AIC 门户与现有的8.1.x CAST AIC门户——确保使用来自CAST AIP新版本的CAST-AICP.war文件。
  • CAST AIP 8.3.x 配置一个新的空交付文件夹。用于CAST AIP 8.3.x的CAST AIC门户的web.xml文件。
  • CAST AIP 8.3.x停止新的CAST AIC门户。
  • 现有8.1.x交付文件夹中复制“plugins”文件夹,并将其粘贴到新的8.3.x中的交付文件夹——覆盖“plugins”文件夹。
  • 现有8.1.x交付文件夹中复制 "data\index.xml"文件,并将其粘贴到新的8.3.x交付文件夹中的“data”文件夹中——在新的交付文件夹中,“数据”文件夹中不应该存在文件。
  • 现有8.1.x交付文件夹中编辑“data\index.xml”文件(使用文本编辑器),删除要升级到CAST AIP新版本的的所有应用引用 —— 这是过程非常简单,需要移除所有以<entry key="<GUID-of-your-Application开头的信息。每个应用大约有10个条目。修改后保存。
  • 新的8.3.x交付文件夹中编辑“data\index.xml”文件(带有文本编辑器),把不升级新版本的CAST AIP的所有应用参考都删除——这是过程非常简单,需要移除所有以<entry key="<GUID-of-your-Application开头的信息每个应用大约有10个条目。修改后保存。
  • 现有8.1.x交付文件夹中剪切并粘贴data”文件夹中的所有应用到要升级的CAST AIP 8.3.x新版本交付文件夹中的“data”文件夹。应用由一个名为<GUID>的文件夹和一个名为<GUID>.entity.xml的文件组成 ——其中GUID对应于应用:


  • 将“data”文件夹中的“localpswds.dat”文件从现有的8.1.x交付文件夹复制到新的8.3.x交付文件夹中的“data”文件夹。
  • 现有的8.1.x Cast AIP打开Cast 管理器,并连接到要升级到Cast AIP 8.3.x的所有管理服务模式。在Window > Preferences中更改“源代码交付文件夹”的位置,使其与Cast AIP 8.3.x中新交付文件夹的位置相对应:

点击放大


  • 最后会得到:
    • 一个8.1.x交付文件夹,仅包含要在CAST AIP 8.1.x上保留的应用
    • 一个8.3.x交付文件夹,仅包含要升级到CAST AIP 8.3.x的应用

关于如何选择评估模型升级策略的信息

 Click here to expand...

在使用CAST升级工具的升级过程中(请参见逐步升级过程),将被要求选择一个选项来处理CAST AIP评估模型


现在请确保根据以下信息决定在升级过程中使用的策略:

CAST升级工具GUI选项CAST 升级工具 CLI 选项描述

保存评估模型自定义,激活AIP 8.3.x中的新规则

-assessmentModelUpgrade activateNewRules

这两个选项将保留分配给CAST仪表盘服务模式的当前评估模型,并合并使用CAST AIP 8.3.x评估模型交付的所有新规则——取决于选择,这些新规定将被激活(通过激活所有选项,提供新版本的优点)或禁用(因此,使升级后的结果更加稳定,并且与以前的CAST AIP版本保持一致,但不能从新版本的更新中获益)。请参见评估模型升级,以获得更多关于在CAST AIP的这个版本中可能添加的新质量规则的信息。

如果选择一种,则会保留以下评估模型值:

  • 激活/非激活质量规则的状态
  • 阈值
  • 权重
  • 关键要素
  • 参数值
  • 自定义指标
  • 自定义质量规则

然而评估模型仍然需要经过升级过程来修改一些值,使其与CAST AIP 8.3.x兼容,例如:

  • SQL和属性实现
  • 适用技术
  • 关联值
  • 文档
保留评估模型自定义,禁用新规则
-assessmentModelUpgrade disableNewRules
使用来自CAST AIP 8.3.x的默认评估模型
-assessmentModelUpgrade replaceby

如果选择这个选项,新的评估模型来自CAST AIP 8.3.x被分配给所选用于更新的CAST仪表盘服务模式,从而取代所有现有的评估模型。

请注意,由于在新模型中以及CAST AIP的交付和分析功能中所做的改进,无论选择何种选项,在生成新快照时,评估结果都会有所不同。有关在更新结果后可能发生更改的更多信息,请参阅升级后结果的变化

关于CAST AIP 8.3.x附带插件的信息和安装作为升级的一部分  

 Click here to expand...

在CAST AIP 8.3.x中,作为CAST改进和加速软件发布频率的一部分,“外部化”CAST AIP的源代码交付和分析功能的过程已经开始。为此各种官方的CAST AIP插件随CAST AIP 8.3.x一起提供和自动安装,作为升级过程的一部分,也当安装新的CAST AIP“三元组”。请参见CAST AIP 8.3.x的技术覆盖变化获取更多信息。

请注意,在升级CAST AIP时,以前安装的插件与CAST AIP 8.3.x一起提供。即使新版本的AIP附带了最新版本的插件,也不会自动升级。要从最新插件版本的最新改进和问题修复中获益,需要显式的选择插件的新版本,如逐步升级过程中所述。

关于使用IBM DB2 z/OS和UDB应用升级的信息  

 Click here to expand...

一段时间以来,CAST通过其DB2分析器为分析IBM DB2 UDBIBM DB2 z/OS(提供开箱即用的CAST AIP≤8.2.x)提供了支持。这个“旧版”分析器要求如下:

  • 对于IBM DB2 UDB,必须手动定义到DB2 UDB实例的连接——这个实例在CAST 管理器中的分析过程中可用——这称为“在线”分析。此外必须在CAST管理器所在的工作站上安装DB2客户机层。
  • 对于IBM DB2 z/OS,必须在目标z/OS执行环境上安装一个基于JCL的独立提取器,那么运行来输出DB2分析器可以处理的数据。

这些需求有时会给将IBM DB2应用加载到CAST AIP的过程带来很大的困难。这样做的直接结果是,为了简化方法,CAST将SQL分析器 开发为一个独立的插件。插件分析DDL, DML SQL出口和(≥2.0)版本中)支持IBM DB2的分析。因此分析是“离线”的(不需要连接到实时数据库)。

CAST AIP≥8.3.x,传统DB2分析器(提供了开箱即用的CAST AIP不再可用,因此升级CAST AIP  8.3.x现有的IBM DB2 UDBIBM DB2 z / OS分析仍将功能和不会阻止升级后一致性快照,然而将不可能在现有或新包中包新源代码,因此建议过渡到SQL分析器版本≥2.0之前CAST AIP 8.3.x升级。参见如何从CAST AIP DB2 Analyzer过渡到SQL 分析器插件

关于使用SAP BusinessObjects应用升级的信息

 Click here to expand...

长期以来,CAST通过其BO分析器提供了支持SAP BusinessObjects源代码分析提供开箱即用的CAST AIP≤8.2.x这个“旧版”分析器要求如下:

  • SAP BusinessObjects BO 设计者模块)必须安装在CAST管理器运行的工作站上。
  • 必须手动定义到使用的全域文件的SAP BusinessObjects实例的连接——这个实例必须在CAST 管理器的分析过程中可用——这称为“在线”分析。

这些需求有时会给将SAP BusinessObjects应用加载到CAST AIP的过程带来很大的困难。这样做的直接结果是,为了简化方法,CAST将SAP BusinessObjects分析器开发为一个独立的插件。插件(在CAST AIP 8.2.5中引入)提供了一种“离线”分析SAP BusinessObjects源代码的方法,即不需要连接到SAP BusinessObjects实例。此外不再需要在CAST 管理器运行的工作站上安装BusinessObjectsBO 设计者模块)。

CAST AIP≥8.3.x,传统BO分析器(CAST AIP中提供的开箱即用)不再可用,因此:

所需操作点

本节列出在启动CAST AIP升级过程之前必须完成的操作。

操作:生成快照

 Click here to expand...

在开始升级过程之前生成快照。这允许比较升级前和升级后的结果,如在升级后结果的变化中所讨论。

操作:备份现有数据

 Click here to expand...

在开始升级过程之前,CAST强烈建议备份来自CAST AIP以前版本的所有现有分析和结果数据。应该将以下项目作为基本的最小备份,以便在升级过程中发生错误时可以恢复现有的AIP环境。

项目备份如何备份
CAST AIP 模式(管理 / 分析 / 仪表盘 / 管理服务

CAST 存储服务 2

  • 使用CAST存储服务备份工具(CSSBackup)来备份想要升级的每个CAST AIP模式——有关正在升级的CAST AIP版本的更多信息,请参见文档。

商业RDBMS (Oracle服务器或Microsoft SQL服务器)

  • 使用RDBMS的内置备份工具来备份要升级的每个CAST AIP模式。
CAST 交付文件夹

确保复制了的交付文件夹—只需将文件夹复制到磁盘上的另一个位置(与CAST AIP无关)。

在CAST存储服务上升级CAST AIP模式时,升级过程将删除可能直接或间接使用所有默认分析/仪表盘服务模式对象创建的所有自定义表/视图/过程等

操作:下载并安装CAST AIP的新版本

 Click here to expand...

下载并安装CAST AIP的新版本,可以在与现有版本相同的工作站上,也可以在以前不存在CAST AIP版本的不同工作站上。请参见从安装程序安装CAST AIP获得更多信息。

操作:下载插件(可选)

 Click here to expand...

现有插件的所有新版本或可能对应用有用的新插件下载到运行升级的工作站上,如下载插件中所述。如果安装插件的最新版本附带CAST AIP,则不需要这样做(请参见CAST AIP 8.3.x的技术覆盖变化以获取更多信息)。

操作:完成升级前检查

 Click here to expand...

在开始更新程序前,请确保已完成以下所有工作:

(tick)

数据库访问独占性

确保拥有对想要升级的模式的独占访问权——即该模式不被所有其它用户、应用(如CAST 管理器)或web门户(如CAST应用分析/工程仪表盘)使用。

(tick)

检查空闲RAM内存

在开始这一步之前,请确保的工作站上至少有1GB的空闲RAM内存。如果没有足够的空闲RAM内存,则有一些升级操作失败的风险。

(tick)

在应用服务器上停止CAST AIC门户

确保在启动升级过程之前停止CAST AIC门户的现有部署(使用应用服务器管理系统)。

(tick)

确保的自定义和官方CAST AIP插件是兼容的(可选)

如果在CAST AIP的当前版本中安装了自定义或官方的CAST AIP插件,则必须确保与要升级到的CAST AIP的新版本兼容。

(tick)

确保的交付文件夹是可访问的,并包含一个version.xml

确保的交付文件夹(在要升级的管理服务模式中定义)可访问,并且包含一个有效的version.xml文件。

(tick)确保所有模式都来自同一个CAST AIP版本

确保升级中涉及的所有CAST AIP模式(分析/仪表盘服务模式)与所选的管理服务模式安装在同一个CAST AIP版本中。

(tick)管理服务模式中的应用/快照

确保要升级的管理服务模式中至少存在一个具有快照的应用

下一步

关于下一步要做什么,请参见逐步升级过程。   

  • No labels