Siebel Anywhere Administration Guide > Planning and Preparing to Use Siebel Anywhere >

Preparing a Delta Repository File


This topic describes how to use the diffsrf utility to create a delta repository file (SRF file) containing only the differences between two complete SRF files.

This task is a step in Roadmap for Creating a Delta Repository File Upgrade Kit.

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

To create a delta SRF file using the diffsrf utility

  1. Note the location and name of the complete SRF file that is currently in use in your Siebel Business Applications implementation.

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

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

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

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

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

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

-F function

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

  • diff. (Default) Creates the 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.
  • apply. Applies the changes that are recorded in the delta repository file delta to the existing repository file oldsrf. Normally, this operation is not required, because repository file changes are applied by using a delta repository file upgrade kit, rather than by using diffsrf.

-O oldsrf

The complete path and file name for an existing repository file.

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

-N newsrf

The complete path and file name for a repository file that contains changes.

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

-P delta

The complete path and file name for a delta repository file.

  • If you use the -F diff argument to create a delta repository file, then 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.
  • If you use the -F apply argument to apply changes in a delta repository file to an existing repository file, then delta is the name of the delta repository file containing the changes to apply.

-L language

The language code for oldsrf, newsrf and delta repository files, such as ENU for U.S. English, DEU for German, and JPN for Japanese.

Siebel Anywhere Administration Guide Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.