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

在此页:

目标用户:

CAST AI 管理员

摘要: 本节提供了关于完成升级后应该期望的内容以及可能需要完成的操作项的信息。

步骤 1: 运行升级之后应该会看到什么

  • 从CAST AIP的新安装中运行CAST管理器。     
  • 连接到承载升级的CAST AIP模式的服务器上的升级管理服务:可能需要创建一个新的连接配置文件。不需要输入许可密钥,或者指定交付/部署文件夹

预期:

  • 交付部署文件夹将保持升级之前的状态     
  • 应用将保持升级前的状态,包括:   
    • 任何现有的交付
    • 当前版本
    • 任何现有的分析单元
    • 任何现有的模块
    • 任何现有的分析/快照

评估模型会发生什么变化?

 Click here to expand...

在升级过程中,将执行以下操作:

  • 无论在CAST服务管理器中选择的评估模型升级选项是什么参见准备升级可用选项的解释),升级时分配给仪表盘服务模式的现有评估模型已经升级,并创建了该评估模型的两个副本:
    • 一个新的CAST AIP 8.3.x质量规则合并并启用保留评估模型自定义,激活AIP 8.3.0中的新规则
    • 一个新的CAST AIP 8.3.x质量规则合并并禁用保留评估模型自定义,禁用新规则
  • 如果选择了CAST AIP 8.3.0选项中的Use缺省评估模型,那么将从CAST AIP 8.3.x中创建一个新的缺省评估模型,并且来自CAST AIP插件的所有评估模型片段都在分配给仪表盘服务模式的评估模型中,在升级时都将合并到这个新的评估模型中。
  • 上述评估模型之一将会被分配给升级的CAST仪表盘服务,依赖于在CAST服务管理器中的评估模型升级选项(参见准备升级可用选项的解释)
  • 在CAST管理器的评估模型视图中,但是在升级时没有分配到仪表盘服务模式的任何评估模型(没有关联的评估模型)都将使用保留评估模型自定义进行升级并禁用新规则选项。

评估模型的标签

 升级后,评估模型视图中的评估模型将被标记如下:

升级过程中选择的选项

评估模型标签在CAST管理器


保留评估模型自定义,激活AIP 8.3.0中的新规则

"[current label] (upgraded, [version] new rules enabled)"

保留评估模型自定义,禁用新规则

"[current label] (upgraded, [version] new rules disabled)"

从CAST AIP 8.3.0中使用默认的评估模型

"Default Assessment Model ([version] + Extensions)"

非相关评估模型将保留其现有标签:

验证消息

如果在升级过程之后CAST管理器的Assessment Models视图中现在有三个以上的评估模型,那么Validation view中将会记录一条消息:


完整的消息状态如下所示。CAST强烈建议删除不再需要的任何评估模型,以提高性能。在删除评估模型之前,可以将它们导出到文件(使用CAST管理器中的File > Export File选项)。

警告:当前管理库中声明的评估模型有3个以上,
这会降低CAST管理器的性能。应该考虑删除那些不再需要的。

步骤 2: 操作项目

此步骤包含各种操作点,这些操作点取决于正在升级的可能需要完成的技术。

评估模型比较过程——可选

 Click here to expand...

CAST强烈建议完成这个比较过程,这样就可以识别新旧评估模型之间的差异,但是它不是升级过程的强制部分,可以跳过这个步骤。有关更多信息,请参见评估模型比较过程

使用Siebel插件的客户

 Click here to expand...

如果使用了CAST Siebel插件并在CAST AIP的上一个版本中生成了快照,那么在使用CAST AIP的新版本生成新快照之前,必须遵循Siebel插件文档中关于重新运行常规分析的说明。参见运行CAST AIP升级或插件升级以获得更多信息。

客户使用旧版BusinessObjects 分析器结果进行升级   

 Click here to expand...

CAST提供了支持通过BO分析器分析SAP BusinessObjects源代码(提供开箱即用的CAST AIP  8.2.x)一段时间了。这个“旧版”分析程序要求如下:

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

这些需求有时会给将SAP business sobjects应用加载到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  8.3.x,现有的SAP BusinessObjects分析将不再起作用并将阻止升级后的一致性快照。因此CAST强烈建议在生成升级后一致性快照之前转换到SAP BusinessObjects 分析器(参见在SAP BusinessObjects Analyzer - 1.0从旧版到新的交付/分析方法的转换)。

客户从CAST AIP 8.1.0(基线)升级——快照验证

 Click here to expand...

