在此页:

目标客户:

CAST管理员

摘要: 本部分文档提供了如何以自动化和可重复的方式运行安装、重新安装和其他CAST 服务管理任务的说明。

简介

CAST AIP模式/数据库的安装/重新安装/更新/卸载是使用基于GUI应用的CAST 服务管理实现的，具有以下菜单选项:

Schema Installation > Schema Installation
Schema Installation > Upgrade Installation
Schema Installation > Component Reinstall
Schema Installation > Component Uninstall
Schema Installation > Troubleshooting > Remove Locks

如果需要自动化这些任务，那么可以使用CAST服务管理提供的CLI(命令行接口)来实现。本文档解释了如何使用。

先决条件

在开始使用CAST 服务管理 CLI之前，必须确保满足以下要求:

	需要安装CAST AIP- 要么完全安装或者所有AIP应用程序安装 (参见从安装程序安装CAST AIP), 必须位于您希望从其中运行CLI的机器上。
	指定目标RDBMS/CSS的CAST服务管理连接配置文件必须已经存在。

它是如何工作的?

CAST Management Studio CLI包含以下命令参数，这些参数允许您自动化所有任务:

-INSTALL_CONFIG_FILE - 此操作必须指定包含任务指令的XML文件
-UPGRADE
-REMOVE_LOCKS
-UNINSTALL_COMBINED
-CONNECT_STRING
-LOG

要通过命令行执行操作，必须指定SERVMAN.exe可执行文件。命令参数用动词表示，然后是各种强制和可选(括在方括号中)选项。下面列出并解释了每个命令参数谓词和各种示例。

命令参数

-INSTALL_CONFIG_FILE (<Path to XML file>)

此选项使您能够指定包含特定数据库安装/重新安装指令的XML文件。下面是您可以用来执行必要任务的标记列表:

单独安装/刷新模式——适用于CAST AIP的所有版本

在执行命令之前，目标数据库/模式必须已经存在。

Click to expand...

标签	属性/内容	解释	注释
<?xml version="1.0" encoding="ISO-8859-1"?>	-	这是根标记，必须存在。
<CAST-AutomaticInstall>	-	这个标记必须存在，并且所有其他标记必须包含在其中。
<ServerInstall>	必须位于<CAST-AutomaticInstall>内。属性如下:	这个标签定义了连接到目标RDBMS/CSS的设置。
	ProfileSystem="PROFILE_NAME"	指定将用于连接到目标RDBMS/CSS的CAST 管理服务器连接配置文件的名称。
	ServerType="CASTStorageService\|Oracle\|SqlServer"	指定要连接的服务器类型。请只使用适当的类型。
	UserSystem="USER_NAME"	指定将用于连接到目标RDBMS/CSS的用户名。
	SystemPassword="PASSWORD"	指定用于连接目标RDBMS/CSS的用户名的密码。
	ServerName="CSS_SERVER_NAME:2280\|ORACLE_TNS_NAME\|MS_SERVER_NAME"	指定要连接的服务器的名称。	请使用ServerName或ConnectionString -不要同时使用! MS_SERVER_NAME也可以是COMPUTER\SERVER_NAME的形式
	ConnectionString="CONNECTION_STRING"	指定特定于要连接的服务器的连接字符串。
<InstallDatabase> or <RefreshDatabase>	必须位于<ServerInstall>内。属性如下:	这个标记定义要安装的数据库/模式和将要安装的包/插件。使用<InstallDatabase>从头开始安装CAST AIP database/schema。相当于GUI中的Database/Schema Installation > Database/Schema Installation选项。使用<RefreshDatabase>运行目标CAST AIP database/schema的重新安装。相当于在GUI中Database/Schema Installation > Component Reinstall 选项。	注意，在XML文件中只能包含一个<InstallDatabase>或一个<RefreshDatabase>标记。这意味着要一次无缝地install/re-install所有CAST AIP databases/schemas，请为希望install/re-install的每个CAST AIP databases/schemas创建一个XML文件。
	DbName="DB_NAME"	指定要安装的数据库的名称。这个数据库/模式必须已经存在!
	DbPassword="DB_PASSWORD"	只有在使用安装在Oracle Server上的CAST AIP模式时才有效:指定在“DbName”中定义的对应模式的密码。
