moveboard(1M)

名前 | 形式 | 機能説明 | オプション | オペランド | 使用例 | 終了ステータス | エラーメッセージ | 注意 | 関連項目

名前

moveboard- ボードのドメインからの切り離しと特定ドメインへの接続

形式

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

機能説明

moveboard コマンドは、システムボードを現在属しているドメイン (「ソースドメイン」と呼びます) から切り離して、domain (「ターゲットドメイン」と呼びます) で指定したドメインに接続します。また、このコマンドは進捗メッセージを SSP のプラットフォームログおよび標準出力に出力します。

moveboard に失敗した場合は、標準エラーにエラーメッセージを出力し、0 以外の終了ステータスを返します。 指定したボードがすでに切り離されていて、かつ、電源が投入されていると、moveboard は指定されたドメインへそのボードを接続しようと試みます。 ボードが指定されたドメイン内にすでに存在していると、moveboard は正常に完了したことを示す終了ステータス 0 を返します。

-r オプションは、moveboard コマンドの実行が失敗した場合の再試行回数の最大値を retry_count で指定します。-t オプションは、再試行の間隔を timeout により秒数で指定します。再試行回数を指定してもタイムアウトを指定しないと、再試行が連続して実行されます。タイムアウトを指定する場合は、必ず、再試行回数も指定してください。

ボードを move (移動) するには、ボードの電源が投入されていることに加え、ボードが以下のいずれかの状態になければなりません。

• ドメインに存在している

• DR 操作が完了していないため、中間状態にある

指定したボードがターゲットドメイン内に存在しない場合、またはそのボードがソースドメインからすでに切り離されている場合に、moveboard は接続操作を実行します。

オプション

以下のオプションをサポートしています。

-b board_number

システムボードの番号 (0 〜 15) を指定します。

-d domain

ドメイン名を指定します。

-f

接続操作を強制的に行います。-f オプションを指定すると、特定のソフトウェア制限よりもこの操作を優先させることができますが、ハードウェアおよび Solaris オペレーティング環境の基本的な安全性と可用性に関する制限を越えることはできません。

-h

状況メッセージを表示します。

-r retry_count

再試行回数を指定します。再試行の指定回数の上限はありません。

-t timeout

再試行の間隔を秒数で指定します。再試行の指定回数の上限はありません。

-q

省略 (quiet) モードを設定します。情報メッセージが標準出力に出力されなくなります。

オペランド

以下のオペランドをサポートしています。

SBx

システムボード番号を指定します。ここで、x は、0 〜 15 までの整数となります。

使用例

以下の例では、コマンドを実行してシステムボード 2 を現在のドメインから別のドメイン (ドメイン名: xf3-b2) へ接続します。ボード移動の最初の試みに失敗すると、再試行が必要な場合に、再試行の間隔を 15 分間として 2 回行います。

---

例 1 ボードの移動 (-b オプション使用時)




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

---

---

例 2 ボードの移動 (-b オプション非使用時)




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

---

終了ステータス

以下の終了ステータス (値) を返します。

0

指定されたドメインへボードを正常に移動しました。

1

コマンドに構文エラーがあります。

2

DR ロックの獲得に失敗しました。

3

DR ロックの解放に失敗しました。

4

DR 通信の初期化に失敗しました。

5

ボードまたはターゲットドメインが切り離し条件に適していません。

6

ターゲットドメイン内のボードが中間切り離し状態にあります。

7

ドメインから最後のプロセッサを削除することになるか、またはドメインに必要な最小メモリー条件を下回ってしまうことになるため、DR デーモンが切り離しを許可しません

8

メモリーのドレイン操作中に失敗しました。

9

ドレイン操作が一定時間、進行できませんでした。

10

ドレイン操作を完了できませんでした。

11

ボードまたはターゲットドメインが接続条件に適していません。

12

ターゲットドメイン内のボードが中間接続状態にあります。

13

接続の初期段階で失敗しました。

14

接続の完了段階で失敗しました。

15

DR ライブラリと動的にリンクできませんでした。

17

終了信号を受信しました。

51

confp->confirm 機能から接続拒否メッセージを受信したため、コマンドは完了しませんでした。

52

この接続点では、システム構成管理がサポートされていません。

53

この接続点では、システム構成管理操作が行えません。

54

コマンドの呼び出し側がコマンドの処理に必要な権限を持っていません。たとえば、デバイスドライバに対して構成管理を行う場合、デバイスノードへの権限によりアクセスが制御されます。

55

システム構成管理システムのエレメントが使用中のため、コマンドは完了しませんでした。

56

コマンドはサービスの中断を要求しましたが、システムの一部を停止 (つまり、休止) できなかったため、このコマンドは完了しませんでした。

57

データ内で手続き上のエラーが発生しました。

58

メモリー、ファイル記述子といったプロセスリソースの取得失敗など、ライブラリ内で手続き上のエラーが発生しました。

59

指定された接続点からハードウェアに関するライブラリを見つけることができませんでした。

60

接続点の状態が原因で、この操作は失敗しました。

61

要求されたシステム構成管理操作は、指定された接続点では行えません。

62

要求された操作の処理中にエラーが発生しました。このエラーコードには、コマンド引数とハードウェア固有コードとの検証失敗などを意味します。

63

指定された接続点が存在しません。

64

指定された属性を持つ接続点が存在しません。

65

指定されたボード ID は無効です。

エラーメッセージ

moveboard は失敗すると標準エラーに診断メッセージを出力します。

注意

moveboard コマンドは、複数の接続または切り離し操作の同時実行を防止します。

関連項目

deleteboard(1M)、moveboard(1M)、rcfgadm(1M)

『Sun Enterprise 10000 SSP 3.5 リファレンスマニュアル』の domain_status(1M) と showdevices(1M)

『Solaris 8 Reference Manual Collection』の「man pages section 1M: System Administration Commands」の dcs(1M) と dr_daemon(1M)

『Sun Enterprise 10000 Dynamic Reconfiguration ユーザーマニュアル』

名前 | 形式 | 機能説明 | オプション | オペランド | 使用例 | 終了ステータス | エラーメッセージ | 注意 | 関連項目