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 VersionVault registry and enter the VersionVault 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.
This setting is valid only at the site level. For example, you can only modify this setting with the –site form of the command.

Examples

  • At the San Francisco site, set the site-level value of ms_vob_max_parallel_host_imports to 3.


    multitool chsetting -site ms_vob_max_parallel_host_imports=3


    <no output means command succeeded>