On this page:

Target audience:

CAST Administrators

Summary: This page explains how to install the extension on your workstation

Prerequistes

Notes

The process of downloading and installing these extensions differs depending on the format that the extension is published in (archive or NuGet format). Historically CAST provided extensions in archive format (a ZIP file or similar), however, starting with CAST AIP 7.3.x, CAST is transitioning to delivery in NuGet format via the CAST Extension Downloader. While this transition phase continues, some releases of an extension may only be available as an archive file (typically older releases) and some may only be available in NuGet format via the CAST Extension Downloader (typically newer releases). In addition, some may be available in both formats.

The latest release status of this extension can be seen when downloading it from the CAST Extend server.

Step 1: Obtain the extension

If your extension is provided as an archive file

You can download the extension as an archive file direct from CAST.

If your extension is provided as a Nuget file

If your extension is provided in NuGet format, it can be downloaded using a tool called the CAST Extension Downloader. For users of CAST AIP 7.3.x the CAST Extension Downloader is not provided as part of the setup. Instead it is available as a separate download from our FTP server. Please unzip the archive file and copy the contents into your CAST AIP installation folder and double click the ExtensionDownloader.exe file to launch the application.


The CAST Extension Downloader connects automatically to a special content delivery server hosted by CAST.





8.x.x
%PROGRAMDATA%\CAST\CAST\Extensions

7.3.x
<CAST_installation_folder>\CustomPlugins


Step 2: Copy files and manage index.xml

If your extension is provided as an archive file

Subfolder
Contents
Required Action
Notes
ToBeCopiedInCProgramDataOrAllUsersFolder

Contains the following configuration folders:

  • Configuration folder
  • InstallScripts folder
These two folders must be copied into the following Windows folder:
  • Windows Vista, Windows 7, Server 2008:  %ALLUSERSPROFILE%\CAST\CAST\<version>
  • previous versions of Windows: %ALLUSERSPROFILE%\Application Data\CAST\CAST\<version>

 

When installing the extension from scratch

If you are installing the extension from scratch, i.e. it has not been installed on the target workstation before, please take into account the following:

  • You may be prompted to merge the two folders with identical folders in the target location - you should do so.
  • If the following files exist already in the target location, please perform a merge rather than overwrite the existing files:
    • InstallScripts\Common\local_custom.pck
    • InstallScripts\Common\central_custom.pck
  • If you need to use the same Assessment Model as was supplied with the legacy Siebel 4.0 extension, please replace the following files as follows:
    • InstallScripts\Common\Siebel\ADG_ConfigData_Siebel.xml > InstallScripts\Common\Siebel\ADG_ConfigData_Siebel_V4.xml
    • InstallScripts\Common\Siebel\ObjSetDefinition_Siebel.xml > InstallScripts\Common\Siebel\ObjSetDefinition_Siebel_V4.xml

When installing the extension as a Service Pack

If you are installing the extension as a Service Pack, i.e. a previous release has already been installed on the target workstation, please take into account the following:

  • You will be prompted to merge the two folders with identical folders in the target location - you should do so. When prompted whether you want to overwrite or replace existing files of the same name, please do so.

Also contains this folder:

  • Configuration\Languages\Siebel\png folder

If you are using the CAST Engineering Dashboard, the contents of png folder must be copied into the following location:

%CATALINA_HOME%\webapps\<MY_CASTAD>\themes\default\objects\
N/A
ToBeInstalledInSCDFPlugins

Contains the CAST Delivery Manager Tool plugins:

  • dmtcastSiebelextractor-1.0.dmtplugin
  • dmtcastSiebeltechno-1.0.dmtplugin
  • dmtcastSiebeldb2extractor-1.0.dmtplugin
  • dmtcastSiebeloracleextractor-1.0.dmtplugin
  • index for Siebel customs.xml

The index for Siebel customs.xml file must be copied to the following location:

<Delivery_folder>\plugins

.dmtplugin files must first be extracted (using a third party extractor such as 7zip) and then the extracted files/folders must be copied into the same folder (<Delivery_folder>\plugins). So, to take the dmtcastSiebelextractor-1.0.dmtplugin as an example:

  • Extract the file with 7zip or similar
  • This will give you these results:

  • Copy the second dmtcastsiebelextractor-1.0 folder (and the .mda file contained within it) into the <Delivery_folder>\plugins folder:

 

Note that:

  • The Delivery folder is used by the CAST AIC Portal and the CAST Management Studio.
  • You only need to deploy one of the following plugins depending on the database in which the Siebel source code is stored:

    • DB2: dmtcastSiebeldb2extractor-1.0.dmtplugin
    • Oracle: dmtcastSiebeloracleextractor-1.0.dmtplugin

Rename the file

  • Rename the file from "index for Siebel customs.xml" to "index.xml"
  • If you already have an index.xml file in the <Delivery_folder>\plugins folder, then you will need to merge the contents of "index for Siebel customs.xml" with the existing index.xml file: all four <entry> tags in "index for Siebel customs.xml" should be copied across to the existing index.xml file.

Enable or disable Oracle/DB2

  • If you are extracting Siebel source code from an Oracle Server, then you do not need to do anything. By default the dmtcastsiebeloracleextractor: is active.
  • If you are extracting Siebel source code from a DB2 Server then you need to:
    • Place the <entry key="plugin.active.dmtcastsiebeloracleextractor-1.0.">true</entry> line in comment by adding <!-- and --> around it.
    • Remove the comments from the line <entry key="plugin.active.dmtcastsiebeldb2extractor-1.0.">true</entry>
  • Save the index.xml.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="plugin.active.dmtcastSiebeltechno-1.0">true</entry>
