C H A P T E R 2 |
SMS DR Procedures |
This chapter contains procedures that describe how to use the DR feature on the Sun Fire high-end server system controller (SC), which runs the system management services (SMS) software. The following procedures are included:
Before you attempt to perform any DR operation, use the showdevices(1M) command to display the device information, especially when you are removing devices.
Use the showdevices(1M) command to display the device information for the domain.
The above command displays the device information for all of the devices in the domain and produces output such as the following:
The following output represents an example of the memory output for the showdevices(1M) command above.
The following output represents an example of the I/O devices output for the showdevices(1M) command above.
Refer to the section showdevices(1M) for more information about the showdevices(1M) command. Refer to the showdevices(1M) man page for a complete list of the options and arguments for this command, and for more information about displaying device-specific information.
Before you attempt to add, move, or delete a board to or from a specific domain, use the showboards(1M) command to determine the domain ID, the boards available to the domain, and the status of the domain.
You can use the domain ID in all of the DR commands. You can use the board list to determine the domain to which a specific board is assigned, and you can use the domain status to determine whether or not you can add, delete, or move a board to or from the domain. Use the showplatforms(1M) command to determine whether the component is in the available component list.
You must have the appropriate privileges to use the showplatforms(1M) command. See the section showplatform(1M) for more information about the showplatforms(1M) command, including a table showing which user groups can use it. Also, refer to the showplatform(1M) man page for more information.
Use the showplatform(1M) command to obtain the domain information.
The showplatform(1M) command displays the domain ID, the available component list, and the status of the domain, as in the following example.
Before you attempt to delete or move a system board, you must query the board to determine the state of the board and the domain to which it is assigned.
On the Sun Fire high-end server SC, a board can be in one of four states: unavailable, available, assigned, or active.
The following table contains descriptions of board states on the SC.
After you have determined the domain ID that contains the board that you want to delete or move, or after you have determined that a particular board has already been assigned to a specific domain, use the showboards(1M) command to determine the state of the board. The board may be in a state that makes it impossible for you to delete or move it.
Note - The output of the showboards(1M) command depends on the privileges of the user. For instance, the platform administrator can obtain information about all of the boards in the server. The domain administrator and domain configurator, however, can obtain the information about only those boards that are assigned and available to the domain(s) to which they have access. Refer to the section showboards(1M) for more information. |
Use the showboards(1M) command to display the board information for the domain.
The above command displays the device information for domain A. The following example contains the information that would be displayed.
Slot Pwr Type of Board Board Status Test Status Domain SB0 On CPU Board Active Passed A SB1 - Empty Slot Assigned - A |
You can use the showboards(1M) command to display all of the assigned system boards, all of the available system boards, and all of the CPU/memory and I/O boards in the domain. Refer to the showboards(1M) man page for more information about showing board information.
Adding a board to a domain moves the board through several state changes. If it is not already assigned, it is first assigned to the domain. Then, it is connected to the domain and configured into the Solaris operating environment. After it is connected, it is considered part of the physical domain and available for use by the operating system.
You must have the appropriate privileges to add a board to a domain. See the section addboard(1M) for more information, including a description of the privileges needed to use this command.
Use the addboard(1M) command to add the board to the domain.
The following example of the addboard(1M) command adds system board 2 (SB2) to the domain specified by domain_id. Two retries are performed, if necessary, with a wait time of 10 minutes (600 seconds) between retries.
Deleting a board from a domain removes the board from the domain to which it is currently assigned, and in which it may be active. To delete a board, it must be in the assigned or active state.
Always check the usage of the components on a board before you delete it from a domain. If the board hosts permanent memory, the memory is moved to another board within the same domain before the board is deleted from the domain. Likewise, if any busy devices are present, you must wait or ensure that the device is no longer being used by the system before you attempt to remove the board.
A domain administrator can unconfigure and disconnect a board, but cannot unassign a board from the a domain unless the board is in the available component list. See deleteboard(1M) for more information, including a description of privileges required to use this command.
Use the deleteboard(1M) command to delete the board from the domain.
The following example of the deleteboard(1M) command deletes system board 2 (SB2) from its current domain. Two retries are performed, if necessary, with a wait time of 15 minutes (900 seconds) between retries.
Moving a board from one domain to another domain is performed in several steps. First, the board is removed from the domain to which it is currently assigned, and in which it may be active; the board must be in the assigned or active state. Next, it is assigned to the target domain. Then, it is connected to the target domain and configured into the Solaris operating environment, where it becomes available for use.
You should always check the usage of the memory and devices on a board before you move it out of a domain. If the board hosts permanent memory, the memory must be moved to another board within the same domain before the board can be moved to another domain. Likewise, if any busy devices are present, you must wait or ensure that the device is no longer being used by the system before you attempt to move the board.
See the section moveboard(1M) for more information, including a description of privileges required to use the moveboard(1M) command.
Use the moveboard(1M) command to move the board from one domain to another domain.
The following example of the moveboard(1M) command moves system board 2 (SB2) from its current domain to the domain specified by domain_id. Two retries are performed, if necessary, with a wait time of 15 minutes (900 seconds) between retires.
This section describes how to replace a system board that is active in a domain with another system board.
In the following steps, system board 2 (SB2) is removed from its current domain and replaced by system board 3 (SB3).
1. Use the deleteboard(1M) command to delete system board 2 (SB2) from the domain.
This step deletes system board 2 from its current domain. Two retries are performed, if necessary, with a wait time of 15 minutes (900 seconds) between retries.
2. Use the addboard(1M) command to add system board 3 (SB3) to the domain.
This step adds system board 3 to the domain specified by domain_id. Two retries are performed, if necessary, with a wait time of 15 minutes (900 seconds) between retries.
Copyright © 2003, Sun Microsystems, Inc. All rights reserved.