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 Administrationsetbus(1m)


NAME

 setbus - perform dynamic bus reconfiguration on active expanders in a domain

SYNOPSIS

 setbus [-q] [-y|-n] -c csb [-b buses] [location ...]
 setbus -h

DESCRIPTION

 

setbus(1M) dynamically reconfigures bus traffic on active expanders in a domain to use either one centerplane support board (CSB) or both. Using both CSBs is considered normal mode. Using one CSB is considered degraded mode.

This feature enables you to swap out a CSB without having to power off the system.

OPTIONS

 

The -y and -n are optional arguments that take effect only if the setbus command displays a confirmation message such as the one shown below. The -y argument supplies an automatic affirmative response to the confirmation message. The -n argument supplies an automatic negative response.

If changing the configuration on the chosen expander requires changing the configuration on additional expanders, setbus displays the following prompt:
 
The expander board in position location communicates with expanders not already listed, and will be added to the list of boards to reconfigure.
Are you sure you want to continue the reconfiguration? (yes/no)?

Additionally, setbus resets any boards that are powered on but not active. Any attach-ready state is lost. To bring the boards back to an attach-ready state refer to the System Management Services (SMS) 1.4 Dynamic Reconfiguration User Guide.

Note – If you have degraded all expanders to one CSB you cannot un-degrade a single expander; you must set them all at the same time, otherwise setbus fails.

The following options are supported

-b buses
Specifies which buses to configure. There are three buses to configure. Valid buses are:
a
Configures the address bus.
d
Configures the data bus.
r
Configures the response bus.

The default is to configure all three buses.

-c csb
Specifies which CSB(s) to use.
CS0
Configures the hardware to use CS0 (degraded mode).
CS1
Configures the hardware to use CS1 (degraded mode).
CS0,CS1
Configures the hardware to use both CSBs (normal mode).
-h
Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.
-n
Automatically answers no to any prompt displayed by the setbus command.
-q
Quiet. Suppresses all messages to stdout including prompts.

When used alone -q defaults to the -n option for all prompts.

When used with either the -y or the -n option, -q suppresses all user prompts and automatically answers with either 'y' or 'n' based on the option chosen.

-y
Automatically answers yes to any prompt displayed by the setbus command.

OPERANDS

 

The following operands are supported:

location
Specifies which expander slots to configure. The default is to configure all. Multiple locations are separated by spaces.

Valid locations are:

Sun Fire 15K, Sun Fire 12K

EX(0...17), EX(0...8)

EXTENDED DESCRIPTION

 

Group Privileges Required

 

You must have platform administrator privileges to reconfigure any set of communicating expanders (SOCX) in the system.

Domain administrators or configurators can reconfigure only the SOCX assigned to the domain(s) in which they have privileges.

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 All Buses on All Active Domains to Use CS0
 

This example displays setbus output when there are inactive boards powered on in one or more of the domains.

 
sc0:sms-user:> setbus -c CS0
The following boards are powered on but are not active in a domain:
SB13
IO9 assigned to domain J
IO16 assigned to domain Q
SB17
These boards will be reset, and any attach-ready state will be lost.
Example 2. Setting All Buses on All Active Domains to Use Both CSBs
 
 
sc0:sms-user:> setbus -c CS0,CS1
Example 3. Setting Address Bus on All Domains to Use CS0
 
 
sc0:sms-user:> setbus -c CS0 -b a
Example 4. Setting Address and Data Buses on Active EX1 to Use CS1
 
 
sc0:sms-user:> setbus -c CS1 -b ad EX1

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

 

showbus(1m)


SMS 1.4Go To TopLast Changed 19 September 2003