Defining a Third Party Software Upgrade Kit

This topic provides specific instructions for defining a Third Party Software upgrade kit using the Upgrade Kit Wizard.

For an example of the creation of a Third Party Software upgrade kit, see "Example of Constructing a Third Party Software Upgrade Kit".

Note:

Third Party Software components are meant to support third-party software products that are needed for operation with Siebel applications. Siebel Anywhere is not a general-purpose tool for software configuration management and distribution.

To define a Third Party Software upgrade kit

Gather the information and files you will need, as described in Chapter 3, "Planning and Preparing to Use Siebel Anywhere."
Start the Upgrade Kit Wizard, as described in "Running the Upgrade Kit Wizard".
Use the information you have gathered and the information in Table 4-7 to respond to the prompts in the Upgrade Kit Wizard.
When you have finished specifying data about the upgrade kit you are defining, click Finish to pass the request to the Upgrade Kit Builder server component and to exit from the Upgrade Kit Wizard.

A new row for the new upgrade kit appears in the Upgrade Kits list, with Status set to Request Submitted. For more information about the upgrade kit information available in this list and other lists, see "Viewing Upgrade Kit Properties".

After you define your upgrade kit, you must proceed to activate, apply, and distribute it. For more information about these tasks, see Chapter 6, "Activating, Applying, and Distributing Upgrade Kits."

The information in Table 4-7 is presented in approximately the sequence used by the Upgrade Kit Wizard.

Table 4-7 Upgrade Kit Wizard Elements for a Third Party Software Upgrade Kit

Wizard Element	Element Type	Comments
Upgrade Component	Drop-down list	The name of the component the upgrade kit will install or upgrade. Select one of the following predefined components, or a custom component you have created: Third Party - Oracle 8 Client Third Party - Microsoft Word Third Party - Microsoft SQL Server Driver Third Party - Microsoft Internet Explorer Third Party - IBM DB2 Client Third Party - Adobe Acrobat Reader Third Party - Adobe Acrobat
UNC Path for Software Directory	Text field	The Universal Naming Convention (UNC) path to the directory that contains the files to include in the upgrade kit. All files in the specified directory are included in the upgrade kit automatically.
Destination Directory	Text field	Specifies where the files from the upgrade kit are to be placed on the client computer. The default value is: `$SiebelRoot\upgrade\$KitName` where $SiebelRoot refers to the Siebel client root directory, and $KitName refers to a subdirectory with the name of the upgrade kit. Both of these variables are case-sensitive.
Delete destination file when done	Check box	When this check box is selected, the upgrade kit files will be deleted, automatically, after the upgrade kit is installed.
Specify file to execute	Text field	Specifies the file that runs the software installer on the subscriber's computer, such as install.exe. Only one file for each upgrade kit can be specified for execution. Make sure that you specify a file that can be executed, such as a BAT or EXE file on Windows. If you specify a file that cannot be executed, such as a TXT file or a CFG file, then the upgrade kit will not install properly.
Enter command line arguments	Text field	Specifies any command-line arguments to use when running the file chosen in the Specify file to execute field.
Minimum Old Version	Text field	The earliest component version that can download and install the upgrade kit. When this field is blank, this indicates that there are no prerequisite versions required for using the upgrade kit. The default value is the current component version recorded in the database. For more information about choosing version values, see "Determining Version-Setting Values".
Maximum Old Version	Text field	The latest component version that can download and install the upgrade kit. When this field is blank, this indicates that there are no prerequisite versions required for using the upgrade kit. For more information about choosing version values, see "Determining Version-Setting Values".
New Version	Text field	The version number that the component being upgraded will have after the upgrade kit is installed. The default value is 1 greater than the current version for the component to be upgraded. For more information about choosing version values, see "Determining Version-Setting Values".
Activate Upgrade Kit	Check box	When this check box is selected, the files to be included in the upgrade kit will be compressed into a single archive on the Siebel File System automatically. You can also perform activation manually, as described in Chapter 6, "Activating, Applying, and Distributing Upgrade Kits." For most upgrade kits, it is recommended that you select this check box. However, if you are creating an upgrade kit that is dependent on another upgrade kit, then clear this check box. For more information about working with dependent upgrade kits, see "Controlling the Order of Upgrade Kit Installation".
Apply Versions	Check box	This check box is displayed only if you previously selected the Activate Upgrade Kit check box in the Upgrade Kit Wizard. When this check box is selected, the compiled information string in the database will be updated automatically with the component version information for this upgrade kit. You can also apply versions manually, as described in Chapter 6, "Activating, Applying, and Distributing Upgrade Kits." For most upgrade kits, it is recommended that you select this check box. However, if you are creating an upgrade kit that is dependent on another upgrade kit, then clear this check box. For more information about working with dependent upgrade kits, see "Controlling the Order of Upgrade Kit Installation".
Required Upgrade Kit	Check box	This check box is displayed only if you previously selected the Apply Versions check box in the Upgrade Kit Wizard. When this check box is selected, the upgrade kit will be required regardless of previous versions installed. (Min Version and Max Version are set equal to the value of New Version, but this change is not visible in the Upgrade Kit Wizard.)
Upgrade Kit Title	Text field	An identifier for the upgrade kit. The default value is the value of Upgrade Component Name followed by a space and the value of New Version. However, you can modify the title while defining the upgrade kit. After the upgrade kit is defined, this identifier appears in the Name field of the Upgrade Kits list.
Comments	Text field	This field is available for comments about the upgrade kit. Comments entered here are displayed in the Upgrade Kits list.