<entry key="plugin.active.dmtcastSiebelextractor-1.0">true</entry>
<entry key="plugin.active.dmtcastSiebeloracleextractor-1.0">true</entry>
<!--<entry key="plugin.active.dmtcastSiebeldb2extractor-1.0">true</entry>-->
</properties> 

If your extension is provided as a Nuget file

For users of CAST AIP 8.x.x

There is nothing to do in this step.

For users of CAST AIP 7.3.x

Extension versionSubfolderContentsRequired ActionNotes
5.0.1ToBeInstalledInSCDFPlugins

Contains the CAST Delivery Manager Tool plugins:

  • dmtcastSiebelextractor-1.0.dmtplugin
  • dmtcastSiebeltechno-1.0.dmtplugin
  • dmtcastSiebeldb2extractor-1.0.dmtplugin
  • dmtcastSiebeloracleextractor-1.0.dmtplugin
  • index for Siebel customs.xml

The index for Siebel customs.xml file must be copied to the following location:

<Delivery_folder>\plugins

.dmtplugin files must first be extracted (using a third party extractor such as 7zip) and then the extracted files/folders must be copied into the same folder (<Delivery_folder>\plugins). So, to take the dmtcastSiebelextractor-1.0.dmtplugin as an example:

  • Extract the file with 7zip or similar
  • This will give you these results:

  • Copy the second dmtcastsiebelextractor-1.0 folder (and the .mda file contained within it) into the <Delivery_folder>\plugins folder:

 

Note that:

  • The Delivery folder is used by the CAST AIC Portal and the CAST Management Studio.
  • You only need to deploy one of the following plugins depending on the database in which the Siebel source code is stored:

    • DB2: dmtcastSiebeldb2extractor-1.0.dmtplugin
    • Oracle: dmtcastSiebeloracleextractor-1.0.dmtplugin

Rename the file

  • Rename the file from "index for Siebel customs.xml" to "index.xml"
  • If you already have an index.xml file in the <Delivery_folder>\plugins folder, then you will need to merge the contents of "index for Siebel customs.xml" with the existing index.xml file: all four <entry> tags in "index for Siebel customs.xml" should be copied across to the existing index.xml file.

Enable or disable Oracle/DB2

  • If you are extracting Siebel source code from an Oracle Server, then you do not need to do anything. By default the dmtcastsiebeloracleextractor: is active.
  • If you are extracting Siebel source code from a DB2 Server then you need to:
    • Place the <entry key="plugin.active.dmtcastsiebeloracleextractor-1.0.">true</entry> line in comment by adding <!-- and --> around it.
    • Remove the comments from the line <entry key="plugin.active.dmtcastsiebeldb2extractor-1.0.">true</entry>
  • Save the index.xml.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<entry key="plugin.active.dmtcastSiebeltechno-1.0">true</entry>
<entry key="plugin.active.dmtcastSiebelextractor-1.0">true</entry>
<entry key="plugin.active.dmtcastSiebeloracleextractor-1.0">true</entry>
<!--<entry key="plugin.active.dmtcastSiebeldb2extractor-1.0">true</entry>-->
</properties> 
5.0.2 and abovecom.castsoftware.siebel.<version>/TOOLS/Plugins

Contains the CAST Delivery Manager Tool plugins (as folders) and the root XML file:

  • dmtcastSiebelextractor-1.0
  • dmtcastSiebeltechno-1.0
  • dmtcastSiebeldb2extractor-1.0
  • dmtcastSiebeloracleextractor-1.0
  • index.xml

plugin folders

Copy/paste the four folders into the <Delivery_folder>\plugins folder.

index.xml

If an index.xml file EXISTS in the <Delivery_folder>\plugins folder:

  • Edit the file with a text editor and add in the the following lines within the existing <properties> tags:
<entry key="plugin.active.dmtcastsiebeldb2extractor-1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeltechno-1.0">true</entry>
<entry key="plugin.active.dmtcastsiebelextractor-1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeloracleextractor-1.0">true</entry>
Please ensure that the part after "active." matches the name of the plugin folders delivered in the extension, which have been copied into the <Delivery_folder>\plugins folder.
  • Finally, save the index.xml.

If an index.xml file DOES NOT EXIST in the <Delivery_folder>\plugins folder:

  • Copy/paste the index.xml file provided in the extension into the <Delivery_folder>\plugins folder.
  • Edit the file with a text editor and add in the the following lines within the existing <properties> tags:
<entry key="plugin.active.dmtcastsiebeldb2extractor-1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeltechno-1.0">true</entry>
<entry key="plugin.active.dmtcastsiebelextractor-1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeloracleextractor-1.0">true</entry>
  • Finally, save the index.xml.
 N/A

Step 3: CAST database installation

Note that this step is valid regardless of the format in which your extension is delivered (archive or NuGet)

CAST recommends creating two "triplets" of CAST databases to use specifically with your Siebel analysis - one for the Project and one for the Vanilla. I.e. create an Analysis Platform with three CAST databases via the "combined installation" option:


Here are some indicative schema sizes for a large Siebel analysis (3.4 GB of source code):

Schema

Data

Index

Total

Management Schema

163 MB

-

163 MB

Dashboard Schema

1.5 GB

1.5 GB

3 GB

Project Analysis Database

7 GB

7 GB

14 GB

Vanilla Analysis Database

5 GB

6 GB

11 GB

Project

Use the "combined installation" to create the three CAST databases.

Vanilla

As with the installation of the CAST schemas for the Project, use the "combined installation" to create the three CAST databases.