VMware HA運用管理テンプレート説明書 - Fujitsu...本書は、Systemwalker Runbook Automation V14.0.0のVMware HA運用管理テンプレートを使用した運用について説明しています。

B1WS-0877-01Z0(00)2010年08月

Systemwalker Runbook Automation V14g

VMware HA運用管理テンプレート説明書

まえがき

本書の目的

本書は、Systemwalker Runbook Automation V14.0.0のVMware HA運用管理テンプレートを使用した運用について説明しています。

本書の読者

本書は、VMwareを利用した仮想環境（VMware HA構成）をSystemwalker Runbook Automationで運用・管理する方を対象としていま

す。

本書を読む場合、Systemwalker Runbook Automationおよび仮想化機構の一般的な知識をご理解の上でお読みください。

コマンド入力例のプロンプトについて

#

システム管理者の権限で実行するコマンドです。

%または$

システム管理者以外の権限でも実行可能なコマンドです。

記号について

[ ]記号

Systemwalker Runbook Automationで提供している画面名、メニュー名、および画面項目名をこの記号で囲んでいます。

コマンドで使用する記号

コマンドで使用している記号について以下に説明します。

記述例

[PARA={a|b|c}…]

記号の意味

記号意味

[ ] この記号で囲まれた項目を省略できることを示します。

｛｝この記号で囲まれた項目の中から、どれか１つを選択することを示します。

_ 省略可能記号“[ ]”内の項目をすべて省略したときの省略値が、下線で示された項目

であることを示します。

｜この記号を区切りとして並べられた項目の中から、どれか１つを選択することを示しま

す。

… この記号の直前の項目を繰り返して指定できることを示します。

略語表記について

・以下の製品すべてを示す場合は、“Windows(R) 7”と表記します。

－ Windows(R) 7 Home Premium

－ Windows(R) 7 Professional

－ Windows(R) 7 Enterprise

－ Windows(R) 7 Ultimate

- i -

・以下の製品すべてを示す場合は、“Windows Server 2008”と表記します。

－ Microsoft(R) Windows Server(R) 2008 Standard

－ Microsoft(R) Windows Server(R) 2008 Enterprise

－ Microsoft(R) Windows Server(R) 2008 R2 Standard

－ Microsoft(R) Windows Server(R) 2008 R2 Enterprise

－ Microsoft(R) Windows Server(R) 2008 Standard x64 Edition

－ Microsoft(R) Windows Server(R) 2008 Enterprise x64 Edition

－ Microsoft(R) Windows Server(R) 2008 Standard without Hyper-V(TM)

－ Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-V(TM)

・以下の製品すべてを示す場合は、“Windows Vista(R)”と表記します。

－ Windows Vista(R) Home Basic

－ Windows Vista(R) Home Premium

－ Windows Vista(R) Business

－ Windows Vista(R) Ultimate

－ Windows Vista(R) Enterprise

・以下の製品すべてを示す場合は、"Windows Server 2003"と表記します。

－ Microsoft(R) Windows Server(R) 2003, Standard x64 Edition

－ Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition

－ Microsoft(R) Windows Server(R) 2003, Standard Edition

－ Microsoft(R) Windows Server(R) 2003 R2, Standard Edition

－ Microsoft(R) Windows Server(R) 2003, Datacenter x64 Edition

－ Microsoft(R) Windows Server(R) 2003, Datacenter Edition for Itanium-based Systems

－ Microsoft(R) Windows Server(R) 2003, Datacenter Edition

－ Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition

－ Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition

－ Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium-based Systems

－ Microsoft(R) Windows Server(R) 2003, Enterprise Edition

－ Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition

・以下の製品すべてを示す場合は、"Windows 2000 Server"と表記します。

－ Microsoft(R) Windows(R) 2000 Server

－ Microsoft(R) Windows(R) 2000 Advanced Server

－ Microsoft(R) Windows(R) 2000 Datacenter Server

・以下の製品すべてを示す場合は、“Windows(R) 2000”と表記します。

－ Microsoft(R) Windows(R) 2000 Professional

－ Microsoft(R) Windows(R) 2000 Server

－ Microsoft(R) Windows(R) 2000 Advanced Server

－ Microsoft(R) Windows(R) 2000 Datacenter Server

- ii -

・以下の製品すべてを示す場合は、“Windows(R) XP”と表記します。

－ Microsoft(R) Windows(R) XP Professional x64 Edition

－ Microsoft(R) Windows(R) XP Professional

－ Microsoft(R) Windows(R) XP Home Edition

・ Solaris(TM) オペレーティングシステムを“Solaris”と略しています。

・ Interstage Business Process Managerを“BPM”と略しています。

・ Interstage Business Process Manager Studio for Systemwalkerを“Interstage BPM Studio for Systemwalker”と略しています。

・ Microsoft(R) Cluster Server、またはMicrosoft(R) Cluster Serviceを、“MSCS”と略しています。

