Contents
OpenBoot Console Overview
The Charon-SSP SPARC virtual machines use a subset of the Sun OpenBoot console found on native Sun workstations and servers. The figure below shows the initial console screen at boot on a virtual SPARCstation 20.
|
OpenBoot Console Command Reference
The following sections describe the currently supported console commands.
banner
Display power-on banner.
Syntax
banner
Description
Use this command to display the power-on banner.
Example
The following example demonstrates the output of the banner command on Charon-SSP configured as a SPARCstation 20.
ok banner
|
boot
Load operating system.
Syntax
boot [ device-alias ] [ boot-args ]
Description
This command boots the specified device-alias passing any optional boot-args to the kernel. The boot-args must be recognized as valid by the Solaris kernel used. Booting from a ZFS disk is supported starting with Charon-SSP version 1.4.1 if the Solaris version supports this feature.
Starting from Charon-SSP version 2.0.5 there is a special boot argument when booting from CD-ROM:
boot cdrom -slow=<sec>
This parameter should only be used if there are problems when booting from ISO files resulting in a BAD TRAP error. This seems to happen quite frequently with Solaris 7 installation ISOs.
For more information about device aliases, see the devalias command.
Example
The following example demonstrates the output of the boot command on Charon-SSP configured as a SPARCstation 20 and booting SunOS 4.1.4 from CD-ROM.
ok boot cdrom
|
devalias
Display device aliases.
Syntax
devalias
Description
These commands display the current device aliases. This shows the link between the aliases, such as cdrom and the devices shown in the device tree, listed by show-devs.
Example
The following example demonstrates the output of the devalias command.
|
help
Display OpenBoot console help.
Syntax
help [ command ]
Description
Use this command to display the list of commands supported by the OpenBoot console. For brief help on individual commands specify the command parameter.
Example
|
history
Display console command history.
Syntax
history
Description
This command displays a list of all commands previously entered at the OpenBoot Console.
Example
The following example demonstrates the output of the history command.
|
nvalias
Stores devalias values in nvramrc.
Syntax
nvalias <alias> <device-path>
Description
Stores the device aliases in in NVRAMRC. The alias persists until the nvunalias or set-defaults command is executed.
Example
The following example demonstrates the use of the nvalias command to create and store a device alias named disk3 that represents a SCSI disk with a target ID of 3 on a SPARCstation 10 system
ok nvalias disk3 /pci@1f,0/pci@1,1/ide@3/disk@3,0 |
nvunalias
Removes a device alias from NVRAMRC.
Syntax
nvunalias <alias>
Description
Deletes the corresponding alias from NVRAMRC.
printenv
Display environment variables.
Syntax
printenv
Description
Use this command to print the current and default values of OpenBoot console variables.
Example
The following examples illustrate the output of the printenv command on Charon-SSP/4U.
|
probe-scsi
Scan SCSI bus for attached devices.
Syntax
probe-scsi
Description
This command scans the SCSI bus to locate attached devices.
Example
The following example demonstrates the output of the probe-scsi command on system with a single virtual CD-ROM.
|
quit or poweroff
Turn off virtual machine.
Syntax
quit | poweroff
Description
Use this command to shut down the virtual machine.
reset
Restart the system.
Syntax
reset
Description
This command restarts the SPARC virtual machine.
setenv
Set console environment variables.
Syntax
setenv variable value
setenv variable --
Description
This command sets a console configuration variable to a specific value. The current and default values of the variables are shown by the printenv command. To restore a variable to its default value, specify ‘--‘ in place of the value. For a complete list of possible variable names and their descriptions, see the list below.
- auto-boot? - If true, boots automatically after power on or reset.
local-mac-address? - If true, the MAC address of the network card is used instead of the system MAC address.
output-device - Output device used at power-on
input-device - Input device used at power-on.
boot-device - Space delimited list of devices to define boot attempt sequence.
boot-file - A string of arguments to be passed to the boot loader (e.g. -a or -v).
ttya-mode - Serial line configuration for ttya
ttyb-mode - Serial line configuration for ttyb
diag-file - Diagnostic mode boot arguments.
diag-device - Diagnostic startup source device.
diag-switch? - Indicates if system should run in diagnostics mode.
Changes to environment variables are stored in NVRAM and are permanent. However, they only take effect after executing the reset command.
Example
The following example illustrates the use of the setenv command.
|
show-devs
Display device tree.
Syntax
show-devs
Description
This command displays the tree of devices visible from the console.
Example
The following example demonstrates the output of the show-devs command.
ok show-devs
|