C H A P T E R  7

Platform/Domain State Management From the System Controller

This chapter describes how to perform dynamic reconfiguration (DR) and other management operations for Sun Fire high-end systems using the Sun Management Center console and the PDSM module. The dynamic reconfiguration operations include such operations as adding a board to a Sun Fire high-end systems domain, removing a board from a Sun Fire high-end systems domain, and moving a board between Sun Fire high-end systems domains. Some other management operations that you might want to perform either as part of a dynamic reconfiguration operation or as part of another operation are testing a board, updating the ACL, and powering a board off or on.

Two Sun Fire high-end systems system-specific modules contain functionality for managing the Sun Fire high-end systems platform and domains:

The PDSM monitoring and management capabilities from the Sun Management Center console are organized into one platform view and up to 18 domain views. See Platform/Domain State Management Module for information about where this module is located and what tables you can view.


Prerequisites

You must be familiar with dynamic reconfiguration operations before you use the Sun Management Center GUI to perform DR operations. Refer to the following documents to learn more about dynamic reconfiguration operations on Sun Fire high-end systems:

For the latest general issues, known limitations, and known bugs about dynamic reconfiguration operations, refer to the System Management Services (SMS) Release Notes.

Supported Components

Currently, the PDSM module supports DR operations on the following hardware components:


SMS Commands Supported by PDSM

Some of the System Management Services (SMS) command-line interface (CLI) commands are supported by the Platform/Domain State Management module. In other words, you can use the Sun Management Center graphical user interface (GUI) to monitor and manage the system components rather than using the SMS CLI commands that do the same thing. Refer to the System Management Services (SMS) Reference Manual for more information about the SMS commands.

TABLE 7-1 lists the SMS CLI commands that are supported by PDSM.


TABLE 7-1 SMS CLI Commands Supported by PDSM

SMS CLI Command

Sun Management Center GUI Menu Item

Description

addboard

Add Board

Assign, connect, and configure a board to a domain

addtag

Add Tag

Assign a domain name (tag) to a domain

deleteboard

Delete Board

Unconfigure, disconnect, and unassign a board from a domain

deletetag

Delete Tag

Remove the domain name (tag) associated with the domain

moveboard

Move Board

Move a board from one domain to another

poweroff

Power Off

Control power off

poweron

Power On

Control power on

rcfgadm -t

Test Board

Test a board

reset

Reset Domain

Send reset to all CPU ports of a specified domain

setkeyswitch

Keyswitch

Change the position of the virtual keyswitch

setupplatform -a|-r

Access Control List

Add or remove boards from the existing ACL



Platform Management Operations From the System Controller

This section contains procedures that describe how to perform platform-wide management operations from the system controller. The following dynamic reconfiguration procedures are described:

The following additional management procedures are described:



Note - Aborting a DR operation might not always halt the operation. Depending on when you click the Abort button, the DR operation might have progressed to the point where it really cannot be aborted. Choosing to abort the DR operation kills the process ID associated with that operation, but does not guarantee the component retains its previous state.



Showing Platform Information

Before you attempt to perform any of the platform-wide management operations from the system controller, look at the Platform View tables in the PDSM module under Hardware. See Platform View for more information about Platform View tables.

Adding a Board

This operation assigns, connects, or configures a board to a domain on the platform. Refer to the addboard(1M) command in the System Management Services (SMS) Reference Manual for more information about adding a board.


procedure icon  To Add a Board



Note - Only empty slots can be assigned.



1. Log in to the Sun Management Center console as a member of the platadmn group.

2. Right-click on the board you want to add in the Platform Slot 0 or 1 Boards or Empty Slots table.

The system displays a menu of board operations.

3. Choose Add Board from the menu.

The system displays the Add Board panel.

4. After ensuring that you have chosen the board you want to add, choose the domain to which to add the board from the drop-down list.

5. Select the appropriate radio button for the state in which you want the board to be after the board is added.

