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

在此页：

目标用户：

CAST AI 管理员

摘要：本节解释如何初始化CAST 管理器——即配置CAST许可证密钥并定义源代码交付和部署文件夹。

简介

CAST模式完成安装后（参见前一步骤：安装 CAST AIP 模式），初始化所需的设置管理器。可通过以下两种方式做到：

  • 通过CAST 管理器 GUI——这种方法最适合于只有少量应用（因此也只有少量CAST模式三元组）需要初始化的小型部署。此选项要求打开CAST 管理器，连接到每个管理服务，然后为每个管理服务模式配置所需的设置。
  • 通过CAST 管理器 CLI——这种方法最适合于需要初始化许多应用的大规模部署。此方法允许通过批处理脚本文件配置设置，因此不需要为每个管理服务模式打开CAST 管理器。

通过CAST 管理器 GUI

在使用此方法时，必须对已安装的每个管理服务模式重复说明。CAST管理器应该从步骤1中安装的CAST管理工作站运行： 从安装程序安装CAST AIP.

启动CAST 管理器

CAST管理器可以启动如下：

  • 要么在开始菜单中选择CAST 管理器快捷方式位置（在运行CAST AIP Windows安装程序时创建）
  • 或者导航到CAST安装文件夹并双击CAST——MS.exe程序   
  • 然后显示Database Connection Manager：   

  • 在组合安装过程中（同时安装所有CAST数据库，分析/仪表盘/管理/测量服务，请参阅安装 CAST AIP 模式），CAST服务器管理器将自动创建连接配置文件至已安装的管理服务（<prefix>_MNGT）。如果没有使用组合安装选项安装CAST数据库，则没有可用的连接配置文件，需要通过单击按钮并定义管理服务的详细信息来创建连接配置文件（<prefix>_MNGT）。
  • 在列表中选择连接配置文件，然后单击Connect。
  • 然后将显示启动向导。

请注意，CAST管理器的一个实例只能与一个管理服务一起使用。CAST不建议使用CAST管理器的多个实例（例如在不同的工作站上）与相同的管理服务进行交互。数据损坏的可能性很高，无法修复。

使用启动向导定义许可证密钥和交付/部署文件夹

启动向导仅在首次启动CAST 管理器时启动。在随后的启动中，向导将不会显示。

这些设置对于CAST管理器非常重要，如果没有这些设置，则CAST AIP无法使用：

  • 单击Next按钮启动向导。
  • 这个页面提示输入CAST license key：  

  • 输入CAST提供许可证密钥，许可证密钥现在已注册，并且对所有终端用户应用有效。请注意，未来的许可证密钥注册和激活可以使用CAST 管理器中的Help > License Key菜单来处理，也可以通过运行下面讨论的ConfigurePlatformPreferences CLI选项来处理。
  • 在向导中单击Next移动到下一页：

  • 为了正确的工作，CAST 交付管理器工具需要用于存储源代码、日志和临时文件的各种文件夹。这些文件夹是必需的——如果没有这些文件夹，则CAST 管理器无法正常工作。每个文件夹的位置尤其重要，特别是CAST AIC门户还必须能够访问源代码交付文件夹。
    • 源代码交付文件夹 —— 一个中央位置，用于存储由交付管理器打包的应用源代码的连续和压缩版本。
    • 源代码部署文件夹 —— CAST 管理器专用于以未压缩格式存储应用源代码的最新版本以供分析的位置。
    • 日志文件夹 —— 用于存储与分析或仪表盘服务的所有交互日志的位置。    

    • LISA（大型中间存储区域）/ LTSA（大型临时存储区域）——存储分析过程中生成临时文件的位置

    • 默认情况下，以下路径将被预加载到每个字段中——您可以将路径保留在默认值，也可根据需要自定义路径：
选项默认路径注意
源交付%SystemDrive%\CASTMS\Delivery

