addboard(1M)

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

NAME

addboard- attach a system board to a specific domain

SYNOPSIS

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

DESCRIPTION

The addboard(1M) command attaches a system board to a domain specified by domain (also referred to as the target domain). It also writes progress messages to the platform log on the SSP and to standard output.

If addboard fails, it writes an error message to standard error and returns a nonzero exit status. The board stays in the state it is in when the command fails. You can rerun addboard, or you can use deleteboard(1M) to return the board to its original state.

The -r option specifies the maximum number of retry attempts, retry_count, in the event that an attach operation 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 be eligible for attachment, a board must be powered on and in one of the following states:

• Not in a domain

• An addboard operation was initiated, but not completed

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

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

If the specified board is already in the domain, addboard returns an exit status of zero, indicating success.

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 number, where x equals an integer from 0 through 15.

EXAMPLES

In the following examples, the command attaches system board 2 to a domain named xf1-b4. If the first attempt to attach the board fails, two retries are made, if necessary, with a wait time of 10 minutes between retries.

---

Example 1 To Add a Board With the -b Option




# addboard -b 2 -d xf1-b4 -r 2 -t 600

---

---

Example 2 To Add a Board Without the -b Option




# addboard -d xf1-b4 -r 2 -t 600 SB2

---

EXIT STATUS

The following exit values are supported.

0

Successfully attached 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.

11

The board or target domain is not eligible for attachment.

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.

16

bringup -C requested process termination.

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 administration 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 addboard fails, it writes diagnostic messages to standard error.

NOTES

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

SEE ALSO

deleteboard(1M), moveboard(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