ページの先頭行へ戻る
SystemwalkerRunbook Automation V14g リファレンスガイド
Systemwalker
第3章 運用操作部品リファレンス > 3.1 自動運用プロセス開発者向けリファレンス > 3.1.51 仮想サーバの詳細情報を取得する
前次

3.1.51 仮想サーバの詳細情報を取得する

機能説明

仮想サーバの詳細情報を取得します。

オプション

基本オプション

(1) servername

詳細情報を取得するサーバ名です。
サーバ名を省略した場合、引数エラーとなります。
サーバ名の文字列の上限は、1024文字です。それ以上の場合、引数エラーとなります。

拡張オプション

(1) detail

仮想環境の管理製品が管理する詳細情報を全て出力するか指定します。
一覧情報に管理製品の出力情報を追加する場合は、“on”を指定します。
出力情報を追加しない場合は、“off”を指定します。なお、大文字／小文字は区別しません。
省略値は“off”です。

(2) timeout

運用操作部品の実行の完了待ち合わせ時間(秒)です。

300～86,400(1日)の範囲で指定が可能です。

(例) 完了待ち合わせを10分間行う場合：600

指定した時間を経過しても運用操作部品の実行が完了しない場合は、運用操作部品の処理を復帰値：201で中断します。

(3) retry

運用操作部品の実行の起動リトライ回数です。

運用操作部品が復帰値：161で終了した場合に、起動リトライを行う回数を指定します。0～5の範囲で指定が可能です。

起動リトライにより再実行した結果、運用操作部品が161以外の復帰値で終了した場合は、指定した起動リトライ回数に達していなくても運用操作部品の実行は終了します。運用操作部品の復帰値は最後に実行した値になります。

(例) 起動リトライを2回行う場合：2

(4) retry_interval

運用操作部品のリトライ間隔(秒)です。

運用操作部品が復帰値：161で終了した場合に、起動リトライを行うまでの間隔を指定します。1～14400の範囲で指定が可能です。

(例) 300秒間隔でリトライを行う場合：300

timeout、retry、およびretry_intervalについて、指定を省略した場合や、範囲外の値を入力した場合は、運用操作部品実行定義ファイルで指定した値が有効になります。詳細は、“2.5 運用操作部品実行定義ファイル”を参照してください。

復帰値

復帰値

意味

0

仮想サーバの詳細情報の取得に成功しました。

161

仮想環境の管理製品との通信処理でエラーが発生しました。リトライ回数を指定した場合、リトライします。

171

仮想環境の管理製品との通信処理で認証エラーが発生しました。

172

仮想サーバの詳細情報の取得に失敗しました。

188

実行中に通信が切断しました。

189

仮想環境の管理サーバに接続できませんでした。

197

オプションの内容に誤りがありました。

201

運用操作部品の実行がタイムアウトしました。

202

運用操作部品が実行されませんでした。運用操作部品を実行するための設定に問題があります。

203

運用操作部品を正常に実行できませんでした。管理サーバの環境に問題があります。

204

運用操作部品が実行されませんでした。運用操作部品実行定義ファイルに問題があります。

205

運用操作部品が実行されませんでした。運用操作部品の入力パラメーター指定に問題があります。

206

運用操作部品を正常に実行できませんでした。運用操作部品の出力パラメーター指定に問題があります。

207

運用操作部品が実行されませんでした。運用操作部品が管理サーバに登録されていない可能性があります。

標準出力/標準エラー出力

仮想サーバの詳細情報の取得に成功した場合、取得した詳細情報を標準出力します。仮想サーバの詳細情報の取得に失敗した場合は、標準出力には何も出力しません。
実行結果を示すメッセージを標準エラー出力します。

詳細情報は以下の形式で出力します。

<?xml version="1.0" encoding="UTF-8"?>
<Resources>
<VirtualServerName>[仮想サーバ名]</VirtualServerName>
<OSType>[OS種別]</OSType>
<PowerStatus>[電源状況]</PowerStatus>
<Processor>
<ProcessorArch>[CPU アーキテクチャ]</ProcessorArch>
<ProcessorSpeed>[CPU クロック数]</ProcessorSpeed>
<NumOfProcessors>[CPU 数]</NumOfProcessors>
</Processor>
<Memory>
<MemorySize>[メモリ容量]</MemorySize>
</Memory>
<Disks>
<Disk>
<DiskSize>[ディスク容量]</DiskSize>
</Disk>
・・・（ディスク毎に繰り返し出力）
</Disks>
<Networks>
<Network>
<MacAddress>[MAC アドレス]</MacAddress>
<IpAddress>[IP アドレス]</IpAddress>
</Network>
・・・  （接続されているネットワークカード毎に繰り返し出力）
</Networks>
</Resources>

detailパラメーターに“on”を指定した場合、上記のネットワーク情報に続けて仮想環境の管理製品の出力情報を出力します。

<?xml version="1.0" encoding="UTF-8"?>
<Resources>
・・・
</Networks>
<AdditionalInfomation>
<Software>[ServerView Resource Orchestrator]</Software>
<OutputData>
[ServerView Resource Orchestratorの出力情報]
</OutputData>
</AdditionalInfomation>
</Resources>

注意事項

前次
Copyright 2010-2011 FUJITSU LIMITED