chsetting

Changes synchronization management settings

Applicability


Product	Command type
MultiSite	multitool subcommand


Platform
UNIX
Linux
Windows

Synopsis

Change the value of site-level synchronization settings:

chsetting –site [ –rgy rgy-hostname –password rgy-passwd ] setting-name = [ value ]

Description

The chsetting command is used to change the values of synchronization management settings, and has three forms: one form to change the settings at the site level, one to change them at the host level, and one to change them at the replica level.

Restrictions

Identities:

With –site, you must have permission to modify the ClearCase® registry and enter the ClearCase registry password.
With –replica, you must have Change or Full permissions on the MultiSite Administration ACL of the host whose settings you want to change.

Options and arguments

Specifying the setting level

Default: None.
–site [ –rgy rgy-hostname –password rgy-passwd ]: Changes a synchronization management setting at the site level. The value of a site level setting applies to all replicas and hosts at the local site. With –rgy, the new site level setting will apply to all replicas and hosts at the site specified by rgy-hostname. If the specified setting is also defined at the host or replica level, the site-level setting is overridden by these settings for the host or replica in context.

Specifying the change

Default

None. You must specify one or more setting-name/value pairs, or specify a setting without a value to reset it to the default.

setting-name= [value ] ...

One or more arguments, where

setting-name: The name of the setting you want to change.
value: The new value for the specified setting. Specifying a setting-name without a value changes the setting back to its default value.

setting-name can be any of the following:

ms_site_name

Name of the site.

This setting is valid only at the site level. For example, you can only modify this setting with the –site form of the command.

ms_sync_status_summary_host

Name of the host that stores synchronization health status information for the site. The host that runs the first job to generate synchronization health status for the site becomes the synchronization health status summary host.