ConfigShardedCluster
Synopsis
[Actions]
ConfigShardedCluster:ClusterURL=ClusterURL,Role=Role,Member=Member,MasterRegexp=MasterRegexp,Regexp=Regexp,Map=Map,ArbiterURL=ArbiterURL,SSLDir=SSLDir
Specifies the location of node1; this field should be populated for all values of Role other than node1.
Substitute ClusterURL with the cluster’s URL in the format IRIS://host:port/namespace, host:port is the hostname and port of the initial node, namespace is the cluster namespace.
Substitute Role with node1, data, compute, or auto.
Substitute Member with primary, backup, drasync, rorasync, rwrasync, or auto.
Used when Role is set to auto.
Default:"-0$"
MasterRegexp identifies the instance to be configured as data node 1 if the name of the instance’s host matches the regular expression that is substituted for MasterRegexp.
The default assumes that the hostname for the node1 node ends in "-0".
Required for using Role and Member in automatic mode.
Default:"-[0-9]+$"
Regexp validates that the name of the instance’s host matches the regular expression that is substituted for Regexp.
The default value assumes a naming scheme such as iris-data-0, iris-data-1...iris-data-N.
Optional
Default:"primary,backup"
Map is used to specify a mirror map. It requires nodes be named in a manner consistent with Regexp, are ascending, and contiguous.
Substitute Map with a comma-separated list of values to assign members of a mirror set; allowed values are primary, backup, and drasync.
Optional
ArbiterURL is used to specify an Arbiter.
Substitute ArbiterURL with the Host (hostname or IP address) and port of the arbiter with the following format, host:port.
Optional
SSLDir is used to specify the path to the directory containing the Certificate Authority certificate (CAFile.pem), Server Certificate file (CertificateFile.pem), and Server Key file (PrivateKeyFile.pem).
Substitute SSLDir with the desired directory path.
Description
ConfigShardedCluster specifies changes to make to a sharded cluster. InterSystems IRIS® modifies the sharded cluster when processing the [Actions] section during a configuration merge. During the merge, InterSystems IRIS runs a sequence of API calls to modify the sharded cluster defined by ConfigShardedCluster.
Changing this Operation
This operation is designed to be used during a configuration merge. You can change ConfigShardedCluster by editing the merge file in a text editor (as described in Editing the Active CPF).
See Sharding for more information on sharding configurations.