C H A P T E R  3

DR User Interface

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.



Note - If your server is configured with SPARC64 VII processors, some restrictions regarding DR might apply. Please see SPARC64 VII+, SPARC64 VII, and SPARC64 VI Processors and CPU Operational Modes.


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.

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.

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

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.

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.

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.