Siebel Anywhere Administration Guide > Defining Upgrade Kits >

Defining a Siebel Repository File Upgrade Kit


This section provides specific instructions for defining a Siebel Repository File upgrade kit using the Upgrade Kit Wizard. These instructions can be used for the following types of upgrade components, which are always language-specific:

  • Siebel Client Repository File_[language-code]
  • Siebel Server Repository File_[language-code]

For either of these component types, two different types of repository file kits can be created:

  • Standard Repository File Upgrade Kit. Contains a complete SRF repository file.
  • Delta Repository File Upgrade Kit. Contains information about changes to a specific version of a Siebel repository file, rather than the complete SRF. The delta repository file must be created ahead of time, using the Siebel Delta SRF Utility (diffsrf).

NOTE:  The upgrade kit also sets the version of the SRF in the Siebel Repository File itself. For both Standard Repository File upgrade kits and Delta Repository File upgrade kits, the kit sets the version in the final Siebel Repository File. When a Delta Repository File upgrade kit is used, the final file that receives the version number is created when the Upgrade Wizard applies the delta file to the base file.

To define a Siebel Repository File upgrade kit

  1. Gather the information you will need, as described in Upgrade Planning and Preliminary Tasks.

    In particular, if you are defining a Delta Repository File upgrade kit, see Process of Creating a Delta Repository File Upgrade Kit.

  2. Start the Upgrade Kit Wizard using the instructions in Running the Upgrade Kit Wizard.
  3. Use the information you have gathered and the information in Table 19 to respond to the prompts in the Upgrade Kit Wizard.
  4. When you have finished specifying data about the upgrade kit you are defining, click Finish to pass the request to the Upgrade Kit Builder 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 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 information on these tasks, see Activating, Applying, and Distributing Upgrade Kits.

Information in Table 19 is presented in approximately the sequence used by the Upgrade Kit Wizard.

Table 19. Upgrade Kit Wizard Elements for a Siebel Repository File Upgrade Kit
Wizard Element
Element Type
Comments

Upgrade Component

Drop-down list

Name of the component the upgrade kit will install or upgrade. Select one of the following:

  • Siebel Client Repository File_[language-code] (use when distributing repository file to clients)
  • Siebel Server Repository File_[language-code] (use when distributing repository file to servers)

Select File Type

Radio button

Specifies whether the kit will contain a complete repository file or a "delta" repository file. Select one of the following values:

  • Standard Repository File. Use this file type when defining a repository upgrade kit for clients if the kit will contain a complete repository file. For a repository upgrade kit for a server, always choose this file type.
  • Delta Repository File. Use this file type when defining an upgrade kit for clients if the kit will contain a "delta" repository file. A delta repository file contains information about changes to a specific version of a complete repository file, rather than the complete file, itself. The delta repository file must be created ahead of time, using the Siebel Delta SRF Utility (diffsrf). For information about creating the delta repository file, see Process of Creating a Delta Repository File Upgrade Kit.

Files to Add

Text field

Universal Naming Convention (UNC) path and file name of the delta .srf file to include in a Delta Repository File upgrade kit. Browsing is available by clicking the Browse button described in the following row of this table.

Browse

Button

Displays a standard dialog box for browsing and choosing a delta .srf file. Available for Delta Repository File upgrade kits only.

UNC Path for SRF file

Text field

Universal Naming Convention (UNC) path and file name of the standard (complete) .srf file to include in a Standard Repository File upgrade kit. Browsing is not available for Standard Repository File upgrade kits.

Minimum Old Version

Read-only text field

Earliest component version that can download and install the upgrade kit. Automatically set to NULL for history-independent component types, including repository files, indicating that there are no prerequisite versions required for using the kit. For more information about choosing version values, see Determining Version Setting Values.

Maximum Old Version

Read-only text field

Latest component version that can download and install the upgrade kit. Automatically set to NULL for history-independent component types, including repository files, indicating that there are no prerequisite versions required for using the kit. For more information about choosing version values, see Determining Version Setting Values.

Base Version

Text field

For a delta Repository File upgrade kit, specifies the version number of the repository file that was used as a base for the changes that the delta kit will distribute.

To determine the version number of the base repository file, open a command window, navigate to SIEBEL_ROOT\bin or SIEBEL_CLIENT_ROOT\bin, and enter the following command, substituting the name of the base repository file and the language code used for that repository:

srfstamp /r repository_file_name /l language-code

New Version

Text field

Version number that the component being upgraded will have after the upgrade kit is installed. Default value is 1 greater than the current version for the component to be upgraded. For a Siebel Repository File upgrade kit, the New Version Value must be an integer. 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. Activation can also be performed manually, as described in 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 dependant on another upgrade kit, be sure to clear this check box. (For example, a repository kit might be dependent on a database schema kit.) For information about working with dependent kits, see Controlling the Order of Kit Installation.

Apply Versions

Check box

Displayed only if Activate Upgrade Kit check box was selected in an earlier Upgrade Kit Wizard screen. 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. Applying versions can also be performed manually, as described in 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 dependant on another upgrade kit, be sure to clear this check box. For information about working with dependent kits, see Controlling the Order of Kit Installation.

Required Upgrade Kit

Check box

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 New Version, but this change is not visible in the Upgrade Kit Wizard.) Displayed only if Apply Versions check box was selected in an earlier Upgrade Kit Wizard screen.

Upgrade Kit Title

Text field

Identifier for the upgrade kit. Defaults to Upgrade Component Name value followed by a space and the New Version value, but can be modified during the kit definition process. After the kit is defined, this identifier appears in the Name field of the Upgrade Kits list.

Comments

Text field

Available for comments about the upgrade kit. Comments entered here are displayed in the Upgrade Kits list.

NOTE:  It is recommended that you keep only one upgrade kit for history-independent components, including repository file kits. Depending on your preference, you can either delete or inactivate previous kits for a history-independent component. Deleting a kit increases available space in the Siebel File System. Inactivating a kit prevents use of the kit, while keeping it available in case you need it unexpectedly.

Siebel Anywhere Administration Guide