Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
System Administrationsetobpparams(1m)


NAME

 setobpparams - set up OpenBoot PROM variables for a domain

SYNOPSIS

 setobpparams -d domain_indicator param=value ...
 setobpparams -h

DESCRIPTION

 

setobpparams(1M) enables a domain administrator to set the virtual NVRAM and REBOOT variables passed to OpenBoot PROM by setkeyswitch(1M). The -d option with domain_id or a domain_tag is required. You must reboot the domain in order for any changes to take effect.

This command is intended for error recovery and not for routine system administration. For more information refer to Chapter 4, "SMS Configuration," in the System Management Services (SMS) 1.4 Administrator Guide.

OPTIONS

 

The following options are supported:

-d domain_indicator
Specifies the domain using one of the following:

domain_id - ID for a domain. Valid domain_ids are A-R and are not case sensitive.

domain_tag - Name assigned to a domain using addtag(1M).

-h
Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.

OPERANDS

 

The following operands are supported:

param=value
NVRAM and REBOOT variable values for OpenBoot PROM. Valid variables are:
  • diag-switch?

    Default value= false

    When set to false, the default boot device is specified by boot-device and the default boot file by boot-file.

    When set to true, OpenBoot PROM runs in diagnostic mode and you need to set either diag-device or diag-file to specify the correct default boot device or file. These default boot device and file settings cannot be set using setobpparams. Use setenv(1) in OpenBoot PROM.

  • auto-boot?

    Default value= false

    When set to true, the domain boots automatically after power-on or reset-all. The boot device and boot file used are based on the settings for diag-switch (see above). Neither boot-device nor boot-file can be set using setobpparams. In the event the OK prompt is unavailable, such as a repeated panic, use setobpparams to set auto-boot? to false.

    When the auto-boot? variable is set to false using setobpparams, the reboot variables are invalidated, the system will not boot automatically and will stop in OpenBoot PROM where new NVRAM variables can be set.

  • fcode-debug?

    Default value= false

    When set to true, this variable includes name fields for plug-in device FCodes.

  • use-nvramrc?

    Default value= false

    When set to true, this variable executes commands in NVRAMRC during system start-up.

  • security-mode

    Default value= none

    Firmware security level.

Valid variable values for all but security mode are:
  • true
  • false

Valid variable values for security mode are:

  • none
  • command
  • full

where:

none - Means that no password is required (default)

command - Means that all commands except boot(1M) and go require the password.

full - Means that all commands except for go require the password.

Note – It is important to remember your security password and to set the security password before setting the security mode. If you forget this password, you cannot use your system; you must call your vendor's customer support service to make your system bootable again. For more information on security-mode and other OpenBoot PROM variables, see the OpenBoot 4.x Command Reference Manual.

Note – Most, but not all, shells require single quotes around the variable values to prevent the question mark from being treated as a special character. See Example 1.

EXTENDED DESCRIPTION

 

Group Privileges Required

 

Domain administrator or configurator privileges for the specified domain are required.

Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4 Administrator Guide for more information.

EXAMPLES

 Example 1. Setting OpenBoot PROM Variable diag-switch to On for Domain A
 
 
sc0:sms-user:> setobpparams -d a 'diag-switch?=true'
Example 2. Setting OpenBoot PROM Variable security-mode to Full for Domain A
 
 
sc0:sms-user:> setobpparams -d a security-mode=full

EXIT STATUS

 

The following exit values are returned:

0
Successful completion.
>0
An error occurred.

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes.

Attribute TypesAttribute Values
AvailabilitySUNWSMSop

SEE ALSO

 

addtag(1m), setkeyswitch(1m), showobpparams(1m)


SMS 1.4Go To TopLast Changed 19 September 2003