How to Disable a Cluster Transport Cable

Language:

You might need to disable a cluster transport cable to temporarily shut down a cluster interconnect path. A temporary shutdown 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 - 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, ensure that another connection is available. Disabling a node's last remaining working cable takes the node out of cluster membership.

The phys-schost# prompt reflects a global-cluster prompt. Perform this procedure on a global cluster.

This procedure provides the long forms of the Oracle Solaris Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical.

You can also use the Oracle Solaris Cluster Manager GUI to disable a cable. For GUI log-in instructions, see How to Access Oracle Solaris Cluster Manager.

Assume the root role on any node in the cluster.

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

# clinterconnect status

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 operational path takes the node out of cluster membership and could result in a cluster reconfiguration.

Start the clsetup utility.
```
# clsetup
```
The Main Menu is displayed.

Type the number for the option for accessing the Cluster Interconnect Menu and press the Return key.

Type the number for the option for disabling the transport cable and press the Return key.
Follow the instructions and provide the requested information. All of the components on this cluster interconnect will be disabled. You need to provide both the node and the adapter names of one of the endpoints of the cable that you are trying to identify.

Verify that the cable is disabled.

# clinterconnect show  node:adapter,adapternode

Example 7-5 Disabling a Cluster Transport Cable

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

[Assume the root role on any node.]
[Start the clsetup utility:]
# clsetup
[Select Cluster interconnect>Disable a transport cable.]

[Answer the questions when prompted.]
[You will need the following information.]
  [ You Will Need:]
Information:               Example:
   node names             phys-schost-2
   adapter names          net0
   switch names           hub1
[Verify that the clinterconnect
command was completed successfully:]
 Command completed successfully.
[Quit the clsetup Cluster Interconnect Menu and Main Menu.]
[Verify that the cable is disabled:]
# clinterconnect show  -p phys-schost-1:net5,hub2
Transport cable:   phys-schost-2:net0@0 ethernet-1@2    Disabled
Transport cable:   phys-schost-3:net5@1 ethernet-1@3    Enabled
Transport cable:   phys-schost-1:net5@0 ethernet-1@1    Enabled