Running an Environment Comparison

This task uses the cfgmerge command-line utility to run a comparison between two environments and creates a parameter migration script, which documents the parameter differences between the two environments. In all cases, run the cfgmerge utility in the target environment.

This task is a step in "Process of Migrating Parameters Between Environments".

To run the environment comparison

Before running the cfgmerge utility, make sure that all of the component groups of interest are enabled on both the source and target environment, in cases where you have a source environment.

For example, if you want to migrate component parameters for a server component in the Siebel Remote component group (alias Remote), then make sure that this component group is enabled on both the source and target environment.
Make a backup copy of the target environment's siebns.dat file. For information about this GUI or command-line interface procedure, see "Backing Up the Siebel Gateway Name Server Data". Rename the backup copy to a unique value, for example, target_siebns.dat.

The siebns.dat file is available in the admin subdirectory of the Siebel Gateway Name Server root directory.
Make a backup copy of the source environment's siebns.dat file. Rename the backup copy to a unique value, for example, source_siebns.dat.
Move the source_siebns.dat file and the target_siebns.dat file copies to the bin subdirectory of the Siebel Server root directory (in the target environment), which contains the cfgmerge utility.
Run the cfgmerge utility using the following commands to execute the environment 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 comma-separated target and source parameter pairs.

For information about the cfgmerge utility's flags and arguments, see Table 11-1. 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, and note the difference between environments. For information about this task, see "Reviewing and Editing a Parameter Migration Script".

Table 11-1 Siebel cfgmerge Utility Flags

Flag	Arguments	Description
`-e`	`source_enterprise_name`, `target_enterprise_name`	Use this flag and two arguments to specify the source and target Siebel Enterprise Server names used for the environment comparison. Note: Make sure to include the comma after the first argument, but do not insert a space after the comma.
`-i`	`source_siebns.dat`, `target_siebns.dat`	Use this flag and two arguments to specify the source and target siebns.dat files. The siebns.dat file, stored on the Siebel Gateway Name Server, defines the configurations of an individual environment. Note: Make sure to include the comma after the first argument, but do not insert a space after the comma.
-l	`language_code`	Use this flag to set the language in the script file. The default language code is ENU. Make sure that the appropriate language is installed before using this flag.
`-o`	`output_file.cmd`	Use this flag to specify a file name and path for the migration script, which is created as a result of execution of the `cfgmerge` utility. This script documents the environment differences.
`-s`	`source_server_name`, `target_server_name`	Use this flag and two arguments to specify the source and target Siebel Server names used for the environment comparison. Note: Make sure to include the comma after the first argument, but do not insert a space after the comma.