![](../graphics/a.gif) |
|
|
System Administration | deleteboard(1m) |
| deleteboard - unconfigure, disconnect,
and unassign a system board from a domain |
SYNOPSIS
| deleteboard [-c function] [-r retry_count [-t timeout] ] [-q ] [-f ] [-y|-n ] location ... |
|
deleteboard(1M) removes a location from the domain it is currently assigned to and possibly active in. The board at that location must be in either the assigned or connected|configured states. The -c option is used to specify the transition of the board from the current configuration state to the new configuration state.
Configuration states are unconfigure, disconnect, and unassign. If the -c option is not specified, the default expected configuration state is unassign.
A domain administrator can unconfigure and disconnect a board but cannot unassign a board from a domain unless the board is in the domain available component list. See setupplatform(1M). This means the deleteboard location field must appear in the domain available component list list.
|
|
The following options are supported.
Note If the deleteboard command fails, a board does not return to its original state. A dxs or dca error message is logged to the domain. If the error is recoverable, you can retry the command. If it is unrecoverable, you need to reboot the domain in order to use that board.
- -c function
- Valid function values are unconfigure, disconnect, or unassign. The -c option is used to control the configuration state transition. Each successive function builds upon the last. For example, unassign first unconfigures and then disconnects the board before unassigning it.
-
- The possible transition states and their meanings are as follows:
-
unconfigure
- Unconfigures the board from the Solaris operating environment running on the domain. Solaris software stops using any of the hardware resources on the board.
Transitions the board into the connected|unconfigured state. In this state the system board is assigned to the logical domain and connected (remains in the active state). This state allows normal system access to hardware resources on the board, but the hardware resources of the board are not represented by the normal Solaris software data structures and thus are not available to the Solaris operating environment. Operations allowed on the board are limited to configuration administration operations.
-
disconnect
- Unconfigures the board from the Solaris operating environment running on the domain. See unconfigure.
Transitions the board into the disconnected|unconfigured state. Removes the board from the physical domain. An UNCLAIM request is sent by the domain to the SC during this step. In this state the system board is assigned to the logical domain and disconnected.
-
unassign
- Unconfigures the board from the Solaris operating environment running on the domain. See unconfigure.
Disconnects the board. See disconnect.
Moves the board out of the logical domain by changing its state to available.
- -f
- Forces the specified action to occur. Typically, this is a hardware-dependent override of a safety feature. Forcing a state change operation can allow use of the hardware resources of an occupant that is not in the ok or unknown conditions, at the discretion of any hardware-dependent safety checks.
- -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.
- -r retry_count -t timeout
- These command arguments enable the user to specify retries in case of failures encountered during state transitions. The -r retry_count option can be used alone and indicates the number of times the configuration state change request should be retried by the domain. The -t timeout option cannot be used without the -r retry_count option and specifies the number of seconds that the domain should wait before the next retry is made. If the -t timeout is not specified, the default timeout is zero, meaning that the request is retried immediately.
- -y
- Automatically answers yes to all prompts. Prompts are displayed unless used with the -q option.
|
|
The following operands are supported:
-
location
- List of board locations separated by a space. Multiple location arguments are permitted.
The following location forms are accepted:
Sun Fire 15K , Sun Fire 12K
SB(0...17), SB(0...8)
IO(0...17), IO(0...8)
Note Use showboards(1M) to display board type. |
|
Group Privileges Required
|
Users with platform administrator privileges can perform only the -c unassign option if the board(s) are in the assigned state (that is, not active in a running domain).
Users with domain administrator or configurator privileges can execute this command but only on their respective domains. To unassign a board, the board must be in the domain available component list.
Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4 Administrator Guide for more information.
|
|
| Example 1. Unconfiguring Boards From a Domain
|
To unconfigure four boards from their domain, you must have domain administrator/configurator privileges and the boards must be in the domain available component list.
All boards are in the configured state in the example domain.
|
sc0:sms-user:> deleteboard -c unconfigure SB0 IO1 SB1 SB2
|
|
Example 2. Unassigning Boards From a Running Domain
|
To unassign three active boards from their domain, set retries to five seconds and timeout to three seconds. The boards are unconfigured and disconnected before being unassigned. You must have domain administrator/configurator privileges, and the boards must be in the domain available component list.
|
sc0:sms-user:> deleteboard -r5 -t3 IO3 IO4 IO5
|
|
|
|
The following exit values are returned:
-
0
- Successful completion.
-
1
- No acknowledge.
-
2
- Not supported.
-
3
- Operation not supported.
-
4
- Invalid privileges.
-
5
- Busy.
-
6
- System busy.
-
7
- Data error.
-
8
- Library error.
-
9
- No library.
-
10
- Insufficient condition.
-
11
- Invalid.
-
12
- Error.
-
13
- A PID does not exist.
-
14
- Invalid attribute.
-
30
- Invalid board ID type.
-
31
- Invalid permissions.
-
32
- Assigned to another domain.
-
33
- Unable to get permissions.
-
34
- Unable to get domain board info.
-
35
- Unable to get active board list.
-
36
- Unable to get assigned board list.
-
38
- Solaris not running.
-
39
- Unable to assign/unassign domain state.
-
40
- Unable to get domain permissions.
-
41
- Unable to get platform permissions.
-
52
- Invalid privileges
-
53
- Internal error.
-
54
- Library error.
-
56
- DR command syntax error.
-
58
- Internal error.
-
68
- Location not assigned.
-
69
- Location not configured.
-
70
- DR operation failed.
|
|
See attributes(5) for descriptions of the following attributes.
Attribute Types | Attribute Values |
Availability | SUNWSMSop |
|
|
addboard(1m), moveboard(1m)
|
SMS 1.4 | Go To Top | Last Changed 19 September 2003 |
Company Info
|
Contact
|
Copyright 2003 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA. All rights reserved.
|