Defining a Siebel Client Executables Upgrade Kit

This topic provides specific instructions for defining an upgrade kit for a Siebel Client Executables component using the Upgrade Kit Wizard. You can deliver a Siebel Innovation Pack release with these components.

Instructions in this topic apply to the following two component types:

Siebel Client Executables. Used for language-independent portions of Siebel Innovation Pack releases, known as base portions. Language-specific files can also be included in this upgrade kit, along with the base files. You can use this component for standard installation or delta installation upgrade kits.

Siebel Client Executables__language-code. Optionally used for language-specific portions of Siebel Innovation Pack releases. You can use these components only for delta installation upgrade kits.

Instructions apply to both the standard installation and the delta installation types of Siebel Client Executables upgrade kit.

This task is a step in "Roadmap for Creating a Delta Installation Siebel Client Executables Upgrade Kit".

For more information about delta installation upgrade kits, see "About Reducing the Size of Siebel Client Executables Upgrade Kits".

Note:

For Siebel Patchset releases, use Siebel Patchset upgrade kits, as described in "Defining a Siebel Patchset Upgrade Kit".

The following procedure describes how to define either a Siebel Client Executables upgrade kit for the base component or a Siebel Client Executables__language-code upgrade kit for a language-specific component.

To define a Siebel Client Executables upgrade kit (base or language-specific)

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-4 to respond to the prompts in the Upgrade Kit Wizard.

Note:

The Minimum Old Version and Maximum Old Version settings are automatically set to NULL for history-independent component types, including Siebel Client Executables, indicating that there are no prerequisite versions required for using the upgrade kit. The value for New Version is also automatically supplied for Siebel Client Executables upgrade kits. These settings are displayed only in the final screen of 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 3, "Planning and Preparing to Use Siebel Anywhere."

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

Table 4-4 Upgrade Kit Wizard Elements for a Siebel Client Executables 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 Siebel Workspace Seed Import.
Select Type of Installation	Radio button	Determines the size and nature of the upgrade kit. If you want the upgrade kit to contain a complete set of the applicable client executable files, then select Standard Install. If you want the upgrade kit to contain condensed information about only the executable files that have changed in a particular Siebel Innovation Pack release, then select Delta Install. For more information about delta installation upgrade kits, see "About Reducing the Size of Siebel Client Executables Upgrade Kits" and "Roadmap for Creating a Delta Installation Siebel Client Executables Upgrade Kit".
UNC Path for Master Installation	Text field	This field is displayed only if you previously selected Standard Install in the Upgrade Kit Wizard. The Universal Naming Convention (UNC) path to the directory that contains the files that you prepared for the upgrade, as described in "Preparing Contents for a Siebel Client Executables Upgrade Kit". Identify a network-accessible location, as follows: An example path is: `\\computer_name\siebel\base`
UNC Path for Siebel Delta Patch File	Text field	This field is displayed only if you previously selected Delta Install in the Upgrade Kit Wizard. The Universal Naming Convention (UNC) path to the RTP delta patch file that was created by using the Siebel Patch Utility (siebpatch.exe). Specify the complete directory path and file name.
The path of startup program	Text field	Specifies the location of the file to be invoked to install the upgrade kit, within the directory specified with UNC Path for Master Installation. Use the default value.
Uninstall previous Siebel version	Check box	Do not select this check box. Caution: When this check box is selected, the Upgrade Wizard automatically uninstalls all existing Siebel applications before proceeding with installation of the upgrade. Note: Siebel Innovation Pack releases are designed to be applied, without the need for previous patches to be uninstalled. However, occasionally it is useful for testing or troubleshooting to uninstall the current release. For more information about uninstalling a release without uninstalling the prior installed release, where applicable, see "Uninstalling a Delta Patch".
Enter command line arguments	Text field	Specifies any command-line arguments to be used by the Siebel Innovation Pack client installer executable program. Use the default value. In general, change the default command-line arguments supplied in this field only if you require special installer behavior.
Major Version	Text field	Enter a value from the first part of the release number. For example, for Siebel CRM version 17.0, set Major Version to 17.
Minor Version	Text field	Enter a value from the second part of the release number. For example, for Siebel CRM version 17.0, set Minor Version to 0.
Maintenance Version	Text field	Enter a value from the third part of the release number. For example, for Siebel CRM version 17.0, set Maintenance Version to 0.
Patch Version	Text field	Enter a value from the fourth part of the release number. For example, for Siebel CRM version 17.0, set Patch Version to 0.
Vertical Code	Drop-down list	Select SIA for Siebel Industry Applications.
Activate Upgrade Kit	Check box	It is recommended that you clear this check box for all Siebel Client Executables upgrade kits. If this check box is selected, then 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 "Activating an Upgrade Kit". 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 make sure to clear this check box. For more information about working with dependent upgrade kits, see "Controlling the Order of Upgrade Kit Installation".
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.
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. It is recommended that you clear this check box for all Siebel Client Executables upgrade kits. 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 "Applying an Upgrade Kit". 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 make sure to 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.)
Description	Text field	This field is available for comments about the upgrade kit. Comments entered here are displayed in the Upgrade Kits list.

Note:

To avoid unnecessary download operations, it is recommended that you keep only one upgrade kit for history-independent components, including Siebel Client Executables upgrade kits. Depending on your preference, you can either delete or deactivate previous upgrade kits for a history-independent component. Deleting an upgrade kit increases available space in the Siebel File System. Deactivating an upgrade kit prevents use of the upgrade kit, while keeping it available in case you need it unexpectedly.