|
Siebel System Administration Guide > Migrating Parameters Between Environments >
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. See also About Migrating Parameters Between Environments and About the cfgmerge Utility. 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 30. 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 30. Siebel cfgmerge Utility Flags
|
|
|
-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.
|
|
