简介

虽然可以使用GUI工具将CAST AIP升级到一个新版本，但是CAST也提供了一个批处理脚本来完成这项工作。这个批处理脚本的优点是:

• 它默默地完成升级
• 一键式解决方案是否意味着您可以避免使用多个工具来实现相同的结果
• 它是预先准备好的，这意味着您不需要搜索CAST AIP文档来定位所需工具的CLI文档

批处理脚本是做什么的?

批处理脚本的功能基于“组合模式安装”，因此它可以对每个定义的“组合模式安装”执行以下升级相关操作:

• 备份:
  • 在“组合模式安装”中所有CAST AIP模式(管理、分析、仪表板服务)
  • 组合模式安装”中与管理服务模式关联的传输文件夹
• 升级:
  • “组合模式安装”中的管理服务模式
  • 所有相关的分析和仪表板服务模式
  • 所有相关的应用程序
  • 所有相关评估模型
  • 相关的传输文件夹
  • 在“组合模式安装”中已经安装的所有CAST AIP插件
• 按需安装:
  • 已下载的CAST AIP插件的任何新版本
• 运行后更新一致性快照

脚本没有做什么?

批处理脚本没有:

• 升级度量服务模式。如果需要这样做，请使用GUI来完成。请参见逐步升级过程
• 升级Oracle服务器或Microsoft SQL Server上主机的“组合模式安装”    
• 升级主机在多个主机CAST存储服务上的“组合模式安装”:所有“组合模式安装”必须位于同一个CAST存储服务主机上。但是如果您需要升级位于多个CAST存储服务上的多个组合模式安装，那么您应该为希望使用的每个CAST存储服务复制“tools\ upgrade \template”文件夹-请参见下面的复制模板文件夹获得有关这一点的更多信息。
  

前提条件

要使用批处理脚本，必须确保满足以下前提条件:

	必须从安装程序安装目标CAST AIP版本(参见 安装 CAST AIP)
	确保您已经阅读了升级准备并完成了所有需要的操作。

准备

找到批处理脚本和相关的配置文件

预准备的批处理脚本可在CAST AIP安装文件夹下的tools\Upgrade\template下找到:  

复制模板文件夹

在tools\Upgrade\CASTUpgrade.bat提供的脚本不能被改变。它包含可以在子文件夹tools\Upgrade\template中提供的文件中定义的参数。将tools\Upgrade\template的全部内容复制到一个新文件夹中(您可能没有在CAST AIP安装文件夹中的新文件夹中修改它们的正确权限)，例如D:\CAST\Upgrade并使用复制来运行升级。

Update the CASTUpgradeRun.bat file 

文件CASTUpgradeRun.bat位于复制模板文件夹中包含一行代码，用于标识CAST AIP安装文件夹的位置:

• 如果CAST AIP安装在默认位置“C:\Program Files\CAST\<version>”，那么您不需要做任何事情。
• 如果CAST AIP未安装在默认位置(即在初始安装时位置已更改)，则必须调整路径“C:\Program Files\CAST\<version>”以匹配您的CAST AIP安装位置。

设置变量

在复制的模板文件夹中打开下列文件，并为您的环境配置它们:

CASTUpgrade_ServerConnection.txt

该文件允许您指定主机CAST存储服务，指定的CAST AIP三元组位于该主机转换存储服务上。您只能选择一个主机CAST存储服务，因此所有的CAST AIP三联必须位于同一个主机上:

HOST=<host_machine_name_or_IP_address>
PORT=<CAST_Storage_Service_port_number>
USER_ID=operator
PASSWD_CRYPTED=<encrypted_password_for_USER_ID>

示例

HOST=SERVER1
PORT=2282
USER_ID=operator
PASSWD_CRYPTED=CRYPTED2:90B8661401B724DB5AC34595

CASTUpgrade_Config.txt

本文件定义了各种技术参数:

OUT_PATH=<path_to_working_folder>
DUMP_PATH=<path_to_backup_folder>
LOG_PATH=<path_to_log_folder>
CAST_HOME=<path_to_target_CAST_AIP_installation_folder>
EXCEL_EXE=<path_to_EXCEL.EXE_file>
DELTA_FILE=C:\ProgramData\CAST\CAST\Extensions\com.castsoftware.deltareportsanpshot.1.0.0\Upgrade_Delta_Explanation.xlsm
ANALYSIS_DELTA_FILE=C:\ProgramData\CAST\CAST\Extensions\com.castsoftware.deltareportanalysis.1.0.0\Upgrade_Delta_Explanation.xlsm

#To activate the debug, put 1
_DEBUG_=1

CASTUpgrade_Schemas.txt

该文件允许您指定一组用于升级的一个或多个CAST AIP模式(以“组合模式”安装)。每个Management Service schema/extension list/Assessment Model strategy/discoverers使用一行来启用以下语法—支持多行(因此支持多个组合模式安装)，但是，所有组合模式安装必须位于相同的主机CAST存储服务上。

<mb_prefix>:<extension_list_to_install>:<assessmentModelUpgrade>:<discoverers_to_enable>

<mb_prefix>: :<assessmentModelUpgrade>

TRIPLET1PREFIX:com.castsoftware.flex:replaceByNewAssessmentModel:HTML5 project;XML scanner
TRIPLET1PREFIX:com.castsoftware.flex:replaceByNewAssessmentModel:HTML5 project
TRIPLET1PREFIX:com.castsoftware.flex:replaceByNewAssessmentModel:XML scanner

示例

TRIPLET1PREFIX:com.castsoftware.angularjs,com.castsoftware.flex:replaceByNewAssessmentModel
TRIPLET2PREFIX:com.castsoftware.angularjs:activateNewRules
TRIPLET1PREFIX:com.castsoftware.flex:replaceByNewAssessmentModel:HTML5 project;XML scanner

CASTUpgrade_Steps.txt

该文件定义了要执行的升级步骤。这为您的工作方式提供了灵活性，也就是说，您可以选择只运行备份步骤，或者只执行升级

#Activation of the different steps for each application
ACTIVATE_BACKUP=Y
ACTIVATE_CLEANUP=N
ACTIVATE_UPGRADE=Y
EXTENSIONS_LATEST_DEPENDENCIES=Y
ACTIVATE_CONSISTENCY=Y
#To limit the consistency to the snapshot (after the update of the AM with extensions), set the option CONSISTENCY_MODE to SNAPSHOT
CONSISTENCY_MODE=
ACTIVATE_RECOVERY=N
INSTALL_CUSTOM_UA_LEGACY=N

运行升级

• 要运行升级，双击复制模板文件夹中的CASTUpgradeRun.bat。不要试图运行tools\Upgrade\CASTUpgradeRun.bat文件作为进程会出错。
• 首先会提示您在目标CAST存储服务上输入操作员用户的密码。即使这个密码是在CASTUpgrade_ServerConnection.txt文件中定义的，将提示您使用此文件作为安全机制，以防止意外或恶意升级。
• 最后您可以在控制台中跟踪升级过程。相同的信息将在主日志文件<timestamp>_CASTUpgrade.log中提供，在使用CASTUpgrade_Config.txt文件中的LOG_PATH变量定义。
• 升级完成后，请阅读升级后操作项，了解完成升级后的预期结果，以及您可能需要完成的任何操作项。
  

下一节列出试图通过批处理脚本运行升级时可能返回的错误编号:

• 错误代码