6. Left-click on the Add Board button.

You can see the progress of the Add Board operation in the panel.

7. If you want to abort the operation after it has started, left-click on the Abort button.

You can see the progress of the Abort operation in the panel.

Deleting a Board

This operation unconfigures, disconnects, or unassigns a system board from a domain on the platform. Refer to the deleteboard(1M) command in the System Management Services (SMS) Reference Manual for more information about deleting a board.


procedure icon  To Delete a Board

1. Log in to the Sun Management Center console as a member of the platadmn group.

2. Right-click on the board you want to delete in the Platform Slot 0 or 1 Boards table.

The system displays a menu of board operations.

3. Choose Delete Board from the menu.

The system displays the Delete Board panel.

4. Ensure that you have chosen the board you want to delete.

5. Select the appropriate radio button for the state in which you want the board to be after the board is deleted.

6. Left-click on the Delete Board button.

You can see the progress of the Delete Board operation in the panel.

7. If you want to abort the operation after it has started, left-click on the Abort button.

You can see the progress of the Abort operation in the panel.

Moving a Board

This operation moves a board from one domain to another on the platform. The board you are moving must be in the ACL of both affected domains. Refer to the moveboard(1M) command in the System Management Services (SMS) Reference Manual for more information about moving a board.


procedure icon  To Move a Board

1. Log in to the Sun Management Center console as a member of the platadmn group.

2. Right-click on the board you want to move in the Platform Slot 0 or 1 Boards table.

The system displays a menu of board operations.

3. Choose Move Board from the menu.

The system displays the Move Board panel.

4. After ensuring that you have chosen the board you want to move, choose the domain to which you want to move the board from the drop-down list.

5. Select the appropriate radio button for the state in which you want the board to be after the board is moved.

6. Left-click on the Move Board button.

You can see the progress of the Move Board operation in the panel.

7. If you want to abort the operation after it has started, left-click on the Abort button.

You can see the progress of the Abort operation in the panel.

Powering on a Board or Peripheral

This operation powers on a board, power supply, or fan tray on the platform. Refer to the poweron(1M) command in the System Management Services (SMS) Reference Manual for more information about powering on a board or peripheral.


procedure icon  To Power on a Board or Peripheral

1. Log in to the Sun Management Center console as a member of the platadmn or platoper group.

2. Right-click on the board, power supply, or fan tray you want to power on in the corresponding Platform View table.

The system displays a menu of operations.

3. Choose Power On from the menu.

The system displays the Power On panel.

4. After ensuring that you have chosen the correct board or peripheral to power on, left-click on the OK button.

Powering off a Board or Peripheral

This operation powers off a board, power supply, or fan tray on the platform. Refer to the poweroff(1M) command in the System Management Services (SMS) Reference Manual for more information about powering off a board or peripheral.


procedure icon  To Power off a Board or Peripheral

1. Log in to the Sun Management Center console as a member of the platadmn or platoper group.

2. Right-click on the board, power supply, or fan tray you want to power off in the corresponding Platform View table.

The system displays a menu of operations.

3. Choose Power Off from the menu.

The system displays the Power Off panel.

This board is active in a domain. Powering down this board might crash the domain. Are you sure you want to power off?

This expander is not empty and might contain components that are active in a domain. Powering down this expander might crash the domain(s). Are you sure you want to power off?

4. After ensuring that you have chosen the correct board or peripheral to power off, left-click on the OK button.

Showing Status

This operation shows the status of the last dynamic reconfiguration command executed for that board or slot. The status display is dynamically updated with the status of the command currently being executed. If the command being executed halts on an error, an error message is displayed. The message "No status from the agent" is displayed if no command has been executed, or if a command finishes execution without errors.



Note - You receive a status message if you attempt a dynamic reconfiguration operation that is not permitted. Refer to the System Management Services (SMS) Release Notes for any known limitations on dynamic reconfiguration operations in this release.




procedure icon  To Show Status