必须定义与安装CAST AIC门户时定义的完全相同的交付文件夹位置（请参见安装和配置CAST AIC门户）。可以在交付文件夹应该位于何处一章中了解更多关于交付文件夹配置的信息。

  • 如果CAST AIC门户和CAST 管理器部署在同一工作站上，那么文件夹也可以在同一台机器上定义（“本地”文件夹）。
    • 您可以使用以下语法D:\CAST\DELIVERY（主机本地文件夹）——当CAST AIC门户和CAST管理器位于同一台计算机上时，请使用此语法。在这种情况下，始终输入包含交付文件夹的本地驱动器的绝对路径（例如dD:\ CAST\ Delivery）。
    • 请不要使用映射的驱动器路径（由Windows GUI或SUBST Windows命令创建），该路径指向本地计算机上的文件夹或远程网络共享——这样做可能导致错误，从而阻止CAST AIC门户/CAST 管理器工作。
  • 如果CAST AIC门户和CAST 管理器部署在不同的工作站上，则这两个文件夹都必须可用。可以使用以下语法：\\HOST\CAST\DELIVERY（远程网络共享上的文件夹）——注意，前斜杠也会起作用。仅当CAST AIC门户和CAST 管理器位于不同的机器上时，请使用此语法。例如：
    • 网络驱动器
    • CAST管理器的“本地”文件夹，可由CAST AIC门户共享和访问
    • CAST管理器可以共享和访问CAST AIC门户的“本地”文件夹
  • CAST AIC门户必须能够访问交付文件夹路径
  • 任何希望与CAST 管理器中的交付文件夹交互的用户（例如，在接受交付时，使用Set as current version选项，或者在CAST管理器中运行CAST Delivery Manager Tool时）都需要对交付文件夹具有读/写访问权限
源部署%SystemDrive%\CASTMS\Deploy

只有CAST管理器可以访问的存储位置，因为这样的CAST建议在CAST管理工作站（即安装CAST管理的机器）上使用“本地”文件夹。

日志%PROGRAMDATA%\CAST\CAST\Log

使用此选项定义一个日志目录，在其中存储与分析或仪表盘服务的所有交互的日志。一旦定义，将生成以下日志文件：

  • 在使用CAST 交付管理器工具、运行分析或生成快照时，将为每个应用生成一个文件夹（使用唯一ID命名）。其内容包括分析日志和交付管理器工具特定的日志（如验证/选择/发现）：
  • 一个名为“CAST_MainTask_SummaryLog_<date>.txt”将与分析/仪表盘服务交互时生成（即运行分析或生成快照）
  • 一个名为“DssEngine.<date>.log.txt”将在生成快照时生成——这将记录快照生成过程
  • 一个名为“RunCSV——<date>.castlog”的日志文件。当生成快照时，将生成CAST系统视图的更新

注意

  • 如果将该字段更改为空白，日志根目录将默认为：
    • %TEMP%\CAST\CAST\<version_number>
  • 这里所做的更改不会影响特定CAST 管理器日志（CAST——MSXX.log.txt）的位置，它显示在日志视图窗口中。
LISA%PROGRAMDATA%\CAST\CAST\CASTMS

此选项允许在本地硬盘上定义一个位置（即文件夹），CAST 管理器可以指定该位置（即文件夹）用于存储分析过程中生成的杂项文件。一旦分析完成，这些文件仍然存在。

一旦使用browse选项选择了某个位置，将自动创建名为LISA的子文件夹。生成的文件将存储在LISA文件夹中。

注意

  • 如果该字段为空，则使用CAST临时文件夹，即：
    • %TEMP%\CAST\CAST\<version_number>\LISA
  • 此功能在J2EE和.NET技术中常用来存储在激活用户输入数据流安全性分析功能时生成的数据。
  • 请注意，该位置必须能够接收大量数据（几百MB）。
  • 这个文件夹存储各种文件——它本质上类似于浏览器缓存。
LTSA%PROGRAMDATA%\CAST\CAST\CASTMS

此选项允许在本地硬盘上定义一个位置（即文件夹），CAST 管理器可以指定该位置（即文件夹）用于存储分析过程中生成的临时文件。一旦分析完成，这些文件将被删除。

一旦使用browse选项选择了一个位置，将自动创建一个名为LTSA的子文件夹。生成的文件将存储在LTSA文件夹中。

注意

  • 如果该字段为空，则使用CAST临时文件夹，即：
    • %TEMP%\CAST\CAST\<version_number>\LTSA
  • 这个文件夹存储临时文件——它本质上类似于Windows %TEMP%文件夹。

请注意以下附加信息：

  • 启动向导中定义的文件夹设置为“per Management Service schema basis”。这意味着文件夹应该只用于所连接的管理服务模式。如果连接到不同的管理服务模式，将需要设置新的文件夹位置——而这些文件夹位置不应该设置为相同的位置。
  • 必须确保：
    • 每个文件夹使用不同的位置（即交付文件夹不应该是部署文件夹的子文件夹，反之亦然）
    • 每个文件夹与用于存储源代码的位置是完全分离的——例如，如果将交付和部署文件夹配置为位于源代码存储位置的子文件夹中，就会出现错误
  • 对于自定义路径，可以使用以下语法：
    • D:\CAST\DELIVERY（主机本地文件夹）——始终输入绝对路径。请不要使用映射的驱动器路径（由Windows GUI或SUBST Windows命令创建），该路径指向本地计算机上的文件夹或指向远程网络共享——这样做可能导致错误，从而阻止CAST AIC门户/CAST 管理器工作。
    • \\HOST\CAST\DELIVERY（远程网络共享文件夹）。注意，前斜杠也会起作用。
  • 预先填充到字段中的默认路径取自CASTGlobalSettings.ini文件（文件位于CAST AIP安装的根文件夹——参见附录——修改默认的CAST数据存储位置）——CASTGlobalSettings.ini文件改变位置不会影响GUI中定义的设置。
  • 做出选择，然后单击Finish完成启动向导。
  • 然后将显示CAST管理器。

