lssystem
Use the lssystem command to display a detailed view of a clustered system (system).
Syntax
>>- lssystem -- --+----------+-- --+-----------------------+--->< '- -nohdr -' '- -delim -- delimiter -'
Parameters
- -nohdr
- (Optional) By default, headings are displayed 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) 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 character with one byte. In a detailed view, the data is separated from its header by the specified delimiter.
Description
This command displays a detailed view of a system.
Table 1 provides the attribute values
that can be displayed as output view data.
Attribute | Possible Values |
---|---|
layer | The value can be either:
|
location | The location is local or remote. |
statistics status | The status is on or off. |
auth_service_type | |
auth_service_configured | True if the auth_service_type is configured and either these is true: |
auth_service_enabled | True if the auth_service_type is configured. |
email_state | The possible values are:
|
partnership | The possible values are:
|
tier | Indicates which system information
is being reported. The values are:
|
tier_capacity | Indicates the total MDisk storage in the tier. |
tier_free_capacity | Indicates the amount of MDisk storage in the tier that is unused. |
compression_active | Indicates whether there are any compressed volume copies in the system. |
compression_virtual_capacity | Indicates the total virtual capacity for all compressed volume copies in the system. This value is in unsigned decimal format. |
compression_compressed_capacity | Indicates the total used capacity for all compressed volume copies in the system. This value is in unsigned decimal format. |
compression_uncompressed_capacity | Indicates the total uncompressed used capacity for all compressed volume copies in the system. This value is in unsigned decimal format. |
rc_buffer_size | Indicates the resource buffer size that is assigned for Metro Mirror and Global Mirror Copy Services. |
has_nas_key | The value is yes or no. |
total_drive_raw_capacity | The total known capacity of all discovered drives (regardless of drive use) |
email_organization | Indicates the user's organization that is shown in the Call Home email function. |
email_machine_address | Indicates the user's mailing address that is shown in the Call Home email function. |
email_machine_city | Indicates the user's city that is shown in the Call Home email function. |
email_machine_state | Indicates the user's state that is shown in the Call Home email function. |
email_machine_zip | Indicates the user's zip code or postal code that is shown in the Call Home email function. |
email_machine_country | Indicates the user's country that is shown in the Call Home email function. |
cache_prefetch | Indicates whether cache prefetching is enabled across the system. The values are on and off. |
local_fc_port_mask | Indicates the Fibre Channel (FC) input/output (I/O) ports that a system can use for node-to-node communications on a local system if those FC I/O ports exist on a node. The value is 64 binary bits. |
partner_fc_port_mask | Indicates the FC I/O ports that a system can use for system-to-system communications on a partner system if those FC I/O ports exist on a node. The value is 64 binary bits. |
high_temp_mode | Indicates whether High Temperature Mode (HTM) is on. |
topology | Indicates the system topology:
|
topology_status | Indicates the system topology status:
|
rc_auth_status | Indicates remote copy authentication. Remote copy includes Metro Mirror and Global
Mirror. The
values are:
|
vdisk_protection_time | Indicates the volume protection time in minutes (whether volume protection is enabled or not enabled). The value must be a number from 15 (default) to 1440. |
vdisk_protection_enabled | Indicates whether volume protection is enabled (yes) or disabled (no) for a system. |
product_name | Indicates the product name (an alphanumeric string of no more than 62 characters). |
odx | Indicates whether offloaded data transfer (ODX) is enabled or disabled. The values are on and off. |
easy_tier_acceleration | Indicates Easy Tier® and pool balancing acceleration status. The values are on and off. |
max_replication_delay | Indicates the value for maximum replication delay. This is a numeric value from 0 to 360. |
partnership_exclusion_threshold | Indicates the partnership exclusion threshold value. This is a numeric value from 30 to 315. |
gen1_compatibility_mode | Indicates whether a system is compatible with a downlevel system (such as a Storwize® V7000 Gen1 ) system. The values are yes and no. |
Information about the remote system is reported by the lssystem command if you issue either the mkfcpartnership or mkippartnership command from the local system to the remote system. For example, if the partnership is at least partially established from the local system.
Issue the lssystem command to display a detailed view of the system.
Detailed
view shows the fields that are described for remote systems only;
if the system location is local,
then partnership and bandwidth do
not apply (and are not defined or provided). For a remote system,
these fields indicate the following information:
- location: remote
- partnership:
- 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 the chpartnership command with the start parameter 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. Either the remote system is offline, or it is 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 is excluding the connection to the remote system due to too many problems, or either system in 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 has been issued in both directions. The remote system is excluding the connection to the local system due to too many problems, or either system in 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. Refer to the 1710 or 1720 errors in the system error log at the local and remote system.
- bandwidth: The bandwidth available on the intersystem link for background copy, in megabytes per second (MBps).
The console_IP field displays either the:
- Automatically-populated system port 1 IP Address - Internet Protocol Version 4 (IPv4) or IPv6
- User-populated IPv4 address
A detailed invocation example
lssystem -delim :
The resulting output:
id:00000200A2600906
name:tbcluster-29
location:local
partnership
bandwidth
total_mdisk_capacity:60.5TB
space_in_mdisk_grps:60.5TB
space_allocated_to_vdisks:643.74GB
total_free_space:59.9TB
total_vdiskcopy_capacity:663.46GB
total_used_capacity:560.99GB
total_overallocation:1
total_vdisk_capacity:501.25GB
total_allocated_extent_capacity:792.50GB
statistics_status:on
statistics_frequency:15
cluster_locale:en_US
time_zone:375 Europe/London
code_level:6.4.0.0 (build 64.6.1205081000)
console_IP:9.71.53.69:443
id_alias:00000200A2600906
gm_link_tolerance:300
gm_inter_cluster_delay_simulation:0
gm_intra_cluster_delay_simulation:0
gm_max_host_delay:5
email_reply
email_contact
email_contact_primary
email_contact_alternate
email_contact_location
email_contact2
email_contact2_primary
email_contact2_alternate
email_state stopped
inventory_mail_interval:0
iscsi_auth_method:chap
iscsi_chap_secret:MYCLUSTERCHAP
auth_service_configured:no
auth_service_enabled:no
auth_service_url
auth_service_user_name
auth_service_pwd_set:no
auth_service_cert_set:no
auth_service_type:tip
relationship_bandwidth_limit:25
tier:ssd
tier_capacity:0.00MB
tier_free_capacity:0.00MB
tier:enterprise
tier_capacity:60.49TB
tier_free_capacity:59.72TB
has_nas_key:no
layer:replication
rc_auth_method:none
rc_buffer_size:48
compression_active:yes
compression_virtual_capacity:1000.00MB
compression_compressed_capacity:0.41MB
compression_uncompressed_capacity:512.05MB
cache_prefetch:on
email_organization:UEFA
email_machine_address:1 Chelsea Blvd
email_machine_city:Fulham
email_machine_state:XX
email_machine_zip:OU812
email_machine_country:GB
total_drive_raw_capacity:900.00GB
easy_tier_acceleration off
local_fc_port_mask:0000000000000000000000000000000000000000000000000000000000001101
partner_fc_port_mask:0000000000000000000000000000000000000000000000000000000000000011
high_temp_mode:on
topology:standard
topology_status:
compression_destage_mode:false
vdisk_protection_time:120
vdisk_protection_enabled no
product_name:Compumarge
odx:on
max_replication_delay:222
partnership_exclusion_threshold:120
A detailed invocation example
lssystem
The resulting output:
id 000002006C40A278
name cluster0
location local
partnership
bandwidth
total_mdisk_capacity 222.2GB
space_in_mdisk_grps 0
space_allocated_to_vdisks 0.00MB
total_free_space 222.2GB
total_vdiskcopy_capacity 0.00MB
total_used_capacity 0.00MB
total_overallocation 0
total_vdisk_capacity 0.00MB
total_allocated_extent_capacity 0.00MB
statistics_status on
statistics_frequency 15
cluster_locale en_US
time_zone 522 UTC
code_level 6.4.0.0 (build 61.9.1112130001)
console_IP 0.0.0.0:443
id_alias 000002006C40A278
gm_link_tolerance 300
gm_inter_cluster_delay_simulation 0
gm_intra_cluster_delay_simulation 0
gm_max_host_delay 5
email_reply
email_contact
email_contact_primary
email_contact_alternate
email_contact_location
email_contact2
email_contact2_primary
email_contact2_alternate
email_state stopped
inventory_mail_interval 0
cluster_ntp_IP_address
cluster_isns_IP_address
iscsi_auth_method none
iscsi_chap_secret
auth_service_configured no
auth_service_enabled no
auth_service_url
auth_service_user_name
auth_service_pwd_set no
auth_service_cert_set no
auth_service_type tip
relationship_bandwidth_limit 25
tier ssd
tier_capacity 0.00MB
tier_free_capacity 0.00MB
tier enterprise
tier_capacity 111.10GB
tier_free_capacity 111.10GB
tier nearline
tier_capacity 111.10GB
tier_free_capacity 111.10GB
has_nas_key no
layer replication
rc_buffer_size 48
compression_active no
compression_virtual_capacity 0.00MB
compression_compressed_capacity 0.00MB
compression_uncompressed_capacity 0.00MB
cache_prefetch on
email_organization
email_machine_address
email_machine_city
email_machine_state XX
email_machine_zip
email_machine_country
total_drive_raw_capacity 173.63TB
easy_tier_acceleration off
local_fc_port_mask:0000000000000000000000000000000000000000000000000000000000001101
partner_fc_port_mask:0000000000000000000000000000000000000000000000000000000000000011
high_temp_mode:on
topology:standard
topology_status:
compression_destage_mode false
vdisk_protection_time 120
vdisk_protection_enabled yes
product_name Compuhomer
odx on
max_replication_delay 333
partnership_exclusion_threshold 120