This chapter describes the user interfaces for DR.
How To Use the DR User Interface
Command Reference
XSCF Web
RCM Script
3.1 How To Use the DR User Interface
XSCF provides two user interfaces for DR: the command line interface by XSCF shell, and the browser-based user interface by XSCF Web. This section describes the main XSCF shell commands used for DR. For other related commands, see Command Reference. For XSCF Web, see Command Reference and XSCF Web.
XSCF shell commands for DR operations are classified into two types: DR display and DR operation commands.
TABLE 3-1 DR Display Commands
Command name
|
Function
|
showdcl
|
Display the DCL and domain status.
|
showdomainstatus
|
Display domain status.
|
showboards
|
Display system board information.
|
showdevices
|
Display information about the CPUs, memory, and I/O devices on system boards.
|
showfru
|
Display PSB configuration information.
|
TABLE 3-2 DR Operation Commands
Command name
|
Function
|
setdcl
|
Update and edit the DCL.
|
setupfru
|
Set the division type and memory mirror mode for a PSB.
|
addboard
|
Add a system board to a domain.
|
deleteboard
|
Delete a system board from a domain.
|
moveboard
|
Move a system board between domains.
|
The sections below describe the DR display and DR operation commands in detail and show examples. For details of the options, operands, and usage of these commands, see the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual.
Note - Use of the user interfaces with XSCF shell and XSCF Web is restricted to selected administrators, and requires administrator privileges for DR operations. When system boards are shared by multiple administrators, the administrators must carefully prepare and plan secure DR operations.
|
3.1.1 Displaying Domain Information
The showdcl(8) command displays domain information including the domain ID, configured system board numbers, and domain status in list format.
The showdcl(8) command is used before a DR operation to determine whether the domain status permits DR operation, and confirm the registration of the DR-target system board in the DCL. The showdcl(8) command is also used after a DR operation to confirm domain status and configuration.
To change domain settings or register a system board in the DCL, use the setdcl(8) command. To change PSB settings, use the setupfru(8) command.
The following examples show the format and specifiable options of the showdcl(8) command.
showdcl [-v] -a
showdcl [-v] -d domain_id [-l lsb [-l lsb]]...
showdcl -h
|
TABLE 3-3 Options of the showdcl Command
Option
|
Description
|
-a
|
Displays configuration information and status of all domains.
|
-v
|
Displays detailed domain configuration information.
|
-h
|
Displays usage information.
|
-d domain_id
|
Displays information about the specified domain, where domain_id is the domain number, possibly 0 to 23, depending on your server. Only one domain ID can be specified.
|
-l lsb
|
Displays information about the specified logical system board (LSB), numbered 00 to 15. For information about multiple LSBs, list board numbers separated by a space. For example:
showdcl -l 00 -l 01.
|
TABLE 3-4 Items of Domain Information to be Displayed
Display items
|
Description
|
DID
|
Domain ID.
|
LSB
|
Logical system board number.
|
XSB
|
System board number.
|
Status
|
Domain Status
|
Powered Off
|
Domain power is off.
|
Initialization Phase
|
POST processing or OpenBoot PROM initialization is in progress.
|
OpenBoot Executing Completed
|
Initialization of OpenBoot PROM is completed.
|
Running
|
Oracle Solaris OS is running.
|
Shutdown Started
|
Oracle Solaris OS is being shut down.
|
Panic State
|
Oracle Solaris OS panic occurred.
|
No-mem
|
Setting of omit-memory option
|
true
|
Enabled: Oracle Solaris OS does not use memory
|
false
|
Disabled: Oracle Solaris OS uses memory.
|
No-IO
|
Setting of omit-IO option
|
true
|
Enabled: Oracle Solaris OS does not use I/O device.
|
false
|
Disabled: Oracle Solaris OS uses I/O device.
|
Float
|
Setting of floating board option
|
true
|
Enabled: Board is designated as a Floating board.
|
false
|
Disabled: Board is not designated as Floating board.
|
Cfg-policy
|
Setting of configuration policy
|
FRU
|
Degradation in units of components.
|
XSB
|
Degradation in units of XSB.
|
System
|
Stopping of domain without degradation.
|
The table below lists the items displayed by the showdcl(8) command.
The following shows examples of displays by the showdcl(8) command.
- Example 1: Display of information on domain #0
XSCF> showdcl -d 0
DID LSB XSB Status
00 Running
00 00-0
04 01-0
05 01-01
06 01-2
07 01-3
08 02-0
|
- Example 2: Display of detailed information on domain #0
XSCF> showdcl -v -d 0
DID LSB XSB Status No-Mem No-IO Float Cfg-policy
00 Running FRU
00 00-0 False False False
01 -
02 -
03 -
04 01-0 False False False
05 01-1 False True False
06 01-2 False True True
07 01-3 True True True
08 02-0 True True True
09 -
10 -
11 -
|
3.1.2 Displaying Domain Status
The showdomainstatus(8) command lists the domains in the system and their status. This command displays the same domain status information as the showdcl(8) command.
Use the showdomainstatus(8) command to check domain status before and after a DR operation.
The following examples show the format and options of the showdomainstatus(8) command:
showdomainstatus -a
showdomainstatus -d domain_id
showdomainstatus -h
|
TABLE 3-5 Options of the showdomainstatus Command
Option
|
Description
|
-a
|
Displays the status of all domains.
|
-d domain_id
|
Displays information about the specified domain, where domain_id is the domain number, possibly 0 to 23, depending on your server. Only one domain ID can be specified.
|
-h
|
Displays usage information.
|
The table below lists the items displayed by the showdomainstatus(8) command.
TABLE 3-6 Items of Domain Information to be Displayed
Display items
|
Description
|
DID
|
Domain ID
|
Status
|
Domain status
|
Powered Off
|
Domain power is off.
|
Initialization Phase
|
POST processing or OpenBoot PROM initialization is in progress.
|
OpenBoot Executing Completed
|
Initialization by OpenBoot PROM is completed.
|
Booting/OpenBoot PROM prompt
|
Oracle Solaris OS is being booted or, due to the domain shutdown or reset, the system is in the OpenBoot PROM running state, or is suspended in the OpenBoot PROM (ok prompt) state.
|
Running
|
Oracle Solaris OS is running.
|
Shutdown Started
|
Oracle Solaris OS is being shut down.
|
Panic State
|
Oracle Solaris OS panic occurred.
|
The following example shows a display of the showdomainstatus (8) command.
- Example: Display of information on all domains
XSCF> showdomainstatus
DID Domain Status
00 Running
01 Powered Off
02 -
03 Running
|
3.1.3 Displaying System Board Information
The showboards(8) command displays system board information including the domain ID of the domain to which the target system board belongs and various kinds of system board status in list format.
Use the showboards(8) command before a DR operation to determine whether the system board status permits DR operations, and to confirm the domain ID of the domain to which the target system board belongs. The showboards(8) command is also used after a DR operation to confirm system board status.
To change domain settings or register a system board in the DCL, use the setdcl(8) command. To change PSB settings, use the setupfru(8) command.
The following examples show the format and options of the showboards(8) command.
showboards [-v] -a [-c sp]
showboards [-v] -d domain _id [-c sp]
showboards [-v] xsb
showboards -h
|
TABLE 3-7 Options of the showboards Command
Option
|
Description
|
-v
|
Displays detailed information about the system board.
|
-a
|
Displays information about all mounted system boards.
|
-h
|
Displays the usage information.
|
-d domain_id
|
Displays information about the specified domain, where domain_id is the domain number, possibly 0 to 23, depending on your server. Only one domain ID can be specified.
|
xsb
|
Displays information about the specified XSB.
Specify xsb in the XX-Y format. (XX = 00 to 15, Y = 0 to 3). The value depends on your server.
|
-c sp
|
Displays information about system boards in system board pool.
|
The table below lists the items displayed by the showboards(8) command.
TABLE 3-8 Items of System Board Information to be Displayed
Display items
|
Description
|
XSB
|
System board number.
|
R
|
Reservation status of a system board.
“*” is displayed for a system board when the board is reserved for addition, deletion, or a move.
|
DID (LSB)
|
Domain ID of the domain into which the system board is added and logical system board number “SP” is displayed for a system board that is in the system board pool.
|
Assignment
|
Status of assignment to domain configuration
|
Unavailable
|
The system board is in the system board pool (not assigned to a domain) and its status is one of the following: not-yet diagnosed, under diagnosis, or diagnosis error. All system boards that are not mounted are also shown as Unavailable.
|
Available
|
The system board is in the system board pool and its diagnosis has completed normally.
|
Assigned
|
The system board is assigned to the domain.
|
Pwr
|
Power-on/off status of system board
|
n
|
Power-off status.
The system board is powered off and cannot be used.
|
y
|
Power-on status.
The system board is powered on.
|
Conn
|
Status of connection to domain configuration
|
n
|
Disconnected status.
The system board is disconnected from the relevant domain configuration or in the system board pool.
|
y
|
Connected status.
The system board is connected to the relevant domain configuration.
|
Conf
|
Status of addition into Oracle Solaris OS
|
n
|
Unconfigured status.
The hardware resources of the system board have been deleted from the Oracle Solaris OS.
|
y
|
Configured status.
The hardware resources of the system board have been added into the Oracle Solaris OS.
|
Test
|
Diagnostic status of system board
|
Unmount
|
The system board is not mounted or cannot be recognized because it is faulty.
|
Unknown
|
The system board is not being diagnosed.
|
Testing
|
testing.
|
Passed
|
The system board was tested, and passed.
|
Failed
|
A system board error was tested, and failed.
The system board cannot be used or has been degraded.
|
Fault
|
Normal/abnormal status of system board
|
Normal
|
Normal.
|
Degraded
|
Components have been degraded, but the system board is operating. Degraded here means that a system board included in the corresponding component is faulty.
|
Failed
|
The system board cannot operate because of an error.
|
COD
|
Indication of whether the system board is a COD board.
|
n
|
The board is not a COD board.
|
y
|
The board is a COD board.
|
The following examples show displays of the showboards(8) command
- Example 1: Display of information on all system boards
XSCF> showboards -a
XSB DID(LSB) Assignment Pwr Conn Conf Test Fault
------------------------------------------------------------------
00-0 00(00) Assigned y y y Passed Normal
00-1 00(01) Assigned y n n Passed Degraded
00-2 SP Available y n n Unknown Normal
00-3 01(15) Assigned y y y Passed Normal
|
- Example 2: Display of detailed information on all system boards
XSCF> showboards -v -a
XSB R DID(LSB) Assignment Pwr Conn Conf Test Fault COD
--------------------------------------------------------------------------
00-0 00(00) Assigned y y y Passed Normal n
00-1 00(01) Assigned y n n Passed Degraded n
00-2 * SP Available y n n Unknown Normal n
00-3 01(15) Assigned y y y Passed Normal n
|
- Example 3: Display of information on the system board in the system board pool in domain #0
XSCF> showboards -c sp -d 0
XSB DID(LSB) Assignment Pwr Conn Conf Test Fault
------------------------------------------------------------------
00-2 SP Available y n n Passed Normal
|
3.1.4 Displaying Device Information
Use the showdevices(8) command to display device information.
The showdevices(8) command displays information about the physical devices including CPUs, memory, and PCI cards mounted on system boards, and displays the hardware resources usable with these devices in hardware resource format.
The showdevices(8) command is used before a DR operation to confirm information about and status of the hardware resources of the DR-target system board, and to determine the process to access the CPU and I/O devices.
Resource management applications or subsystems provide information concerning use of the hardware resources. A showdevices(8) command offline query about management target resources estimates the effect of each DR operation applied to the system boards and displays the results.
The following examples show the format and options of the showdevices(8) command.
showdevices [-v] [-p bydevice|byboard|query|force] xsb
showdevices [-v] [-p bydevice|byboard] -d domain_id
showdevices -h
|
Note - The showdevices(8) command only reports information about a running domain.
|
Note - (Note 2) The showdevices(8) command will succeed only if the following Oracle Solaris Service Management Facility (SMF) services are active on that domain:
- Domain SP Communication Protocol (dscp)
- Domain Configuration Server (dcs)
- Oracle Sun Cryptographic Key Management Daemon (sckmd).
|
TABLE 3-9 Options of the showdevices Command
Option
|
Description
|
-v
|
Specifies that the command displays information about all devices.
Information about not only the management target devices but also other devices is displayed. However, the displayed information includes resource information about the devices whose resources are managed and does not include resource information about the devices whose resources are not managed.
|
-p bydevice
|
Specifies that the command display information about the devices mounted on a system board (CPU, memory, and I/O devices), sorted by device.
If neither -p bydevice nor -p byboard is specified, -p bydevice is the default.
|
-p byboard
|
Specifies that the command display information about the devices mounted on system boards (CPU, memory, and I/O devices) by system board.
|
-p query
|
Tests the detachability of the board by test-running the DR command without actually executing it.
|
-p force
|
Tests the detachability of the board by test-running the DR command with the force flag without actually executing it.
|
xsb
|
Specifies a system board (XSB) number. Specify xsb in the XX-Y format. (XX = 00 to 15, Y = 0 to 3). The value depends on your server.
|
-d domain_id
|
Specifies ID of the specified domain, where domain_id is the domain number, possibly 0 to 23, depending on your server. Only one domain ID can be specified.
|
TABLE 3-10 Domain Information Displayed by the showdevices command
Display items
|
Description
|
CPU
|
CPU information.
|
DID
|
Domain ID.
|
XSB
|
System board number.
|
id
|
CPU ID.
|
state
|
CPU status.
|
speed
|
CPU frequency (MHz).
|
ecache
|
CPU cache size (Megabyte: MB).
|
usage
|
Description of instance using resources.
|
Memory
|
Memory information.
|
DID
|
Domain ID
|
XSB
|
System board number
|
board mem
|
Size of memory on system board (MB).
|
perm mem
|
Size of non-relocatable (kernel) memory on system board (MB)
|
base address
|
Base physical address of memory on system board.
|
domain mem
|
Size of memory in domain (MB).
|
target board
|
System board number of the system board whose kernel memory is drained.
|
deleted mem
|
Size of already deleted memory (MB).
|
remaining mem
|
Size of remaining memory to be deleted (MB).
|
IO Devices
|
I/O device information.
|
DID
|
Domain ID.
|
XSB
|
System board number.
|
device
|
Instance name and number of I/O device.
|
resource
|
Management resource name.
|
usage
|
Description of resource usage.
|
query
|
Results of estimation with an offline query.
|
usage/reason
|
Description of resource usage and reason for the results of estimation with an offline query.
|
The following example shows a display by the showdevices(8) command.
- Example: Display of device information on XSB00-0
XSCF> showdevices 00-0
CPU:
----
DID XSB id state speed ecache
00 00-0 0 on-line 2048 4
00 00-0 1 on-line 2048 4
Memory:
-------
board perm base domain target deleted remaining
DID XSB mem MB mem MB address mem MB XSB mem MB mem MB
00 00-0 8192 2048 0x000003c000000000 65536
I/O Devices:
----------
DID XSB device resource usage
00 00-0 sd0 /dev/dsk/c0t0d0s0 mounted filesystem “/”
00 00-0 sd0 /dev/dsk/c0t0d0s1 swap area
00 00-0 sd0 /dev/dsk/c0t0d0s1 dump device (swap)
00 00-0 bge0 SUNW_network/bge0 bge0 hosts IP addresses: 10.1.1.1
|
3.1.5 Displaying System Board Configuration Information
Use the showfru(8) command to display system board configuration information.
The showfru(8) command displays information about the PSB division type and memory mirroring mode settings in list format.
To change the PSB configuration, use the setupfru(8) command.
The following examples show the format and options of the showfru(8) command.
showfru -a device
showfru device location
showfru -h
|
TABLE 3-11 Options of the showfru Command
Option
|
Description
|
-a
|
Specifies that the command display all configuration information on devices of the type specified by devtype.
|
-h
|
Displays usage information.
|
device
|
Specifies a device type. Specify “sb” for DR.
|
location
|
Specifies a device name. Specifies a physical system board (PSB) number. Specify a decimal number from 00 to 15 for PSB. To display information about multiple system boards, several PSB numbers can be specified by delimiting each with a space. The range of PSB numbers to be specified varies depending on your server.
|
The table below lists the items displayed by the showfru(8) command.
TABLE 3-12 Items of System Board Configuration Information to be Displayed
Display items
|
Description
|
Device
|
Device type.
“sb” is the corresponding device for DR.
|
Location
|
Mounting location of a device.
Displays a physical system board (PSB) number.
|
XSB Mode
|
XSB division type.
|
Uni
|
Uni-XSB (no division) mode.
|
Quad
|
Quad-XSB: four-division mode.
|
Memory Mirror Mode
|
Memory mirror mode.
|
yes
|
Memory mirror mode is enabled.
|
no
|
Memory mirror mode is disabled.
|
The following example shows a display of the showfru(8) command.
- Example: Display of configuration information on all system boards
XSCF> showfru -a sb
Device Location XSB Mode Memory Mirror Mode
sb 00 Quad yes
sb 01 Quad yes
sb 02 Quad no
sb 03 Uni no
|
3.1.6 Adding a System Board
Use the addboard(8) command to add a system board to a domain or reserve the addition of a system board to a domain based on the DCL. The system board must already be registered in the target domain’s DCL.
Use the showdcl(8) command to check whether a system board is registered in the DCL. To register a system board in the DCL, use the setdcl(8) command.
Before executing the addboard(8) command, check the status of the DR-target domain and system board. You must determine whether you can perform the DR operation based on the status of the domain and system board.
The following examples show the format and options of the addboard(8) command.
addboard [[-q] -{y|n}] [-f] [-v] [-c configure] -d domain_id xsb [...]
addboard [[-q] -{y|n}] [-f] [-v] -c assign -d domain_id xsb [...]
addboard [[-q] -{y|n}] [-f] [-v] -c reserve -d domain_id xsb [...]
addboard -h
|
TABLE 3-13 Options of the addboard Command
Option
|
Description
|
-q
|
Specifies the suppression of output message display.
The -y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.
|
-y
|
Specifies that a response of "yes" is made automatically to all output messages.
The -y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.
|
-n
|
Specifies that a response of "no" is made automatically to all output messages.
The-y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.
|
-f
|
Forcibly adds a system board that has not been diagnosed to a domain. This option for normal DR operations must not be used.
A faulty system board, or a system board where a fault is detected will not be forcibly added to the destination domain.
|
-v
|
Displays the progress of this DR command.
If the option is specified with the -q option, the -v option is ignored.
|
-h
|
Displays the usage information.
|
-c configure
|
Specifies that the command add a system board to the domain. If no other -c option is specified, -c configure is the default.
|
-c assign
|
Specifies that the command assign a system board to the domain.
With this option specified, the command assigns the target system board to the domain. The assigned system board is added to the domain when the addboard(8) command with the -c configure option specified is executed, and then the domain power is turned on or the domain rebooted.
|
-c reserve
|
Specifies that the command reserve the addition of a system board to the domain.
With this option specified, the command executes the same processing as for the -c assign option, and it assigns the target system board to the domain. The assigned system board is added to the domain when the addboard(8) command with the -c configure option specified is executed, and then the domain power is turned on or the domain is rebooted.
|
-d domain_id
|
Specifies the domain ID of the domain to add a system board, where domain_id is the domain number, possibly 0 to 23, depending on your server. Only one domain ID can be specified.
|
xsb
|
Specifies the system board (XSB) number of the system board to be added.
Specify xsb in the XX-Y format. (XX = 00 to 15, Y = 0 to 3). The value depends on your server. To specify multiple system boards, several XSB numbers can be specified by delimiting each with a space.
|
Note - (Note 1) In the system board addition processing executed by this command, a diagnosis of the system board to be added is performed first, and then the system board is added to the target domain. For this reason, much time may be required for the command to complete its operation.
|
Note - (Note 2) If DR processing by the addboard(8) command fails, the target system board cannot be restored to its previous status. You must identify the cause of failure based on the error message output by the addboard(8) command and Oracle Solaris OS messages, and then take appropriate corrective action. Note that some errors require the domain to be rebooted.
|
Note - (Note 3) If a system board has been forcibly added to a domain by the addboard(8) command with the -f option specified, normal operation of all added hardware resources may be disabled. For this reason, you should avoid using the -f option for normal DR operations. After adding a system board by using the addboard(8) command with the -f option specified, be sure to check the status of the added system board and the devices on the system board.
|
Note - (Note 4) You can execute the addboard(8) command on a domain that is not running. When the domain is running, the addboard(8) command with "-c configure" will succeed only if the following Oracle Solaris Service Management Facility (SMF) services are active on that domain:
- Domain SP Communication Protocol (dscp)
- Domain Configuration Server (dcs)
- Oracle Sun Cryptographic Key Management Daemon (sckmd)
|
3.1.7 Deleting a System Board
Use the deleteboard(8) command to delete a system board from a domain and assign it to the system board pool. If you specify the -c reserve option, the action takes place the next time the domain is powered off or rebooted.
Before executing the deleteboard(8) command, check the status of the target domain and system board, and the device usage status on the system board. You must determine whether you can perform the DR operation according to the status of the domains and system board, and the device usage status on the system board. You must also stop the processes that are bound to the CPU and the accessing of I/O devices to prepare for system board deletion.
If the system board to be deleted is a kernel memory board, check the status and memory size of the system board to which kernel memory is to be moved.
The following examples show the format and options of the deleteboard(8) command.
deleteboard [[-q] -{y|n}] [-f] [-v] [-c disconnect] xsb [xsb...]
deleteboard [[-q] -{y|n}] [-f] [-v] -c unassign xsb [xsb...]
deleteboard [[-q] -{y|n}] [-f] [-v] -c reserve xsb [xsb...]
deleteboard -h
|
TABLE 3-14 Options of the deleteboard Command
Option
|
Description
|
-q
|
Specifies the suppression of output message display.
The -y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.
|
-y
|
Specifies that a response of "yes" is made automatically to output messages.
The -y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.
|
-n
|
Specifies that a response of "no" is made automatically to output messages.
The -y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the-q option) or displayed.
|
-f
|
Forcibly deletes a system board from the domain. This option for normal DR operations must not be used.
|
-v
|
Displays the progress of this DR command.
If the option is specified with the -q option, the -v option is ignored.
|
-h
|
Displays the usage information.
|
-c disconnect
|
Specifies that the command delete a system board from the domain and set it in the status where it is assigned to the domain. This is a default option.
|
-c unassign
|
Deletes the board and adds it to the system board pool.
The command unconfigures and disconnects the system board from the domain. If the board is in the state where it is assigned to the domain, the command unassigns the board from the domain and puts it in the system board pool. Also, if the domain power is off, the command similarly puts the board in the system board pool.
|
-c reserve
|
Reserves the deletion of a system board from a domain. The system board is deleted from the domain and placed in the system board pool when the domain power is turned off or the domain is rebooted.
If the board is in the state where it is assigned to the domain, the command unassigns the board from the domain and places it in the system board pool. Also, if the domain power is off, the command similarly places the board in the system board pool.
|
xsb
|
Specifies the system board (XSB) number of the system board to be deleted.
Specify xsb in the XX-Y format. (XX = 00 to 15, Y = 0 to 3). The value depends on your server. To specify multiple system boards, several XSB numbers can be specified by delimiting each with a space.
|
Note - (Note 1) The time required for system board deletion processing depends on the amount of hardware resources mounted on the target system board. For this reason, much time may be required for the command to end its operation. If the system board contains kernel memory, the OS is suspended for a while.
|
Note - (Note 2) If the DR processing executed by the deleteboard(8) command fails, the target system board cannot be restored to the previous status. If DR processing fails, identify the cause of failure based on the error message output by the deleteboard(8) command and Oracle Solaris OS messages, and then take appropriate corrective action. Note that some errors require the domain to be rebooted.
|
Note - (Note 3) When a system board is forcibly deleted from a domain by the deleteboard(8) command with the -f option specified, a serious problem may occur in a process that is bound to the CPU or in accessing an I/O device. For this reason, you should avoid using the -f option for normal DR operations. When using the deleteboard(8) command with the -f option specified, be sure to check the status of the domain and application processes.
|
Note - (Note 4) You can execute the deleteboard(8) command on a domain that is not running. When the domain is running, the deleteboard(8) command with "-c disconnect" or "-c unassign" will succeed only if the following Oracle Solaris Service Management Facility (SMF) services are active on that domain:
- Domain SP Communication Protocol (dscp)
- Domain Configuration Server (dcs)
- Oracle Sun Cryptographic Key Management Daemon (sckmd)
|
3.1.8 Moving a System Board
Use the moveboard(8) command to delete a system board from the move-source domain and add it to the move-destination domain, assign it to the move-destination domain, or reserve it to be moved later.
To execute the moveboard(8) command, the system board must have been configured in or assigned to the move-source domain, and be registered in the DCL for the move-destination domain.
Use the showdcl(8) command to check whether a system board is registered in the DCL. To register a system board in the DCL, use the setdcl(8) command.
Before executing the moveboard(8) command, check the status of the move-source and move-destination domains and move-target system board, and the device usage status on the system board. You must determine whether you can perform the DR operation according to the status of the domains and system board, and the device usage status on the system board. You must also stop any processes that are bound to the CPU and any that are accessing I/O devices to prepare for system board deletion.
If the system board to be deleted is a kernel memory board, check the status and memory size of the system board to which kernel memory is to be moved.
The following examples show the format and options of the moveboard(8) command.
moveboard [[-q] -{y|n}][-f][-v][-c configure] -d domain_id xsb[xsb...]
moveboard [[-q] -{y|n}][-f][-v] -c assign -d domain_id xsb[xsb...]
moveboard [[-q] -{y|n}][-f][-v] -c reserve -d domain_id xsb[xsb...]
moveboard -h
|
TABLE 3-15 Options of the moveboard Command
Option
|
Description
|
-q
|
Specifies the suppression of output message display.
The -y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.
|
-y
|
Specifies that a response of "yes" is made automatically to output messages.
The -y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.
|
-n
|
Specifies that a response of "no" is made automatically to output messages.
The -y or -n option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.
|
-f
|
Forcibly deletes a system board from the move-source domain and move it to the move-destination domain. This option for normal DR operations must not be used.
A faulty system board, or a system board where a fault is detected will not be forcibly added to the destination domain.
|
-v
|
Displays messages about the progress of this DR operation.
If the option is specified with the -q option, the -v option is ignored.
|
-h
|
Displays the usage information.
|
-c configure
|
Specifies that the command delete a system board from the move-source domain and adds it to the move-destination domain.
If no other -c option is specified, -c configure is the default.
The move operation from the move-source domain is performed when the domain power is off or the Oracle Solaris OS is running in the move-source domain. However, if the domain power is off or the Oracle Solaris OS is not running in the move-destination domain, the move operation from the move-source domain is not performed and DR processing terminates with an error.
|
-c assign
|
Specifies that the command delete a system board from the move-source domain and assign it to the move-destination domain.
The assigned system board is added to the move-destination domain when the addboard(8) command is executed in the move-destination domain, the power of the move-destination domain is turned on, or the move-destination domain is rebooted.
The move operation from the move-source domain is performed and the system board is set to the state where it is assigned to the move-destination domain when the domain power is off in both the move-source domain and the move-destination domain or the Oracle Solaris OS is not running in both domains.
|
-c reserve
|
Specifies that the command reserve a system board move in the move-source domain.
The system board is deleted from the move-source domain and assigned to the move-destination domain when the power of move-source domain is turned off or the move-source domain rebooted. The assigned system board is added to the move-destination domain when the addboard(8) command is executed in the move-destination domain, the power of the move-destination domain is turned on, or the move-destination domain is rebooted.
The move operation from the move-source domain is performed and the system board is set to the state where it is assigned to the move-destination domain when the domain power is off or the Oracle Solaris OS is not running in the move-source domain.
|
-d domain_id
|
Specifies the domain ID of the move-destination domain, where domain_id is the domain number, possibly 0 to 23, depending on your server. Only one domain ID can be specified.
|
xsb
|
Specifies the system board (XSB) number of the system board to be moved.
Specify xsb in the XX-Y format. (XX = 00 to 15, Y = 0 to 3). The value depends on your server. To specify multiple system boards, several XSB numbers can be specified by delimiting each with a space.
|
Note - (Note 1) The time required for system board deletion processing in the move-source domain depends on the amount of hardware resources mounted on the target system board. Moreover, in the system board addition processing in the move-destination domain, the system board to be added is first diagnosed, and then added to the domain. For this reason, much time may be required for the command to end its operation. Oracle Solaris OS is suspended for a while when the system board includes kernel memory.
|
Note - (Note 2) If the DR processing executed by the moveboard(8) command fails, the target system board cannot be restored to the previous status. If DR processing fails, identify the cause of failure based on the error message output by the moveboard(8) command and Oracle Solaris OS messages in the move-source and move-destination domains, and then take appropriate corrective action. Note that some errors require one of the domains to be rebooted.
|
Note - (Note 3) When a system board is forcibly deleted from the move-source domain by the moveboard(8) command with the -f option specified, a serious problem may occur in a process that is bound to the CPU or in accessing an I/O device. For this reason, you should avoid using the -f option for normal DR operations. When using the moveboard(8) command with the -f option specified, be sure to check the status of the move-source domain and application processes.
|
Note - (Note 4) You can execute the moveboard(8) command on a source domain or a destination domain that is not running. When the source domain is running, the moveboard(8) command with "-c configure" or "-c assign" will succeed only if the following Oracle Solaris Service Management Facility (SMF) services are active on that domain:
- Domain SP Communication Protocol (dscp)
- Domain Configuration Server (dcs)
- Oracle Sun Cryptographic Key Management Daemon (sckmd)
|
3.1.9 Replacing a System Board
Use the deleteboard(8) and addboard(8) commands to replace a system board. Use them to replace, add, or delete such hardware resources as the CPU, memory, and I/O devices, or replace the PSB of a CMU or IOU.
Note - In a midrange server, you cannot use DR commands to replace a system board. Instead, turn off the power of all domains, and then replace the target system board.
|
To replace a system board in a domain, first delete the target system board from the domain by using the deleteboard(8) command to make the PSB replaceable. Next, replace the PSB with a new one, and then add the target system board to the domain.
For details of the conditions and actions for executing the deleteboard(8) command, see Deleting a System Board. For details of the conditions and actions for executing the addboard(8) command, see Adding a System Board.
Note - (Note 1) Before replacing a system board, you must know the division type of the replacement-target PSB and the configurations and operation status of all domains to which all XSBs on the PSB belong.
If the division type of the replacement-target PSB is Quad-XSB and the XSBs on the replacement-target PSB belong to multiple domains, you must consult with all administrators of the relevant domains in advance to adequately adjust the method of replacing the system board.
If the division type of the replacement-target PSB is Uni-XSB, its replacement does not affect any other domains. However, prior adjustment may be required when the replacement-target system board is used as a floating board for multiple domains or hardware replacement work may affect other domains
|
Note - (Note 2) If the DR processing executed by the deleteboard(8) or addboard(8) commands fails, the target system board cannot be restored its the previous status. Identify the cause of failure based on the error messages output by the commands and Oracle Solaris OS messages, and then take appropriate corrective action. Note that some errors require the domain to be rebooted.
|
Note - (Note 3) If a system board is forcibly deleted from a domain by the deleteboard(8) command with the -f option specified, a serious problem may occur in a process bound to the CPU or accessing an I/O device. For this reason, you should avoid using the -f option in normal DR operations. If you must use the deleteboard(8) command with the -f option specified, be sure to check the status of the domain and application processes before and after execution.
|
Note - (Note 4) To execute the addboard(8) command to add a system board by DR, the system board must already be registered in DCL. Use the showdcl(8) command to check whether a system board is registered in the DCL. To register a system board in the DCL, use the setdcl(8) command.
|
To replace hardware, you must set the system board to the state where it is assigned to the domain or to the state where it is placed in the system board pool by using the deleteboard(8) command.
3.1.10 Reserving a Domain Configuration Change
Use the addboard(8), deleteboard(8), or moveboard(8) command to reserve a domain configuration change.
A domain configuration change is reserved when a system board cannot be added, deleted, or moved immediately for operational reasons. The reserved addition, deletion, or move of the system board is executed when the power of the target domain is turned on or off, or the domain rebooted.
If a system board is placed in the system board pool, a domain configuration change can be reserved to assign the system board to the intended domain in advance, preventing the system board from being acquired by another domain.
To reserve the addition of a system board to a domain, use the addboard(8) command with the -c reserve option specified. The system board will be added to the domain when the domain power is turned on, the domain is rebooted, or the next time the addboard(8) command with the -c configure option specified is executed.
For details about the addboard(8) command, see Adding a System Board.
To reserve the deletion of a system board from a domain, use the deleteboard(8) command with the -c reserve option specified. The system board will be deleted from the domain when the domain power is turned off, the domain is rebooted, or the next time the deleteboard(8) command with the -c disconnect or -c unassign option specified is executed. For details about the deleteboard(8) command, see Deleting a System Board.
To reserve a system board move in a domain to another domain, use the moveboard(8) command with the -c reserve option specified. The system board will be deleted from the move-source domain and moved to the move-destination domain when the power of the move-source domain is turned off, the move-destination domain is rebooted, or the next time the moveboard(8) command with the -c configure or -c assign option specified is executed.
For details about the moveboard(8) command, see Moving a System Board.
3.2 Command Reference
This section lists the DR commands and other commands related to DR.
For details of the commands, see the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual. For the DR commands, see How To Use the DR User Interface.
Note - (Note 1) Use of each command is restricted to selected administrators only. To use each command, you must have appropriate administrator privileges. For details, see the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual.
|
Note - (Note 2) This section does not list all commands related to DR. For other DR-related commands, see the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF Reference Manual.
|
TABLE 3-16 DR Display Commands
Command name
|
Function
|
showdcl
|
Displays the DCL and the domain status.
|
showdomainstatus
|
Displays domain status.
|
showboards
|
Displays system board information.
|
showdevices
|
Displays information about the CPUs, memory, and I/O devices on system boards.
|
showfru
|
Displays PSB configuration information.
|
TABLE 3-17 DR Operation Commands
Command name
|
Function
|
setdcl
|
Updates and edits the DCL.
|
setupfru
|
Sets the division type and memory mirror mode for PSB.
|
addboard
|
Adds a system board into a domain.
|
deleteboard
|
Deletes a system board from a domain.
|
moveboard
|
Moves a system board between domains.
|
TABLE 3-18 DR-related Commands
Command name
|
Function
|
poweron
|
Turns on the power of all domains or a specified domain.
|
poweroff
|
Turns off the power of all domains or a specified domain.
|
setdscp
|
Configures DSCP network.
|
showdscp
|
Displays the DSCP network configuration.
|
addfru
|
Installs a Field Replaceable Unit (FRU).
|
deletefru
|
Removes a Field Replaceable Unit (FRU).
|
replacefru
|
Replaces a Field Replaceable Unit (FRU).
|
showhardconf
|
Displays all components mounted in the server.
|
showstatus
|
Lists degraded components.
|
showlog
|
Displays an error log, power log, event log, console log, panic log, IPL log, temperature/humidity log, and monitoring message log.
|
3.3 XSCF Web
XSCF Web lets you execute DR functions from a browser. XSCF Web is beyond the scope of this document. For details, see the SPARC Enterprise M3000/M4000/M5000/M8000/M9000 Servers XSCF User’s Guide.
3.4 RCM Script
Reconfiguration Coordination Manager (RCM) is a framework used to manage the dynamic disconnection of system components. RCM provides script functions that enable you to write your own scripts for dynamic reconfiguration.
Using RCM scripts enables you to avoid complicated DR operations (e.g., stopping applications and releasing devices from applications).
For details of how to register RCM scripts and script execution timing, see the Oracle Solaris man page for rcmscript(4).
Note - (Note 1) An RCM script can only automate actions performed to prepare for the deletion of a system board. When a system board is added to a domain, any actions required for use of the added resources must be manually performed.
|
Note - (Note 2) You should test the RCM scripts you create for DR before executing the DR operations. The RCM scripts may not be able to execute certain processing.
|
SPARC Enterprise M4000/M5000/M8000/M9000 Servers Dynamic Reconfiguration (DR) User’s Guide
|
821-2796-11
|
|
Copyright © 2010, Oracle and/or its affiliates. All rights reserved.