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

On this page:

Target audience:

CAST Administrators

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

Prerequistes

  • This section assumes that a complete installation of CAST AIP as described in the CAST AIP install documentation has already been actioned.
  • You must also ensure that your CAST AIP installation is compatible with the extension - AIP compatibility is listed in  Siebel 5.1 - Release Notes.
The latest release status of this extension can be seen when downloading it from the CAST Extend server.

Step 1: Obtain the extension

The extension 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.

  • First you need to locate the extension you want to download.
  • In the menu shown below, ensure that the following two options are selected:
    • the Latest versions only option (CAST recommends this option to filter out previous releases of extensions)
    • the Long term support only option (CAST recommends this option to filter out pre-release or BETA releases)


  • Now click the Available option on the left hand side of the application - this option will display all extensions which you have not already downloaded:


  • All extensions matching the selected filtering options will now be displayed. Scroll through to find the extension your require - selecting an extension in the list will display information about it in the right hand panel, highlighted in red below:


  • Ensure you take note of the required Dependencies as highlighted above - dependencies listed will be downloaded at the same time as the extension you have chosen (for example, the AngularJS extension requires the HTML5/JavaScript and WBSLinker extensions, the most recent versions of which will be downloaded at the same time).
  • Click the Download button to start the download of the extension:


  • Extensions are downloaded to the following location on your local machine:
8.x.x
%PROGRAMDATA%\CAST\CAST\Extensions

7.3.x
<CAST_installation_folder>\CustomPlugins


Step 2: Copy files and manage index.xml (only for users of CAST AIP 7.3.x)

  • The extension will have been downloaded to <CAST_installation_folder>\CustomPlugins. Browse to this location and locate the folder of the extension you downloaded.
  • In the folder you will find various sub-folders and files.
  • Please ensure that you complete the actions listed in the Required Action column, taking note of any information in the Notes column.
Extension versionSubfolderContentsRequired Action
5.1.0 and above
com.castsoftware.siebel.<version>/TOOLS/Plugins

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

  • dmtcastsiebeldb2extractor-1.1.0
  • dmtcastsiebeldeliveryextractor-1.0.0
  • dmtcastsiebeldiscoverer-1.0.0
  • dmtcastsiebelextractor-1.1.0
  • dmtcastsiebeloracleextractor-1.1.0
  • dmtcastsiebeltechno-1.1.0
  • index.xml

Plugin folders

Copy/paste all the 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.1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeldeliveryextractor-1.0.0">true</entry>
<entry key="plugin.active.dmtcastsiebeldiscoverer-1.0.0">true</entry>
<entry key="plugin.active.dmtcastsiebelextractor-1.1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeloracleextractor-1.1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeltechno-1.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.1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeldeliveryextractor-1.0.0">true</entry>
<entry key="plugin.active.dmtcastsiebeldiscoverer-1.0.0">true</entry>
<entry key="plugin.active.dmtcastsiebelextractor-1.1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeloracleextractor-1.1.0">true</entry>
<entry key="plugin.active.dmtcastsiebeltechno-1.1.0">true</entry>
  • Finally, save the index.xml.

Step 3: CAST database installation

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:

  • Management Base
  • Analysis Service
  • Dashboard Service


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 schemas.

  • Run CAST Server Manager (ServMan.exe) and choose the "Schema Installation/Schema Installation… option on the toolbar.
  • In the wizard, choose Initial platform base(s) installation > Additional Analysis platform

  • In CAST AIP 8.x.x you will be prompted to choose the Siebel extension to install (this screen will not be visible in CAST AIP 7.3.x but the extension will be installed automatically):

  • Set the database prefix (SIEBEL5 for our example), and password (if asked), then continue the wizard process.

  • CAST Server Manager will install three CAST schemas named as follows:
    • SIEBEL5_LOCAL (CAST Project Analysis Service)
    • SIEBEL5_CENTRAL (CAST Dashboard Service)
    • SIEBEL5_MNGT (for the CAST Management Service)
  • The extension will be installed at the same time.

Vanilla

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

  • Run CAST Server Manager (ServMan.exe) and choose the "Schema Installation/Schema Installation… option on the toolbar.
  • In the wizard, choose Initial platform base(s) installation > Additional Analysis platform
  • In CAST AIP 8.x.x you will be prompted to choose the Siebel extension to install (this screen will not be visible in CAST AIP 7.3.x but the extension will be installed automatically)
  • Set the database prefix (SIEBEL5_V for our example), and password (if asked), then continue the wizard process.

  • CAST Server Manager will install three CAST schemas named as follows:
    • SIEBEL5_V_LOCAL (CAST Project Analysis Service)
    • SIEBEL5_V_CENTRAL (CAST Dashboard Service)
    • SIEBEL5_V_MNGT (for the CAST Management).
  • The extension will be installed at the same time.
  • No labels

2 Comments

  1. Anonymous

    When updating the index.xml file in the plugins directory, make sure that the entries in the index.xml file match the directory names that were copied to the plugins directory.  For example - the current Siebel 5.1.1 extension release requires that the index.xml file be updated to below:

    <entry key="plugin.active.dmtcastsiebeldb2extractor-1.1.0">true</entry>

    <entry key="plugin.active.dmtcastsiebeldeliveryextractor-1.0.0">true</entry>
    <entry key="plugin.active.dmtcastsiebeldiscoverer-1.0.0">true</entry>
    <entry key="plugin.active.dmtcastsiebelextractor-1.1.0">true</entry>
    <entry key="plugin.active.dmtcastsiebeloracleextractor-1.1.1">true</entry>
    <entry key="plugin.active.dmtcastsiebeltechno-1.1.0">true</entry>
    1. Thanks for the feedback, the doc does stipulate this already:

      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.

      And this should only need to be done if you are using the extension with CAST AIP 7.3.x - if you are using 8.x then the installation via Server Manager should manage this aspect automatically.