・ Windows上で動作するSystemwalker Runbook Automationを“Windows版”と表記します。

・ Itanium以外の64ビットアーキテクチャに対応したWindows上で動作するSystemwalker Runbook Automationの固有記事

を“Windowsx64版”と表記します。

・ Solaris上で動作するSystemwalker Runbook Automationを“Solaris版”と表記します。

・ Linux上で動作するSystemwalker Runbook Automationを“Linux版”と表記します。

・ Solaris版およびLinux版のSystemwalker Runbook Automationを包括して“UNIX版”と表記します。

商標について

ITIL(R)は、英国政府OGC（Office of Government Commerce）および米国特許商標局の登録商標です。

Linuxは、Linus Torvalds氏の米国およびその他の国における登録商標または商標です。

Microsoft、Windows、Windows ServerおよびMicrosoft Cluster Serviceは、米国Microsoft Corporationの米国およびその他の国にお

ける登録商標または商標です。

Netscape、Netscape の N および操舵輪のロゴ、Netscape Navigator、Netscape Communicatorは、米国およびその他の国における

Netscape Communications Corporation 社の登録商標です。

Oracleは、米国ORACLE Corporationの登録商標です。

Red HatおよびRed Hatをベースとしたすべての商標とロゴは、Red Hat, Inc.の米国およびその他の国における登録商標または商標で

す。

Sun、Sun Microsystems、Sunロゴ、Solaris およびすべての Solarisに関連する商標およびロゴは、米国およびその他の国における米国

Sun Microsystems, Inc.の登録商標または商標です。

JavaおよびすべてのJava関連の商標およびロゴは、米国およびその他の国における米国Sun Microsystems, Inc.の登録商標または商

標です。Systemwalker、Interstage、CollaborationRing、およびSymfowareは、富士通株式会社の登録商標です。

UNIXは、米国およびその他の国におけるオープン・グループの登録商標です。

VMware、VMwareロゴ、Virtual SMPおよびVMotionはVMware,Incの米国およびその他の国における登録商標または商標です。

PowerChute は、American Power Conversion Corporation の米国およびその他の国における登録商標です。

その他記載の会社名、製品名は、それぞれの会社の商標または登録商標です。

