|
System Administration | setbus(1m) |
| setbus - perform dynamic bus reconfiguration
on active expanders in a domain |
SYNOPSIS
| setbus [-q] [-y|-n] -c CS0|CS1|CS0,CS1 [-b buses] [location ...] |
|
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 can allow you to swap out a CSB without having to power off the system.
|
| Note The -y and -n are optional arguments to the setbus(1M) command. If one of these optional arguments is not provided, setbus prompts the user with a confirmation message.Note If changing the configuration on the chosen expander will require changing the configuration on additional expanders, setbus displays the following message:
|
The expander board in position location communicates with expanders not already listed, and will be added to the list of boards to reconfigure.
|
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 CS0|CS1|CS0,CS1
- 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 all prompts. Prompts are displayed unless used with the -q option.
- -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 all prompts. Prompts are displayed unless used with the -q option.
|
|
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)
|
|
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 in the System Management Services (SMS) 1.2 Administrator Guide for the Sun Fire 15K/12K Systems for more information.
|
|
| Example 1. Set All Buses on All Active Domains to Use CS0
|
|
sc0:sms-user:> setbus -c CS0
|
|
Example 2. Set All Buses on All Active Domains to Use Both CSBs
|
|
sc0:sms-user:> setbus -c CS0,CS1
|
|
Example 3. Set Address Bus on All Active Domains to Use CS0
|
|
sc0:sms-user:> setbus -c CS0 -b a
|
|
Example 4. Set Address and Data Buses on Active EX1 to Use CS1
|
|
sc0:sms-user:> setbus -c CS1 -b ad EX1
|
|
|
|
The following exit values are returned:
-
0
- Successful completion
- >0
- An error occurred.
|
|
See attributes(5) for descriptions of the following attributes:
Attribute Types | Attribute Values |
Availability | SUNWSMSop |
|
| |