Siebel Database Upgrade Guide > Performing the Siebel Repository Merge >

Running the Siebel Repository Preparation Wizard


Upgrades from: Siebel 6.x.

Environments: Development environment only.

This topic is part of an upgrade process. See How to Perform a Siebel Database Upgrade.

When upgrading to Siebel 7.7.x, you must run the Repository Preparation Wizard on the Prior Customer Repository. You must do this before running the repository merge.

The Repository Preparation Wizard does the following:

  • Migrates strings. Siebel 7.x supports locale strings in object-specific tables. The utility moves the S_MSG data to the new locale table structure in Siebel 7.x.
  • Merges labels and fields. Siebel 7.x merges labels with controls so that the label is a caption property of the control.
  • Merges Web templates. Siebel 7.x merges Web templates in Siebel Tools to only use Base and Edit/Query/New for the majority of the preconfigured applets. Previous Siebel releases used four separate templates to deliver the same functionality.

To run the Repository Preparation Wizard

  1. In Siebel Tools, navigate to the Tools menu, and then choose Tools > Upgrade > Prepare Repository.
  2. Choose Prior Customer Repository.

    The String Migration window appears.

  3. In the String Migration window:
    1. Select the languages for which you want to migrate strings.
    2. Click in the check box beside Log migrated strings, then click Browse to specify the log file.

      If you have a single-language implementation and your base language is not English (ENU), you need to perform extra steps to upgrade labels of custom applets. See Oracle's Siebel SupportWeb Alert 426.

      To continue, click Next. The Merge Labels and Fields window appears.

  4. In the Merge Labels and Fields window:
    1. Specify the input file by clicking Browse.

      The utility operates on every form applet except those specified in the input file. The default input file is applets.txt. Modify the input file only if you have additional applets that should not be merged.

      If you are upgrading to Siebel Financial Services 7.x, do not use the default input file, applets.txt. Instead, browse to the Tools bin directory and select the input file named fins_applets.txt.

    2. Click Next. The Merge Applet Web Templates window appears.
  5. In the Merge Applet Web Templates window, click Browse to specify the same input file that you used in Step 4, then click Next.

    The wizard prepares your Prior Customer Repository for the merge.

  6. Verify that the wizard completed successfully:
    1. In the Siebel Tools Object Explorer, click Repository.
    2. In the Prior Customer Repository record, locate the Comments field.
    3. Verify the field contains the following string: StMgLFmgTMrg.

      If the string is present, the wizard completed successfully. If the string, or any part of it, is not present, the wizard did not complete successfully. Review the log files to locate the errors and contact Oracle's Siebel Technical Support.

  7. Review the log files. They are located in the following directory:

    Tools_install_dir\temp

    Where

    Tools_install_dir is the directory where Siebel Tools is installed.

    The following table describes the log files.

File Name
Description

labelmerge.txt

Generated by label and field merge. Lists all applets that were modified. For each applet modified, displays whether the label and field merge was successful. If a control already had a caption, the old caption is listed for that control.

templatemerge.txt

Generated by the template merge. Lists all applets that were modified and displays whether the merge was successful. For each applet, displays the following:

  • The template used as the source (other templates are merged into this template).
  • Applet Web Templates that were inactivated.
  • Controls whose types were changed to ensure that they only appear in the correct modes.

The following errors in the templatemerge.txt file are acceptable if they are against standard applets. This is because there were no Edit or New applet Web templates for standard applets in the previous Siebel release:

  • Upgrading APPLET_NAME.
  • Using Edit as source template.
  • Could not find source template.

Siebel Database Upgrade Guide