<PackName>	必须位于<InstallDatabase> 或<RefreshDatabase>内。内容如下:	指定应该安装到目标CAST AIP database/schema的“包”。根据您正在安装的数据库类型(MNGT/ANALYSIS/DASHBOARD/MEASURE)，包的列表将有所不同。	注意，不能在单个 <InstallDatabase>/ <RefreshDatabase>标记中混合用于不同CAST AIP database/schemas的包，也不能在单个XML文件中使用多个<InstallDatabase> / <RefreshDatabase>标记。
	Analysis Service database/schema: <PackName>BASE_LOCAL</PackName> <PackName>ADG_LOCAL_APPW</PackName> <PackName>KMS_LOCAL</PackName> <PackName>KMS2_LOCAL</PackName>	使用这些包安装分析服务。
	Dashboard Service database/schema: <PackName>ADG_FULL_CENTRAL</PackName>	使用这些包安装仪表板服务。
	Management Service database/schema: <PackName>PMC_MAIN</PackName>	使用这些包安装管理服务。
	Measurement Service database/schema: <PackName>AAD_MAIN</PackName>	使用这些包安装度量服务。
<Plugin>	必须位于<InstallDatabase> 或<RefreshDatabase>内。属性如下:	指定要安装到目标CAST AIP database/schema的插件名。	请注意，必须将插件安装到分析服务、仪表板服务和管理服务。测量服务不需要安装插件。
	id="EXTENSION_ID"	指定要安装插件名的id。	这个插件必须存在于: %PROGRAMDATA%\CAST\CAST\Extensions
	version="<VERSION_NUMBER> \| remove"	<VERSION_NUMBER>: 指定要安装插件的特定版本。如果省略此选项，则将安装已下载的最新版本。删除: 使用版本="remove"将使插件失效。
<InstallDependencies>	必须位于<InstallDatabase> 或<RefreshDatabase>内。属性如下:	仅供安装插件时使用。
	strategy="TakeLatest\|TakeMinimal"	将自动安装指定插件名的任何必需依赖项。CAST建议使用此选项，否则您将需要手动指定依赖项，如果指定了不正确的依赖项，则可能导致命令行失败。 TakeLatest将选择最新版本(即最高数量) TakeMinimal将选择可用的最老版本(即最低数量) 两者都只考虑兼容的版本。	依赖项必须存在于: %PROGRAMDATA%\CAST\CAST\Extension
<SkipLookupLegacyUADefaultLocation/>	必须位于<InstallDatabase>中。	防止位于磁盘上的遗留 %PROGRAMDATA%\CAST\CAST\<version>位置安装插件(这是在引入CAST插件下载器之前用于安装插件的位置)。如果包含此参数，则不会使用 %PROGRAMDATA%\CAST\CAST\<version>的任何内容。	在CAST Server Manager GUI中使用“Manage 插件”时，%PROGRAMDATA%\CAST\CAST\<version>显示为一个名为<all users dir>的插件名。默认行为是激活它，这个标记是禁用它。

说明

如果XML文件的路径包含空格(例如:C:\Script Folder\local.xml)，那么必须用引号括起来，例如:-INSTALL_CONFIG_FILE(“C:\Script Folder\local.xml”)

每个命令行只能调用一个XML文件，在这个XML文件中，只能安装/重新安装一个CAST AIP数据库/模式。因此，如果您希望一次性无缝地安装/重新安装所有CAST AIP数据库/模式，请考虑使用批处理文件尽可能多地调用该命令，并为希望安装/重新安装的每个CAST AIP数据库/模式创建一个XML文件。
CAST AIP 插件:
- 当从头开始安装CAST AIP数据库/模式时，或者当您希望在现有的CAST AIP数据库/模式上安装插件时，可以使用上述参数:
  - 要在安装新的CAST AIP数据库/模式的同时安装插件，只需在<PackName> 参数旁边包含所需的参数。
  - 要安装对现有CAST AIP数据库/模式的插件，请删除所有<PackName> 参数，并仅在<InstallDatabase>或<RefreshDatabase>标记中包含与插件相关的参数。
- CAST AIP插件必须安装到分析、仪表板和管理服务数据库，因此您需要在每个XML文件(每个数据库一个)中包含相同插件的相关参数，然后为每个XML文件运行命令行。

实例

为CAST存储服务提供的示例假设您使用的是具有默认密码的操作登录。

分析服务

