Bookshelf Home | Contents | Index | PDF     

Siebel Anywhere Administration Guide > Upgrade Planning and Preliminary Tasks > Process of Creating a Delta Repository File Upgrade Kit >

Preparing a Delta Repository File

This topic describes how to use the diffsrf utility to create a delta repository file containing only the differences between two complete repository files. This task is a step in Process of Creating a Delta Repository File Upgrade Kit.

NOTE:  Every delta repository file contains information that is required for version control. This version information requires approximately 1 to 2 MB of space in the delta repository file, regardless of the size of the base SRF or the changes you have made.

To create a delta repository file using the diffsrf utility

  1. Note the location and name of the complete Siebel repository file (SRF) that is currently in use in your Siebel implementation.

    CAUTION:  This should be the location of a file that has been distributed to an actual client machine using Siebel Anywhere. If necessary, copy the file from a client machine to the machine where you will create the delta patch file. Do not use a repository file that has not passed through the process of being distributed by Siebel Anywhere. In some cases, a delta patch file that is created from an undistributed repository will fail to apply correctly on client machines.

  2. Note the location and name of the complete Siebel repository file (SRF) that contains the changes you want to distribute.
  3. On the machine that you will use to run diffsrf, open a Command Prompt window and navigate to the appropriate directory:
    • On your Siebel Server machine, navigate to the siebsrvr\bin directory for your Siebel implementation.
    • On a Siebel Developer Client machine, navigate to the web client\bin directory for that machine.
  4. In the Command Prompt window, enter the following command, substituting actual values for the italicized argument placeholders shown here.

    For information about the arguments for the diffsrf command, see Table 14.

    diffsrf -F diff -O oldsrf -N newsrf -P delta -L language

    NOTE:  For best results, close other applications before running diffsrf. The diffsrf utility is cpu-intensive, and may take a few moments to complete its operations.

Table 14. Arguments for the diffsrf.exe utility
Argument
Comments

-F function

Function that you want the utility to perform. Valid values include:

  • apply. Applies the changes that are recorded in delta repository file delta to existing repository file oldsrf. Normally, this operation is not required, as repository file changes are applied by using a delta repository file upgrade kit, rather than by using diffsrf.
  • diff. (Default) Creates delta repository file delta, based on differences between repository files oldsrf and newsrf. This delta repository file can be included in a delta repository file upgrade kit.

-O oldsrf

Complete path and filename for an existing repository file.

  • If you use the -F apply argument to apply changes in a delta repository file to an existing repository file, oldsrf should be the existing repository file.
  • If you use the -F diff argument to create a delta repository file, oldsrf should be the SRF that is currently used in your Siebel implementation. Use an SRF that has actually been distributed to a client machine using Siebel Anywhere. (Specifying an SRF that has not passed through the distribution process can cause failures during attempts to apply the delta repository file to clients.)

-N newsrf

Complete path and filename for a repository file that contains changes.

  • If you use the -F apply argument to apply changes in a delta repository file to an existing repository file, newsrf is the name of the new repository file to create.
  • If you use the -F diff argument to create a delta repository file, newsrf should be the SRF that contains the changes that you want to distribute.

-P delta

Complete path and filename for a delta repository file.

  • If you use the -F apply argument to apply changes in a delta repository file to an existing repository file, delta is the name of the delta repository file containing the changes to apply.
  • If you use the -F diff argument to create a delta repository file, delta is the name of the delta repository file for diffsrf to create. Be sure to specify a location for which you have write permission.

-L language

Language code for oldsrf, newsrf and delta repository files, such as ENU for English, DEU for German, and JPN for Japanese.
    
Siebel Anywhere Administration Guide