moveboard(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | ERROR MESSAGES | NOTES | SEE ALSO

NAME

moveboard- detach a board from its domain and attach it to a specific domain

SYNOPSIS

moveboard -b board_number -d domain [-r retry_count [-t timeout]] [-q]
moveboard -d domain [-r retry_count [-t timeout]] [-q] SBx
moveboard -h

DESCRIPTION

The moveboard command detaches a system board from its current domain (referred to as the source domain) and attaches it to the domain specified by domain (referred to as the target domain). It also writes progress messages to the platform log on the SSP and to standard output.

If moveboard fails, it writes an error message to standard error and returns a nonzero exit status. If the specified board is already detached and powered on, moveboard attempts to attach it to the specified domain. If the board is already in the specified domain, moveboard returns an exit status of zero, indicating success.

The -r option specifies the maximum number of retry attempts, retry_count, in the event that the moveboard command fails. The -t option specifies a time period in seconds, timeout, between retry attempts. If you specify the number of retries, but no timeout, there is no delay between retry attempts. If you specify a timeout, you must also specify the number of retries.

To move a board, it must be powered on and in one of the following states:

• In a domain

• A addboard(1M) operation was initiated, but not completed

• A deleteboard(1M) operation was initiated, but not completed

• A moveboard operation was initiated, but not completed

If the board is not already in the target domain or if it has already been detached from its source domain, moveboard proceeds with the attach operation.

OPTIONS

The following options are supported:

-b board_number

Specifies the system board number, 0 through 15.

-d domain

Specifies the domain name.

-h

Displays a usage message.

-r retry_count

Specifies the number of retry attempts. There are no limits to the possible retries.

-t timeout

Specifies the time in seconds between retry attempts. There is no limit to the amount of time.

-q

Turns on quiet mode, which means informational messages are not written to standard output.

OPERANDS

The following operand is supported:

SBx

Specifies the system board, where x equals an integer 0 through 15.

EXAMPLES

In the following examples, the command moves system board 2 from its current domain to a domain named xf3-b2. If the first attempt to move the board fails, two retries are made, if necessary, with a wait time of 15 minutes between retries.

---

Example 1 To Move a Board With the -b Option




# moveboard -b 2 -d xf3-b2 -r 2 -t 900

---

---

Example 2 To Move a Board Without the -b Option




# moveboard -d xf3-b2 -r 2 -t 900 SB2

---

EXIT STATUS

The following exit values are supported.

0

Successfully moved the board to the specified domain.

1

Command syntax error occurred.

2

Failed to acquire DR lock.

3

Failed to release DR lock.

4

Failed to initialize DR communications.

5

Board or target domain is not eligible for detachment.

6

A board in the target domain is in an intermediate detach state.

7

DR daemon does not allow a detach operation when it removes the last processor from the domain or when it drops the memory in the domain below the minimum requirement.

8

Failed during the memory drain operation.

9

Failed to make progress during the drain operation.

10

Failed to complete the drain operation.

11

The board or target domain is not eligible for detachment.

12

A board in the target domain is in an intermediate attach state.

13

Failed in initial attachment stage.

14

Failed in complete attachment stage.

15

Failed to dynamically link with DR library.

17

A termination signal was received.

51

The command was not completed because of a negative acknowledgment from the confp->confirm function.

52

System configuration administration is not supported on this attachment point.

53

System configuration administration operation is not supported on this attachment point.

54

The caller does not have the required process privileges. For example, if configuration administration is performed through a device driver, the permissions on the device node are used to control access.

55

The command was not completed because an element of the system configuration admistration system was busy.

56

The command required a service interruption and was not completed because part of the system could not be suspended (that is, quiesced).

57

A procedural error occurred in the data.

58

A procedural error occurred in the library, including a failure to obtain process resources such as memory and file descriptors.

59

A hardware-specific library could not be located by using the specified attachment point.

60

The operation failed because of the condition of the attachment point.

61

The system configuration administration operation requested is not supported on the specified attachment point.

62

An error occurred during the processing of the requested operation. This error code includes validation of the command arguments by the hardware-specific code.

63

No such attachment point exists.

64

No attachment point with the specified attributes exists.

65

An invalid board ID was specified.

ERROR MESSAGES

If moveboard fails, it writes diagnostic messages to standard error.

NOTES

The moveboard command prevents more than one attach or detach operation from executing concurrently.

SEE ALSO

addboard(1M), deleteboard(1M), rcfgadm(1M)

domain_status(1M) and showdevices(1M) in the Sun Enterprise 10000 SSP 3.5 Reference Manual

dcs(1M) and dr_daemon(1M) in man pages section 1M: System Administration Commands in the Solaris 8 Reference Manual

Sun Enterprise 10000 Dynamic Reconfiguration User Guide

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | ERROR MESSAGES | NOTES | SEE ALSO