**** This example file contains parameters for use in CAST Storage Service, Oracle and Microsoft environments - remember to remove the elements you do not need ****

**** This example file contains parameters to install a CAST database from scratch. Please change the InstallDatabase parameter to RefreshDatabase if you need to re-install an existing database. For example:
<InstallDatabase DbName="DB_NAME" > becomes <RefreshDatabase DbName="DB_NAME" > ****

CSS (CAST Storage Service)

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ServerName="NEFYN:2280" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ConnectionString="LIBPQ:NEFYN:2280" > -->
  <InstallDatabase DbName="DB_NAME" >
   <PackName >BASE_LOCAL</PackName>
   <PackName >ADG_LOCAL_APPW</PackName>
   <PackName >KMS_LOCAL</PackName>
   <PackName >KMS2_LOCAL</PackName>
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   

  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

Oracle

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="TNS_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallDatabase DbName="DB_NAME" DbPassword="DB_PASSWORD" >
   <PackName >BASE_LOCAL</PackName>
   <PackName >ADG_LOCAL_APPW</PackName>
   <PackName >KMS_LOCAL</PackName>
   <PackName >KMS2_LOCAL</PackName>
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

Microsoft

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="SERVER_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallDatabase DbName="DB_NAME" >
   <PackName >BASE_LOCAL</PackName>
   <PackName >ADG_LOCAL_APPW</PackName>
   <PackName >KMS_LOCAL</PackName>
   <PackName >KMS2_LOCAL</PackName>

   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
</InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

仪表板服务

**** This example file contains parameters for use in CAST Storage Service, Oracle and Microsoft environments - remember to remove the elements you do not need ****

**** This example file contains parameters to install a CAST database from scratch. Please change the InstallDatabase parameter to RefreshDatabase if you need to re-install an existing database. For example:
<InstallDatabase DbName="DB_NAME" > becomes <RefreshDatabase DbName="DB_NAME" > ****

CSS (CAST Storage Service)

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ServerName="NEFYN:2280" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ConnectionString="LIBPQ:NEFYN:2280" > -->
  <InstallDatabase DbName="DB_NAME" >
   <PackName >ADG_FULL_CENTRAL</PackName>
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

Oracle

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="TNS_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallDatabase DbName="DB_NAME" DbPassword="DB_PASSWORD" >
   <PackName >ADG_FULL_CENTRAL</PackName>
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>     
   
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

Microsoft

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="SERVER_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallDatabase DbName="DB_NAME" >
   <PackName >ADG_FULL_CENTRAL</PackName>
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
</InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

管理服务

**** This example file contains parameters for use in CAST Storage Service, Oracle and Microsoft environments - remember to remove the elements you do not need ****

**** This example file contains parameters to install a CAST database from scratch. Please change the InstallDatabase parameter to RefreshDatabase if you need to re-install an existing database. For example:
<InstallDatabase DbName="DB_NAME" > becomes <RefreshDatabase DbName="DB_NAME" > ****


CSS (CAST Storage Service)

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ServerName="NEFYN:2280" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ConnectionString="LIBPQ:NEFYN:2280" > -->
  <InstallDatabase DbName="DB_NAME" >
   <PackName >PMC_MAIN</PackName>
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

Oracle

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="TNS_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallDatabase DbName="DB_NAME" DbPassword="DB_PASSWORD" >
   <PackName >PMC_MAIN</PackName>
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

Microsoft

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="SERVER_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallDatabase DbName="DB_NAME" >
   <PackName >PMC_MAIN</PackName>

   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
</InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

度量服务

**** This example file contains parameters for use in CAST Storage Service, Oracle and Microsoft environments - remember to remove the elements you do not need ****

**** This example file contains parameters to install a CAST database from scratch. Please change the InstallDatabase parameter to RefreshDatabase if you need to re-install an existing database. For example:
<InstallDatabase DbName="DB_NAME" > becomes <RefreshDatabase DbName="DB_NAME" > ****


CSS (CAST Storage Service)

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ServerName="NEFYN:2280" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ConnectionString="LIBPQ:NEFYN:2280" > -->
  <InstallDatabase DbName="DB_NAME" >
   <PackName >AAD_MAIN</PackName>
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

Oracle

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="TNS_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallDatabase DbName="DB_NAME" DbPassword="DB_PASSWORD" >
   <PackName >AAD_MAIN</PackName>   
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

