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 15K/12K systems using the Sun Management Center 3.5 GUI and the PDSM module. The dynamic reconfiguration operations include such operations as adding a board to a Sun Fire 15K/12K domain, removing a board from a Sun Fire 15K/12K domain, and moving a board between Sun Fire 15K/12K 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, or powering a board off or on.

Two Sun Fire 15K/12K system-specific modules contain functionality for managing the Sun Fire 15K/12K 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 need to be familiar with dynamic reconfiguration operations before you use the Sun Management Center 3.5 GUI to perform DR operations. Refer to the following documents to learn more about dynamic reconfiguration operations on Sun Fire 15K/12K systems:

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


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) 1.3 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:

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) 1.3 Reference Manual for more information about adding a board.


procedure icon  To Add a Board



Note - Empty slots can only 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. Left-click on the Add Board menu selection.

The system displays the Add Board panel.

4. After ensuring that you have selected the board you want to add, select the domain to which to add the board in the drop-down list box.

5. Left-click on the appropriate radio button to select 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) 1.3 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. Left-click on the Delete Board menu selection.

The system displays the Delete Board panel.

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

5. Left-click on the appropriate radio button to select 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) 1.3 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. Left-click on the Move Board menu selection.

The system displays the Move Board panel.

4. After ensuring that you have selected the board you want to move, select the domain to which you want to move the board in the drop-down list box.

5. Left-click on the appropriate radio button to select 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) 1.3 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. Left-click on the Power On menu selection.

The system displays the Power On panel.

4. After ensuring that you have selected 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) 1.3 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. Left-click on the Power Off menu selection.

The system displays the Power Off panel.

4. After ensuring that you have selected 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) 1.3 Installation Guide and 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 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. Left-click on the Show status menu selection.

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.

As another example, after the configure operation finishes successfully--or if no command has been executed--the status shows the type of message in FIGURE 8-7 on page 223.

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 15K/12K 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 15K/12K 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) 1.3 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 1 Boards table.

The system displays a menu of board operations.

3. Left-click on the Add Board menu selection.

The system displays the Add Board panel.

4. After ensuring that you have selected the board you want to add, select the domain to which to add the board.

5. Left-click on the appropriate radio button to select 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) 1.3 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 1 Boards table.

The system displays a menu of board operations.

3. Left-click on the Delete Board menu selection.

The system displays the Delete Board panel.

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

5. Left-click on the appropriate radio button to select 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) 1.3 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 need to have access to both affected domains.

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

The system displays a menu of board operations.

3. Left-click on the Move Board menu selection.

The system displays the Move Board panel.

4. After ensuring that you have selected the board you want to move, select the domain to which to move the board.

5. Left-click on the appropriate radio button to select 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) 1.3 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. Left-click on the Power On menu selection.

The system displays the Power On panel.

4. After ensuring that you have selected 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) 1.3 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. Left-click on the Power Off menu selection.

The system displays the Power Off panel.

4. After ensuring that you have selected 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) 1.3 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. Left-click on the Test Board menu selection.

The system displays the Test Board panel.

4. Left-click on the radio button beside the test option you want.

5. If you want to force the test, left-click on the check box beside Use Force Option. 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 check box is blank.

6. After ensuring that you have selected 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) 1.3 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. Left-click on the Add Tag menu selection.

The system displays the Add Tag panel.

4. After ensuring that you have selected 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) 1.3 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. Left-click on the Delete Tag menu selection.

The system displays the Delete Tag panel.

4. After ensuring that you have selected 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) 1.3 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. Left-click on the Keyswitch menu selection.

The system displays the Keyswitch panel.

4. Left-click on 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 not receive 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 and Standby to Off.



5. Left-click on the OK button.

Setting Up or Changing the Access Control List (ACL)

This operation sets up or changes the Access Control List for the domain. The default for an ACL for a domain is empty. You need to 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 from a domain if the board is not in the domain's ACL. Refer to the setupplatform(1M) command in System Management Services (SMS) 1.3 Reference Manual for more information about setting up or changing the ACL.



Note - The Access Control List in the Sun Management Center 3.5 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. Left-click on the Access Control List menu selection.

The system displays the Access Control List panel.

4. If you want to add a slot to the ACL for a domain, select the slot from the left list box (Add To ACL List:), and left-click on Add. If you want to remove a slot from the ACL for a domain, select the slot from the right list box (Slots in ACL:), and left-click on Remove.

5. When you have the ACL exactly the way you want it, left-click on the OK button.

Resetting a Domain

This operation resets all the CPU ports of a specified domain; in other words, resets the hardware to a clean state. Refer to the reset(1M) command in the System Management Services (SMS) 1.3 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. Left-click on the Reset Domain menu selection.

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) 1.3 Installation Guide and 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 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. Left-click on the Show status menu selection.

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.

As another example, after the configure operation finishes successfully--or if no command has been executed--the status shows the type of message in FIGURE 8-7 on page 223.

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: