ls3sitercconsistgrp

Edit online

Use the ls3sitercconsistgrp command to list the detailed status of all 3-site remote copy consistency groups present in a 3-site configuration.

Syntax

Description

Based on the status of a 3-site remote copy consistency group, the administrator can take appropriate action, as necessary. If 3-Site Orchestrator is not able to connect to any of the sites, this command fails.

This table shows the potential output for this command.

Table 1. ls3sitercconsistgrp output
Attribute	Value
name	Specifies the name of a 3-site remote copy consistency group. The value is a string with a maximum length of 15 characters.
state	Specifies the state from the 3-site replication state machine. The possible values are: `partial` `stopped` `3site_consistent` `3site_inconsistent` `2site_periodic`
primary	Specifies the primary site for the 3-site remote copy consistency group. This value is the site alias or cluster name.
sync_copy_state	Specifies the state of the near site synchronous copy. The possible values are: `consistent_synchronized` `idling_disconnected` `idling` `consistent_copying` `consistent_stopped`
periodic_copy_state	Specifies the state of the remote site periodic copy. The possible values are: `copying` `copied` `stopped` `idling`
freeze_time	Specifies the last available snapshot at the auxiliary-far site. The value is a string in YY/MM/DD/HH/MM/SS format.
periodic_copy_source	Specifies the source site for periodic remote copy. The value is the site alias or cluster name.
cycle_period	Specifies the 3-site replication cycle period in seconds in the range 300 - 86400 (1 day).
status	Specifies the 3-site data cycling status for the 3-site consistency group.

The possible status values are:

online: 3-site data cycling is working in 3site_consistent mode.
sync_link_offline: The near site link is disconnected. The 3-site relationship is either in the stopped or 2site_periodic state. Fix the link to resume 3site_consistent mode. Alternately, switch to 2site_periodic mode by changing the periodic source site.
sync_link_stopped: The near site link is reconnected but it is in a stopped state. The 3-site relationship is either in a stopped or 2site_periodic state. Rejoin a non-primary near site to resume 3site_consistent mode.
active_link_offline: This value indicates that the active link is down and 3-site data cycling is in a stopped state. To resume 3site_consistent mode, fix the link manually or move the periodic source site to continue in degraded mode.
inactive_link_offline: This value indicates that an idle link is down. It does not impact the 3-site data cycling. You must manually fix the inactive link.
primary_offline: This value indicates that the primary site for this consistency group is down or is isolated from the partnership (there is no available network and the site is unable to be reached from the remaining two sites).
periodic_src_offline: This value indicates that the periodic site for this consistency group is down or is isolated from the partnership (there is no available network and the site is unable to be reached from the remaining two sites).
primary_and_periodic_src_offline: This value indicates that the primary and periodic source sites for this consistency group are down or isolated from the partnership. The 3-site consistency group is in the stopped state. Data cycling can be started again in 2site_periodic mode by changing the primary and periodic source sites.
partner_offline: This value indicates that the near partner site, which is neither a primary nor periodic source, is offline. Data cycling is in 2site_periodic mode. You must fix the near partner site.
auxfar_offline: This value indicates that the auxiliary-far site, which is neither a primary nor periodic source, is offline. Data cycling is stopped. You must fix the auxiliary-near site. Data cycling resumes automatically.
primary_storage_offline: The 3-site relationship is either in the stopped or 2site_periodic state. The primary site storage is offline. You must fix the storage problems to change to 3site_consistent mode or change the primary to 2site_periodic mode.
periodic_src_storage_offline: The 3-site relationship is either in the stopped or 2site_periodic state. The periodic site storage is offline. You must fix the storage problems to change to 3site_consistent mode or change the periodic source to 2site_periodic mode.
partner_storage_offline: This value indicates that at the near partner site, which is neither a primary nor a periodic source, storage is offline. Data cycling is in 2site_periodic mode. You must fix the master site.
auxfar_storage_offline: This value indicates that at the auxiliary-far site, which is neither a primary nor a periodic source, storage is offline. Data cycling is stopped. You must fix the auxiliary-near site. Data cycling resumes automatically.
site_unreachable: This value indicates one or more sites lost connection with 3-Site Orchestrator. You must fix the network connection. Data cycling resumes automatically.
maintenance_exclusion_mode: This value indicates that a site is excluded for maintenance and its state is 2site_periodic or stopped.
sync_link_not_synchronized: Indicates that data on the synchronous link is not in sync. This may happen if the application is writing data at a higher rate than the replication link between near sites.
hyperswap_and_auxfar_partnership_offline: Indicates that the partnership between the HyperSwap® system and the auxiliary-far system is offline.
hyperswap_cluster_offline: Indicates that the HyperSwap system is offline.
partner_dead_domain: Indicates that one of the near sites in the HyperSwap system has encountered a dead domain.
master_and_auxnear_storage_offline: Indicates that storage on the master site and auxiliary-near site is offline.

An invocation example that shows a 3-site consistency group's view of 3-site data cycling with master as primary, star topology at 5-minute cycle time.

ls3sitercconsistgrp

The resulting output:

name  state primary periodic_copy_source  sync_copy_state periodic_copy_state  freeze_time cycle_period   status 
cg0   3site_consistent  master   master consistent_synchronized copying 18/04/17/10/10/14  300

An invocation example where the user did not define site aliases. Cluster names are displayed. View of 3-site data cycling with master as primary, cascaded topology at 5-minute cycle time.

ls3sitercconsistgrp

The resulting output:

name  state  primary periodic_copy_source  sync_copy_state periodic_copy_state  freeze_time cycle_period   status 
cg0   3site_consistent  Master_cluster   Auxnear_cluster consistent_synchronized  copying 18/04/17/10/10/14  300

An invocation example that shows a 3-site consistency group does not exist in the configuration (no output is returned).

ls3sitercconsistgrp

The resulting output:

No output

An invocation example that shows the auxiliary-near site, which is a periodic source site, is down due to a disaster.

ls3sitercconsistgrp

The resulting output:

name  state    primary  periodic_copy_source  sync_copy_state periodic_copy_state  freeze_time cycle_period    status 
cg0   stopped  Master_cluster   Auxnear_cluster consistent_disconnected  stopped 18/04/17/10/10/14  300 periodic_src_offline

An invocation example that shows 3-Site Orchestrator lost IP connection to any site (for example, master). Even though the site is alive and partnerships are connected, the command fails.

ls3sitercconsistgrp

The resulting output:

CMMVC9507E SSH connection failed with site [Master_cluster_ip]