Going Live with Siebel Business Applications > Migrating Parameters Between Environments >

Running Environment Comparison

This task uses the cfgmerge command-line utility to run a comparison between two applications and creates a parameter migration script, which documents the parameter differences between the two applications. In all cases, run the cfgmerge utility in the target environment, which must be version 7.8 or later.

Running an application comparison is a task in the Process for Migrating Parameters Between Environments.

For background information on the parameter migration process, see About Migrating Parameters Between Environments. For background information on the cfgmerge utility, see About Cfgmerge Utility.

To run the environment comparison

1. Before running the cfgmerge utility, make sure all component groups of interest are enabled on both the source and target application.

   For example, if you want to migrate component parameters for a server component in the Siebel Remote component group (alias Remote), make sure this component group is enabled on both the source and target environment.

2. Make a backup copy of the target application's siebns.dat file. For information on this GUI or command-line interface procedure, see Siebel System Administration Guide. Rename the backup copy to a unique value, for example, target_siebns.dat.

   The siebns.dat file is available in the Administration folder of the Siebel Gateway Name Server root directory.

3. Make a backup copy of the source application's siebns.dat file. Rename the backup copy to a unique value, for example, source_siebns.dat.
4. Move the source_siebns.dat file and the target_siebns.dat file copies to the bin subdirectory of the Siebel Server root directory, which contains the cfgmerge utility.

   NOTE:  The cfgmerge utility does not require the Siebel application to be up or down when running.

5. Run the cfgmerge utility using the following commands to execute the application comparison. The cfgmerge utility can run a comparison in Enterprise mode or Siebel Server mode:
   • Running Enterprise-mode comparison:

   cfgmerge -l language_code -i source_siebns.dat,target_siebns.dat -e source_enterprise_name,target_enterprise_name -o output_file.cmd

   • Running Siebel Server-mode comparison:

   cfgmerge -l language_code -i source_siebns.dat,target_siebns.dat -e source_enterprise_name,target_enterprise_name -s source_server_name,target_server_name -o output_file.cmd

   NOTE:  Do not include a space between the target and source parameter pairs.

   For details on the cfgmerge utility's flags and arguments, see Table 6

A successful execution results in the creation of a parameter migration script, which is saved by specifying an output file during command execution. Review this file to note the difference between applications. For further information on this task, see Reviewing and Editing a Parameter Migration Script.