Skip to main content

6.2.2 Example of System Board Incorporation


6.2.2 Example of System Board Incorporation
If the physical partition to which a system board (PSB) is added is in the operation state, use the addboard command with the -c configure option specified to incorporate the PSB into the physical partition.

When the addboard command is executed, the PSB registered in the physical partition configuration information (PPAR configuration information) or the PSB assigned to the physical partition by the -c assign option is incorporated into the physical partition. At this time, the physical partition needs to be powered on, and the control domain needs to be operating.

When you incorporate a PSB into a physical partition, you can specify whether to enable the automatic assignment function of the added resources of the PSB to be incorporated.
- Without the -m option specified or with -m bind=resource specified
If resources have been deleted with the deleteboard command before execution of the addboard command, the resource assignment that existed before executing the deleteboard command can be recovered. However, if the logical domain configuration is changed before executing the addboard command, the resulting resource assignment is in accordance with the logical domain configuration information. Suppose that the logical domain configuration information of the physical partition is factory-default. Then the resources added with the PSB will be assigned to the control domain.

- With -m bind=none specified
The resources added with the PSB will be free resources of the physical partition.
Note - The command with the -c configure option specified cannot incorporate a PSB into a physical partition where the PPAR DR function is disabled.
Note - In PSB incorporation using the addboard command, the target PSB is incorporated into the physical partition after the hardware diagnosis of the PSB is completed. For this reason, it may take some time before the command finishes.
The operation example of the SPARC M10-4S presented here uses XSCF shell commands and the ldm command of Logical Domains Manager, which is management software of Oracle VM Server for SPARC. The same operations are also used for the SPARC M12-2S.

  1. Log in to the XSCF.
  2. When you add a PSB for system expansion, use the addfru command to incorporate SPARC M10-4S into the system.
Note - For details of system expansion, see "Chapter 9 Expanding a System with a Building Block Configuration" in the Installation Guide of your server.
  1. Execute the showpcl command to check the current physical partition configuration information (PPAR configuration information).
XSCF> showpcl -p 0
PPAR-ID LSB PSB Status
00 Running
00 00-0
  1. Execute the setpcl command to register the PSB in the PPAR configuration information.
    In the following example, PSB 01-0 is mapped to logical system board (LSB 1) of physical partition 0.
XSCF> setpcl -p 0 -a 1=01-0
  1. Execute the showpcl command to check the PPAR configuration information that has been set.
XSCF> showpcl -p 0
PPAR-ID LSB PSB Status
00 Running
00 00-0
01 01-0
  1. Connect to the control domain console of the physical partition.
  2. Execute the ldm list-domain command to check the operation status of the logical domain.
  1. The following example shows the control domain and three guest domains in operation.
# ldm list-domain
NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME
primary active -n-cv- UART 14 8G 64% 2h 54m
guest0 active -n---- 5000 16 8G 42% 2h 54m
guest1 active -n---- 5001 16 8G 11% 2h 54m
guest2 active -n---- 5002 16 8G 7.3% 2h 54m
  1. Return to the XSCF shell, and execute the showcodusage command to display information on the CPU core resources.
    The following example displays the CPU core resource information.
    As shown here, the system has 128 mounted CPU core resources and 128 registered CPU Activations, 64 of the CPU core resources are in use, and the number of CPU Activations currently not in use is 64.
XSCF> showcodusage -p resource
Resource In Use Installed CoD Permitted Status
-------- ------ --------- ------------- ------

PROC 64 128 128 OK: 64 cores available

Note:
Please confirm the value of the "In Use" by the ldm command of Oracle VM Server for SPARC.

The XSCF may take up to 20 minutes to reflect the "In Use" of logical domains.
Note - If the number of registered CPU Activations is not enough for the number of CPUs to be used, purchase CPU Activations and add the CPU Activation keys. For details on how to add a CPU Activation key, see "Chapter 5 CPU Activation" in the Fujitsu SPARC M12 and Fujitsu M10/SPARC M10 System Operation and Administration Guide.
  1. Execute the setcod command to assign the CPU core resources to the physical partitions.
  1. The following example adds 64 CPU core resources to physical partition 0.
XSCF> setcod -p 0 -s cpu -c add 64
PROC Permits assigned for PPAR 0 :64 -> 128

PROC Permits assigned for PPAR will be changed.
Continue? [y|n] :y

Completed.
Note - XSCF firmware of versions XCP 2250 and earlier do not support the -c add, -c delete, and -c set options. Specify the options of the setcod command as shown below to interactively add and delete CPU core resources.
XSCF> setcod -s cpu
  1. Execute the showboards command to check the PSB status.
  1. The following example shows that PSB 01-0 is in the system board pool state.
XSCF> showboards -p 0
PSB PPAR-ID(LSB) Assignment Pwr Conn Conf Test Fault
---- ------------ ----------- ---- ---- ---- ------- --------

00-0 00(00) Assigned y y y Passed Normal
01-0 SP Available n n n Passed Normal
  1. Execute the addboard command with the -c configure option specified to incorporate the PSB into the physical partition.
  1. In the following example, PSB 01-0 is incorporated into physical partition 0.
XSCF> addboard -c configure -p 0 01-0
PSB#01-0 will be configured into PPAR-ID 0. Continue?[y|n] :y
Start connecting PSB to PPAR. [3600sec]
0..... 30..... 60..... 90.....120.....150.....180.....210.....240.....
270.....300.....330.....360.....390.....420.....450.....480.....510.....

540.....570.....600.....630.....660.....690.....720.....750.....780.....

810.....840.....870.....900.....930.....960.....end

Connected PSB to PPAR.
Start configuring PSB to Logical Domains (LDoms) Manager. [1800sec]
0.....end

Configured PSB to Logical Domains (LDoms) Manager.
Operation has completed.
  1. Execute the showresult command to check the exit status of the addboard command just executed.
  1. In the following example, exit status of 0 is returned, indicating normal termination of the addboard command.
XSCF> showresult
0
  1. Execute the showboards command to check the PSB status.
  1. The next example shows "y" in the [Conn] and [Conf] columns for PSB 01-0, indicating that the PSB has been added correctly.
XSCF> showboards -p 0
PSB PPAR-ID(LSB) Assignment Pwr Conn Conf Test Fault
---- ------------ ----------- ---- ---- ---- ------- --------

00-0 00(00) Assigned y y y Passed Normal
01-0 00(01) Assigned y y y Passed Normal
  1. Execute the ldm list-domain command on the control domain console of the physical partition to confirm that the operation status of the logical domain has not changed after the addition of the PSB.
  1. Assign the physical partition resources in the logical domain to reconfigure the logical domain.