1. Log in as a member of the platadmn or platoper group.

2. Right-click on the system board or slot for which you want to show status in the appropriate board table.

The system displays a menu of board or slot operations.

3. Choose Show status from the menu.

The system displays the Status box showing the execution status of the most current dynamic reconfiguration command, if any. There can be a slight delay (up to a minute) before you receive the most current status.

For example, if an operation fails, the status shows the type of message in FIGURE 8-6 on page 223.

After the configure operation finishes successfully--or if no command has been executed--the status shows the type of message in FIGURE 8-7.

4. Left-click on the OK button when you are finished looking at the status.


Domain Management Operations From the System Controller

This section contains procedures that describe how to perform Sun Fire high-end systems domain management operations from the system controller. The following dynamic reconfiguration procedures are described:

The following additional management procedures are described:

Showing Domain Information From the System Controller

Before you perform Sun Fire high-end systems domain management operations from the system controller, look at the Domain View tables in the PDSM modules under Hardware. See Domain X View for more information about the Domain View tables.

Adding a Board

This operation adds a board to a specific domain. Refer to the addboard(1M) command in the System Management Services (SMS) Reference Manual for more information about adding a board.


procedure icon  To Add a Board

1. Log in to the Sun Management Center console as a member of the platadmn, dmnxadmn, or dmnxrcfg group, where x is the domain where you want to add a board.

2. Right-click on the board you want to add in the Domain X Slot 0 or Slot 1 Boards table.

The system displays a menu of board operations.

3. Choose Add Board from the menu.

The system displays the Add Board panel.

4. After ensuring that you have chosen the board you want to add, choose the domain to which to add the board.

5. Select the appropriate radio button for the state in which you want the board to be after the board is added.

6. Left-click on the Add Board button.

You can see the progress of the Add Board operation in the panel.

7. If you want to abort the operation after it has started, left-click on the Abort button.

You can see the progress of the Abort operation in the panel.

Deleting a Board

This operation unconfigures, disconnects, and unassigns a system board from a specific domain. Refer to the deleteboard(1M) command in the System Management Services (SMS) Reference Manual for more information about deleting a board.


procedure icon  To Delete a Board

1. Log in to the Sun Management Center console as a member of the platadmn, dmnxadmn, or dmnxrcfg group, where x is the domain where you want to delete a board.

2. Right-click on the board you want to delete in the Domain X Slot 0 or Slot 1 Boards table.

The system displays a menu of board operations.

3. Choose Delete Board from the menu.

The system displays the Delete Board panel.

4. Ensure that you have chosen the board you want to delete.

5. Select the appropriate radio button for the state in which you want the board to be after the board is deleted.

6. Left-click on the Delete Board button.

You can see the progress of the Delete Board operation in the panel.

7. If you want to abort the operation after it has started, left-click on the Abort button.

You can see the progress of the Abort operation in the panel.

Moving a Board

This operation moves a board from one domain to another. The board you are moving must be in the ACL of both affected domains. Refer to the moveboard(1M) command in the System Management Services (SMS) Reference Manual for more information about moving a board.


procedure icon  To Move a Board

1. Log in to the Sun Management Center console.

If you log in as a member of the platadmn group, you do not need additional access privileges. If you log in as a member of the dmnxadmn or dmnxrcfg group, where x is the domain, you must have access to both affected domains.

2. Right-click on the board you want to move in the Domain X Slot 0 or Slot 1 Boards table.

The system displays a menu of board operations.

3. Choose Move Board from the menu.

The system displays the Move Board panel.

4. After ensuring that you have chosen the board you want to move, choose the domain to which to move the board.

5. Select the appropriate radio button for the state in which you want the board to be after the board is moved.

6. Left-click on the Move Board button.

You can see the progress of the Move Board operation in the panel.

7. If you want to abort the operation after it has started, left-click on the Abort button.

You can see the progress of the Abort operation in the panel.

Powering on a Board

