Sun Cluster 3.0 System Administration Guide

5.1.3 How to Remove Cluster Transport Cables and Transport Adapters

Use the following procedure to remove cluster transport cables and cluster transport adapters from a node. 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 -

A cluster node needs at least one functioning cable attached to the cluster interconnect to be a member of the cluster. 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 remaining cluster transport path.


    # 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. Execute the scsetup utility.


    # scsetup
    

    The Main Menu appears.

  4. Access the Cluster Interconnect Menu by entering 2 (Cluster interconnect).

  5. Remove the cable by entering 4 (Remove a transport cable).

    Follow the instructions and enter the requested information. You need to enter both the node and the adapter names of one of the endpoints of the cable you are trying to identify.


    *** Cluster Interconnect Menu ***
        Please select from one of the following options:
        ...
        4) Remove a transport cable
        ...
        Option: 4
        ...
    >>> Remove a Cluster Transport Cable <<<
        ...
        Is it okay to continue (yes/no) [yes]? <Return>
        ...
        To which node is the cable attached? nodename
        Name of the adapter on "node"? adaptername
        Is it okay to proceed with the update (yes/no) [yes]? <Return>
        ...
        Command completed successfully.    Hit ENTER to continue: <Return>
    

    Note -

    If you are removing a physical cable, disconnect the cable between the port and the destination device.


  6. To remove an adapter, enter 5 (Remove a transport adapter from a node).

    Follow the instructions and enter the requested information. You need to enter both the node and the adapter names of one of the endpoints of the cable you are trying to identify.


    *** Cluster Interconnect Menu **    Please select from one of the following options:
        ...
        5) Remove a transport adapter
        ...
        Option: 5
        ...
    >>> Remove a Cluster Transport Adapter <<<
        ...
        Is it okay to continue (yes/no) [yes]? <Return>
        ...
        To which node is the cable attached? nodename
        Name of the adapter on "node"? adaptername
        Is it okay to proceed with the update (yes/no) [yes]? <Return>
        ...
        Command completed successfully.    Hit ENTER to continue: <Return>
    

    Note -

    If you are removing a physical adapter from a node, see the Sun Cluster 3.0 Hardware Guide for hardware service procedures.


  7. Verify that the cable or the adapter has been removed.


    # scconf -p | grep cable
    # scconf -p | grep adapter
    

    The transport cable or adapter removed from the given node should not appear in the output from this command.

5.1.3.1 Example--Removing a Transport Cable or Transport Adapter

The following example shows how to remove a transport cable or transport adapter using the scsetup command.


[Become superuser on a node in the cluster.]
[Execute the scsetup utility:]
# scsetup
[Enter option 2:]
*** Main Menu ***
    Please select from one of the following options:
    ...
      2) Cluster interconnect
    ...    Option: 2
[Enter option 4 to remove a cable:]
*** Cluster Interconnect Menu ***
    Please select from one of the following options:
    ...
      4) Remove a transport cable
    ...
    Option: 4
[Enter the requested information:]
>>> Remove a Cluster Transport Cable <<<
    ...
    Is it okay to continue (yes/no) [yes]? <Return>	.
    ...
    To which node is the cable attached? phys-schhost-2
    Name of the adapter on "phys-schost-2"? qfe-0
    Is it okay to proceed with the update (yes/no) [yes]? <Return>	.
scconf -a -m endpoint=phys-schost-2:hme1,endpoint=hub0
    Command completed successfully.    Hit ENTER to continue: <Return>
[Enter option 5 to remove an adapter:]
*** Cluster Interconnect Menu ***
    Please select from one of the following options:
    ...
      5) Remove a transport adapter from a node
    ...
    Option: 5
[Enter the requested information:]
>>> Remove a Cluster Transport Adapter <<<
    ...
    Is it okay to continue (yes/no) [yes]? <Return>	.
    ...
    To which node is the cable attached? phys-schhost-2
    Name of the adapter on "phys-schost-2"? qfe-0
    Is it okay to proceed with the update (yes/no) [yes]? <Return>	.
 
scconf -r -m endpoint=phys-schost-2:hme1
 
    Command completed successfully.    Hit ENTER to continue: <Return>
[Verify that the cable or adapter is removed:]
# scconf -p | grep cable
  Transport cable:   phys-schost-2:qfe0@1 ethernet-1@2    Enabled
  Transport cable:   phys-schost-3:qfe0@1 ethernet-1@3    Enabled
  Transport cable:   phys-schost-1:qfe0@0 ethernet-1@1    Enabled
# scconf -p | grep adapter
  Node transport adapters:   qfe2 hme1 qfe0
  Node transport adapter:   qfe0
  Node transport adapters:   qfe0 qfe2 hme1
  Node transport adapter:   qfe0
  Node transport adapters:   qfe0 qfe2 hme1
  Node transport adapter:   qfe0