Sun Cluster System Administration Guide for Solaris OS

How to Disable a Cluster Transport Cable

You can also accomplish this procedure by using the SunPlex Manager GUI. See the SunPlex Manager online help for more information.

You might need to disable a cluster transport cable to temporarily shut down a cluster interconnect path. This is useful when troubleshooting a cluster interconnect problem or when replacing cluster interconnect hardware.

When a cable is disabled, the two endpoints of the cable remain configured. An adapter cannot be removed if it is still in use as an endpoint in a transport cable.

Caution – Caution –

Each cluster node needs at least one functioning transport path to every other node in the cluster. No two nodes should be isolated from one another. Always verify the status of a node's cluster interconnect before disabling a cable. Only disable a cable connection after you have verified that it is redundant; that is, that another connection is available. Disabling a node's last remaining working cable takes the node out of cluster membership.

  1. Become superuser on any node in the cluster.

  2. Check the status of the cluster interconnect before disabling a cable.

    # scstat -W

    Caution – Caution –

    If you receive an error such as “path faulted” while attempting to remove one node of a two-node cluster, investigate the problem before continuing with this procedure. Such a problem could indicate that a node path is unavailable. Removing the remaining good path takes the node out of cluster membership and could result in a cluster reconfiguration.

  3. Enter the scsetup(1M) utility.

    # scsetup

    The Main Menu is displayed.

  4. Access the Cluster Interconnect Menu by typing 3 (Cluster interconnect).

  5. Disable the cable by typing 8 (Disable a transport cable).

    Follow the instructions and enter the requested information. All of the components on this cluster interconnect will be disabled. You need to enter both the node and the adapter names of one of the endpoints of the cable you are trying to identify.

  6. Verify that the cable is disabled.

    # scconf -p | grep cable

Example—Disabling a Cluster Transport Cable

This example shows how to disable a cluster transport cable on adapter qfe-1 located on the node phys-schost-2.

[Become superuser on any node.]
[Enter the scsetup utility:]
# scsetup
Select Cluster interconnect>Disable a transport cable.
Answer the questions when prompted.
You will need the following information.
   You Will Need:         Example:
   node names             phys-schost-2
   adapter names          qfe1
   junction names         hub1
[Verify that the scconf command completed successfully:]
scconf -c -m endpoint=phys-schost-2:qfe1,state=disabled
Command completed successfully.
Quit the scsetup Cluster Interconnect Menu and Main Menu.
[Verify that the cable is disabled:]
# scconf -p | grep cable
  Transport cable:   phys-schost-2:qfe1@0 ethernet-1@2    Disabled
  Transport cable:   phys-schost-3:qfe0@1 ethernet-1@3    Enabled
  Transport cable:   phys-schost-1:qfe0@0 ethernet-1@1    Enabled