This operation powers on a board for a specific domain. Refer to the poweron(1M) command in the System Management Services (SMS) Reference Manual for more information about powering on a board.


procedure icon  To Power on a Board

Before you power on a board, the power state must be OFF.

1. Log in to the Sun Management Center console as a member of the platadmn, platoper, dmnxadmn, or dmnxrcfg group, where x is the domain where you want to power on a board.

2. Right-click on the board you want to power on in the one of the Domain X View tables.

The system displays a menu of board operations.

3. Choose Power On from the menu.

The system displays the Power On panel.

4. After ensuring that you have chosen the correct board to power on, left-click on the OK button.

Powering off a Board

This operation powers off a board for a specific domain. Refer to the poweroff(1M) command in the System Management Services (SMS) Reference Manual for more information about powering off a board.


procedure icon  To Power off a Board

Before you power off a board, the power state must be ON.

1. Log in to the Sun Management Center console as a member of the platadmn, platoper, dmnxadmn, or dmnxrcfg group, where x is the domain where you want to power off a board.

2. Right-click on the board you want to power off in the Domain X Slot 0 or 1 Boards table.

The system displays a menu of board operations.

3. Choose Power Off from the menu.

The system displays the Power Off panel.

4. After ensuring that you have chosen the correct board to power off, left-click on the OK button.

Testing a Board

This operation tests a board in a specific domain. Refer to the rcfgadm(1M) command, option -t, in the System Management Services (SMS) Reference Manual for more information about testing a board.


procedure icon  To Test a Board

1. Log in to the Sun Management Center console as a member of the dmnxadmn group, where x is the domain where you want to test a board.

2. Right-click on the board you want to test in the Domain X View table.

The system displays a menu of board operations.

3. Choose Test Board from the menu.

The system displays the Test Board panel.

4. Select the radio button beside the test option you want.

5. (Optional) If you want to force the test, select the Use Force Option check box.

If you do choose this option, note the caution on the menu. If you do not want to force the test, be sure that the Use Force Option check box is left unchecked.

6. After ensuring that you have chosen the correct board to test and have the correct options checked, left-click on the Start Test button.

You can see the progress of the Test Board operation in the panel.

7. If you want to abort the operation after it has started, left-click on the Abort button.

You can see the progress of the Abort operation in the panel.

Adding or Changing a Domain Tag

This operation adds the specified domain tag name to a domain or changes the domain tag name. Only one name tag can be assigned to a domain, and it must be unique across all domains. Refer to the addtag(1M) command in the System Management Services (SMS) Reference Manual for more information about adding or changing a domain tag.


procedure icon  To Add or Change a Domain Tag

1. Log in to the Sun Management Center console as a member of the platadmn group.

2. Right-click on the Domain (A-R) in the Domain X Info table for which you want to add or change a tag.

The system displays a menu of domain operations.

3. Choose Add Tag from the menu.

The system displays the Add Tag panel.

4. After ensuring that you have chosen the correct domain for which you want to add a tag, type the new domain tag name in the text box under Set new tag:

5. Left-click on the OK button.

Deleting a Tag

This operation removes the domain tag name associated with the domain. Refer to the deletetag(1M) command in the System Management Services (SMS) Reference Manual for more information about deleting a tag.


procedure icon  To Delete a Domain Tag

1. Log in to the Sun Management Center console as a member of the platadmn group.

2. Right-click on the Domain (A-R) in the Domain X Info table for which you want to delete a tag.

The system displays a menu of domain operations.

3. Choose Delete Tag from the menu.

The system displays the Delete Tag panel.

4. After ensuring that you have chosen the correct domain for which you want to delete a tag, left-click on the OK button.

Changing the Keyswitch Position

This operation changes the position of the virtual keyswitch for a domain to one of these specified values:

Refer to the setkeyswitch(1M) command in System Management Services (SMS) Reference Manual for more information about the virtual keyswitch and definitions of the positions.


procedure icon  To Change the Keyswitch Position

