User Rights Assignment Shutdown The System Of Doctor

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.


Command name

Function

Display the DCL and domain status.

Display domain status.

Display system board information.

Display information about the CPUs, memory, and I/O devices on system boards.

Display PSB configuration information.



Command name

Function

Update and edit the DCL.

Set the division type and memory mirror mode for a PSB.

Add a system board to a domain.

Delete a system board from a domain.

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 (8) command displays domain information including the domain ID, configured system board numbers, and domain status in list format.

The (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 (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 (8) command. To change PSB settings, use the (8) command.

The following examples show the format and specifiable options of the (8) command.


domain_id


Option

Description

Displays configuration information and status of all domains.

Displays detailed domain configuration information.

Displays usage information.

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:

.



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 (8) command.

The following shows examples of displays by the (8) command.

  • Example 1: Display of information on domain #0

  • XSCF> 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

  • 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 (8) command lists the domains in the system and their status. This command displays the same domain status information as the (8) command.

Use the (8) command to check domain status before and after a DR operation.

The following examples show the format and options of the (8) command:


domain_id


Option

Description

Displays the status of all domains.

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.

Displays usage information.


The table below lists the items displayed by the (8) command.


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 ( 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 (8) command.

  • Example: Display of information on all domains

  • XSCF> DID Domain Status 00 Running 01 Powered Off 02 - 03 Running

3.1.3 Displaying System Board Information

The (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 (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 (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 (8) command. To change PSB settings, use the (8) command.

The following examples show the format and options of the (8) command.


showboards [-v] -a [-c sp] showboards [-v] -d domain _id [-c sp] showboards [-v] xsbshowboards -h


Option

Description

Displays detailed information about the system board.

Displays information about all mounted system boards.

Displays the usage information.

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.

Displays information about system boards in system board pool.


The table below lists the items displayed by the (8) command.


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 (8) command

  • Example 1: Display of information on all system boards

  • XSCF> 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> 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> 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 (8) command to display device information.

The (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 (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 (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 (8) command.


showdevices [-v] [-p bydevice|byboard|query|force] xsbshowdevices [-v] [-p bydevice|byboard] -d domain_idshowdevices -h



Note - The (8) command only reports information about a running domain.




Note - (Note 2) The (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).


 


Option

Description

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.

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.

Specifies that the command display information about the devices mounted on system boards (CPU, memory, and I/O devices) by system board.

Tests the detachability of the board by test-running the DR command without actually executing it.

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.

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.



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 (8) command.

  • Example: Display of device information on XSB00-0

  • XSCF> 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 (8) command to display system board configuration information.
The (8) command displays information about the PSB division type and memory mirroring mode settings in list format.

To change the PSB configuration, use the (8) command.

The following examples show the format and options of the (8) command.


showfru -a deviceshowfru device locationshowfru -h


Option

Description

Specifies that the command display all configuration information on devices of the type specified by devtype.

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 (8) command.


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 (8) command.

  • Example: Display of configuration information on all system boards

  • XSCF> 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 (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 (8) command to check whether a system board is registered in the DCL. To register a system board in the DCL, use the (8) command.

Before executing the (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 (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


Option

Description

Specifies the suppression of output message display.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the option) or displayed.

Specifies that a response of "yes" is made automatically to all output messages.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the option) or displayed.

Specifies that a response of "no" is made automatically to all output messages.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the option) or displayed.

 

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.

Displays the progress of this DR command.

If the option is specified with the option, the option is ignored.

Displays the usage information.

Specifies that the command add a system board to the domain. If no other option is specified, is the default.

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 (8) command with the option specified is executed, and then the domain power is turned on or the domain rebooted.

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 option, and it assigns the target system board to the domain. The assigned system board is added to the domain when the (8) command with the option specified is executed, and then the domain power is turned on or the domain is rebooted.

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 (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 (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 (8) command with the option specified, normal operation of all added hardware resources may be disabled. For this reason, you should avoid using the option for normal DR operations. After adding a system board by using the (8) command with the 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 (8) command on a domain that is not running. When the domain is running, the (8) command with "" 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 (8) command to delete a system board from a domain and assign it to the system board pool. If you specify the option, the action takes place the next time the domain is powered off or rebooted.

Before executing the (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 (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


Option

Description

Specifies the suppression of output message display.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the option) or displayed.

Specifies that a response of "yes" is made automatically to output messages.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the option) or displayed.

Specifies that a response of "no" is made automatically to output messages.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the option) or displayed.

Forcibly deletes a system board from the domain. This option for normal DR operations must not be used.

Displays the progress of this DR command.

If the option is specified with the option, the option is ignored.

Displays the usage information.

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.

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.

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 (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 (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 (8) command with the 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 option for normal DR operations. When using the (8) command with the option specified, be sure to check the status of the domain and application processes.




Note - (Note 4) You can execute the (8) command on a domain that is not running. When the domain is running, the (8) command with "" or "" 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 (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 (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 (8) command to check whether a system board is registered in the DCL. To register a system board in the DCL, use the (8) command.

Before executing the (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 (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_idxsb[xsb...] moveboard [[-q] -{y|n}][-f][-v] -c reserve -d domain_idxsb[xsb...] moveboard -h


Option

Description

Specifies the suppression of output message display.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.

Specifies that a response of "yes" is made automatically to output messages.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.

Specifies that a response of "no" is made automatically to output messages.

The or option determines how output messages are automatically answered, whether or not the messages themselves are suppressed (with the -q option) or displayed.

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.

Displays messages about the progress of this DR operation.

Computer Configuration\Windows Settings\Security Settings\Local Policies\User Rights Assignment

Description

Determines which users logged on locally to the computer can shut down the operating system using the Shut Down command.

This user right is defined in the Default Domain Controller Group Policy object (GPO) and in the local security policy of workstations and servers.

The default groups that have this right on each platform are:

  • Workstations and Servers

    • Administrators

    • Backup Operators

    • Power Users

    • Users

  • Domain Controllers

    • Account Operators

    • Administrators

    • Backup Operators

    • Server Operators

    • Print Operators

Related Policies

Top Of Page

One thought on “User Rights Assignment Shutdown The System Of Doctor

Leave a Reply

Your email address will not be published. Required fields are marked *