3.9.7 仮想サーバ追加(仮想ディスク)
機能
複数の仮想サーバにディスクを追加します。
このサービステンプレートが前提とするサーバを次に示します。
・vCenterサーバ
VMware vCenter Serverがインストールされているサーバです。
・vCenter操作サーバ
VMware vSphere PowerCLIがインストールされているサーバです。
・仮想サーバ
vCenterサーバおよびVMware vSphere ESXiによって管理されている仮想サーバです。
処理の概要を以下に示します。
(1) 仮想サーバの電源状態を取得します。
(2) 仮想サーバの電源状態がOFFになっていることを確認します。
電源状態がOFFでない場合は，ユーザー応答待ち部品を実行して，電源をOFFにするか・しないかを確認します。
ユーザー応答待ち部品のメール送信先/送信内容，タイムアウト，画面表示内容はModify権限のユーザーが設定できます。
ユーザー応答待ちのGUIで"Shutdown"を選択した場合は，仮想サーバのシャットダウンを行います。
"Cancel"を選択するか，応答待ちがタイムアウトになった場合は，仮想サーバには操作を行わずにサービスが異常終了します。
仮想サーバを停止する際には，vmware.checkPowerStateIntervalプロパティに指定した秒数待ち合わせ，電源状態がOFFになることを確認する動作を，vmware.checkPowerStateCountプロパティに指定した回数繰り返します。デフォルトの値で不都合がある場合，利用している環境に合わせて調整してください。
(3) 仮想サーバに仮想ディスクを追加します。
仮想サーバが複数の場合，指定した条件の仮想ディスクを各仮想サーバに追加します。この処理は並列に実行されます。
前提条件
【サービステンプレート実行システム内前提製品】/【サービステンプレート実行システム内前提製品の稼働OS】の最新のサポート状況については，リリースノートを参照してください。
また、OSおよび製品について略称を用いています。対象とするOSおよび製品については「はじめに」を参照してください。
【サービステンプレート実行システム内前提製品】
(1)vCenterサーバの前提製品
・VMware vCenter Server
(2)仮想サーバを管理するVMware vSphere ESXi
(3)vCenter操作サーバの前提製品
・VMware PowerCLI
【サービステンプレート実行システム内前提製品の稼働OS】
(1)仮想サーバの前提OS
vCenterサーバの前提製品/仮想サーバを管理するVMware vSphere ESXi/vCenter操作サーバの前提製品がサポートする構成の範囲で，次のOSがサポート範囲です。
・Windows Server
・Red Hat Enterprise Linux Server
(2)vCenter操作サーバの前提OS
・Windows Server
【サービステンプレート実行システム内前提製品の使用条件】
(1)仮想ディスクの追加対象となる仮想サーバの電源がOFFになっていること。
(2)VMware vSphere ESXiがVMware vCenter Serverで管理されていること。
(3)仮想マシン名はvCenterサーバ内で一意になるようにしてください。
(4)対象となる仮想サーバに，VMwareToolsがインストールされていること。
注意事項
(1)このサービステンプレートでは仮想サーバに追加した仮想ディスクの初期化は行いません。必要に応じて仮想サーバのOSにログインし，ディスクの初期化を実施してください。
(2)同一の仮想サーバに対して，このサービスを複数同時に実行しないでください。
(3)UserResponseplugin.dialogTextにHTMLタグを指定する場合，指定できるタグおよび属性はユーザー応答待ち部品と同じです。詳細については，本製品マニュアルの「ユーザー応答待ち部品」について説明しているトピックを参照してください。
実行権限
(1)VMware vCenter Serverに接続するユーザーに，次の権限が必要です。
システム管理者ロール
バージョン
04.00.00
タグ
Modify VM,VMware vSphere
プロパティ一覧
プロパティに設定されているプロパティグループの一覧を次に示します。
|
プロパティグループ |
説明 |
初期表示 |
|---|---|---|
|
仮想システム環境情報 |
VMware vCenter Serverの情報を指定してください。 |
表示されます。 |
|
仮想ディスク情報 |
追加する仮想ディスクの情報を指定してください。 |
表示されます。 |
|
ユーザー応答待ちオプション |
仮想サーバが起動していた場合のユーザー応答のためのオプションです。必要に応じて変更してください。 |
表示されません。 |
|
実行時オプション |
仮想サーバの停止を行う際の状態確認に関するプロパティです。必要に応じて変更してください。 |
表示されません。 |
［サービス設定］画面に表示されるプロパティの一覧を次に示します。
- （凡例）
-
○：プロパティの指定は必須です。
△：プロパティの指定は省略可能です。ただし，ほかのプロパティの指定内容によっては，指定が必須になります。各プロパティの「説明」を確認してください。
|
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
必須区分 |
プロパティグループ |
|---|---|---|---|---|---|---|
|
vmware.targetHost |
VMware vCenter操作サーバのホスト名 |
VMware vCenter Serverを操作するサーバ(vSphere PowerCLIインストール済みサーバ)のホスト名またはIPアドレスを指定します。IPv6アドレスには対応していません。 |
入力 |
無効 |
○ |
仮想システム環境情報 |
|
vmware.vCenterServerName |
vCenterサーバ名 |
VMware vCenter Serverのホスト名，またはIPアドレスを指定します。IPv6アドレスには対応していません。 |
入力 |
無効 |
○ |
仮想システム環境情報 |
|
vmware.userName |
VMware vCenter Serverに接続するためのユーザー名 |
VMware vCenter Serverに接続するためのユーザー名を指定します。 |
入力 |
無効 |
○ |
仮想システム環境情報 |
|
vmware.password |
VMware vCenter Serverに接続するためのパスワード |
VMware vCenter Serverに接続するためのパスワードを指定します。 |
入力 |
無効 |
○ |
仮想システム環境情報 |
|
vmware.portNumber |
VMware vCenter Server接続用ポート番号 |
VMware vCenter Serverに接続するためのポート番号(VMware vCenter ServerのWebサービス用)を指定します。指定しなかった場合には，VMware vCenter Serverで設定されているデフォルト値で接続します。 |
入力 |
無効 |
△ |
仮想システム環境情報 |
|
vmware.protocol |
VMware vCenter Server接続用プロトコル |
VMware vCenter Serverに接続するためのプロトコルを指定します。 |
入力 |
無効 |
○ |
仮想システム環境情報 |
|
UserResponsePlugin.toAddress |
TOメールアドレス |
ユーザー応答待ちになった場合のメール通知の宛先メールアドレス(TO)を指定します。複数のアドレスを指定する場合は，「,」で区切って指定してください。例：mailA,mailB |
入力 |
無効 |
△ |
ユーザー応答待ちオプション |
|
UserResponsePlugin.ccAddress |
CCメールアドレス |
ユーザー応答待ちになった場合のメール通知の宛先メールアドレス(CC)を指定します。複数のアドレスを指定する場合は，「,」で区切って指定してください。例：mailA,mailB |
入力 |
無効 |
△ |
ユーザー応答待ちオプション |
|
UserResponsePlugin.bccAddress |
BCCメールアドレス |
ユーザー応答待ちになった場合のメール通知の宛先メールアドレス(BCC)を指定します。複数のアドレスを指定する場合は，「,」で区切って指定してください。例：mailA,mailB |
入力 |
無効 |
△ |
ユーザー応答待ちオプション |
|
UserResponsePlugin.mailSubject |
メール件名 |
ユーザー応答待ちになった場合のメール通知のメールの件名を指定します。 |
入力 |
無効 |
△ |
ユーザー応答待ちオプション |
|
UserResponsePlugin.mailBody |
メール本文 |
ユーザー応答待ちになった場合のメール通知のメール本文を指定します。 |
入力 |
無効 |
△ |
ユーザー応答待ちオプション |
|
UserResponsePlugin.encodeType |
エンコード種別 |
ユーザー応答待ちになった場合のメール通知のエンコード種別を指定します。指定可能なエンコード名は次のとおりです。us-ascii，iso-2022-jp，shift_jis，euc-jp，utf-8。指定しなかった場合には，utf-8で送信されます。 |
入力 |
無効 |
△ |
ユーザー応答待ちオプション |
|
UserResponsePlugin.dialogText |
応答入力画面の補足情報 |
ユーザー応答待ちになった場合の応答入力ダイアログに表示する補足情報を指定します。テキスト形式，またはHTML形式で指定できます。指定可能なHTMLタグは，アンカータグ，ボールドタグ，ブレークタグ，フォントタグ，イタリックタグ，下線タグです。 |
入力 |
無効 |
△ |
ユーザー応答待ちオプション |
|
UserResponsePlugin.responseTimeOut |
応答タイムアウト時間(分) |
ユーザー応答待ちになった場合の応答がタイムアウトする時間を分単位で指定します。応答タイムアウト時間が過ぎると，サービスが異常終了します。 |
入力 |
無効 |
○ |
ユーザー応答待ちオプション |
|
vmware.checkPowerStateCount |
電源状態の確認回数 |
仮想サーバの停止を確認する際の，電源状態の確認回数を指定します。電源状態の確認間隔と組み合わせて最大待ち時間となります。 |
入力 |
無効 |
○ |
実行時オプション |
|
vmware.checkPowerStateInterval |
電源状態の確認間隔 |
仮想サーバの停止を確認する際の，電源状態の確認間隔を秒単位で指定します。 |
入力 |
無効 |
○ |
実行時オプション |
［サービス設定］画面および［サービス実行］画面に表示されるプロパティの一覧を次に示します。
|
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
必須区分 |
プロパティグループ |
|---|---|---|---|---|---|---|
|
vmware.foreachVmName |
仮想サーバ名(複数指定可) |
仮想サーバの名称(VMware vCenter Serverにおける仮想サーバ名。ホスト名ではありません。)を指定します。複数指定する場合はコンマで区切ってください。99個まで指定できます。 |
入力 |
無効 |
○ |
仮想ディスク情報 |
|
vmware.dataStoreName |
データストア名 |
仮想ディスクのタイプでFlatを選択する場合は，仮想ディスクの作成先とするデータストアの名称を指定します。仮想ディスクのタイプでRawVirtualまたはRawPhysicalを選択する場合は，LUNマッピングの保存先とするデータストアの名称を指定します。 |
入力 |
無効 |
○ |
仮想ディスク情報 |
|
vmware.capacity |
容量 (GB) |
ディスクの容量をGB単位で指定します。仮想ディスクのタイプにFlatを指定する場合は必須です。仮想ディスクのタイプにRawVirtualまたはRawPhysicalを指定した場合は無視されます。 |
入力 |
無効 |
△ |
仮想ディスク情報 |
|
vmware.vHardDiskType |
仮想ディスクのタイプ |
仮想ディスクのタイプを指定します。次のどれかを選択します。Flat:仮想ディスクをVMFS上に作成します。RawPhysical:Rawデバイスのマッピング(物理)を設定します。RawVirtual:Rawデバイスのマッピング(仮想)を設定します。 |
入力 |
無効 |
△ |
仮想ディスク情報 |
|
vmware.deviceName |
LUNのデバイス名 |
仮想ディスクを作成するLUNのデバイス名を指定します。仮想ディスクのタイプでRawVirtualまたはRawPhysicalを選択した場合だけ指定します。vSphere Clientの新しいRawハードディスク追加ウィザードで表示されるLUNの名称を指定してください(例:/vmfs/devices/disks/naa.XXX)。 |
入力 |
無効 |
△ |
仮想ディスク情報 |
［タスク詳細］画面にだけ表示されるプロパティの一覧を次に示します。
|
プロパティキー |
プロパティ名 |
説明 |
入出力種別 |
共有設定 |
|---|---|---|---|---|
|
common.taskResult |
繰り返しタスクの実行結果 |
タスクごとの成功(true)，失敗(false)をコンマ区切りで出力します。 |
出力 |
無効 |
［サービス設定］画面に表示されるプロパティの入力制限を次に示します。
|
プロパティキー |
入力可能文字 |
|---|---|
|
vmware.targetHost |
256文字以内の半角英数字および「.」，「-」。 |
|
vmware.vCenterServerName |
256文字以内の半角英数字および「.」，「-」。 |
|
vmware.userName |
512文字以内の半角英数字および半角記号。 ただし，「<」，「>」，「|」，「;」，「&」，「'」，「"」，「*」，「?」，「[」，「]」，「`」，「/」，「:」，「=」，「,」，「+」，「%」を除く。 |
|
vmware.password |
127文字以内の半角英数字および半角記号。ただし，「<」，「>」，「|」，「;」，「&」，「'」，「"」，「*」，「?」，「[」，「]」，「`」，「%」を除く。 |
|
vmware.portNumber |
1〜65535の整数値。 |
|
vmware.protocol |
次の値のどれかを選択する。 http,https |
|
UserResponsePlugin.toAddress |
1024文字以内の半角英数字および半角記号。 |
|
UserResponsePlugin.ccAddress |
1024文字以内の半角英数字および半角記号。 |
|
UserResponsePlugin.bccAddress |
1024文字以内の半角英数字および半角記号。 |
|
UserResponsePlugin.mailSubject |
256文字以内の文字列。 |
|
UserResponsePlugin.mailBody |
1024文字以内の文字列。 |
|
UserResponsePlugin.encodeType |
次の値のどれかを選択する。 us-ascii,iso-2022-jp,shift_jis,euc-jp,utf-8 |
|
UserResponsePlugin.dialogText |
512文字以内の文字列。 |
|
UserResponsePlugin.responseTimeOut |
1〜9999の整数値。 |
|
vmware.checkPowerStateCount |
1〜3600の整数値。 |
|
vmware.checkPowerStateInterval |
1〜60の整数値。 |
［サービス設定］画面および［サービス実行］画面に表示されるプロパティの入力制限を次に示します。
|
プロパティキー |
入力可能文字 |
|---|---|
|
vmware.foreachVmName |
1024文字以内の文字列。ただし，「<」，「>」，「|」，「;」，「&」，「'」，「"」，「*」，「?」，「[」，「]」，「`」，「%」を除く。 |
|
vmware.dataStoreName |
42文字以内の半角英数記号。ただし，「<」，「>」，「|」，「;」，「&」，「'」，「"」，「*」，「?」，「[」，「]」，「`」，「%」を除く。 |
|
vmware.capacity |
1以上の整数値。 |
|
vmware.vHardDiskType |
次の値のどれかを選択する。 RawVirtual,RawPhysical,Flat |
|
vmware.deviceName |
255文字以内の文字列。ただし，「<」，「>」，「|」，「;」，「&」，「'」，「"」，「*」，「?」，「[」，「]」，「`」，「%」を除く。 |
フロー仕様詳細
フロー仕様詳細を次の表に示します。
|
階層 |
[タスク詳細]画面での表示名 |
ステップ名 |
部品 |
||
|---|---|---|---|---|---|
|
部品名 |
説明 |
エラー時の回復方法 |
|||
|
1 |
仮想ディスク追加 |
仮想ディスク追加 |
繰り返し実行部品 |
複数の仮想サーバに仮想ディスクを追加します。 |
エラーの原因を取り除いたあと，サービスを再実行してください。 |