Siebel System Administration Guide > Migrating Parameters Between Environments >

About Migrating Parameters Between Environments

Migrating Siebel Enterprise or Siebel Server configuration parameter values from one Siebel Business Applications environment to another is a necessary part of migrating to a new development, test, or production environment. The configuration upgrade utility, cfgmerge, facilitates the automatic migration of these parameters between environments.

When it is undertaken manually, the parameter migration process can incur data entry errors and extend downtime of the target Siebel Business Applications environment. The cfgmerge utility allows for the automation of the parameter migration process.

The cfgmerge utility compares the source environment with the target environment and creates a parameter migration script, which includes documentation on the parameter differences between the two environments. The migration script documents the differences between environments, including noting parameters that cannot be updated automatically and identifying obsolete or modified parameters in the new environment.

After a review, the migration script can then be applied on the target environment to update the parameters. Use the automated migration process to:

• Update environments of the same software version, for example, updating a test environment from the development environment.
• Update environments with different major release software versions.

NOTE:  Running cfgmerge requires a source siebns.dat file. A complete source environment is not required for this operation. For example, in some upgrade cases you might not have a source environment at the time that you run cfgmerge. While you have the source environment, you might have to preserve its siebns.dat file in order to be able to run cfgmerge later.

Migrating parameters between environments can be run in either of the following modes:

• Enterprise mode. This mode migrates enterprise parameters, component definition parameters, and named subsystem parameters between environments.
• Siebel Server mode. This mode migrates Siebel Server parameters and Siebel Server component parameters between Siebel Server environments. Siebel Server mode does not include parameters whose values are inherited from the Siebel Enterprise level.

For procedures on migrating parameters between environments, see Process of Migrating Parameters Between Environments.

The cfgmerge utility runs on both Microsoft Windows and UNIX. For more information about this utility, see About the cfgmerge Utility.

NOTE:  The cfgmerge utility migrates only parameter values between environments. Other environment configurations, such as custom components, are not migrated to the target environment. For example, if you have a custom component in the source environment, then you have to create a component definition of the same type, with the same name, in the target environment to migrate the parameter settings for that component. For information about creating component definitions, see Creating a Custom Siebel Server Component Definition.