如果只是从CAST AIP 8.1.0(基线)升级,那么应该检查快照,查看在使用CAST 服务管理器升级测量服务模式期间可能发生的错误。为此:

  • 从CAST AIP的上一个版本连接并登录到健康仪表盘(仍然可用)。
  • 浏览所有升级到CAST AIP新版本的应用,并检查每个应用快照选择器中的快照列表:


  • 任何包含字符串“MIGR_ERROR_ALG_xxx_x_x”(例如“MIGRERROR_ALG_1106776204_3_4”)的快照版本名称都可能在使用CAST 服务管理器升级测量服务模式时发生错误。无法自动修复此错误,因此快照可能在健康仪表盘或CAST报表生成器中生成错误数据。

分辨率

如果任何现有快照被标记为包含错误,需要执行一组特定的操作来删除和重新整合测量服务模式中的快照(包含错误)。为此:

  • 启动位于<CAST_AIP_installation_folder>\AAD\GUI中的AadConsolidation-GUI.exe


  • 在GUI中,勾选上面所示的Reset选项。
  • 填写AAD Connection选项卡中的字段(如上所示),以连接到包含错误快照的测量服务模式。有关更多信息,请参见HD - GUI公共域
  • 移动到Reset选项卡,根据包含错误快照的版本名,填写以下三个字段:“MIGRERROR_ALG_1106776204_3_4”。


  • 第一个图(这里是1106776204)表示site_id
  • 第二个(这里是3)是application_id
  • 第三个(这里是4)是snapshot_id
  • 最后点击Run Application按钮,开始删除过程:


  • 对升级后的应用中出现版本名称错误的所有快照重复此过程。
  • 最后从CAST AIP的新版本中打开CAST管理器,打开应用编辑器并移动到Execute选项卡
  • 单击Upload snapshot to Measurement Service选项可重新整合当前应用的所有快照。必要时对每个应用重复。

步骤3:在最新版本上生成一个新的升级后快照

  • 虽然不是强制性的(除了下面列出的情况),但是CAST强烈建议将其激活,因为提供了一种方法来比较CAST AIP的两个不同版本中相同源代码的分析结果。如果此时不想生成快照,可以跳过这一段,并转到步骤4重新配置CAST web应用。在升级到CAST AIP的当前版本之后,如果要交付用于分析的应用源代码的新版本,则需要使用CAST 交付管理工具。这个过程在交付中描述。
  • 当应用包含DB2z/OSUDB)源代码而还没有转换SQL分析器插件时,这一步总是必需的。这是为了确保正确生成此技术的数据。
  • 下面列出的所有步骤都应该在CAST 管理器中从CAST AIP的新版本中运行。
  • 有一个预先准备的批处理脚本,它将自动执行这个步骤(以及其它步骤)。这个脚本使用各种CAST AIP工具的命令行接口。参见自动CAST AIP升级过程

更新当前版本的交付

 Click here to expand...

复制交付

  • 首先,确保当前版本设置为用于生成最新快照(即升级之前生成的最后快照)的版本。
  • 现在选择当前版本并单击Add version(单击放大) 。


  • 现在将显示以下界面。请确保按照以下步骤去做:
    • 1) 输入此复制版本的名称
    • 2) 确保选择复制源代码选项(点击放大):
    • 3) 可以从CAST AIP 8.3.5:通过在发射器中的激活域输入名称,决定是否启用任何特定的发现程序。可以输入以下任何一个(如果输入多个发射器,请用逗号分隔):

      • HTML5项目”(Web文件发现程序)——启用这个发射器的目标用户是那些正在升级为CAST AIP 8.3.x的用户(来自以前的CAST AIP版本)包含HTML5和JavaScript文件的应用。这将在升级期间自动强制为HTML5和JavaScript文件创建分析单元,因此这是一个确保升级后快照结果一致性的选项,其中应用包含这些文件类型

      • XML扫描器”(DMT XML扫描器)——启用此发射器将在CAST 交付管理工具“交付报告”中提供额外信息。

  • 单击Finish继续。

重新打包源代码并交付

 
目标是应用在CAST 交付管理工具的新版本中可能已经交付的任何修复,并包括在CAST 交付管理工具的新版本中引入的附加插件的结果。
  • CAST 交付管理工具将打开(点击放大):


  • 现在需要打开每个“Package”(双击)并检查所有配置设置是否正常。
  • 在版本级别单击Package并确保:
    • 未勾选Force extraction选项——这将限制与升级前生成的上一个快照所交付的源代码结果进行比较
    • Force scan选项未勾选


  • 单击Finish以运行包操作
  • 检查每个包的Package Content选项卡中的打包操作的状态
  • 单击Deliver关闭版本。
  • 退出CAST交付管理器工具。

