|
|
|
System Administration | moveboard(1m) |
| moveboard - move a board from one domain
to another |
SYNOPSIS
| moveboard -d domain_indicator [-c function] [-r retry_count [-t timeout] ] [-q] [-f] [-y|-n] location |
|
moveboard(1M) first attempts to unconfigure, disconnect, and unassign location from the domain it is currently assigned to and possibly active in, and then proceeds to assign, connect, and configure location to the domain domain_id or domain_tag.
The -c function command option is used to specify the transition of the board from the current configuration state to a new configuration state. Configuration states are assign, connect, and configure. If the -c option is not specified, the default expected configuration state is configure.
Note moveboard performs tasks synchronously and does not return control to the user until the command is complete. If the board is not powered on or tested and a -c connect|configure option is specified, then the command powers on the board and tests it. Note If the specified board is in the automatic system recovery (ASR) blacklist file, moveboard displays an error message when assigning a board and then continues. When using the connect or configure functions, moveboard displays an error message and then exits.Note If the moveboard 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. |
|
The following options are supported.
- -c function
- Valid function values are assign, connect, and configure. One of these values is used to control the configuration state transition.
-
- The possible transition states and their meanings are as follows:
-
assign
- Unconfigures the board from the Solaris operating environment running on the domain. Solaris software stops using any of the hardware resources on the board. (See deleteboard -c unconfigure.)
Disconnects the board. Transitions the board into the disconnected|unconfigured state. (See deleteboard -c disconnect.)
Unassigns the board from the current domain. (See deleteboard -c unassign.)
Moves the board out of the logical domain by changing its state to available.
Assigns the board to the new logical domain. This is a board state in which the domain has sole access to the board; however, the board is not active. Once assigned, the board can be connected or configured into the domain with the use of either setkeyswitch
on or the connect or configure options.
-
-
-
connect
- Unconfigures the board from the Solaris operating environment running on the domain. Solaris software stops using any of the hardware resources on the board. (See deleteboard -c unconfigure.)
Disconnects the board. Transitions the board into the disconnected|unconfigured state. (See deleteboard -c disconnect.)
Unassigns the board from the current domain. (See deleteboard -c unassign.)
Moves the board out of the logical domain by changing its state to available. Assigns the board to the new logical domain. (See assign earlier in this section; see also addboard(1M) -c assign.)
Transitions the board into the connected|unconfigured state.
In this state the board is assigned to the logical domain and connected (active). This state allows the normal system access to hardware resources on the board. The hardware resources of the board are not represented by the normal Solaris software data structures, however, and cannot be used by the Solaris operating environment. Allowed operations on the board are limited to configuration administration operations. (See also addboard -c connect.) This is an intermediate state and does not have any standalone implementation at this time.
-
-
-
configure
- Unconfigures the board from the Solaris operating environment running on the domain. Solaris software stops using any of the hardware resources on the board. (See deleteboard -c unconfigure.)
Disconnects the board. Transitions the board into the disconnected|unconfigured state. (See deleteboard -c disconnect.)
Unassigns the board from the current domain. (See deleteboard -c unassign.)
Moves the board out of the logical domain by changing its state to available. Assigns the board to the new logical domain. (See assign earlier in this section; see also addboard -c assign.)
Transitions the board into the connected|unconfigured state.
In this state, the board is assigned to the logical domain and connected (active). This state allows the normal system access to hardware resources on the board. The hardware resources of the board are not represented by the normal Solaris software data structures, however, and cannot be used by the Solaris operating environment. Allowed operations on the board are limited to configuration administration operations. (See connect earlier in this section; see also addboard -c connect.)
Transitions the board into the connected|configured state. In this state, the board is not only assigned and connected to a domain, but also configured into the Solaris operating environment. The hardware resources on the board can be used by Solaris software. (See also addboard -c configure.)
- -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).
This is the domain to which the board is being moved.
- -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
- Board location separated by a space. Multiple location arguments are not permitted.
The following location forms are accepted:
Sun Fire 12K and E20K:
SB(0...8)
IO(0...8)
Sun Fire 15K and E25K:
SB(0...17)
IO(0...17)
Note Use showboards(1M) to display board type. |
|
Group Privileges Required
|
Users with platform administrator privileges can perform the -c assign option if the board is in the assigned state (not active in a running domain) of the domain from which the board is being removed.
Users with domain administrator or configurator privileges can execute this command, but only on their respective domains. You must belong to both domain groups affected, and the board must be in the available component list of both domains.
Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4.1 Administrator Guide for more information.
|
|
|
For all examples, if the board is currently active in another domain, you must have domain administrator privileges for that domain. In addition, you must have platform administrator privileges or the board must be in the domain available component list in order for it to be unassigned from its current domain.
You must have platform privileges or the board must be in the domain's available component list for you to assign the system board to a new domain. In addition, the user must have domain privileges in the new domain in order to connect or configure the board into the domain.
Example 1. Assigning a CPU Board at SB4 to Domain A
|
|
sc0:sms-user:> moveboard -d A -c assign SB4
SB4 assigned to domain: A
|
|
Example 2. Assigning a Blacklisted CPU Board at SB4 to Domain A
|
|
sc0:sms-user:> moveboard -d A -c assign SB4
SB4 assigned to domain: A
Warning: SB4 is blacklisted.
You will not be able to connect or configure it.
sc0:sms-user:>
|
|
Example 3. Configuring an IO Board Into Domain A
|
Note: The default function is set to configure.
|
sc0:sms-user:> moveboard -d A IO2
IO2 unassigned from domain: B
IO2 assigned to domain: A
assign IO2
assign IO2 done
poweron IO2
poweron IO2 done
test IO2
test IO2 done
connect IO2
connect IO2 done
configure IO2
configure IO2 done
notify online /devices/pci@5d,700000
notify online /devices/pci@5d,600000
notify online /devices/pci@5c,700000
notify online /devices/pci@5c,600000
notify add capacity IO2 done
|
|
Example 4. Connecting an IO Board at IO7 to Domain R
|
You must have platform privileges, or the board must be in the domain available component list.
|
sc0:sms-user:> moveboard -d R -c connect IO7
|
|
Example 5. Connecting a Blacklisted Board to Domain C
|
|
sc0:sms-user:> moveboard -d C -c connect SB0
SB0 is blacklisted. Exiting.
sc0:sms-user:>
|
|
|
|
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.
-
51
- Invalid domain.
-
52
- Invalid privileges.
-
55
- Library error.
-
56
- DR command syntax error.
-
58
- Internal error.
-
59
- Component blacklisted.
-
60
- Unable to get ASR blacklist.
-
61
- Unable to get domain blacklist.
-
62
- Unable to get platform blacklist.
-
64
- Activity check error.
-
65
- Unassign check error.
-
66
- Unassign, unrestricted check error.
-
67
- Domain permissions check error.
-
70
- DR operation failed.
|
|
The following files are used by this command:
-
/etc/opt/SUNWSMS/config/asr/blacklist
- List of components excluded by esmd.
-
/etc/opt/SUNWSMS/config/platform/blacklist
- List of platform components excluded.
-
/etc/opt/SUNWSMS/config/domain_id/blacklist
- List of domain components excluded.
Note This file is created and used internally and should not be edited manually. To remove a component from the ASR blacklist file, use enablecomponent(1M). |
|
See attributes(5) for descriptions of the following attributes.
Attribute Types | Attribute Values |
Availability | SUNWSMSop |
|
|
addtag(1m), addboard(1m), deleteboard(1m), enablecomponent(1m), esmd(1m), showcomponent(1m)
|
SMS 1.4.1 | Go To Top | Last Changed 23 January 2004 |
Company Info
|
Contact
|
Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, CA 95054 USA. All rights reserved.
|