Debugging iSCSI backend sessions

Complete the steps in the following procedures to debug iSCSI backend sessions.

MDisks are in a degraded/offline state

  1. Run the command lseventlog to check the system event log. If the issue is resolved by following the directed maintenance procedures (DMPs), then no further action is required. If the issue is not resolved, complete the following steps to debug iSCSI sessions.
  2. Run the command lsmdiskmdisk_id | mdisk_name for the MDisk that is in degraded/offline state. In the detailed view, note the values for the fields preferred_iscsi_port_id and active_iscsi_port_id.
  3. Issue the svcinfo lsiscsistorageport command, map the values from step 2, and verify the status field.
  4. If the status is not full, then obtain a detailed view for that particular session by using the command svcinfo lsiscsistorageportsessions_row_id.
  5. In the detailed view of lsiscsistorageport from step 4, check the values of the field connected. It indicates which nodes, which src_ip, is having an issue. The src_port_id and node_id attributes are also available in the detailed view.
  6. Using the command svcinfo lsportip, check the link status for the src_port_id, node_id, and src_port_ip tuple.
  7. If link status is not active, check the physical connection of the cable/small form-factor pluggable (SFP) transceiver.
  8. Check the port status of the particular port on the switch.

Controllers are in a degraded/offline state

  1. Run the command lseventlog to check the system event log. If the issue is resolved by following the directed maintenance procedures (DMPs), then no further action is required. If the issue is not resolved, complete the following steps to debug iSCSI sessions.
  2. Run the command lscontrollercontroller_id | controller_name for the MDisk that is in degraded/offline state. In the detailed view, note the values for the field iscsi_port_id.
  3. Issue the command svcinfo lsiscsistorageport, map the values from step 2, and verify the status field.
  4. If the status is not full, then obtain a detailed view for that particular session by using the command svcinfo lsiscsistorageportsessions_row_id.
  5. In the detailed view of lsiscsistorageport from step 4, check the values of the field connected. It indicates which nodes, which src_ip, is having an issue. The src_port_id and node_id attributes are also available in the detailed view.
  6. Using the command svcinfo lsportip, check the link status for the src_port_id, node_id, and src_port_ip tuple.
  7. If link status is not active, check the physical connection of the cable/small form-factor pluggable (SFP) transceiver.
  8. Check the port status of the particular port on the switch.
Parent topic: Troubleshooting