lspartnership

Use the lspartnership command to display a concise or detailed view of the current clustered systems (systems) that are associated with the local system.

Syntax

lspartnership [ -filtervalueattribute=value ] [ -delimdelimiter ] [ -nohdr ] [ -filtervalue? ] [ { system_id | system_name } ]

Parameters

-filtervalueattribute=value
(Optional) Specifies a list of one or more filters. Only objects with a value that matches the filter attribute value are displayed. If a capacity is specified, the units must also be included.
  • Some filters allow the asterisk character (*) when you enter the command. The following rules apply to the use of wildcard characters with the SAN Volume Controller command-line interface (CLI):
    • The wildcard character is an asterisk (*).
    • The command can contain a maximum of one wildcard.
    • When you use a wildcard, you must enclose the filter entry within double quotation marks (""):
      lspartnership -filtervalue "name=md*"
-nohdr
(Optional) By default, headings are displayed for each column of data in a concise style view, and for each item of data in a detailed style view. The -nohdr parameter suppresses the display of these headings.
Note: If there is no data to be displayed, headings are not displayed.
-delim delimiter
(Optional) By default in a concise view, all columns of data are space-separated. The width of each column is set to the maximum width of each item of data. In a detailed view, each item of data has its own row, and if the headers are displayed, the data is separated from the header by a space. The -delim parameter overrides this behavior. Valid input for the -delim parameter is a 1-byte character. If you enter -delim : on the command line, the colon character (:) separates all items of data in a concise view; for example, the spacing of columns does not occur. In a detailed view, the data is separated from its header by the specified delimiter.
-filtervalue?
(Optional) displays a list of filters that can be applied against this view. The following filter attributes are valid:
  • id
  • name
system_id | system_name
(Optional) Specifies the name or ID of a system. Using this parameter displays the detailed view of the specific partner system, and any value that is specified by the -filtervalue (which filters a view that is based on specific attribute values that relate to each object type) parameter is ignored. When you specify system_id or system_name parameter, the concise view of all systems that match the filtering requirements that are specified by the -filtervalue parameter are displayed.

Description

This table described attribute values.

Table 1. lspartnership attribute values
Attribute Value
id Indicates the system ID.
name Indicates the system name.
location Indicates the system location.
code_level Indicates the code level.
partnership Indicates the current state of the partnership; not applicable for the local system and is blank.

The partnership field can show the following values:

fully_configured
The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available.
partially_configured_local
The mkfcpartnership or mkippartnership command is issued from the local system to the remote system. The remote system is online and available for partnership.
partially_configured_local_stopped
The mkfcpartnership or mkippartnership command is issued from the local system to the remote system. The chpartnership command with the stop parameter is issued from the local system, and the remote system is online and available. Issue chpartnership -start on the local system, and mkfcpartnership or mkippartnership on the remote system
not_present
The mkfcpartnership or mkippartnership command is issued from the local system to the remote system, and the remote system is not available. The remote system is either offline or not connected to the local system.
fully_configured_stopped
The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available. The chpartnership command with the stop parameter is issued from the local system.
fully_configured_remote_stopped
The mkfcpartnership or mkippartnership command is issued in both directions and the remote system is online and available. The chpartnership command with the stop parameter is issued from the remote system.
fully_configured_local_excluded
The mkfcpartnership or mkippartnership command is issued in both directions. The local system excludes the connection to the remote system and the partnership is unable to sustain the I/O workload for the Metro Mirror or Global Mirror relationships.
fully_configured_remote_excluded
The mkfcpartnership or mkippartnership command is issued in both directions. The local system excludes the connection to the remote system and the partnership is unable to sustain the I/O workload for the Metro Mirror or Global Mirror relationships.
fully_configured_exceeded
There are too many systems in the system network and the partnership from the local system to the remote is disabled.
relationship_bandwidth_limit Indicates the current relationship bandwidth limit setting. The relationship bandwidth limit controls the maximum rate at which any one remote-copy relationship can synchronize. The default value for the relationship bandwidth limit is 25 megabytes per second (MBps).
type Indicates the type of partnership:
  • Fibre Channel (FC)
  • Internet Protocol Version 4 (IPv4) or Internet Protocol Version 6 (IPv6)
FC partnerships are created connecting two systems over FC or Fibre Channel over Ethernet (FCoE) fabrics. IPv4 or IPv6 partnerships are created connecting two systems over native IP links.
cluster_ip Indicates the partner system IP address, which can be IPv4 or IPv6. This information is displayed for IP-based partnerships. For IP-based partnership this field displays the system IP address that is specified while the partnership using mkippartnership is created.
chap_secret Indicates the Challenge-Handshake Access Protocol (CHAP) secret (up to 80 alphanumeric characters) for the partner system. The CHAP authenticates the local system with the partner system during discovery, and Internet Small Computer System Interface (iSCSI) system session creation. For FC-based and FCoE-based relationships this field is always blank.
link_bandwidth_mbits Indicates the aggregate bandwidth for the Remote Copy (RC) link in megabits per second (Mbps). This is a numeric value from 0 to 100000. If there are multiple links between the local and remote systems, this parameter is set to the sum of the link bandwidths for these links.
background_copy_rate Indicates the bandwidth allocation for background copy operations that are performed over the replication link. It is expressed as a percentage of the link bandwidth value, and is the maximum rate at which background copy operations are performed. This value is a number from 0 to 100 .
event_log_sequence Indicates the last sequence number (indicating the last event) from event log for this partnership. This is a numeric value in the range 100 - 8000000. For FC-based and FCoE-based relationships this field is always blank.
max_replication_delay Indicates the value for maximum replication delay. This value is a number in the range 100 - 360.
compressed Indicates whether compression is enabled. The values is yes or no (default).

A concise invocation example

lspartnership

The concise resulting output:

id                name      location  partnership                type  cluster_ip                  event_log_sequence
000002006BC0A0D4  system-1  local
000002006200A0E5  system-2  remote    partially_configured_local ipv6  fe80::200:f8ff:fe21:67cf
000002006200A0F6  system-3  remote    partially_configured_local fc                                
000002006200A0G7  system-4  remote    partially_configured_local fc                                

A detailed invocation example

lspartnership cluster-2

The detailed resulting output:

id 000002006200A0EA
name system-2
location remote
partnership partially_configured_local
code_level 6.3.0.0 (build 35.7.1105071000)
console_IP 9.180.28.63:443
gm_link_tolerance 300
gm_inter_system_delay_simulation 0
gm_intra_system_delay_simulation 0
relationship_bandwidth_limit 25
gm_max_host_delay 5
type fc
cluster_ip
chap_secret
event_log_sequence
link_bandwidth_mbits 1024
background_copy_rate 25
max_replication_delay 145compressed yes