Sun Cluster System Administration Guide for Solaris OS

Administering the Cluster Interconnects

This section provides the procedures for reconfiguring cluster interconnects, such as cluster transport adapters and cluster transport cables. These procedures require that you install Sun Cluster software.

Most of the time, you can use the scsetup(1M) utility to administer the cluster transport for the cluster interconnects. See the scsetup man page for more information.

For cluster software installation procedures, see the Sun Cluster Software Installation Guide for Solaris OS. For procedures about servicing cluster hardware components, see the Sun Cluster Hardware Administration Manual for Solaris OS.


Note –

You can usually choose to use the default port name, where appropriate, during cluster interconnect procedures. The default port name is the same as the internal node ID number of the node that hosts the adapter end of the cable. However, you cannot use the default port name for certain adapter types, such as SCI.


Table 6–1 Task List: Administering the Cluster Interconnect

Task 

For Instructions, Go To... 

Administer the cluster transport 

    - Use scsetup(1M)

How to Access the scsetup Utility

Check the status of the cluster interconnect 

    - Use scstat

How to Check the Status of the Cluster Interconnect

Add a cluster transport cable, transport adapter, or transport junction 

    - Use scstat(1M)

How to Add Cluster Transport Cables, Transport Adapters, or Transport Junctions

Remove a cluster transport cable, transport adapter, or transport junction 

    - Use scsetup

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

Enable a cluster transport cable 

    - Use scsetup

How to Enable a Cluster Transport Cable

Disable a cluster transport cable 

    - Use scsetup

How to Disable a Cluster Transport Cable

Dynamic Reconfiguration With Cluster Interconnects

There are a few issues you must consider when completing dynamic reconfiguration (DR) operations on cluster interconnects.


Caution – Caution –

Sun Cluster requires that each cluster node has at least one functioning path to every other cluster node. Do not disable a private interconnect interface that supports the last path to any cluster node.


Complete the following procedures in the order indicated when performing DR operations on public network interfaces.

Table 6–2 Task Map: Dynamic Reconfiguration with Public Network Interfaces

Task 

For Instructions, Go To... 

1. Disable and remove the interface from the active interconnect 

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

2. Perform the DR operation on the public network interface. 

Sun Enterprise 10000 DR Configuration Guide and the Sun Enterprise 10000 Dynamic Reconfiguration Reference Manual (from the Solaris 8 on Sun Hardware and Solaris 9 on Sun Hardware collections)

How to Check the Status of the Cluster Interconnect

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

You do not need to be logged in as superuser to perform this procedure.

  1. Check the status of the cluster interconnect.


    # scstat -W
    

  2. Refer to the following for common status messages.

    Status Message 

    Description and Possible Action 

    Path online

    The path is currently functioning correctly. No action is necessary. 

    Path waiting

    The path is currently being initialized. No action is necessary. 

    Path faulted

    The path is not functioning. This can be a transient state when paths are going between the waiting and online state. If the message persists when scstat -W is rerun, take corrective action.

Example—Checking the Status of the Cluster Interconnect

The following example shows the status of a functioning cluster interconnect.


# scstat -W
-- Cluster Transport Paths --
                    Endpoint             Endpoint             Status
                    --------             --------             ------
  Transport path:   phys-schost-1:qfe1   phys-schost-2:qfe1   Path online
  Transport path:   phys-schost-1:qfe0   phys-schost-2:qfe0   Path online
  Transport path:   phys-schost-1:qfe1   phys-schost-3:qfe1   Path online
  Transport path:   phys-schost-1:qfe0   phys-schost-3:qfe0   Path online
  Transport path:   phys-schost-2:qfe1   phys-schost-3:qfe1   Path online
  Transport path:   phys-schost-2:qfe0   phys-schost-3:qfe0   Path online

How to Add Cluster Transport Cables, Transport Adapters, or Transport Junctions

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

  1. Ensure that the physical cluster transport cables are installed.

    For the procedure on installing a cluster transport cable, see the Sun Cluster Hardware Administration Manual for Solaris OS.

  2. Become superuser on any node in the cluster.

  3. Enter the scsetup utility.


    # scsetup
    

    The Main Menu is displayed.

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


    Note –

    If your configuration uses SCI adapters, do not accept the default when you are prompted for the adapter connections (the port name) during the “Add” portion of this procedure. Instead, provide the port name (0, 1, 2, or 3) found on the Dolphin switch, to which the node is physically cabled.


  5. Add the transport cable by typing 1 (Add a transport cable).

    Follow the instructions and enter the requested information.

  6. Add the transport adapter by typing 2 (Add a transport adapter to a node).

    Follow the instructions and enter the requested information.

  7. Add the transport junction by typing 3 (Add a transport junction).

    Follow the instructions and enter the requested information.

  8. Verify that the cluster transport cable, transport adapter, or transport junction is added.


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

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

How 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.


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 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. 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

How to Enable 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.

This option is used to enable an already existing cluster transport cable.

  1. Become superuser on any node in the cluster.

  2. Enter the scsetup(1M) utility.


    # scsetup
    

    The Main Menu is displayed.

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

  4. Enable the transport cable by typing 7 (Enable a transport cable).

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

  5. Verify that the cable is enabled.


    # scconf -p | grep cable
    

Example—Enabling a Cluster Transport Cable

This example shows how to enable 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>Enable 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=enabled
 
Command completed successfully.
Quit the scsetup Cluster Interconnect Menu and Main Menu.
[Verify that the cable is enabled:]
# scconf -p | grep cable
  Transport cable:   phys-schost-2:qfe1@0 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

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