また、本書に記載されている会社名、システム名、製品名等には必ずしも商標表示(TM・(R)）を付記しておりません。

Microsoft Corporationのガイドラインに従って、画面写真を使用しています。

平成22年 8月

改版履歴

平成22年 8月初版

Copyright 2010 FUJITSU LIMITED

- iii -

目　次

第1章概要................................................................................................................................................................................11.1 VMware HA運用管理テンプレートとは.............................................................................................................................................11.2 動作環境.............................................................................................................................................................................................1

1.2.1 Systemwalker Runbook Automationのバージョン.......................................................................................................................11.2.2 導入形態......................................................................................................................................................................................1

1.3 運用手順の概要..................................................................................................................................................................................21.4 動作条件.............................................................................................................................................................................................3

1.4.1 ハードウェア条件..........................................................................................................................................................................31.4.2 ソフトウェア条件............................................................................................................................................................................3

第2章セットアップ......................................................................................................................................................................52.1 Systemwalker技術情報ホームページからのダウンロード.................................................................................................................52.2 運用フローセットの設定......................................................................................................................................................................5

2.2.1 Interstage BPM Studio for Systemwalkerに運用操作部品をインポート.....................................................................................62.2.2 Interstage BPM Studio for Systemwalkerに運用フローセットをインポート.................................................................................62.2.3 Interstage BPM Studio for Systemwalkerを使用して、運用フローセットを変更.........................................................................8

2.3 運用自動化サーバの設定................................................................................................................................................................102.3.1 サーバのアカウント管理機能のセットアップ..............................................................................................................................102.3.2 運用コマンドの配置...................................................................................................................................................................102.3.3 環境変数の設定.........................................................................................................................................................................10

2.4 運用自動化サーバに運用フローセットを登録.................................................................................................................................112.4.1 運用自動化サーバに運用操作部品を登録..............................................................................................................................112.4.2 運用自動化サーバに運用フローセットを登録..........................................................................................................................112.4.3 運用フローセットの伝票種別コードを確認................................................................................................................................112.4.4 停電時に運用フローセットが実行されるように設定..................................................................................................................11

第3章運用..............................................................................................................................................................................133.1 停電を検出した場合の運用.............................................................................................................................................................13

3.1.1 運用フローセット更新中に電源切断が発生した場合...............................................................................................................13

付録A 運用フローセット開発者向けリファレンス........................................................................................................................14A.1 ESXサーバ上の仮想マシンをシャットダウンする............................................................................................................................14A.2 ESXサーバをメンテナンスモードに変更する..................................................................................................................................16A.3 ESXサーバを強制シャットダウンする..............................................................................................................................................19

付録B 運用操作部品の開発者向けリファレンス........................................................................................................................23B.1 ESXサーバ上の仮想マシンをシャットダウンする............................................................................................................................23B.2 ESXサーバをメンテナンスモードに変更する..................................................................................................................................24B.3 ESXサーバを強制シャットダウンする...............................................................................................................................................26

付録C 運用コマンドリファレンス................................................................................................................................................28C.1 VMware HA伝票起票コマンド.........................................................................................................................................................28

- iv -

第1章概要

本章では、Systemwalker Runbook AutomationでVMware HA運用管理テンプレートを利用する場合の概要について説明します。

1.1 VMware HA運用管理テンプレートとは

VMwareをHAクラスタ構成で利用している場合、仮想サーバをシャットダウンしたあとメンテナンスモードに切り換えてから、ESXサー

バのシャットダウンをする必要があります。

しかし、停電時には、この操作ができずにシステムトラブルを引き起こす危険性があります。

システムトラブルの例として、ESXサーバが管理できなくなる、VMware HA構成が壊れて再構成が必要になるなど、業務を復旧するま

での時間が長くなる場合があります。

「Systemwalker Runbook Automation」でVMware HA運用管理テンプレートを利用すれば、停電時に自動で仮想サーバを停止してか

らメンテナンスモードに切り換え、ESXサーバをシャットダウンできます。これによりVMware HA構成の破壊を防ぐことができます。

VMware HA運用管理テンプレートは、このようにSystemwalker Runbook Automationを導入してVMwareをHAクラスタ構成で利用して

いる環境に対して、ESXサーバを適切な順番でシャットダウンするためのテンプレートです。

1.2 動作環境

本節では、VMware HA運用管理テンプレートを利用するための動作環境について説明します。

1.2.1 Systemwalker Runbook Automationのバージョン

VMware HA運用管理テンプレートの対象となるSystemwalker Runbook Automationのバージョンを以下に示します。

・ Windows版 Systemwalker Runbook Automation V14.0.0

1.2.2 導入形態

Systemwalker Runbook AutomationとVMware HA運用管理テンプレートの導入形態の全体図を図1.1に示します。

図1.1 導入形態の全体図

- 1 -

1.3 運用手順の概要

本節では、事前準備の概要と、運用の概要を説明します。

事前準備の概要

事前準備の概要を、図1.2で説明します。

図1.2 事前準備

運用フロー開発者は、VMware HA運用管理テンプレートのダウンロードを行い、業務内容に応じて設定をした後、運用自動化サーバに

VMware HA運用管理テンプレートを登録します。

運用の概要

運用の概要を図1.3で説明します。

図1.3 運用

停電を検出した場合、UPS装置から運用自動化サーバに通知します。その結果、運用フローが動作したあとでESXサーバを停止しま

す。

- 2 -

ポイント

使用可能なUPS装置

UPS装置は、停電を検出したときに、運用自動化サーバのコマンドを実行できる必要があります。

例えば、以下のUPS装置を使用する場合、管理ソフト”PowerChute Network Shutdown Standard v2.2.4/v2.2.5”を使用することで、停電

を検出したときに運用自動化サーバのコマンドが実行可能です。詳細は、使用するUPS装置と管理ソフトのドキュメントを参照してくだ

さい。

・ Smart-UPS C500J

・ Smart-UPS 750J

・ Smart-UPS 1500J

・ Smart-UPS 1500RMJ

・ Smart-UPS 3000RMJ

・ Smart-UPS RT 5000

・ Smart-UPS RT 10000VA

1.4 動作条件

1.4.1 ハードウェア条件

[UPS装置]

以下の条件を満たしている必要があります。

・停電を検出したときに、運用自動化サーバのコマンドを実行できること。

1.4.2 ソフトウェア条件

VMware HA運用管理テンプレートを使用する場合、以下がインストールされている必要があります。

[運用自動化サーバ]

・ Windows PowerShell 1.0以降 (注１)

・ VMware vSphere PowerCLI 4.0 または、4.1

[vCenter サーバ]

・ VMware vSphere 4.0 （注２）のコンポーネントであるVMware vCenter Server

[管理対象サーバ(ESXサーバ）]

・ VMware vSphere 4.0 のコンポーネントであるVMware ESX（注３）

注意

[注１]

Windows Server 2008 R2では、Windows PowerShell 2.0がデフォルトでインストールされています。したがって、新たにインストールす

る必要はありません。

Windows PowerShellのスクリプト実行ポリシーは、「RemoteSigned」に変更する必要があります。実行ポリシーの詳細は、WindowsPowerShellのマニュアルを参照してください。

実行ポリシーを変更するためには、PowerShellを起動したあとで、以下のコマンドを実行してください。

> Set-ExecutionPolicy RemoteSigned

- 3 -

[注２]

vCenter サーバは、運用自動化サーバからVMware vSphere PowerCLIを利用して、HTTPS 経由で通信されます。このため、ファイア

ウォールでポート 443 (HTTPS)が有効になっている必要があります。

[注３]

VMware HAを使用することを前提とします。なお以下の機能とは併用しないでください。

・ VMware Fault Tolerance

・ VMware DRS（Distributed Resource Scheduler）

- 4 -

第2章セットアップ

本章では、Systemwalker Runbook Automationにおいて、VMware HA運用管理テンプレートで運用する場合のセットアップ方法につ

いて説明します。

2.1 Systemwalker技術情報ホームページからのダウンロード

ダウンロードの方法を以下に示します。

1. Systemwalker Runbook Automationが導入されていない場合は、Systemwalker Runbook Automationを導入します。

2. Systemwalker 技術情報ホームページで公開している VMware HA 運用管理テンプレート（ファイル

名 swrba_template_vmware.exe）をダウンロードします。

3. ダウンロードしたVMware HA運用管理テンプレートのファイルは圧縮されているため、展開してください。展開すると、以下の構

成になります。

[swrba_template_vmwareフォルダ]

├ swrba_template_vmware_flow.bar (1)

├ swrba_template_vmware_tool_VMshutdown.zip (2)

├ swrba_template_vmware_tool_esxmaintenance.zip (3)

├ swrba_template_vmware_tool_esxshutdown.zip (4)

├ swrba_haesxstop.bat (5)

├ readme.txt (6)

それぞれのファイルに関して、内容を表2.1に示します

表2.1 VMware HA運用管理テンプレートの構成

種別内容

(1) 運用フローセット VMware HA構成で運用しているESXサーバをシャットダウンする運用フ

ローセットです。

(2) 運用操作部品仮想マシンをシャットダウンする運用操作部品です。

(3) 運用操作部品 ESXサーバをメンテナンスモードに変更する運用操作部品です。

(4) 運用操作部品 ESXサーバを強制シャットダウンする運用操作部品です。

(5) 運用コマンド ESXサーバをシャットダウンするためにフローを動作させるための運用コ

マンドです。

(6) 使用説明書使用説明書です。

2.2 運用フローセットの設定

Systemwalker Runbook AutomationにVMware HA運用管理テンプレートを登録する場合、Interstage BPM Studio for Systemwalkerで、事前にvCenterサーバのホスト名およびESXサーバ名の設定が必要になります。以下の手順で設定を実施してください。

Interstage BPM Studio for Systemwalkerに、運用操作部品をインポートする。（“2.2.1 Interstage BPM Studio for Systemwalkerに

運用操作部品をインポート”参照)

Interstage BPM Studio for Systemwalkerに、運用フローセットをインポートする。（“2.2.2 Interstage BPM Studio for Systemwalker

に運用フローセットをインポート”参照）

- 5 -

Interstage BPM Studio for Systemwalkerを使用して、フローを変更する。（“2.2.3 Interstage BPM Studio for Systemwalkerを使用

して、運用フローセットを変更”参照）

2.2.1 Interstage BPM Studio for Systemwalkerに運用操作部品をインポート

Interstage BPM Studio for Systemwalkerに運用操作部品をインポートするための方法を説明します。

VMware HA運用管理テンプレートの運用操作部品は、３つのファイルで構成されています。このためそれぞれのファイルに対して、以

下の操作を実施します。

1. [運用操作部品管理]ビューで、[サーバの操作]カテゴリを右クリックします。ポップアップメニューから、[運用操作部品のインポー

ト]を選択します。

2. [運用操作部品のインポート]ダイアログが開きます。以下の２つの入力を実施します。

－ [アーカイブ・ファイル]フィールドにインポートする運用操作部品を選択します。[参照]をクリックし、Systemwalker技術情報

ホームページからダウンロードした以下のインポートする.zipファイルを選択し、[OK]をクリックします。

[ファイル名]

swrba_template_vmware_tool_VMshutdown.zip

swrba_template_vmware_tool_esxmaintenance.zip

swrba_template_vmware_tool_esxshutdown.zip

－ [プロセス定義エディタのパレットに運用操作部品を登録する]をチェックします。

3. [プロセス定義エディタのパレットに運用操作部品を登録する]をチェックしてインポートを行った場合、Interstage BPM Studio forSystemwalker を再起動するかどうかを確認するダイアログが表示されます。すぐに再起動する場合は、[はい]をクリックします。

2.2.2 Interstage BPM Studio for Systemwalkerに運用フローセットをインポート

Interstage BPM Studio for Systemwalkerに運用フローセットをインポートする方法を説明します。

- 6 -

1. [ナビゲーター]ビューで、任意の場所を右クリックします。ポップアップメニューから、[Barファイルのインポート]を選択します。

2. [Barファイルのインポート]ダイアログが開きます。インポートするプロジェクトを指定するため以下の手順に従います。

(1) [アーカイブ・ファイル]フィールドにインポートする運用フローセットを選択します。

(2) [参照]をクリックしたあとで、Systemwalker技術情報ホームページからダウンロードした以下のインポートする.barファイルを選

択し、[OK]をクリックします。

[ファイル名]

swrba_template_vmware_flow.bar

(3) [プロジェクト名]から、インポートするプロジェクトの名前を選択します。インポートするプロジェクトの名前がワークスペースの

他のプロジェクトと同じ場合は、エラーメッセージが表示されます。競合を避けるために、プロジェクトの名前を変更してください。

- 7 -

(4) [次へ]をクリックします。

3. [プロジェクト]ダイアログで、プロジェクトの追加情報を入力します。

プロジェクトの追加情報の入力はオプションです。プロジェクトの簡単な説明およびプロジェクト所有者の名前を入力できます。

なお、所有者は設定する必要はありません。

4. [終了]をクリックして、選択したプロジェクトコンポーネントをワークスペースにインポートします。

2.2.3 Interstage BPM Studio for Systemwalkerを使用して、運用フローセットを変更

以下の手順で、運用フローセットを変更します。

1. [ナビゲーター]ビューのProcess Definitionsから、“2.2.2 Interstage BPM Studio for Systemwalkerに運用フローセットをインポー

ト”でインポートした運用フローセットを参照します。

本テンプレートでは、ESXサーバを適切にシャットダウンするために、以下の順番で処理します。

(1) ２つのESXサーバ配下に存在する、ESX管理下のすべての仮想マシンをシャットダウンします。

(2) ２つのESXサーバをメンテナンスモードに変更します。

(3) ２つのESXサーバを強制シャットダウンします。

- 8 -

ポイント

運用フローは、表2.2に示すように６つのアクティビティが配置されています。

表2.2 アクティビティの配置

アクティビティ名目的

RBA_VMShutdown_host1 Host1の仮想マシンをシャットダウンする部品

RBA_VMShutdown_host2 Host2の仮想マシンをシャットダウンする部品

RBA_ESXMaintenance_host1 Host1のESXをメンテナンスモードにする部品

RBA_ESXMaintenance_host2 Host2のESXをメンテナンスモードにする部品

RBA_ESXShutdown_host1 Host1のESXを強制シャットダウンする部品

RBA_ESXShutdown_host2 Host2のESXを強制シャットダウンする部品

2. 業務要件に合わせて、運用フローセットを変更します。

操作方法に関しては、“Interstage BPM Studio for Systemwalker 利用ガイド”を参照してください。

[ポイント]

－ VMware HA運用管理テンプレートの運用フローセットは、すべての部品が正常に動作することを前提としています。運用要

件によって、異常となる部品がある場合は、アクティビティの配置や接続条件を見直し、運用フローセットを変更してくださ

い。

－ VMware HA運用管理テンプレートの運用フローセットは、HA構成となっている２つのESXサーバを停止します。このため３

つ以上のESXサーバを停止する場合、アクティビティを配置し運用フローセットを変更してください。

3. 運用フローの入出力情報を設定します。

入力情報のうち、以下のパラメタはアクティビティごとに入力する内容が異なります。

－ hostname

－ esxname

表2.3に従い、それぞれ入力してください。

- 9 -

表2.3 アクティビティごとに入力方法

アクティビティ名 hostname esxname

RBA_VMShutdown_host1 vCenterサーバのホスト名を入力 Host1のESXサーバ名を入力する。

RBA_ESXMaintenance_host1

RBA_ESXShutdown_host1

RBA_VMShutdown_host2 vCenterサーバのホスト名を入力 Host2のESXサーバ名を入力する。

RBA_ESXMaintenance_host2

RBA_ESXShutdown_host2

注意

運用フローセットのアクティビティにおいて、「入力情報の編集」の「種別」をslipに変更しないでください。slipに変更した場合、運

用フローが実行エラーになります。

4. 運用フローセットのエクスポートをします。（エクスポートした運用フローセットは、“2.3.2 運用コマンドの配置”で使用します。）運

用フローセットのエクスポートの方法については、“Systemwalker Runbook Automation 開発ガイド”の“運用操作部品のエクス

ポート”を参照してください。

2.3 運用自動化サーバの設定

本節では、運用自動化サーバの設定方法について説明します。

2.3.1 サーバのアカウント管理機能のセットアップ

運用自動化サーバからvCenterサーバに接続するためのユーザの情報（vCenterサーバへの操作を実行するユーザ名、パスワード）が

必要になります。CMDBに、swpm_uaimportコマンドを利用して以下の情報を登録してください。

・ vCenterサーバのIPアドレス

・ vCenterサーバのOSの種別

・ vCenterサーバへの操作を実行するユーザ名

・ vCenterサーバへの操作を実行するユーザのパスワード

詳細については、“Systemwalker Runbook Automation 管理ガイド”の“サーバのアカウント管理機能”を参照してください。

2.3.2 運用コマンドの配置

Systemwalker技術情報ホームページからダウンロードした以下のファイルを、運用自動化サーバの任意のディレクトリに配置します。

[ファイル名]

swrba_haesxstop.bat

2.3.3 環境変数の設定

VMware HA運用管理テンプレートを使用するために必要な環境変数を設定する必要があります。

運用自動化サーバのシステム環境変数PATHに、以下を追加してください。

・ vSphere PowerCLIのスクリプトへのパス

<VMware vSphere PowerCLIのインストールディレクトリ>\Scripts

- 10 -

ポイント

vSphere PowerCLIのインストールディレクトリを変更しなかった場合、vSphere PowerCLIのスクリプトへのパスのデフォルトは以下を

参照してください。

32ビットアーキテクチャの場合

C:\Program Files\VMware\Infrastructure\vSphere PowerCLI\Scripts

64ビットアーキテクチャの場合

C:\Program Files (x86)\VMware\Infrastructure\vSphere PowerCLI\Scripts

2.4 運用自動化サーバに運用フローセットを登録

Systemwalker Runbook AutomationへのVMware HA運用管理テンプレートの登録方法は、以下の手順で実施します。

運用自動化サーバに運用操作部品を登録する。（“2.4.1 運用自動化サーバに運用操作部品を登録”参照）

運用自動化サーバに運用フローセットを登録する。（“2.4.2 運用自動化サーバに運用フローセットを登録”参照）

運用フローセットの伝票種別コードを確認する。（“2.4.3 運用フローセットの伝票種別コードを確認”参照）

停電時に運用フローセットが実行されるようにする。（“2.4.4 停電時に運用フローセットが実行されるように設定”参照）

2.4.1 運用自動化サーバに運用操作部品を登録

開発した運用操作部品は、運用自動化サーバに登録したあとで、運用操作部品を実行できる状態にします。

運用操作部品の登録の手順など詳細については、“Systemwalker Runbook Automation 管理ガイド”の“運用操作部品の登録”を参

照してください。

2.4.2 運用自動化サーバに運用フローセットを登録

開発した運用フローセットを、運用自動化サーバに登録したあとで、運用フローを実行できる状態にします。

運用フローセットの登録の手順など詳細については、“Systemwalker Runbook Automation 管理ガイド”の“運用フローセットの管理”を

参照してください。

2.4.3 運用フローセットの伝票種別コードを確認

コマンドから、運用フローセットを実行する場合、伝票種別コードが必要になるため、あらかじめ確認してください。（確認した伝票種別

コードは“2.4.4 停電時に運用フローセットが実行されるように設定”で使用します。）

伝票種別コードの確認方法については、"Systemwalker Runbook Automation 管理ガイド"の"伝票定義の編集"を参照してください。

2.4.4 停電時に運用フローセットが実行されるように設定

停電を検出した場合に、UPS装置から運用フローを実行されるように、設定する必要があります。

運用フローをコマンドで実行するには、swrba_haesxstop.batコマンドを使用します。UPS装置または管理ソフトの仕様に従い、停電を検

出した場合に、swrba_haesxstop.batコマンドが呼び出されるように設定をしてください。

- 11 -

swrba_haesxstop.batコマンドの使用方法は、“C.1 VMware HA伝票起票コマンド”を参照してください。

[例]

# swrba_haesxstop.bat USER1 65cts80001

ポイント

・第１引数で指定する値は、プロセスの起案者IDを指定します。

・第２引数で指定する値は、“2.4.3 運用フローセットの伝票種別コードを確認”で取得した伝票種別コードを指定します。

注意

1. 運用自動化サーバの運用フローセットを更新した場合、更新した運用フローセットの伝票種別コードが変更になります。このた

め運用自動化サーバの運用フローセットを更新した場合、伝票種別コードを再度取得してから、運用フローセットが実行される

ように設定してください。

2. UIアクティビティを追加し、UIアクティビティが2つ以上ある運用フローセットをswrba_haesxstop.batコマンドで実行する場合、以

下の２つの注意が必要です。

－回覧先を事前に設定するために、回覧ルート定義を登録する必要があります。

－運用自動化サーバの運用フローセットを更新した場合、回覧ルート定義を再登録する必要があります。

- 12 -

第3章運用

本章では、Systemwalker Runbook AutomationでVMware HA運用管理テンプレートを使用した運用を説明します。

3.1 停電を検出した場合の運用

停電を検出した場合、登録されている運用フローが自動起動され、仮想サーバをシャットダウンしたあとメンテナンスモードに切り換え

てから、ESXサーバのシャットダウンをします。

電源回復したことを確認したあとで、ESXサーバの起動を行ってください。

注意

シャットダウン時にメンテナンスモードにしているため、ESXサーバを起動するとメンテナンスモードで起動されます。このためESXサー

バを起動後に、メンテナンスモードの解除を実施してください。メンテナンスモードを解除する前に、vCenterサーバおよび運用管理

サーバが起動していることを確認してください。

3.1.1 運用フローセット更新中に電源切断が発生した場合

運用自動化サーバのVMware HA運用管理テンプレートを使用した運用フローセットを更新している最中に、停電を検出した場合、運

用フローが更新中なため正常動作しません。このため、運用自動化サーバでVMware HA運用管理テンプレートを使用した運用フロー

セットを、運用中に更新しないことを推奨します。

また、運用自動化サーバの運用フローセットを更新する場合、伝票種別コードが変更になります。このため、伝票種別コードの取得と、

UPS装置の設定が再度必要になります。詳細は“2.4.3 運用フローセットの伝票種別コードを確認”、 “2.4.4 停電時に運用フローセット

が実行されるように設定”を参照してください。

- 13 -

付録A 運用フローセット開発者向けリファレンス

本章では、VMware HA運用管理テンプレートに含まれる運用フローセットについて開発者向けに説明します。

A.1 ESXサーバ上の仮想マシンをシャットダウンする

機能説明

ESXサーバ上の仮想マシンのシャットダウン操作をします。

オプション

必須オプション

(1) hostname

vCenterサーバのホスト名またはIPアドレスです。

ホスト名またはIPアドレスを省略した場合、引数エラーとなります。

ホスト名またはIPアドレスの文字数の上限は、1024バイトです。1024バイト以上の場合、引数エラーとなります。

(2) esxname

ESXサーバの名前です。

ESXサーバ名を省略した場合、引数エラーとなります。

ESXサーバ名の文字列の上限は、1024バイトです。1024バイト以上の場合、引数エラーとなります。

- 14 -

詳細オプション

(1) execusername

ESXサーバへの操作を実行するユーザ名です。

実行ユーザ名の入力を省略した場合、引数エラーとなります。ただし実行ユーザ名と、実行に必要なパスワードを両方とも省略し

た場合、指定したホスト名またはIPアドレスを元に構成管理データベース(CMDB)を検索し、取得した管理者ユーザの値を

Systemwalker Runbook Automationが自動的に設定します。

実行ユーザ名の文字列の上限は、1024バイトです。1024バイト以上の場合、引数エラーとなります。

(2) execpassword

ESXサーバへの操作を実行するユーザのパスワードです。

実行に必要なパスワードの入力を省略した場合、引数エラーとなります。ただし実行ユーザ名と、実行に必要なパスワードを両方と

も省略した場合、指定したホスト名またはIPアドレスを元に構成管理データベース(CMDB)を検索し、取得した管理者ユーザのパ

スワードの値をSystemwalker Runbook Automationが自動的に設定します。

実行に必要なパスワードの文字列の上限は、1024バイトです。1024バイト以上の場合、引数エラーとなります。

(3) timeout

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

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

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

省略値は300(秒)です。

(4) retry

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

0～5の範囲で指定が可能です。

(例) 起動リトライを2回する場合：2

省略値は0(回)です。

復帰値

- 15 -

復帰値意味

0 ESXサーバへの操作に成功しました。

42 powershellコマンドが呼び出せませんでした。

161 ESXサーバへの接続または操作に失敗しました。

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

200 内部エラーが発生しました。

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

202 運用操作部品が実行されませんでした。

203 運用操作部品の実行が失敗しました。運用自動化サーバの環境に問題があります。

その他内部コマンドの呼び出しに失敗しました。

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

ESXサーバへの操作に成功した場合、"Success"という文字列を標準エラー出力します。

ESXサーバへの操作に失敗した場合、エラー内容を文字列として標準エラー出力します。

注意事項

・本運用操作部品を利用してESXサーバに操作を指示する場合、運用自動化サーバに以下のソフトウェアが必要です。

－ VMware vSphere PowerCLI

－ Windows PowerShell

・本運用操作部品では、 execusername、 execpasswordの入力を省略した場合、CMDBに格納された値をSystemwalkerRunbookAutomationが自動的に設定します。そのため、CMDBに格納された値を利用する場合、必要となる情報を事前にCMDBへswpm_uaimportコマンドを利用して格納する必要があります。

－ swpm_uaimportコマンドで指定する入力ファイル(CSV形式)の例

"vCenterサーバのIPアドレス","OS"," vCenterサーバへの操作を実行するユーザ名"," vCenterサーバへの操作を実行するユー

ザのパスワード","true","false",,"コメント"

・復帰値の確認は、BPMコンソールを用いてします。詳細については、“Systemwalker Runbook Automation 管理ガイド”の“伝票の

処理状況確認”を参照してください。

・ 202、203の復帰値が出力された場合は、運用フローセットが異常終了しています。運用自動化サーバのイベントログ上に出力され

ているメッセージを確認したあとで、適切な対処を実施してください。メッセージの詳細については、“Systemwalker RunbookAutomation メッセージ集”を参照してください。

A.2 ESXサーバをメンテナンスモードに変更する

機能説明

ESXサーバをメンテナンスモードに変更します。

オプション

- 16 -


(1) hostname




(2) esxname




- 17 -


(1) execusername






(2) execpassword






(3) timeout





(4) retry





復帰値

- 18 -

復帰値意味













注意事項












A.3 ESXサーバを強制シャットダウンする

機能説明

ESXサーバを強制シャットダウンします。

オプション

- 19 -


(1) hostname




(2) esxname




- 20 -


(1) execusername






(2) execpassword






(3) timeout





(4) retry





復帰値

- 21 -

復帰値意味













注意事項












- 22 -

付録B 運用操作部品の開発者向けリファレンス

本章では、VMware HA運用管理テンプレートに含まれる運用操作部品について開発者向けに説明します。

B.1 ESXサーバ上の仮想マシンをシャットダウンする

記述形式

swrba_esx_vm_shutdown.rb -input 入力情報ファイル

機能説明

ESXサーバ上の仮想マシンのシャットダウン操作をします。

オプション

-input

運用操作部品に入力情報を入力します。

入力情報ファイル

運用操作部品への入力情報を格納したXML形式ファイルの名前(絶対パス)です。

運用操作部品の動作に必要な入力情報

(1) hostname

vCenterサーバのホスト名です。

ipaddressを指定する場合、hostnameを指定する必要はありません。

hostnameとipaddressの両方を指定した場合、ipaddressを優先します。

hostnameとipaddressの両方を省略した場合、引数エラーとなります。

ホスト名の文字数の上限は、1024バイトです。1024バイト以上の場合、引数エラーとなります。

(2) ipaddress

vCenterサーバのIPアドレスです。




IPアドレスの文字数の上限は、1024バイトです。1024バイト以上の場合、引数エラーとなります。

(3) esxname




(4) execusername


実行ユーザ名を省略した場合、引数エラーとなります。


(5) execpassword


実行に必要なパスワードを省略した場合、引数エラーとなります。

- 23 -


復帰値

復帰値意味


42 powershellコマンドの呼び出しに失敗しました。


197 入力情報に誤りがありました。

198 オプションの指定に誤りがありました。









利用ライブラリ

入力情報ライブラリ

コマンドライブラリ

注意事項




B.2 ESXサーバをメンテナンスモードに変更する

記述形式

swrba_esx_maintenance.rb -input 入力情報ファイル

機能説明

ESXサーバをメンテナンスモードに変更します。

オプション

-input




- 24 -


(1) hostname






(2) ipaddress






(3) esxname




(4) execusername




(5) execpassword




復帰値

復帰値意味













- 25 -





注意事項




B.3 ESXサーバを強制シャットダウンする

記述形式

swrba_esx_shutdown.rb -input 入力情報ファイル

機能説明

ESXサーバを強制シャットダウンします。

オプション

-input





(1) hostname






(2) ipaddress






(3) esxname




- 26 -

(4) execusername




(5) execpassword




復帰値

復帰値意味

















注意事項




- 27 -

付録C 運用コマンドリファレンス

本章では、Systemwalker Runbook AutomationでVMware HA運用管理テンプレートで運用する場合のテンプレートに含まれる運用コ

マンドについて説明します。

C.1 VMware HA伝票起票コマンド

記述形式

swrba_haesxstop.bat プロセスの起案者ID 伝票種別ID

機能説明

ESXサーバ上の仮想マシンのシャットダウン操作をする伝票を起票します。

オプション

プロセスの起案者ID

起案するプロセスの起案者IDを指定します。

起案するプロセスの起案権限を持ったIDにしてください。

伝票種別ID

起案する伝票の伝票種別IDを指定します。

復帰値

復帰値意味

0 正常終了

1 コマンド実行エラー

2 パラメタエラー

3 環境定義エラー

4 内部エラー

5 データベースアクセスエラー

6 ファイル入出力エラー

20 プロセス起案エラー

不定強制終了

実行に必要な権限/実行環境

・ Administrator権限が必要です。ご利用OSがWindows Server 2008の場合は、管理者として実行してください

・運用自動化サーバで実行可能です。

注意事項

・運用フローセットのアクティビティにおいて、「入力情報の編集」の「種別」をslipに変更した場合、本コマンドは使用できません。

- 28 -

Documents

VMware HA運用管理テンプレート 説明書 - Fujitsu...本書は、Systemwalker Runbook Automation V14.0.0のVMware HA運用管理テンプレートを使用した運用について説明しています。

VMware HA運用管理テンプレート説明書 - Fujitsu...本書は、Systemwalker Runbook Automation V14.0.0のVMware HA運用管理テンプレートを使用した運用について説明しています。