Microsoft

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="SERVER_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallDatabase DbName="DB_NAME" >
   <PackName >AAD_MAIN</PackName>
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

安装一个三元组，即“组合安装”——用于CAST AIP≥8.3.5

目标数据库/模式是在安装过程中创建的。

Click to expand...

标签	属性/内容	解释	注释
<?xml version="1.0" encoding="ISO-8859-1"?>	-	这是根标记，必须存在。
<CAST-AutomaticInstall>	-	这个标记必须存在，并且所有其他标记必须包含在其中。
<ServerInstall>	必须位于<CAST-AutomaticInstall>内。属性如下:	这个标签定义了连接到目标RDBMS/CSS的设置。
	ProfileSystem="PROFILE_NAME"	指定将用于连接到目标RDBMS/CSS的CAST Server Manager连接配置文件的名称。
	ServerType="CASTStorageService\|Oracle\|SqlServer"	指定要连接的服务器类型。请只使用适当的类型。
	UserSystem="USER_NAME"	指定将用于连接到目标RDBMS/CSS的用户名。
	SystemPassword="PASSWORD"	指定用于连接目标RDBMS/CSS的用户名的密码。
	ServerName="CSS_SERVER_NAME:2280\|ORACLE_TNS_NAME\|MS_SERVER_NAME"	指定要连接服务器的名称。	请使用ServerName或ConnectionString -不要同时使用! MS_SERVER_NAME也可以是COMPUTER\SERVER_NAME的形式
	ConnectionString="CONNECTION_STRING"	指定特定于要连接服务器的连接字符串。
<InstallPlatform>	必须位于<ServerInstall>中。属性如下:	该标记定义了安装三元组或“组合安装”(即管理服务模式、分析服务模式和仪表板服务模式)的设置。
	SchemaPrefix="<schema_prefix>"	指定要使用的模式前缀。例如，SchemaPrefix="TEST"将产生以下database/schemas: TEST_MNGT TEST_CENTRAL TEST_LOCAL
<Plugin>	必须位于<InstallPlatform>中。属性如下:	指定要安装到目标CAST AIP database/schemas的插件名
	id="EXTENSION_ID"	指定要安装插件名的id。	插件必须位于: %PROGRAMDATA%\CAST\CAST\Extensions
	version="<VERSION_NUMBER> \| remove"	<VERSION_NUMBER>: 指定要安装插件的特定版本。如果省略此选项，则将安装已下载的最新版本。删除: 使用版本="remove”将使插件失效。
<InstallDependencies>	必须位于<InstallPlatform>中。属性如下:	仅供安装插件时使用。
	strategy="TakeLatest\|TakeMinimal"	将自动安装指定插件名的任何必需依赖项。CAST建议使用此选项，否则您将需要手动指定依赖项，如果指定了不正确的依赖项，则可能导致命令行失败。 TakeLatest将选择最新版本(即最高数量) TakeMinimal将选择可用的最老版本(即最低数量) 两者都只考虑兼容的版本。	依赖项必须存在于: %PROGRAMDATA%\CAST\CAST\Extension
<SkipLookupLegacyUADefaultLocation/>	必须位于<InstallPlatform>中。属性如下:	防止位于磁盘上的遗留 %PROGRAMDATA%\CAST\CAST\<version>位置安装插件(这是在引入CAST插件下载器之前用于安装插件的位置)。如果包含此参数，则不会使用 %PROGRAMDATA%\CAST\CAST\<version>的任何内容。	在CAST Server Manager GUI中使用“Manage 插件”时，%PROGRAMDATA%\CAST\CAST\<version>显示为一个名为<all users dir>的插件名。默认行为是激活它，这个标记是禁用它。

说明

如果XML文件的路径包含空格(例如:C:\Script Folder\local.xml)，那么必须用引号括起来，例如:-INSTALL_CONFIG_FILE ("C:\Script Folder\local.xml")

每个命令行只能调用一个XML文件。

实例

为CAST存储服务提供的示例假设您使用的是具有默认密码的操作登录。

**** This example file contains parameters for use in CAST Storage Service, Oracle and Microsoft environments - remember to remove the elements you do not need ****

**** This example file contains parameters to install a CAST triplet from scratch. ****

CSS (CAST Storage Service)

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ServerName="NEFYN:2280" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ConnectionString="LIBPQ:NEFYN:2280" > -->
  <InstallPlatform SchemaPrefix="<schema_prefix>" >
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   

  </InstallPlatform>
 </ServerInstall>
