Sun Microsystems, Inc.
   www.sun.com docs.sun.com | | |  
   
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_id|domain_tag param=value ...
 setobpparams -h

DESCRIPTION

 

setobpparams(1M) allows 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 routine system administration. For more information refer to Chapter 4 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems.

OPTIONS

 

The following options are supported.

-d domain_id
ID for a domain. Valid domain_ids are 'A'...'R' and are case insensitive.
-d 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?
  • auto-boot?
  • fcode-debug?
  • use-nvramrc?
  • security-mode

Valid variable values for all but security mode are:

  • true
  • false

Valid variable values for security mode are:

  • none
  • command
  • full

where:

none - No password required (default)

command - All commands except for boot(1M) and go require the password

full - 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 shells require using single quotes around the variable values to prevent the '?' from being treated as a special character. See the examples below.

EXTENDED DESCRIPTION

 

Group Privileges Required

 

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

Refer to Chapter 2 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.

EXAMPLES

 Example 1. Setting OpenBoot PROM Variable diag-switch 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.2Go To TopLast Changed 22 April 2002

 
      
      
Copyright 2002 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA. All rights reserved.