通过CAST 管理器 CLI

使用此方法时，必须对已安装的每个管理服务模式进行重复说明——但是可以将每个管理服务模式的说明组合到一个批处理文件中，然后运行该批处理文件，一次性配置所有设置。更多有关信息，请参见自动化CAST管理工作室的任务。

要使用此方法，CAST建议创建一个空批处理文件，并将所需的命令放入批处理文件中——然后只需双击该批处理文件即可执行该批处理文件。要通过命令行执行操作，必须指定CAST——MS——CLI.exe可执行文件（而不是CAST——MS.exe可执行）。所需的语法如下：

CAST——MS——CLI.exe ConfigurePlatformPreferences ——connectionProfile "<profile_name>" ——licenseKey "<license_key>" ——sourceDeliveryFolder "<path_to_delivery_folder>" ——sourceDeploymentFolder "<path_to_deployment_folder" ——temporaryWorkingPath "<path_to_parent_folder_for_LISA>" ——storageWorkingPath "<path_to_parent_folder_for_LTSA>" ——logRootPath "<path_to_logs_folder>"
选项描述

——connectionProfile

指定连接配置文件的名称，以用于连接所选的CAST管理服务模式。可以从CAST 管理器中的Connection Profile对话框中获取此信息——请注意，连接配置文件可以包含空格，在这种情况下，请确保名称周围带有引号：

在组合安装过程中（同时安装所有CAST数据库，分析/仪表盘/管理/测量服务，参见安装 CAST AIP 模式），CAST服务器管理器将自动创建连接配置文件或配置文件到已安装的管理服务（<prefix>_MNGT）。如果未使用组合安装选项安装CAST模式，则没有可用的连接配置文件，需要通过单击按钮，定义需要初始化的每个管理服务模式（<prefix>_MNGT）的详细信息来创建一个连接配置文件。

——licenseKey

输入CAST提供的许可密钥。
——sourceDeliveryFolder

输入源代码交付文件夹和源代码部署文件夹的位置。有关可以使用路径语法的更多信息，请参见上面的小节。

——sourceDeploymentFolder
——temporaryWorkingPath输入LISA的位置（大型中间存储区域）。LISA子文件夹将在选定的位置创建。
——storageWorkingPath输入LTSA（大型临时存储区域）的位置。将在选定的位置创建LTSA子文件夹。
——logRootPath

输入Logs文件夹的位置。绝对路径是必需的。可以使用前斜杠或后斜杠。默认情况下，CAST 管理器生成的所有日志文件都将加盖日期戳。

输出代码

CLI将返回两个输出代码：

  • 0 = 无错误 （成功执行）
  • 2 = 存在错误 （例如，许可证密钥的格式可能是错误的）

日志记录

默认情况下（如果CLI中没有使用日志记录选项），CLI将使用以下位置存储与此流程相关的日志文件：

%TEMP%\CAST\CAST\<version_number>\CAST——MS<number>.log.txt

如果字符串包含空白，可以使用以下语法覆盖默认的日志位置，将字符串括在双引号中。指定的文件夹不需要已经存在：

——logRootPath <string>

示例

下面的示例使用许可证密钥、交付文件夹路径、部署文件夹路径更新一个管理服务模式，并包括一个日志文件位置：

CAST——MS——CLI.exe ConfigurePlatformPreferences ——connectionProfile "v830_mngt on CastStorageService _ NEFYN：2280"——licenseKey "xxxxx" ——sourceDeliveryFolder "D：\CAST\Delivery" ——sourceDeploymentFolder "D：\CAST\Deploy" ——storageWorkingPath "D：\CAST\Storage" ——temporaryWorkingPath "D：\CAST\Storage" "——logRootPath "C：\CAST\Log"

注意

  • 使用命令行界面成功初始化设置之后，打开CAST管理器并首次连接到相关的管理服务将不会显示启动向导。
  • 使用启动向导或CLI界面完成设置后，可使用CLI界面更新设置（不包括-sourcedDeliveryFolder和-sourcedDeploymentFolder）。


  • No labels