</CAST-AutomaticInstall>

Oracle

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="TNS_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="Oracle" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallPlatform SchemaPrefix="<schema_prefix>" >
   
   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
  </InstallPlatform>
 </ServerInstall>
</CAST-AutomaticInstall>

Microsoft

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYYY" ServerName="SERVER_NAME" >
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="SqlServer" UserSystem="XXXX" SystemPassword="YYYY" ConnectionString="CONNECTION_STRING" > -->
  <InstallPlatform SchemaPrefix="<schema_prefix>" >

   <!-- Extensions: install a specific version -->
   <Plugin id="com.castsoftware.html5" version="1.1.0"/>
   
   <!-- Extensions: install most recent that has been downloaded -->
   <Plugin id="com.castsoftware.html5"/>
   
   <!-- Extensions: automatically install any required dependencies, using the most recent version that has been downloaded -->
   <InstallDependencies strategy="TakeLatest"/>

   <!-- Extensions: prevents installation from the legacy %programdata%\CAST\CAST\<version> location -->
   <SkipLookupLegacyUADefaultLocation/>   
   
  </InstallPlatform>
 </ServerInstall>
</CAST-AutomaticInstall>

-升级

此选项仅在需要在CLI模式下运行CAST度量服务模式升级的情况下使用。

说明

该选项必须与-INSTALL_CONFIG_FILE选项一起使用
在-INSTALL_CONFIG_FILE选项中指定的XML文件必须只使用<InstallDatabase> 标记，而不能使用 <RefreshDatabase> / <InstallPlatform>
度量服务模式仅在CAST存储服务中起作用。

实例

下面的命令行将度量服务模式从以前的版本升级到当前的版本。

SERVMAN.EXE -INSTALL_CONFIG_FILE ("C:\Script Folder\measure.xml") -UPGRADE -LOG(c:\log.castlog, -IMMEDIATE)

在-INSTALL_CONFIG_FILE选项中指定的XML文件应该采用以下形式:

<?xml version="1.0" encoding="ISO-8859-1"?>
<CAST-AutomaticInstall>
<!-- Use either ServerName= or ConnectionString= -->
 <!-- <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ServerName="CEIRIAD:2280" > -->
 <ServerInstall ProfileSystem="PROFILE_NAME" ServerType="CASTStorageService" UserSystem="operator" SystemPassword="CastAIP" ConnectionString="LIBPQ:CEIRIAD:2280" >
  <InstallDatabase DbName="DB_NAME" >
	<PackName >AAD_MAIN</PackName>
  </InstallDatabase>
 </ServerInstall>
</CAST-AutomaticInstall>

-CONNECT_STRING("<server_name/IP_address:port>",operator,<password>)

仅用于CAST AIP≥ 8.3.6.

该选项提供了一种方法，可以连接到所需的CAST存储服务，以便与某些其他CLI函数一起使用。

说明

该选项目前仅与-REMOVE_LOCKS和-UNINSTALL_COMBINED选项一起使用。
该选项仅与CAST存储服务一起使用。

选项

"<server_name/IP_address:port>"

使用服务器DNS名称或IP地址和端口号指定目标CAST存储服务:

CAST 存储服务3: [SERVER_DNS_NAME]:2282 or [SERVER_IP_ADDRESS]:2282
CAST 存储服务2: [SERVER_DNS_NAME]:2280 or [SERVER_IP_ADDRESS]:2280

operator

CAST存储服务的默认用户名。

与操作员用户名相对应的密码。这可能是默认的CastAIP，也可能已经更改。

实例

下面的命令行:

使用默认操作符用户名和密码连接到安装在服务器“localhost”上的CAST存储服务3。

SERVMAN.EXE -CONNECT_STRING("localhost:2282",operator,CastAIP)

-REMOVE_LOCKS(management:="<mngt_name>")

仅用于CAST AIP≥ 8.3.6。

此选项在组合安装(通过父管理服务模式指定)的管理、分析和仪表板服务模式上运行删除锁选项。在大多数情况下，CAST AIP应用程序创建的数据库锁在伴随的过程成功完成后或关闭应用程序时被删除。但是，在出现应用程序错误或与数据库服务器的连接丢失时，锁有时可能仍然存在。因此这个选项使您能够清除这些锁，而不必重新启动RDBMS。

