Page tree
Skip to end of metadata
Go to start of metadata
Summary: This section of documentation provides an explanation of how to run install, re-install and other CAST Server Manager tasks in an automated and repeatable way.

Introduction

The install/reinstall/update of CAST AIP schemas/databases is achieved using the GUI based application CAST Server Manager with the following menu options:

  • Database/Schema Installation > Database/Schema Installation
  • Database/Schema Installation > Component Reinstall
  • Database/Schema Installation > Component Update

If you need to automate these tasks, then you can do so by using the CLI (Command Line Interface) provided with the CAST Server Manager. This document explains how.

Prerequisites

Before you can starting using the CAST Server Manager CLI, you must ensure that you meet the following requirements:

(tick)An installation of CAST AIP is required - either a Full Installation or a All Application Intelligence Platform Applications installation (see Install CAST AIP components), which must be located on the machine you wish to run the CLI from.
(tick)A CAST Server Manager connection profile specifying the target RDBMS/CSS must already exist.

In this section:

Target audience:

  • CAST administrators

How does it work?

The CAST Management Studio CLI includes the following command arguments which allow you to automate all tasks:

  • -INSTALL_CONFIG_FILE - this action must specify an XML file that contains the task instructions.
  • -UPGRADE
  • -LOG

To execute an action via the command line, you must specify the SERVMAN.exe executable. Command arguments are expressed as verbs and then various mandatory and optional (enclosed in square brackets) options. Each command argument verb and various examples is listed and explained below.

Command arguments

-INSTALL_CONFIG_FILE (<Path to XML file>)

This option enables you to specify the XML file that contains the specific database install/re-install instructions. Below is a list of the tags that you can use to perform the necessary tasks:

TagsAttributes/ContentsRequired?ExplanationNotes
<?xml version="1.0" encoding="ISO-8859-1"?>
-(tick)This is the root tag and must be present. 
<CAST-AutomaticInstall>
-(tick)This tag must be present and all other tags must be contained within it. 
<ServerInstall>
Must be located within <CAST-AutomaticInstall>. See below for attributes:(tick)This tag defines the settings for connecting to the target RDBMS/CSS. 
 
ProfileSystem="PROFILE_NAME"
(tick)Specifies the name of the CAST Server Manager connection profile that will be used for connecting to the target RDBMS/CSS. 
 
ServerType="CASTStorageService|Oracle|SqlServer"
(tick)Specifies the type of server you are connecting to. Please use only the appropriate type. 
 
UserSystem="USER_NAME"
(tick)Specifies the user name that will be used for connecting to the target RDBMS/CSS. 
 
SystemPassword="PASSWORD"
(tick)Specifies the password for the User Name that will be used for connecting to the target RDBMS/CSS. 
 
ServerName="CSS_SERVER_NAME:2280|ORACLE_TNS_NAME|MS_SERVER_NAME"
(error)Specifies the name of the server you are connecting to.
  • Please use either ServerName or ConnectionString - not both!
  • MS_SERVER_NAME can also be of the form COMPUTER\SERVER_NAME
 
ConnectionString="CONNECTION_STRING"
(error)Specifies the connection string specific to the server you are connecting to.
<InstallDatabase> or <RefreshDatabase>
Must be located within <ServerInstall>. See below for attributes:(tick)

This tag defines the database/schema to be installed and the packages/extensions that will be installed.

Use <InstallDatabase> to install CAST AIP database/schema from scratch. Equivalent to the Database/Schema Installation > Database/Schema Installation option in the GUI.

Use <RefreshDatabase> to run a reinstall of the target CAST AIP database/schema. Equivalent to the Database/Schema Installation > Component Reinstall option in the GUI.

Note that it is ONLY possible to include either ONE single <InstallDatabase> or ONE single <RefreshDatabase> tag in an XML file.

This means that to seamlessly install/re-install all CAST AIP databases/schemas in one go, please create one XML file per CAST AIP database/schema you wish to install/re-install.

 
DbName="DB_NAME"
(tick)Specifies the name of the database you want to install. This database/schema must ALREADY exist! 
 
DbPassword="DB_PASSWORD"
(tick)Only valid when working with CAST AIP schemas installed on Oracle Server: specifies the password for the corresponding schema defined in "DbName". 
<PackName>
Must be located within <InstallDatabase> or <RefreshDatabase>. See below for contents:(tick)

Specifies the "packs" that should be installed to the target CAST AIP database/schema. The list of "packs will differ depending on the type of database you are installing (MNGT/ANALYSIS/DASHBOARD/MEASURE).

Note that you CANNOT mix packs for different CAST AIP database/schemas in one single <InstallDatabase> / <RefreshDatabase> tag and nor can you use multiple <InstallDatabase> / <RefreshDatabase> tags in one single XML file.
 

Analysis Service database/schema:

<PackName>BASE_LOCAL</PackName>
<PackName>ADG_LOCAL_APPW</PackName>
<PackName>KMS_LOCAL</PackName>
<PackName>KMS2_LOCAL</PackName>
(tick)Use these packs to install an Analysis Service. 
 

Dashboard Service database/schema:

<PackName>ADG_FULL_CENTRAL</PackName>
(tick)Use these packs to install a Dashboard Service. 
 

Management Service database/schema:

<PackName>PMC_MAIN</PackName>
(tick)Use these packs to install a Management Service. 
 

Measurement Service database/schema:

<PackName>AAD_MAIN</PackName>
(tick)Use these packs to install a Measurement Service. 
<Plugin>
Must be located within <InstallDatabase> or <RefreshDatabase>. See below for attributes:(error)Specifies the Extension that you would like to install to the target CAST AIP database/schema.

Note that an extension must be installed to the Analysis Service, Dashboard Service and the Management Service.

Measurement Services do not require the installation of extensions

 
id="EXTENSION_ID"
(error)Specifies the ID of the extension to install. 

This extension must exist in:

  • %PROGRAMDATA%\CAST\CAST\Extensions.
 
version="<VERSION_NUMBER> | remove"
(error)

<VERSION_NUMBER>:

Specifies a specific version of an Extension to install. If this is omitted, then the most recent version that has been downloaded will be installed.

remove:

Using version="remove" will deactivate the extension.

 
<InstallDependencies> 
Must be located within <InstallDatabase> or <RefreshDatabase>. See below for attributes:(error)Only for use when installing an Extension. 
 
strategy="TakeLatest|TakeMinimal"
(error)

Will automatically install any required dependencies of the specified extension(s). CAST recommends using this option otherwise you will need to manually specify the dependencies, which can lead to command line failure if the incorrect dependencies are specified.

  • TakeLatest will select the most recent version available (i.e. highest number)
  • TakeMinimal will select the oldest version available (i.e. lowest number)

Both will only consider compatible versions.

The dependencies must exist in:

  • %PROGRAMDATA%\CAST\CAST\Extensions.
<SkipLookupLegacyUADefaultLocation/>
Must be located within <InstallDatabase>.(error)Prevents installation of extensions from the legacy %PROGRAMDATA%\CAST\CAST\<version> location on disk (this was the location used to install extensions prior to the introduction of the CAST Extension Downloader). If this parameter is included, none of the content in %PROGRAMDATA%\CAST\CAST\<version> location will be used.

When using "Manage Extensions" in CAST Server Manager GUI,  %PROGRAMDATA%\CAST\CAST\<version> is displayed as a single extension named <all users dir>.

Default behaviour is to activate it, and this tag is to disable it.

Notes

  • The target database MUST ALREADY EXIST before executing the commands.
  • If the path to the XML file contains white spaces (for example: C:\Script Folder\local.xml) then you must enclose the path with quote marks, e.g.: -INSTALL_CONFIG_FILE ("C:\Script Folder\local.xml")
  • You can only call ONE XML file per command line and within that XML file, only ONE CAST AIP database/schema can be installed/re-installed. As such, if you want to seamlessly install/re-install all CAST AIP databases/schemas in one go, please consider using a batch file to call the command as many time as necessary, and create one XML file per CAST AIP database/schema you wish to install/re-install.
  • CAST AIP Extensions:
    • The above parameters can be used when installing CAST AIP databases/schemas from scratch, or when you want to install the extensions on existing CAST AIP databases/schemas:
      • To install extensions at the same time as installing new CAST AIP databases/schemas, simply include the required parameters alongside the <PackName> parameters
      • To install extensions to existing CAST AIP databases/schemas, remove all <PackName> parameters, and include only the parameters relevant to extensions within the <InstallDatabase> or <RefreshDatabase> tag.
    • CAST AIP extensions must be installed to the Analysis, Dashboard and Management Service databases, therefore you need to include the same extension related parameters in each XML file (one for each database) and then run the command line for each XML file.

Examples

The examples given for the CAST Storage Service assume that you are using the operator login with the default password.

Analysis Service

**** 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>

Dashboard Service

**** 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>

Management Service

**** 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>

Measurement Service

**** 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>

-UPGRADE

This option is only to be used in situations where you need to run an upgrade of the CAST Measurement Service schema in CLI mode.

Notes

  • The option MUST be used in conjunction with the -INSTALL_CONFIG_FILE option
  • The XML file specified in the -INSTALL_CONFIG_FILE option MUST use the <InstallDatabase> tag, and NOT <RefreshDatabase>
  • This option MUST NOT be used to upgrade an Analysis, Dashboard or Management Service schema, instead please use the CAST Update Tool in CLI mode - see Automating CAST Update Tool tasks
  • Measurement Service schemas only exist on CAST Storage Service host RDBMS.

Example

The following command line upgrades a Measurement Service schema from a previous release to the current release.

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

The XML file specified n the -INSTALL_CONFIG_FILE option should take the following form:

<?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>

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

Initializes the log file.

  • <filename> specify the name and location of the output log file (use the .castlog extension)
  • <arguments> specify any of the following log file parameters
-USELOGFILEactivates the use log file mode
-IMMEDIATEactivates the immediate save mode (i.e. entries will be written to the log file every time a message is sent by the server or by Server Manager.)
-TRUNCATEactivates the truncate file mode (i.e. the log file will be emptied each time Server Manager is executed.)
  • <maxlines> sets the log file's maximum length

Notes

  • If you need to specify more than one argument, please separate the arguments with a space: SERVMAN.EXE -LOG(c:\log.castlog, -IMMEDIATE -TRUNCATE).
  • If you are only specifying one argument, you can also use the argument without a dash and without an initial space: SERVMAN.EXE -LOG(c:\log.castlog,IMMEDIATE).
  • If you want to rapidly deactivate an option, you can use the "!" character after the dash: SERVMAN.EXE -LOG(c:\log.castlog, -!IMMEDIATE -!TRUNCATE).

Example

The following command line activates saving to the log file in immediate mode:

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