1. Log in to the Sun Management Center console as a member of the dmnxadmn group, where x is the domain for which you want to change the keyswitch position.

2. Right-click on the Domain (A-R) in the Domain X Info table for which you want to change the keyswitch position.

The system displays a menu of domain operations.

3. Choose Keyswitch from the menu.

The system displays the Keyswitch panel.

4. Select the radio button next to the position you want to set for the domain.



caution icon

Caution - If you attempt to change a keyswitch position directly from On to Off, the operation fails, and you do notreceive a message that it fails. If you want to change a keyswitch position from On to Off, go through Standby first. In other words, go from On to Standby andthen from Standby to Off.



5. Left-click on the OK button.

Setting Up or Changing the Access Control List

This operation sets up or changes the Access Control List (ACL) for the domain. The default for an ACL for a domain is empty. You must set up the ACL list for a domain initially and put in all boards you want to assign to the domain. You cannot assign a board to a domain if the board is not in the domain's ACL. Refer to the setupplatform(1M) command in System Management Services (SMS) Reference Manual for more information about setting up or changing the ACL.



Note - The Access Control List in the Sun Management Center GUI is the same list that is called the Available Component List in the Systems Management Services (SMS) setupplatform(1M) command.




procedure icon  To Set Up or Change the Access Control List

1. Log in to the Sun Management Center console as a member of the platadmn group.

2. Right-click on the Domain (A-R) in the Domain X Info table for which you want to set up or change the Access Control List.

The system displays a menu of domain operations.

3. Choose Access Control List from the menu.

The system displays the Access Control List panel.

4. Perform one of these steps:

5. When you have finished making your changes, click the OK button.

Resetting a Domain

This operation resets all the CPU ports of a specified domain; in other words, it resets the hardware to a clean state. Refer to the reset(1M) command in the System Management Services (SMS) Reference Manual for more information about resetting a domain.


procedure icon  To Reset a Domain

To reset a domain, the virtual keyswitch must not be in the secure position. If the keyswitch is in the secure position and you attempt to reset the domain, you receive an error message. See Changing the Keyswitch Position for instructions on changing the keyswitch position.

1. Log in to the Sun Management Center console as a member of the dmnxadmn group, where x is the domain you want to reset.

2. Right-click on the Domain (A-R) in the Domain X Info table that you want to reset.

The system displays a menu of domain operations.

3. Choose Reset Domain from the menu.

The system displays the Reset Domain panel.

4. If you are sure this is the domain you want to reset, left-click on the OK button.

Showing Status

This operation shows the status of the last dynamic reconfiguration command executed for that board or slot. The status display is dynamically updated with the status of the command currently being executed. If the command being executed halts on an error, an error message is displayed. The message "No status from the agent" is displayed if no command has been executed, or if a command finishes execution without errors.



Note - You receive a status message if you attempt a dynamic reconfiguration operation that is not permitted. Refer to the System Management Services (SMS) Release Notes for any known limitations on dynamic reconfiguration operations in this release.




procedure icon  To Show Status

1. Log in as a member of the platadmn, platoper, dmnxadmn, or dmnxrcfg group, where x is the domain in which you want to show status for a system board or slot.

2. Right-click on the system board or slot for which you want to show status in the appropriate board table.

The system displays a menu of board or slot operations.

3. Choose Show Status from the menu.

The system displays the Status box showing the execution status of the most current dynamic reconfiguration command, if any. There can be a slight delay (up to a minute) before you receive the most current status.

For example, if an operation fails, the status shows the type of message in FIGURE 8-6.

After the configure operation finishes successfully--or if no command has been executed--the status shows the type of message in FIGURE 8-7.

4. Left-click on the OK button when you are finished looking at the status.


Possible Reasons for DR Operation Attempts Failing

There are a number of reasons why a dynamic reconfiguration operation attempt might fail:

When you receive any of these messages other than Timeout error, refer to the following files for more information: