Sun Enterprise 10000 SSP 3.3 リファレンスマニュアル

moveboard(1M)

名前

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

形式

moveboard

-b

board_number

-d

domain

-h

-r

retry_count

-q

-t

timeout

機能説明

moveboard は、board_number で指定されたボードを現在のドメイン (ソースドメインと呼びます) から切り離し、domain で指定されたドメイン (ターゲットドメインと呼びます) に接続します。moveboard は、複数の DR (動的再構成) 切り離し操作および接続操作を実行して、進捗メッセージを SSP のプラットフォームログおよび標準出力に出力します。

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

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

ボードを切り離すには、電源が投入されていることに加え、ボードが以下のいずれかの状態にある必要があります。

ドメインに存在する
中間切り離し状態 (ドレイン段階後だが切り離し完了前) にある

ソースドメイン内のボードが不明または中間接続状態にある場合は、moveboard 操作が失敗し、終了ステータス 5 が返されます。

同じソースドメインに board_number で指定された別のボードが存在し、そのボードが中間切り離し状態にある場合は、moveboard 操作が失敗し、終了ステータス 6 が返されます。ソースドメイン内のそのボードの切り離しが完了するまで、moveboard 操作は完了できません。

ターゲットドメイン内のボードが不明な状態または中間切り離し状態にある場合は、moveboard 操作が失敗し、終了ステータス 11 が返されます。

オプション

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

-b board_number: 移動するシステムボードの番号 (0 〜 15)。
-d domain: ボードの移動先のドメイン。
-h: moveboard の使用法を標準エラーに出力します。
-r retry_count: 移動が失敗した場合の再試行回数。
-t timeout: 次の再試行までの時間 (秒)。
-q: 省略 (quiet) モード。情報メッセージが標準出力に出力されません。

使用例

例 1

以下の例では、システムボード 2 を現在のドメインから xf3-b2 という名前のドメインに移動します。ボードの移動操作の 1 回目が失敗した場合には、必要に応じて再試行が 15 分間隔で 2 回繰り返されます。

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

終了ステータス

以下の終了ステータスが返されます。

0: 指定したボードが指定したターゲットドメインに正常に移動されました。
1: コマンドの構文エラー。
2: DR ロックの獲得に失敗しました。
3: DR ロックの解放に失敗しました。
4: DR 通信の初期化に失敗しました。
5: ボードまたはソースドメインが切り離しに適しません。
6: ソースドメイン内のボードが中間切り離し状態です。
7: ドメインから最後のプロセッサが削除されるか、またはドメインが最小メモリー要件を下回ってしまうため、DR デーモンが切り離しを許可しません。
8: メモリーのドレイン操作中に失敗しました。
9: ドレイン操作が一定期間、実行できませんでした。
10: 切り離しを完了できませんでした。
11: ボードまたはターゲットドメインが接続に適しません。
12: ターゲットドメイン内のボードが中間接続状態です。
13: 接続の初期段階で失敗しました。
14: 接続の完了段階で失敗しました。
15: DR ライブラリに動的にリンクできませんでした。

エラーメッセージ

moveboard が失敗すると、診断メッセージが標準エラーに出力されます。

ファイル

moveboard により以下のファイルが使用されます。

/var/opt/SUNWssp/.ssp_private/domain_config

ソフトウェアドメイン設定

/var/opt/SUNWssp/adm/messages

プラットフォームログファイル

注意事項

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

指定したボードが中間切り離し状態にある場合は、moveboard により切り離し操作が完了され、そのボードが指定したドメインに接続されます。