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.

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 15K, Sun Fire 12K

SB(0...17), SB(0...8)

IO(0...17), IO(0...8)

Group Privileges Required

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.

sc0:sms-user:> moveboard -d A -c assign SB4 
SB4 assigned 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:>

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

sc0:sms-user:> moveboard -d R -c connect IO7

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.

See attributes(5) for descriptions of the following attributes.

addtag(1m), addboard(1m), deleteboard(1m), enablecomponent(1m), esmd(1m), showcomponent(1m)