Sun Microsystems
Products & Services
 
Support & Training
 
 

Previous Previous     Contents     Index     Next Next

Example--Adding a Cluster Transport Cable, Transport Adapter, or Transport Junction

The following example shows how to add a transport cable, transport adapter, or transport junction to a node using the scsetup command.

[Ensure the physical cable is installed.]
# scsetup
Select Cluster interconnect.
Select either Add a transport cable, 
Add a transport adapter to a node, 
or Add a transport junction.
Answer the questions when prompted. 
   You Will Need:         Example:
   node names             phys-schost-1
   adapter names          qfe2
   junction names         hub2
   transport type         dlpi
[Verify that the scconf command completed successfully:]
Command completed successfully.
Quit the scsetup Cluster Interconnect Menu and Main Menu.
[Verify that the cable, adapter, and junction are added:]
# 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
# scconf -p | grep junction
  Cluster transport junctions:                       hub0 hub1 hub2
  Cluster transport junction:                        hub0
  Cluster transport junction:                        hub1
  Cluster transport junction:                        hub2

ProcedureHow to Remove Cluster Transport Cables, Transport Adapters, and Transport Junctions

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

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


<b>Caution - </b> 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 remaining cluster transport path.
    # scstat -W


    <b>Caution - </b> 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 utility.

    # scsetup

    The Main Menu is displayed.

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

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

    Follow the instructions and enter the requested information. You will need to know the applicable node names, adapter names, and junction names.


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


  6. Remove the adapter by typing 5 (Remove a transport adapter from a node).

    Follow the instructions and enter the requested information. You will need to know the applicable node names, adapter names, and junction names.


    Note - If you are removing a physical adapter from a node, see the Sun Cluster Hardware Administration Manual for Solaris OS for hardware service procedures.


  7. Remove the junction by typing 6 (Remove a transport junction).

    Follow the instructions and enter the requested information. You will need to know the applicable node names, adapter names, and junction names.


    Note - A junction cannot be removed if any of the ports are still in use as endpoints on any transport cables.


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

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

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

Example--Removing a Transport Cable, Transport Adapter, or Transport Junction

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

[Become superuser on any node in the cluster.]
[Enter the utility:]
# scsetup
Type 3 (Cluster interconnect).
Select either Add a transport cable, 

Add a transport adapter to a node, 

or Add a transport junction.

Answer the questions when prompted.
   You Will Need:         Example:
   node names             phys-schost-1
   adapter names          qfe1
   junction names         hub1
[Verify that the scconf command completed successfully:]
"Command completed successfully."
Quit the scsetup Cluster Interconnect Menu and Main Menu.
[Verify that the cable, adapter, or junction 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
# scconf -p | grep junction
  Cluster transport junctions:     hub0 hub2
  Cluster transport junction:      hub0
  Cluster transport junction:      hub2

Previous Previous     Contents     Index     Next Next