说明

该选项必须与-CONNECT_STRING选项一起使用。
如果度量服务模式已作为组合安装的一部分安装，则删除选项将不在此度量服务模式上运行。
该选项不能在单个模式上运行(即度量服务或安装为“独立”的其他模式)。

选项

management:="<mngt_name>"	指定要在其上运行该选项的组合安装的管理服务模式的名称。

实例

下面的命令行:

在名为“app1”的管理服务模式以及相关的分析和仪表板服务模式上运行删除锁选项。
使用安装在服务器“localhost”上的CAST存储服务3上的管理服务模式。
在C:\log中生成一个日志文件，快速模式下保存。

SERVMAN.EXE -REMOVE_LOCKS(management:="app1") -CONNECT_STRING("localhost:2282",operator,CastAIP) -LOG(C:\log.castlog, -IMMEDIATE)

-UNINSTALL_COMBINED(management:="<mngt_name>")

仅用于CAST AIP≥ 8.3.6。

此选项将在组合安装(通过父管理服务模式指定)的管理、分析和仪表板服务模式上运行卸载操作。

说明

该选项必须与-CONNECT_STRING选项一起使用。
如果度量服务模式已作为组合安装的一部分安装，则卸载选项将不在此度量服务模式上起作用。
该选项不能在单个模式上运行(即度量服务或安装为“独立”的其他模式)。
模式被删除，所有数据不可恢复地丢失。

选项

management:="<mngt_name>"	指定要在其上运行该选项的组合安装的管理服务模式的名称。

实例

下面的命令行:

在名为“app1”的管理服务模式以及相关的分析和仪表板服务模式上运行卸载选项。
使用安装在服务器“localhost”上的CAST存储服务3的管理服务模式。
在C:\log中生成一个日志文件，快速模式下保存。

SERVMAN.EXE -UNINSTALL_COMBINED(management:="app1") -CONNECT_STRING("localhost:2282",operator,CastAIP) -LOG(C:\log.castlog, -IMMEDIATE)

-LOG(<filename>,[<arguments>],[<maxlines>])

初始化日志文件.

<filename> 指定输出日志文件的名称和位置(使用.castlog插件)
<arguments>指定以下任何日志文件参数

-USELOGFILE	激活使用日志文件模式
-IMMEDIATE	激活立即保存模式(即每当服务器或服务器管理器发送消息时，将记录写到日志文件中)。
-TRUNCATE	激活截断文件模式(即在每次执行服务器管理器时清空日志文件)。

<maxlines> 设置日志文件的最大长度

说明

如果需要指定多个参数，请使用空格分隔参数:SERVMAN.EXE -LOG(c:\log.castlog, -IMMEDIATE -TRUNCATE).
如果您只指定了一个参数，那么您也可以使用没有破折号和初始空间的参数:SERVMAN.EXE -LOG(c:\log.castlog,IMMEDIATE).
如果您想快速禁用一个选项，可以在破折号后使用“!”字符:SERVMAN.EXE -LOG(c:\log.castlog, -!IMMEDIATE -!TRUNCATE).
如果省略此选项，则将使用默认的CAST 服务管理日志文件(%PROGRAMDATA%\CAST\CAST\Logs\ServMan\Servman-<date>-<time>.castlog

实例

以下命令行以立即模式激活对日志文件的保存:

SERVMAN.EXE -INSTALL_CONFIG_FILE ("C:\Script Folder\local.xml") -LOG(c:\log.castlog, -IMMEDIATE)

Page tree

自动化CAST服务器管理器安装任务

简介

先决条件

它是如何工作的?

命令参数

-INSTALL_CONFIG_FILE (<Path to XML file>)

单独安装/刷新模式——适用于CAST AIP的所有版本

说明

实例

分析服务

仪表板服务

管理服务

度量服务

安装一个三元组，即“组合安装”——用于CAST AIP≥8.3.5

说明

实例

-升级

说明

实例

-CONNECT_STRING("<server_name/IP_address:port>",operator,<password>)

说明

选项

实例

-REMOVE_LOCKS(management:="<mngt_name>")

说明

选项

实例

-UNINSTALL_COMBINED(management:="<mngt_name>")

说明

选项

实例

-LOG(<filename>,[<arguments>],[<maxlines>])

说明

实例