Sun Cluster System Administration Guide for Solaris OS

ProcedureHow to Disable a Cluster Transport Cable

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

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 – 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 Sun Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix B, Sun Cluster Object-Oriented Commands.

  1. Become superuser on any node in the cluster.

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


    # clinterconnect status
    

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


  3. Start the clsetup utility.


    # clsetup
    

    The Main Menu is displayed.

  4. Type the number that corresponds to the option for accessing the Cluster Interconnect Menu and press the Return key.

  5. Type the number that corresponds to 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.

  6. 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 qfe-1, located on the node phys-schost-2.


[Become superuser 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          qfe1
   switch names           hub1
[Verify that the clinterconnect
 command was completed successfully:]
 Command completed successfully.
[Quit the scsetup Cluster Interconnect Menu and Main Menu.]
[Verify that the cable is disabled:]
# clinterconnect show  -p phys-schost-1:qfe2,hub2
  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