请注意,如果原始交付管理器选择将这些密码存储在本地的工作站上,而不是将其存储在CAST AIC门户中,则可能需要重新输入密码以访问数据库、SVN或TFS。

接受并设置为当前版本

  • 回到CAST 管理器,这个版本现在会显示在Delivery done部分(点击放大):


  • Accept该版本并将其设置为current


  • 正常部署源代码(单击放大):

注意仅对于文件系统包,如果希望节省时间,可以跳过源代码的部署(取消部署源选项)。

  • 现在已经准备好生成快照——请参见下面的内容。

生成一个新的快照

 Click here to expand...
  • 对于升级中涉及的每个应用生成一个快照。这样做的原因是,可以比较升级前后的快照。
  • 首先,确保仪表盘服务分配了正确的Assessment Model(使用专家用户模式),单击放大:

  • 现在检查分析单元,以确保任何基于文件的源代码都可用。在应用编辑器中使用Current Version选项卡(单击放大):

  • 接下来右键单击升级的应用并选择Execute > Take a snapshot of the application。这将运行所有的分析,同步模块和执行一个新的快照:

请确保:

  • 运行快照时不要跳过分析。
  • 如果尚未为健康仪表盘安装测量服务,也未将其配置为正常工作,则不要将结果上传到测量服务 (参见安装 CAST AIP 模式安装和配置健康仪表盘中的独立安装获得更多信息)。


检查快照的结果

 Click here to expand...

快照完成后,可以通过启动一个临时工程仪表盘来检查内容:

  • 在CAST管理器中打开仪表盘服务
  • 确保General选项卡URL字段中不存在URL
  • 单击General选项卡中的Open Engineering Dashboard选项卡,比较升级前后的快照(凭证是admin/cast)。

步骤4:重新配置CAST web应用

此步骤对应于将CAST web应用部署到CAST AIP的新版本中使用:

  • CAST AIC门户通过CAST 交付管理工具(DMT)管理用于分析的源代码的交付和打包
  • 用于顶层数据消耗的健康仪表盘     
  • 用于详细数据调查的工程仪表盘 
  • 用于详细数据调查的旧版CAST工程仪表盘CAST发现门户(根据许可协议可选)

需要的操作——一般过程

CAST强烈建议将CAST AIP新版本中的CAST web应用“并排”部署到CAST AIP以前版本中的所有已部署web应用(包括来自Alpha和Beta预览版的所有已部署的WARs)中,以利用新特性并遵守兼容性限制。参见部署CAST web 应用获得更多关于部署CAST web应用的新版本的信息。

在“并行”部署中,需要从旧的web应用传输到新的web应用环境的详细信息(存储在配置文件中,例如web.xml/context.xml/other .properties/.xml文件)。请注意,在CAST AIP的不同版本之间,配置文件的结构和内容可能发生了变化,因此应该执行合并或覆盖配置文件(除非在下面的说明中特别要求这样做)——相反,必须用旧配置文件中的详细信息手动更新新的配置文件。

CAST AIC门户特定操作

 Click here to expand...

重新部署CAST AIC门户时,请确保始终执行以下操作:

  • 必须将门户配置为指向现有的交付文件夹——不要创建新的空交付文件夹。
  • CAST AIC门户使用文件格式数据库存储各种持久性信息。必须将此数据库中的两个文件从现有的CAST AIC门户部署复制到新的CAST AIC门户部署中的相同文件夹中——在出现提示时,应该覆盖现有文件。必须复制的文件如下:
%CATALINA_HOME%\webapps\CAST-AICP\database\security.properties
%CATALINA_HOME%\webapps\CAST-AICP\database\security.script
  • 必须在位于交付文件夹根目录下的“data”文件夹中的index.xml文件中对尚未升级到CAST AIP当前应用版本的任何引用进行注释(即特意此时选择不更新某些应用)。这是为了防止这些应用出现在CAST AIC门户中,并通过CAST 交付管理工具意外的处理。例如,在以下index.xml中有两个应用:MEUDON已经更新,SEVRES还没有更新。有关SEVRES应用的注释已经发布:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
 <comment/>
 <!--
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_4454b831-7931-405c-85e2-60727ebaef74.entity.xml_checksum">4a8579cf20d2a7fb74da82b70940ce3c</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_4454b831-7931-405c-85e2-60727ebaef74.entity.xml_lastModified">1435072140917</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_4454b831-7931-405c-85e2-60727ebaef74.entity.xml_length">2287</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_manager"></entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_mngtId">1764613107</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_name">SEVRES</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_owner"></entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_syncId">4</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_type">delivery.Application</entry>
 <entry key="4454b831-7931-405c-85e2-60727ebaef74_uuid">4454b831-7931-405c-85e2-60727ebaef74</entry>
 -->
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_c8bf6626-4840-44eb-ac3a-080370e67bbf.entity.xml_checksum">3387ef40b17e24ae225cea19f52a6d48</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_c8bf6626-4840-44eb-ac3a-080370e67bbf.entity.xml_lastModified">1434985964337</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_c8bf6626-4840-44eb-ac3a-080370e67bbf.entity.xml_length">2287</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_manager"></entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_mngtId">1764613107</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_name">MEUDON</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_owner"></entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_syncId">4</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_type">delivery.Application</entry>
 <entry key="c8bf6626-4840-44eb-ac3a-080370e67bbf_uuid">c8bf6626-4840-44eb-ac3a-080370e67bbf</entry>
</properties>

健康仪表盘/工程仪表盘——特定操作

 Click here to expand...

重新部署健康/工程仪表盘时,请注意以下事项:

WAR文件的名字

继续使用CAST AIP 8.3.2中的仪表盘重新命名修改(参见更改或新特性- 8.3.2),WAR文件在CAST AIP 8.3.3中重新命名如下:

曾用名
新名称
CAST-AAD.warCAST-Health.war
CAST-AED.warCAST-Engineering.war
CAST-AAD-AED.warCAST-Health-Engineering.war

请确保注意到这一点,并修改所有可能的WAR部署例程。参见:

.JSON 文件

如果通过.JSON文件对tile进行配置更改,并且希望将这些更改保留在仪表盘的新版本中,可以重新使用旧的.JSON文件新部署的仪表盘,但是请注意,这样做将无法从健康仪表盘/工程仪表盘当前版本中添加的任何改进或特性中获益。

用户、组和角色配置

在CAST AIP 8.3.x中,健康仪表盘/工程仪表盘/ RestAPI的用户、组和角色的配置已经更新,并与CAST AIC门户中使用的方法保持一致。因此,必须确保熟悉在更改或新特性中列出的更改。可在以下网页找到更多资料:

增强功能点计数模式(仅适用于健康仪表盘)

在CAST AIP 8.2.x中,CAST实现了一种新的增强功能点计数模式(参见CAST AIP增强功能点计数模式),修改了健康仪表盘默认的增强功能点平铺配置(参见自动增强点),只从新的AEP度量中提取数据。

但是,在以前的CAST AIP版本(≤8.1.x)中已经安装了应用,并将其升级为CAST AIP≥8.2.x,将继续为将来的快照使用旧版EFP度量模式(除非手动更改),因此仪表盘中的新图块不会显示关于增强功能点的信息(N/A)。

如果需要显示配置为显示EFP数据的图块,请将以下文本段从现有已部署WAR%CATALINA_HOME%\webapps\CAST-Health\portal\resources\app.json文件)复制到新部署WAR中的等效文件中:

{
    "id": 2,
    "title": "Software Enhancement Function Points (since previous version)",
    "panels": [
        {
            "id": 2000,
            "plugin": "FunctionalWeightMeasureResult",
            "color": "blue",
            "parameters": {
                "title": "",
                "functionalWeightMeasure": {
                    "id": "ADDED_FUNCTION_POINTS",
                    "format": "0,000",
                    "description": "Automated FPs Added"
                }
            }
        },
        {
            "id": 2002,
            "plugin": "FunctionalWeightMeasureResult",
            "color": "green",
            "parameters": {
                "title": "",
                "functionalWeightMeasure": {
                    "id": "MODIFIED_FUNCTION_POINTS",
                    "format": "0,000",
                    "description": "Automated FPs Modified"
                }
            }
        },
        {
            "id": 2001,
            "plugin": "FunctionalWeightMeasureResult",
            "color": "purple",
            "parameters": {
                "title": "",
                "functionalWeightMeasure": {
                    "id": "DELETED_FUNCTION_POINTS",
                    "format": "0,000",
                    "description": "Automated FPs Deleted"
                }
            }
        }
  • No labels