UPDATE REPLRULE (Update replication rules)

Use this command to enable or disable a replication rule.

Issue this command on the server that acts as a source for replicated data.

Tip: Do not confuse replication rules with replication storage rules. Replication rules are associated with the traditional method of node replication. You define a replication rule on the command line by using the REPLICATE NODE command. Replication storage rules are associated with a newer replication method that is more flexible and granular. You define replication storage rules by using the DEFINE STGRULE command. The UPDATE REPLRULE command applies to traditional replication rules.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagramUPDate REPLRulerule_nameSTate=ENabledDISabled

Parameters

rule_name (Required)

Specifies one or more replication rules to be updated. You can specify a priority type for a specific type of data. You can use wildcard characters to specify one or more rules. You can specify one of the following rules:

  • ALL_DATA
  • ACTIVE_DATA
  • ALL_DATA_HIGH_PRIORITY
  • ACTIVE_DATA_HIGH_PRIORITY
STate (Required)
Specifies whether replication is allowed for the rule. You can specify one of the following values:
ENabled
Specifies that the data to which the rule applies is ready to be replicated.
DISabled
Specifies that replication does not occur until you enable it.

Example: Disable replication for backup data

Disable replication of normal-priority, active-backup data for all file spaces in all client nodes that are configured for replication: 
update replrule active_data state=disabled

Related commands

Table 1. Commands related to UPDATE REPLRULE
Command Description
QUERY FILESPACE Displays information about data in file spaces that belong to a client.
QUERY NODE Displays partial or complete information about one or more clients.
QUERY REPLICATION Displays information about node replication processes.
QUERY REPLRULE Displays information about node replication rules.
SET ARREPLRULEDEFAULT Specifies the server node-replication rule for archive data.
SET BKREPLRULEDEFAULT Specifies the server node-replication rule for backup data.
SET SPREPLRULEDEFAULT Specifies the server node-replication rule for space-managed data.
UPDATE FILESPACE Changes file-space node-replication rules.
UPDATE NODE Changes the attributes that are associated with a client node.
VALIDATE REPLICATION Verifies replication for file spaces and data types.