Skip to main content

8.13.2 Commands Used With the Hypervisor Dump Function


8.13.2 Commands Used With the Hypervisor Dump Function
Enabling/Disabling Hypervisor Dump
Use the ldm set-hvdump command of Oracle VM Server for SPARC to configure Hypervisor dump.
primary# ldm set-hvdump [hvdump=on|off] [hvdump-reboot=on|off]
For hvdump, specify whether to enable the Hypervisor dump function. To enable it, specify on. To disable it, specify off. The default is enabled (on).
For hvdump-reboot, specify whether to automatically restart the physical partition after dump file collection. To restart the physical partition, specify on. To not restart it, specify off. The default value is off. If the value is set to off, even after a dump file is collected, the control domain remains in the special factory-default configuration to collect a Hypervisor dump.
If you change the hvdump and hvdump-reboot settings by the ldm set-hvdump command, use the ldm add-spconfig command to save the configuration information.
primary# ldm add-spconfig file
Note - Even if you restart the control domain started in a special factory-default configuration to collect a Hypervisor dump, the system does not return to the original configuration. To start the system in the original configuration, you need to restart the physical partition. After executing the poweroff command of the XSCF or the shutdown -i5 command of Oracle Solaris, execute the poweron command of the XSCF to restart the system.
Note - Even when the hvdump-reboot setting is on, if a dump file is not collected because eight dump files are already collected or the disk is running out of space, the physical partition cannot be restarted. In such cases, move or delete a collected dump file first. Then, use the ldm start-hvdump command to collect a dump file. After the dump file collection completed, restart the physical partition.
Displaying the Contents of the Hypervisor Dump Settings
Use the ldm list-hvdump command to display the contents of the Hypervisor dump settings.
primary# ldm list-hvdump
The following information is displayed when the ldm list-hvdump command is executed.
Table 8-5  Content Displayed by the ldm list-hvdump Command
Item Description
hvdump Whether the Hypervisor dump function is enabled. If enabled, on is displayed. If disabled, off is displayed.
hvdump-reboot Whether to restart the system after dump file creation. If it will be restarted, on is displayed. If it will not be restarted, off is displayed.
Note - If dump file collection did not end normally, "Pending hvdump exists" message is displayed.
Operation Procedure
  1. Switch from the XSCF console to the target control domain console.
    For details on how to switch to the control domain console, see "8.3 Switching to the Control Domain Console From the XSCF Shell."
    If you have already switched to the control domain console or to the XSCF, go to the next step.
  2. Configure the Hypervisor dump function.
    The following example enables the Hypervisor dump function and sets the control domain to restart after dump file collection.
primary# ldm set-hvdump hvdump=on hvdump-reboot=on
  1. Display the settings made for the Hypervisor dump function.
    The following example shows that the Hypervisor dump function is enabled and that restart after dump file collection is enabled.
primary# ldm list-hvdump
hvdump=on
hvdump-reboot=on
  1. Save the settings made for the Hypervisor dump function.
    Designate and save a file name in config_name in the following example.
primary# ldm add-spconfig config_name