Hitachi IT System Configuration Manager 解説

解説書

3021-3-471-20

前書き

対象製品

P-2A61-11A4 Hitachi IT System Configuration Manager 10-04（適用OS：Windows Server 2008 R2，Windows Server 2012 R2，Windows 7，Windows 8.1）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，BladeSymphony，Cosminexus，Groupmax，HiRDB，JP1，ServerConductor，uCosminexusは，株式会社 日立製作所の商標または登録商標です。

BSAFEは，米国EMC コーポレーションの米国およびその他の国における商標または登録商標です。

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

Microsoft, Excel, MS-DOS, Windows, およびWindows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。

Red Hatは，米国およびその他の国でRed Hat, Inc. の登録商標もしくは商標です。

RSAは，米国EMC コーポレーションの米国およびその他の国における商標または登録商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

Hitachi IT System Configuration Managerは，米国EMC コーポレーションのRSA BSAFE(R)ソフトウェアを搭載しています。

This product includes software developed by Ben Laurie for use in the Apache-SSL HTTP

server project.

Portions of this software were developed at the National Center for Supercomputing

Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley

and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5

Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie

Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open

source software, written by Philip Hazel, and copyright by the University of

Cambridge, England. The original software is available from

ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

This product includes software developed by Ralf S. Engelschall <rse@engelschall.com>

for use in the mod_ssl project (http://www.modssl.org/).

This product includes software developed by the Apache Software Foundation

(http://www.apache.org/).

This product includes software developed by IAIK of Graz University of Technology.

This product includes software developed by the Java Apache Project for use in the

Apache JServ servlet engine project (http://java.apache.org/).

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi

(http://relaxngcc.sf.net/).

This product includes software developed by Andy Clark.

マイクロソフト製品のスクリーンショットの使用について

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

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

製品名

Windows

Windows Server 2008 R2

Microsoft(R) Windows Server(R) 2008 R2 Standard 日本語版

Microsoft(R) Windows Server(R) 2008 R2 Enterprise 日本語版

Microsoft(R) Windows Server(R) 2008 R2 Datacenter 日本語版

Windows Server 2012 R2

Microsoft(R) Windows Server(R) 2012 R2 Standard 日本語版

Microsoft(R) Windows Server(R) 2012 R2 Datacenter 日本語版

Windows 7

Microsoft(R) Windows(R) 7 Professional 日本語版(64ビット版)

Microsoft(R) Windows(R) 7 Enterprise 日本語版(64ビット版)

Microsoft(R) Windows(R) 7 Ultimate 日本語版(64ビット版)

Windows 8.1

Windows(R) 8.1 Pro 日本語版(64ビット版)

Windows(R) 8.1 Enterprise 日本語版(64ビット版)

Excel

Microsoft(R) Excel

Microsoft(R) Office Excel

MS-DOS

Microsoft(R) MS-DOS(R)

発行

2016年 3月　3021-3-471-20

著作権

All Rights Reserved. Copyright (C) 2014, 2016, Hitachi, Ltd.

変更内容

変更内容（3021-3-471-20）Hitachi IT System Configuration Manager 10-04

追加・変更内容

変更個所

Windows 7，Windows 8.1に対応しました。

−

Hitachi IT System Configuration Manager 10-03

追加・変更内容

変更個所

設計書の入力項目に，特殊文字定義および設計書オプション定義を追加しました。

2.11.4(2)

Cosminexusセットアップ手順に，仮想サーバグループの存在確認および管理ユニットから仮想サーバグループの削除の処理を追加しました。

付録D

用語解説に，UOCおよび設計書を追加しました。

付録I

単なる誤字・脱字などはお断りなく訂正しました。

変更内容（3021-3-471-10）Hitachi IT System Configuration Manager 10-01

追加・変更内容

インストールおよびアンインストール画面を変更しました。

サービスを起動する画面を変更しました。

業務システムを構築する手順に注釈を追加しました。

Cosminexusを構築する場合の注意事項を追加しました。

はじめに

このマニュアルはプログラムプロダクトP-2A61-11A4　Hitachi IT System Configuration Managerの製品概要について説明するものです。なお，このマニュアルでは，Hitachi IT System Configuration ManagerをISCMと表記します。

またISCMは，uCosminexus Service Directorの後継製品です。このため，このマニュアルでは「uCosminexus Service Director」またはuCosminexus Service Directorの略称である「uCSD」と表記した個所があります。「uCosminexus Service Director」は「Hitachi IT System Configuration Manager」に，「ISCM」は「uCSD」に適宜読み替えてください。

対象読者

ISCMを使って業務システムを構築／運用する方々を対象としています。

このマニュアルは，次の内容を理解されていることを前提としています。

クラウドコンピューティングに関する知識

Windowsに関する基本的な知識

JP1のITリソース管理に関する基本的な知識

ミドルウェア製品に関する基本的な知識

1　製品概要

この章では，Hitachi IT System Configuration Managerの機能概要について説明します。

1.1　機能概要

Hitachi IT System Configuration Manager（以降，ISCMと表記します。）は，信頼性や性能を考慮したPaaS（Platform as a Service）基盤に関するSI業務（設計・構築・運用・保守）を省力化し，迅速な業務システム構築と安定したサービス提供を支援します。

1.2　前提条件

ISCMの前提OSおよび前提ソフトウェア（同一装置内前提ソフトウェア／システム内前提ソフトウェア）のバージョンや種類については，リリースノートを参照してください。

1.3　機器構成

ISCMを利用して実現するPaaS環境の構成例を次の図に示します。

図1‒1　機器構成図（ハイパーバイザ種別がVMwareの場合）

図1‒2　機器構成図（ハイパーバイザ種別がHVMの場合）

図1‒3　機器構成図（管理LANのみの構成，かつハイパーバイザ種別がVMwareの場合）

また，図中の機器・プログラムの説明を次の表に示します。

表1‒1　機器構成の説明

項番

機器・プログラム

説明

1

uCosminexus Application Server

仮想化環境上のCosminexusを管理します。

仮想サーバマネージャ機能を使用します。

2

JP1/ITRM

ISCMの前提製品であり，JP1/IT Resource Management - Managerの略称です。仮想化環境のITリソースを管理します。

3

HV（ハイパーバイザ）

管理ソフトウェア

ハイパーバイザを一括して管理します。

JP1/ITRMは，ハイパーバイザ管理ソフトウェアを管理します。

4

HV（ハイパーバイザ）

仮想マシンを実現するための制御プログラムです。

ハイパーバイザの上位で仮想マシンを動作できます※。

注※　管理LANのみの構成の場合，HVMは未サポートです。

5

管理用端末

ITリソース管理者が，管理サーバマシンを利用する端末です。

管理用サーバマシンに直接ログインすることもできます。

6

共有ディスク

主に仮想サーバの仮想イメージが格納されます。

JP1/ITRMが管理し，デプロイ時はここに格納されている仮想イメージから仮想ホストを構築します。

7

LB

ロードバランサです。

業務システムへのリクエストの負荷分散を行います。

仮想サーバマネージャがサポートするLBは，ISCMの構成管理対象にできます※。

注※　管理LANのみの構成の場合は，ISCMの構成管理対象にできません。

8

管理LAN

各マシン，システムの管理用データが流れるLANです。

PaaS提供者やPaaS利用者によるISCMの運用データは管理LANを経由します。

9

業務LAN

業務用のデータが流れるLANです。

管理LANと同じ場合もあります。逆に，性能要件や，セキュリティ要件で，業務LANが複数に分かれることもあります。

10

管理用サーバマシン

仮想環境または物理環境を管理・運用するマシンです。

ISCMを運用する際は，このマシンにログインして操作します。

11

HV（ハイパーバイザ）

管理用サーバマシン

業務システムの仮想化環境を管理・運用するマシンです。

ハイパーバイザ管理ソフトウェアが動作します。

ハイパーバイザ種別がVMwareの場合：vCenter

ハイパーバイザ種別がHVMの場合：JP1/SC/DPM，HDvM

12

PM（Physical Machine）

物理マシンです。物理サーバやブレードに相当します。

13

GW（Gate Way）

ゲートウェイです。外部ネットワークから業務システムにアクセスするための入り口としての機能を果たす機器です。

1.4　ソフトウェア構成

ISCMをインストールする管理用サーバマシン内のソフトウェア構成を次の図に示します。

図1‒4　ソフトウェア構成図

ISCMを構成するプログラムはクライアントとサーバに分類できます。ISCMのクライアントはコマンドインタフェースを提供します。また，ISCMのサーバはWindowsサービスとして実行されます。ISCMへの操作はコマンドを使用し，サーバで処理します。

ISCMは，JP1/ITRMやCosminexus仮想サーバマネージャと連携することで，業務システムを管理します。

なお，仮想ホストのデプロイを行わない場合は，JP1/ITRMは不要です。また，Cosminexusのセットアップを行わない場合はCosminexus仮想サーバマネージャは不要です。

2　PaaS環境のライフサイクル

この章では，PaaS環境について説明します。

2.1　アクターの整理

ISCMを使用する上で，想定するアクターは，PaaS提供者とPaaS利用者です。

PaaS提供者は，PaaS利用者が使用するアプリケーションが動作するためのPaaS基盤（ハードウェア，OS，ミドルウェア）を安定的かつ効果的に構築・運用管理する責任があります。

一方で，PaaS利用者は，PaaS基盤上にアプリケーションを動作させ，業務システムとして構築・保守し，エンドユーザにサービスを提供する責任があります。

2.2　前提作業

2.2.1　ISCMで仮想ホストをデプロイする場合

ISCMで，PaaS環境を構築する前に，「仮想ホストを構築する」作業が完了していることが前提となります。その仮想ホストで，PaaS利用者の業務システムに使用されるミドルウェアもインストールした環境で，仮想イメージテンプレートを作成する必要があります。

また，インストールするミドルウェアは次のような状態にしてください。

ミドルウェア

状態

Cosminexus

仮想サーバマネージャで操作が開始できる状態にしてください。

上記以外

テンプレートに含むセットアップスクリプトの前提に合わせた状態にしてください。

詳細については，マニュアル「JP1/IT Resource Management - Manager 運用ガイド」の「仮想ホストを構築する」の章を参照してください。

ミドルウェアの詳細はCosminexusのマニュアル，またはインストールするミドルウェアのマニュアルを参照してください。

2.2.2　ISCMで仮想ホストのデプロイを行わない場合

ISCMでPaaS環境を構築する前に，対象のホストが存在し，PaaS利用者の業務システムに使用されるミドルウェアのインストールが完了していることが前提となります。

ISCMはPaaS環境を構築するために対象の仮想ホストに接続を行います。次の対象のOSごとに必要な設定を行ってください。

(1)　Windowsの場合

管理共有を有効にする必要があります

管理共有を有効にするには，次のレジストリーを設定したあと対象ホストを再起動してください。

ミドルウェア

状態

レジストリーキー

HKEY_LOCAL_MACHINE¥SYSTEM¥CurrentControlSet¥Services¥Lanmanserver¥parameters

レジストリーエントリー

AutoShareServer

レジストリーエントリーに設定する値

1 (DWORD)

次のコマンドでも設定できます。

reg add HKEY_LOCAL_MACHINE¥SYSTEM¥CurrentControlSet¥Services¥Lanmanserver¥parameters /v AutoShareServer /t REG_DWORD /d 1

(2)　Linuxの場合

接続用アカウントのログインshellを次のとおり設定します。

既存のアカウントを使用する場合

usermod -sコマンドを実行してログインshellを/bin/bashまたは/bin/tcshに変更してください。

新規アカウントを作成する場合

useraddコマンドの実行時に，ログインshellを-sオプションで/bin/bashまたは/bin/tcshに指定してください。

初期化スクリプトの設定

通常，ログイン時にシェル初期化スクリプトが実行され，エイリアスや環境変数が自動で設定されます。シェル初期化スクリプトはアカウントごとに設定できて，ホームディレクトリに格納されます。アカウントごとのシェル初期化スクリプトがない場合，システム標準のシェル初期化スクリプトが実行されます。システム標準のシェル初期化スクリプトでエイリアスなどが設定されると動作に支障をきたすために，接続用アカウントに空の初期化スクリプトを設定する必要があります。

初期化スクリプトにはログインshellが起動したときにだけ起動するログイン用と，そのあとshellからほかのshellを起動したときにも起動するshell起動用の2種類があります。また，bashとtcshではファイル名が異なります。システム標準とアカウント個別，ログイン用とshell起動用の組み合わせに応じたファイル名を次の表に示します。

初期化スクリプトの種類

初期化スクリプトのファイル名

bash

tcsh

標準

ログイン用

/etc/profile

/etc/csh.login

shell起動用

−

/etc/csh.cshrc

個別

ログイン用

~/.bash_profile※

~/.login

shell起動用

~/.bashrc

~/.cshrc

注※

~/.bash_profileが存在しない場合は，~/.bash_loginが，~/.bash_loginも存在しないときは，~/.profileが対象のファイル名となります。

また，これらのファイルでログイン時にメッセージを出力する設定はしないでください。ssh接続時にエラーとなりcsdmideploy/csdmiundeploy/csdmiupdateコマンドが失敗します。

IP接続許可の設定

IP接続を許可するかどうかは，/etc/hosts.allowファイルおよび/etc/hosts.denyファイルで設定します。

デフォルトでは，すべてのIPアドレスからの接続が許可されています。/etc/hosts.denyファイルでの設定内容に応じて，/etc/hosts.allowファイルでの設定内容が変わります。必要に応じて，/etc/hosts.allowファイルを編集してください。

/etc/hosts.denyファイルによって，SSHプロトコルが拒否されている場合

状況に応じて，次のとおり/etc/hosts.allowファイルを編集してください。

/etc/hosts.allowファイルに，すでにSSHプロトコルの定義がある場合

次のとおり内容を編集してください。

in.sshd:他IPアドレス,ISCMサーバのIPアドレス

/etc/hosts.allowファイルに，SSHプロトコルの定義がない場合

次のとおり内容を追加してください。

in.sshd:ISCMサーバのIPアドレス

/etc/hosts.denyファイルによって，SSHプロトコルが拒否されていない場合

状況に応じて，次のとおり/etc/hosts.allowファイルを編集してください。

/etc/hosts.allowファイルに，すでにSSHプロトコルの定義がある場合

次のとおり内容を編集してください。

in.sshd:他IPアドレス,ISCMサーバのIPアドレス

/etc/hosts.allowファイルに，SSHプロトコルの定義がない場合

SSHプロトコルに対して，すべてのIPアドレスが許可されているため，ファイルの編集は不要です。

SSHの設定

csdmideploy/csdmiundeploy/csdmiupdateコマンド実行時に，管理対象のホストでSSHデーモンが起動している必要があります。また，ISCMからSSH接続するための追加の設定手順を次に示します。この手順はroot権限で実行してください。

ほかのユーザがSSH接続を使用していないことを確認する。

viなどのテキストエディタで，設定ファイルを編集する。

設定ファイルは次のファイルを使用します。

/etc/ssh/sshd_config

表2‒1　SSHの設定内容

設定項目

設定値

設定内容

PermitRootLogin

Yes

rootユーザで認証する場合は，Yesを設定しroot接続を許可します。一般ユーザで認証する場合は，設定は不要です。デフォルトはYesです。

PasswordAuthentication

Yes

パスワード認証を許可するよう設定します。

デフォルトはYesです。

Protocol

"2,1"または"2"※

使用するSSHバージョンを設定します。デフォルトはバージョン2を許可する設定です。

RequiredAuthentications2

password

オプションが有効なOSの場合，使用する認証方法を設定します。

デフォルトは"password"です。

注※

"2,1"は，バージョン1および2のどちらかを使用する場合に設定します。また，"2"はバージョン2だけを使用する場合に設定します。ISCMでは，バージョン2を使用するので，2を含めた値を設定してください。

次のコマンドを実行してSSHデーモンを再起動する。

/etc/rc.d/init.d/sshd restart

OSの構成についての注意事項

OSの構成についての注意事項を次に示します。

ディレクトリ構成やファイル構成など，OSの標準的な構成を変更しないこと。

次に示すシステム標準のコマンドのパスが変更されていないこと。

/sbin, /bin, /usr/sbin, /usr/bin

2.3　作業範囲と作業手順の概要

PaaS提供者，および，PaaS利用者の作業手順とその内容を次の表に示します。

表2‒2　PaaS提供者およびPaaS利用者の作業手順と内容

項番

作業手順

内容

PaaS

提供者

PaaS

利用者

1

ISCMの導入手順

（2.4）

2.4.1　ISCMのインストールとアンインストール

○

×

2

2.4.2　ISCMサーバ定義

○

×

3

2.4.3　ISCMのセットアップとアンセットアップ

○

×

4

2.4.4　ISCMのサービス実行ユーザ設定

○

×

5

2.4.5　ISCMのサービス開始と停止

○

×

6

2.4.6　アカウント情報の登録

○

×

7

PaaS環境の構築

（2.5）

2.5.1　テンプレート登録

○

×

8

2.5.2　マスターイメージ登録

○

○

9

2.5.3　業務システム構築

○

○

10

PaaS環境の運用

（2.6）

2.6.1　テンプレート管理

○

×

11

2.6.2　マスターイメージ管理

○

○

12

2.6.3　業務システム管理

○

○

13

2.6.4　ISCMシステム資源の管理

○

×

14

2.6.5　ISCMのトラブルシュート

○

○

（凡例）

○：作業できます。

×：作業できません。

2.4　ISCMの導入手順

ISCMを導入する流れを説明します。導入手順の概略を次の表に示します。

表2‒3　ISCM導入手順の概略

項番

手順

具体的な処理/コマンド例

参照先

1

ISCMのインストーラを起動します。

日立総合インストーラを起動

2.4.1

2

セットアップとサービス起動に必要な定義ファイルを作成します。

セットアップ定義ファイルを作成

システム定義ファイルを作成

2.4.2

3

ISCMのセットアップコマンドを実行します。

csdsetupコマンドを実行

2.4.3

4

Hitachi IT System Configuration Manager - Managerサービスの実行ユーザを設定します。

Windowsのサービス管理ツールでサービスのプロパティを変更

2.4.4

5

ISCMのサービスを起動します。

Windowsのサービス管理ツールでISCMのサービスを開始

2.4.5

6

PaaS利用者向けのアカウントを準備します。

また，業務システムでCosminexusを使用する場合，アカウント情報をISCMに登録します。

OSのユーザカウント機能で登録

csdsetaccountコマンドを実行

2.4.6

2.4.1　ISCMのインストールとアンインストール

(1)　ISCMのインストール

インストールは，PaaS提供者が，"Administrator"ユーザアカウント（Administratorsグループに所属）で実行します。ISCMのインストール手順を次に示します。

(a)　日立総合インストーラの起動

提供媒体をCD-ROMドライブに入れます。

起動した「日立総合インストーラ」の指示に従ってインストールを進めます。

インストール時には，次の項目を設定します。

ユーザ情報（図2-1）

ユーザ名：最大50文字の文字列を指定してください。

会社名：最大80文字の文字列を指定してください。

インストール先のディレクトリ（図2-2）

デフォルトでは次のディレクトリが設定されます。

システムドライブ：¥Program Files¥HITACHI¥uCSD

インストール先のディレクトリについての注意事項

インストール先のディレクトリを変更する場合，絶対パスで半角35文字以内の文字列を指定してください（全角文字での指定はできません）。

UNC表記はできません。

ネットワークドライブは指定できません。

インストーラが正常に終了すれば，インストールは完了です。

図2‒1　インストール（ユーザ情報）

図2‒2　インストール（インストール先のディレクトリ）

参考

ISCMは，次の製品を利用した遠隔管理機能に対応していません。

JP1/NETM/DM

Groupmax Remote Installation

JP1/ServerConductor/Deployment Manager

ISCMは，複数の製品のトレース形式を統一する共通部品として，日立ネットワークオブジェクトプラザトレース共通ライブラリ（HNTRLib2）をインストールしています。このとき，Windowsのシステム環境変数PathにHNTRLib2のパス（システムドライブ：¥Program Files¥Common Files¥Hitachi，システムドライブ：¥Program Files (x86)¥Common Files¥Hitachi）が追加されます。ISCMを使用する上で，日立ネットワークオブジェクトプラザトレース共通ライブラリの処理を意識する必要はありません。

ISCMをインストールしたホストの時刻は，GMTを基準とします。

ISCMをインストールしたホストに対して，同じバージョンのISCMのインストールを再度実行することでプログラムの修復ができます。

ISCMを「システムドライブ：¥Program Files¥」下にインストールする場合，システムドライブの直下に「Program」という名称のディレクトリまたはファイルがあると，インストールに失敗します。「Program」という名称のディレクトリまたはファイルがないことを確認して，インストールを実行してください。

すでにインストールしているバージョンより古いバージョンをインストールする場合は，すでにインストールしているISCMのアンセットアップ（csdunsetupコマンド）を行い，アンインストールした上で，古いバージョンのISCMをインストールする必要があります。

(b)　環境変数の設定

ISCMで設定する環境変数は，次のとおりです。

環境変数の設定方法については，OSのドキュメントを参照してください。

Path

ISCMのコマンドを使用するために設定します。必要に応じて設定してください。

次のパスをPath環境変数に追加してください。

<インストール先ディレクトリ>¥mgr¥bin

(c)　アクセス許可の設定

インストール先のディレクトリをデフォルト以外に変更した場合，<インストール先ディレクトリ>とサブディレクトリおよびファイルについては，Administratorsグループのアクセス許可に，"フルコントロール"を設定してください。

(2)　ISCMのアンインストール

アンインストールは，PaaS提供者が，"Administrator"ユーザアカウント（Administratorsグループに所属）で実行します。ISCMのアンインストール手順を次に示します。

(a)　［プログラムと機能］を起動

Windowsコントロールパネルより［プログラムと機能］を選択すると，次の図に示す［プログラムと機能］のウィンドウが表示されます。

図2‒3　 ISCMのアンインストール画面

(b)　Hitachi IT System Configuration Manager選択

［プログラムと機能］に表示されるプログラムの名前一覧より，Hitachi IT System Configuration Managerを選択し，［修復］ボタンまたは［アンインストール］ボタンを押します。

アンインストールを実行した場合，次のディレクトリおよびファイルを削除します。

<インストール先ディレクトリ>¥mgr

<インストール先ディレクトリ>¥PATCHLOG.TXT （修正パッチ適用時に作成するファイル）

<インストール先ディレクトリ>¥patch_backup_dir （修正パッチ適用時に作成するディレクトリ）

上記ディレクトリ下にあるディレクトリおよびファイルは，インストール後にISCMまたはユーザが作成，変更したものを含めてすべて削除します。必要な場合はアンインストール前にバックアップを取得してください。

また，上記ディレクトリおよびファイルを削除してインストール先ディレクトリが空になった場合は，インストール先ディレクトリも削除します。

参考

アンインストールの完了後に，一部のディレクトリが削除されないで残ることがあります。

削除されないで残ったディレクトリ，およびディレクトリ下のファイルが不要である場合は手動で削除してください。

2.4.2　ISCMサーバ定義

ISCMの導入時に必要なISCMサーバ定義として，下記2つの定義ファイルを作成します。各ファイルの詳細は，マニュアル「Hitachi IT System Configuration Managerリファレンス」を参照してください。

セットアップ定義ファイル

ISCMをセットアップするために必要なセットアップ定義ファイルを準備します。

セットアップ定義ファイルを準備する際，「2.7　csd_receive_timeout設定値の算出手順」を参照し，セットアップ定義ファイルに指定するcsd_receive_timeoutの値を算出してください。この手順は必ず実施してください。

システム定義ファイル

ISCMサービスを開始するために必要なシステム定義ファイルを準備します。

2.4.3　ISCMのセットアップとアンセットアップ

ISCMをセットアップするにはcsdsetupコマンドを，アンセットアップするにはcsdunsetupコマンドを使用します。ISCMやISCMを構成するプログラムの設定値を変更したい場合は，ISCMをセットアップする前に，セットアップ定義ファイルを作成しておく必要があります。

(1)　ISCMのセットアップ

csdsetupコマンドは，Administratorユーザアカウント（Administratorsグループに所属）で実行する必要があります。

また，csdsetupコマンドを実行するときは，次に示すWindowsサービスが存在しない，または停止している必要があります。

Hitachi IT System Configuration Manager - Manager

Hitachi IT System Configuration Manager

次のサービスが“停止”または“開始”状態である必要があります。

Hitachi IT System Configuration Manager - Manager DB Service

ISCMをセットアップする方法には，新規セットアップと上書きセットアップの2種類があります。

(a)　新規セットアップ

新規セットアップは，ISCMの運用を開始するため，実行環境を新規に構築する場合に使用する機能です。ISCMの新規インストール後，または，アンセットアップ後に，ISCMの実行環境が存在しない状態でcsdsetupコマンドを実行すると，新規セットアップ機能で実行環境を構築します。

(b)　上書きセットアップ

上書きセットアップは，次の場合に使用する機能です。

ポート番号や運用コマンドのレスポンスタイムアウト時間などの，セットアップ済みISCM実行環境の設定値を変更する場合

セットアップ済みのISCMの実行環境に対して上書きインストールを実行したあと，アップグレードしたモジュールで実行環境を再構築する場合

ISCMの実行環境が存在する状態でcsdsetupコマンドを実行すると，上書きセットアップ機能で実行環境を再構築します。

注意事項

次に示す条件をすべて満たすと，上書きセットアップが失敗することがあります。

上書きセットアップに失敗すると，ISCMのWindowsサービスが"無効"の状態となり，サービスを開始できなくなります。

ISCMのサービス開始時，依存するサービスの開始に失敗したことがある。

依存するサービスの開始が失敗したあと，OS再起動をしたことがない。

この場合，OSを再起動してから，再度セットアップを実行してください。

(2)　ISCMのアンセットアップ

csdunsetupコマンドは，"Administrator"ユーザアカウント（Administratorsグループに所属）で実行する必要があります。また，csdunsetupコマンドを実行するときは，次のWindowsサービスが停止している必要があります。

Hitachi IT System Configuration Manager - Manager

Hitachi IT System Configuration Manager

次のサービスが“停止”または“開始”状態である必要があります。

Hitachi IT System Configuration Manager - Manager DB Service

注意事項

次に示す条件をすべて満たすと，アンセットアップが正常に終了しても，ISCMのWindowsサービスが"無効"の状態で残ることがあります。

ISCMのWindowsサービス開始時，依存するサービスの開始に失敗したことがある。

依存するサービスの開始が失敗したあと，OS再起動をしたことがない。

"無効"状態のサービスを削除するには，ログオフまたはOSを再起動してください。

2.4.4　ISCMのサービス実行ユーザ設定

csdsetupコマンドでセットアップが完了したら，Hitachi IT System Configuration Manager - Managerサービスを実行するユーザアカウントを設定します。上書きセットアップの場合でも再設定が必要です。

設定手順を次に示します。

Windowsの「スタート」ボタン→「管理ツール」→「サービス」を選択して「サービス」ウィンドウを表示します。

「サービス」ウィンドウでHitachi IT System Configuration Manager - Managerサービスを右クリックし，「プロパティ(R)」を選択して「プロパティ」ウィンドウを表示します。

「プロパティ」ウィンドウの「ログオン」タブを表示して，「アカウント(T)」を選択します。

「アカウント(T)」，「パスワード(P)」，「パスワードの確認入力(C)」の入力欄にAdministratorsグループに所属するユーザのユーザ名とパスワードを入力します。

必ずAdministratorsグループに所属するユーザを設定してください。Administratorsグループに所属していないユーザを設定した場合，Hitachi IT System Configuration Manager - Managerサービスの起動時にKFUD21118-Eメッセージを出力して失敗します。

また，設定を行わずにローカルシステムアカウント（SYSTEM）でHitachi IT System Configuration Manager - Managerサービスを起動した場合，同一サーバ上のJP1/ITRMに対してコマンドプロンプトなどから実行したJP1/ITRMのコマンドがKNAR81210-Eメッセージを出力して失敗する場合があります。

2.4.5　ISCMのサービス開始と停止

(1)　ISCMのサービス開始の前提

ISCMのサービスを開始する前に，システム定義ファイルを作成しておく必要があります。

この製品の前提ソフトウェア（同一装置内前提ソフトウェア／システム内前提ソフトウェア）については，ISCMを起動する前に起動しておく必要があります。

ISCMではcsdrscupdateコマンドを契機にJP1/ITRMが管理する物理構成情報を取得し，管理しています。

そのため，JP1/ITRMが管理する物理構成情報が実際の物理構成と異なっていた場合，ISCMで正しい物理配置候補を算出できない可能性があります。

物理構成情報が変更された場合は，ISCMの起動，および，csdrscupdateコマンド実行の前に，JP1/ITRMが管理する物理構成情報の更新（jirminfocollectコマンドまたはGUIによる物理構成情報の再収集）を行ってください。

JP1/ITRMが管理する物理構成情報の更新は，JP1/ITRMの管理対象の構成に影響を与える操作が完了したことを確認してから行ってください。例えば，jirminfocollectコマンドを実行中にvMotionや，ESXの再起動を行った場合，JP1/ITRMが管理している物理構成情報を正しく更新できないことがあります。

(2)　ISCMのサービス開始

ISCMを起動するには，ISCMサービスを開始して，サービスの状態を［開始］にする必要があります。ISCMサービスは，OSでサービスのスタートアップの種類を自動に設定しておくと，OSの起動時に自動的に開始できます。サービスのスタートアップの種類を自動にしない場合やISCMを再起動する場合，手動でサービスを開始して，ISCMを起動する必要があります。

ISCMの起動は，OSのAdministratorsグループに属するユーザで実行する必要があります。手動でのISCMの起動は，Windowsの［スタート］ボタン→［管理ツール］→［サービス］のウィンドウから実行します。その例を図2-4に示します。

ISCMサービスの開始は，上記［サービス］ウィンドウで，該当サービスを右クリックし，表示されるプロパティから「開始(S)」を選択することで実行されます。開始するサービスは次の表のとおりです。Hitachi IT System Configuration Managerサービスを起動すると，すべてのサービスが起動します。

表2‒4　ISCM起動時に開始するサービス名

項番

サービス名

依存関係

1

Hitachi IT System Configuration Manager - Manager DB Service

−

2

Hitachi IT System Configuration Manager - Manager

項番2を起動すると，項番1も自動起動

3

Hitachi IT System Configuration Manager

項番3を起動すると，項番2も自動起動

（凡例）

−：該当なし

図2‒4　サービスの画面

(3)　ISCMのサービス停止

ISCMを終了する場合には，ISCMサービスを停止します。ISCMの終了は，OSのAdministratorsグループに属するユーザで実行する必要があります。

ISCMの終了は，Windowsの［スタート］ボタン→［管理ツール］→［サービス］のウィンドウから実行します。

ISCMサービスの停止は，上記［サービス］ウィンドウで，該当サービスを右クリックし，表示されるプロパティから「停止(O)」を選択してください。停止するサービスの名称は次の表のとおりです。Hitachi IT System Configuration Manager - Manager DB Serviceサービスを停止すると，すべてのサービスが停止します。

表2‒5　ISCM停止時に停止するサービス名

項番

サービス名

依存関係

1

Hitachi IT System Configuration Manager - Manager DB Service

項番1を停止すると，項番2も自動停止

2

Hitachi IT System Configuration Manager - Manager

項番2を停止すると，項番3も自動停止

3

Hitachi IT System Configuration Manager

−

（凡例）

−：該当なし

2.4.6　アカウント情報の登録

(1)　仮想サーバマネージャの管理アカウント情報を登録

PaaS提供者は，業務システムでCosminexusを使用する場合，そのセットアップを行うため，仮想サーバマネージャの管理者アカウント情報を，ISCMに登録する必要があります。登録するためには，csdsetaccountコマンドを使用します。

(2)　PaaS利用者用アカウントの準備

PaaS提供者は，PaaS利用者用のアカウントを次の手順で準備します。

(a)　PaaS利用者用のユーザグループ作成

ISCMサーバ定義のシステム定義ファイル（authentication.usergroupプロパティ）で設定したグループ名を，PaaS利用者用のユーザグループとして，作成します。

(b)　PaaS利用者アカウントをPaaS利用者用グループに追加

ISCMにPaaS利用者としてアクセスを許可するアカウントを作成して，PaaS利用者用のユーザグループに追加します。

(c)　ディレクトリの権限設定

PaaS利用者用グループに，次の表に示すディレクトリ，サブディレクトリおよびファイルに対する権限を与えます。

表2‒6　ディレクトリ権限設定の一覧

項番

ディレクトリ，サブディレクトリおよびファイル

許可する権限

1

<ISCMインストールディレクトリ>¥mgr¥bin

読み取りと実行

2

<ISCMインストールディレクトリ>¥mgr¥conf

読み取り

3

<ISCMインストールディレクトリ>¥mgr¥sysconf

読み取り

4

<ISCMインストールディレクトリ>¥mgr¥log

読み取り，書き込み

5

<ISCMインストールディレクトリ>¥mgr¥data¥user

読み取り，書き込み

2.5　PaaS環境の構築

PaaS環境の構築について，概要を次の図に示します。

図2‒5　PaaS環境構築の概要

PaaS提供者について

PaaS提供者は，仮想ホストおよびミドルウェアの構成情報を定義したテンプレートを登録します。テンプレートは，構成パターンテンプレートとコンポーネントテンプレートから構成されます。構成パターンテンプレートでは，業務システムの層（tier）を定義します。また，コンポーネントテンプレートでは，構成パターンテンプレートで定義した各層の中身を定義します。ほかに，ミドルウェア定義の固定値を設定することもできます。なお，ISCMでは，APサーバ（Cosminexus）とDBサーバ（HiRDB）を構築可能とするテンプレートをサンプルとして提供しています。PaaS提供者は，このテンプレートをカスタマイズして，テンプレートを作成・登録することもできます。

PaaS利用者について

PaaS利用者は，テンプレートを基に，業務システム固有情報を付けて作成した業務システム情報一式として，マスターイメージを登録します。マスターイメージは，業務システムごとに作成して，そのあと，デプロイ指示を行うための基となるデータになります。

PaaS利用者は，新規にマスターイメージを登録する方法と，既存マスターイメージを流用して登録する方法があります。マスターイメージを登録するときに，テンプレートを選択して，業務要件（スループット／業務データ量／タイムアウト時間など）を入力します。ISCMは，選択されたテンプレートと入力された業務要件に応じて，CPU（コア数）／メモリ量／ディスク容量／APサーバ台数をサイジング処理によって決定します。なお，マスターイメージを登録するとき，その前提となるテンプレートが準備されている必要があります。また，サイジング処理については，サイジングUOCを作成して，カスタマイズすることができます。

次に，使用する物理配置を決定します※。このとき，物理配置制約ファイルに定義された制約条件をもとに，仮想ホストの配備先となる物理ホストの位置を決めることができます。

そして，IPアドレスなどネットワーク・リソース割り当て，予約を行います。これは，他利用者が同一リソースを利用することを回避するためです。ISCMは，この手順の延長で配備先のミドルウェア定義を完成させます。ここまでの手順で，マスターイメージが完成することになります。

最後に，マスターイメージを選択して，デプロイします。デプロイ時には，VM配備※，ミドルウェアの定義パラメータ配布，ミドルセットアップスクリプトの配布と実行およびhostsファイルの配布を行います。

注※　仮想ホストデプロイを行うマスターイメージだけ実行します。

次に，各手順の詳細について説明します。

2.5.1　テンプレート登録

(1)　仮想ホストデプロイを行うテンプレートの場合

ISCMで利用するテンプレートをISCMに登録してPaaS利用者が利用できるようにするためには，PaaS提供者が次の表に示す手順を実行します。

表2‒7　テンプレート登録手順

項番

手順

具体的な処理/コマンド例

1

［新規に仮想イメージテンプレートを用意する場合］

仮想イメージテンプレートの基となる仮想ホストを，仮想化ソフトウェア（VMWare，HVM）で作成します。

仮想化ソフトウェアのマニュアルを参照してください。

Cosminexus，HiRDBを使用する仮想ホストの作成例は「3.1.4　PaaS環境を準備」（VMWare），「3.2.4　PaaS環境を準備」（HVM）に記載しています。

2

［新規に仮想イメージテンプレートを用意する場合］

JP1/ITRMの仮想イメージテンプレートを作成します。

JP1/ITRMのマニュアルを参照してください。※1

3

テンプレートに付属するファイルを準備します。必要に応じて次に示すファイルを作成してください。

［構成パターンテンプレート］

サイジングUOC

［コンポーネントテンプレート］

OSの設定ファイル

ミドルウェアの定義ファイル

ミドルウェアのセットアップスクリプト

ミドルウェアのアップデートスクリプト

ミドルウェアのアンセットアップスクリプト

hostsファイルのテンプレート

新規に作成するか，ISCMが提供するテンプレートのサンプルをベースに必要個所を修正して作成します。

サイジングUOCの作成手順は「2.9.1　サイジングUOC」を参照してください。

4

登録するテンプレートファイルを準備します。

テンプレートには業務システムの構成パターンを示す構成パターンテンプレートと，各構成要素のホストとホスト上で動くミドルの定義情報を示すコンポーネントテンプレートがあります。

XMLエディタなどでファイルを開き，新規でテンプレートファイルを作成します。なお，ISCMが提供するテンプレートのサンプルをベースに必要個所を修正して，作成することもできます。

5

テンプレート登録コマンドを実行し，テンプレートをISCMに登録します。

csdtmpregister

-fテンプレートファイル名

6

登録したテンプレートを利用して業務システムを構築するテストを行い，正しく利用できることを確認します。

2.5.2　マスターイメージ登録

2.5.3　業務システム構築

7

テンプレート属性変更コマンドで，テンプレートの公開属性を「公開」にします。

csdtmpcontrol

-nテンプレート名

-a public

8

テンプレートを追加した旨をPaaS利用者に通知します。

メール，Webページなどの手段で通知します。

注※1

JP1/ITRMでGUIから仮想イメージテンプレートを登録するときにデフォルト値を設定する各項目で，業務システムの構築時にISCMが値を設定するものを次に示します。

表2‒8　仮想イメージテンプレートの設定項目

項番

設定項目

仮想イメージテンプレート登録時の指定値

業務システム構築時の設定有無

Linux

Windows

1

CPUクロック周波数

業務システム構築に必要な値はISCMが設定します。ここでは任意の値を指定してください。

○

○

2

CPUコア数

○

○

3

CPU占有種別

推奨値は占有です。

ISCMの物理構成定義ファイルを使用してCPUクロック周波数の残量管理をしながら各仮想ホストに必要なCPUを占有で割り当てることができます。

×

×

4

メモリ

業務システム構築に必要な値はISCMが設定します。ここでは任意の値を指定してください。

○

○

5

ライセンス情報

指定は任意です。必要に応じて設定してください。

−

×

6

ユーザ名

OSごとに固定値が設定されます。

Linux：root

Windows：Administrator

−

−

7

パスワード

ユーザ名に表示されたユーザのパスワードを指定してください。

×

×

8

パスワード確認

×

×

9

Windowsドメイン名/ワークグループ名

指定は任意です。必要に応じて設定してください。

−

×

10

DNSサフィックス

×

−

11

ユーザスクリプト

×

×

（凡例）

○：業務システムの構築時にサイジングの結果（サイジングを行わなかった場合はコンポーネントテンプレートの指定値）を設定します。

×：ISCMは値を設定しません。JP1/ITRMで設定したデフォルト値を使用します。

−：値の設定，変更ができない項目です。

(2)　仮想ホストデプロイを行わないテンプレートの場合

表2‒9　テンプレート登録手順

項番

手順

具体的な処理/コマンド例

1

管理対象となるホストを用意します。

対象となるホストの準備または，ISCM以外のツールを使用し仮想ホストのデプロイを実施。

2

テンプレートに付属するファイルを準備します。必要に応じて次に示すファイルを作成してください。

［構成パターンテンプレート］

サイジングUOC

［コンポーネントテンプレート］

OSの設定ファイル

ミドルウェアの定義ファイル

ミドルウェアのセットアップスクリプト

ミドルウェアのアップデートスクリプト

ミドルウェアのアンセットアップスクリプト

hostsファイルのテンプレート

新規に作成するか，ISCMが提供するテンプレートのサンプルをベースに必要個所を修正して作成します。

サイジングUOCの作成手順は「2.9.1　サイジングUOC」を参照してください。

3

登録するテンプレートファイルを準備します。

テンプレートには業務システムの構成パターンを示す構成パターンテンプレートと，各構成要素のホストとホスト上で動くミドルの定義情報を示すコンポーネントテンプレートがあります。

XMLエディタなどでファイルを開き，新規でテンプレートファイルを作成します。なお，ISCMが提供するテンプレートのサンプルをベースに必要個所を修正して，作成することもできます。

4

テンプレート登録コマンドを実行し，テンプレートをISCMに登録します。

csdtmpregister

-fテンプレートファイル名

5

登録したテンプレートを利用して業務システムを構築するテストを行い，正しく利用できることを確認します。

2.5.2　マスターイメージ登録

2.5.3　業務システム構築

6

テンプレート属性変更コマンドで，テンプレートの公開属性を「公開」にします。

csdtmpcontrol

-nテンプレート名

-a public

7

テンプレートを追加した旨をPaaS利用者に通知します。

メール，Webページなどの手段で通知します。

2.5.2　マスターイメージ登録

PaaS利用者が，マスターイメージを登録して，物理配置候補算出とリソース予約を行います。マスターイメージを登録する方法には，次の3種類があります。

新規作成

マスターイメージのコピー

マスターイメージのスナップショットから作成

なお，すべての登録方法で，マスターイメージで使用するテンプレートが登録済みである必要があります。

(1)　マスターイメージを登録する方法

(a)　新規作成

PaaS利用者が，新規にマスターイメージを作成して，登録します。手順を次の表に示します。

表2‒10　マスターイメージ登録手順（新規作成）

項番

手順

具体的な処理/コマンド例

1

構築する業務システムの目的や性能に応じたテンプレートを選択します。

PaaS提供者から提供されたドキュメントなどを参考にして選択します。

2

サイジングUOCを準備します。

新規に作成するか，テンプレートに登録済みのサイジングUOC（csdtmpls -iテンプレートID -dディレクトリ名で取得）や既存のサイジングUOCをシステム要件に基づき確認し，必要であれば修正します。サイジングUOCの作成手順は「2.9.1　サイジングUOC」を参照してください。

3

テンプレートのOSやミドルウェアのパラメータを確認し，追加・変更する定義があるかを検討します。

追加・変更する定義がある場合は，マスターイメージ定義ファイルに記述します。

−

4

サイジングUOCをISCMコマンドからアクセスできるディレクトリに置きます。

作成・修正したサイジングUOCを該当するディレクトリにコピーします。

5

下記情報を記述したマスターイメージ定義ファイルを作成します。

【マスターイメージ定義ファイルに記述する情報例】

マスターイメージ名

利用するテンプレート名

UOCのパス

UOCに渡すパラメータと値（省略可）

XMLエディタなどでマスターイメージ定義ファイルを作成します。

6

マスターイメージ登録コマンドでマスターイメージ定義ファイルをISCMに登録します（サイジングも実行）。

成功すると業務システムに割り当てたマスターイメージIDが表示されます。

csdmiregister

-f マスターイメージ定義ファイル

-d UOC格納ディレクトリ

-s

(b)　マスターイメージのコピー

PaaS利用者が，既存のマスターイメージをコピーして，登録します。手順を次の表に示します。

表2‒11　マスターイメージ登録手順（マスターイメージのコピー）

項番

手順

具体的な処理/コマンド例

1

マスターイメージ表示コマンドでコピー元のマスターイメージ定義ファイルを出力して編集します。

csdmils

-iマスターイメージID

-o マスターイメージ定義ファイル出力ファイル名（パスを指定）

2

マスターイメージ登録コマンドを利用して，既存のマスターイメージをコピーして，新しいマスターイメージを登録します（サイジングも実行※）。

csdmiregister

-f マスターイメージ定義ファイル

-i マスターイメージID

-c -s

注※　サイジングを実行しなければ，コピー元のマスターイメージの構成(ホスト台数)を引き継ぎます。

(c)　マスターイメージのスナップショットから作成

PaaS利用者が，他管理用サーバでエクスポートされたマスターイメージのスナップショットを基にして，登録します。手順を次の表に示します。

なお，マスターイメージのスナップショットの作成手順は，表2-22をご参考ください。

表2‒12　マスターイメージ登録手順（マスターイメージのスナップショットから作成）

項番

手順

具体的な処理/コマンド例

1

マスターイメージのスナップショットに含まれるマスターイメージ定義ファイルをコピーして編集します。

XMLエディタなどでマスターイメージ定義ファイルを編集

2

マスターイメージ登録コマンドでマスターイメージ定義ファイルをISCMに登録します（サイジングも実行※）。

成功すると業務システムに割り当てたマスターイメージIDが表示されます。

csdmiregister

-f マスターイメージ定義ファイル

-m マスターイメージのスナップショット

-s

注※　サイジングを実行しなければ，コピー元のマスターイメージの構成（ホスト台数）を引き継ぎます。

(2)　物理配置候補算出とリソース予約

PaaS利用者が，物理配置候補を算出して，リソース予約を行います。手順を次の表に示します。

仮想ホストデプロイを行わないマスターイメージの場合，次の表の項番1から4の作業は不要です。

表2‒13　物理配置候補算出とリソース予約の手順

項番

手順

具体的な処理/コマンド例

1

物理構成情報表示コマンドで，空きリソースを確認します。

csdrscls

-l（IPアドレス指定の場合）

2

（必要に応じて）物理配置の制約を検討し，物理配置制約ファイルを作成します。

項番1の結果と業務システムの要件を基にXMLエディタなどで物理配置制約ファイルを作成

3

マスターイメージの物理配置候補コマンドを実行し配置候補を算出します。

項番2で物理配置制約ファイルを作成した場合にはそのファイルをコマンド引数に指定します。

csdmipos

-n マスターイメージ名

(-f 物理配置制約ファイル)

4

項番3で満足する結果が得られない場合には，物理配置制約ファイルを見直し再度項番3を実行します。

−

5

割り当てるIPアドレスなどを記述したリソース定義ファイルを作成します。

−

6

リソース予約コマンドで項番3で算出したリソースを予約します。

マスターイメージの状態は，リソース確保状態になります。

csdmireserve

-n マスターイメージ名

-f リソース定義ファイルパス

2.5.3　業務システム構築

(1)　業務システムの構築

PaaS利用者が，マスターイメージを選択して，業務システムを構築する手順を次の表に示します。

マスターイメージには，ユーザ固有の処理を登録することも可能であり，ミドルウェアのセットアップ，パッチ適用，アプリの配布などのカスタマイズにも対応できます。ISCMが行うミドルウェアのセットアップ手順については「付録D　ミドルウェアのセットアップ手順」を参照してください。

表2‒14　業務システム構築手順

項番

手順

具体的な処理/コマンド例

1

業務システム構築コマンドで予約したリソースに業務システムを構築します※。

csdmideploy

-nマスターイメージ名

注※　必要に応じて業務アプリケーションを停止します。

Cosminexusの構築をする場合，業務アプリケーションの停止に関して注意事項があります。詳細については，「付録F　業務システムでCosminexusを使用する場合の注意事項」の「(3)　運用に関する注意事項」を参照してください。

(2)　構築に失敗した仮想ホストの削除

PaaS利用者が，構築に失敗した仮想ホストを削除する手順を表2-15に示します。

表2‒15　構築に失敗した仮想ホストの削除手順

項番

手順

具体的な処理/コマンド例

1

マスターイメージ表示コマンドでホストの状態が”failed(deploy)”となっている仮想ホストのホストIDを確認します。

Cosminexusを使用する仮想ホストの状態が”failed(deploy)”となっている，かつミドルウェアの状態がnotsetupではない場合，仮想ホスト名とコンポーネントIDも確認します。

csdmils

-n マスターイメージ名

-l

2

業務システムの仮想ホスト削除コマンドで，構築に失敗した仮想ホストをすべて削除します。

csdmiundeploy

-n マスターイメージ名

-p ホストID

3

マスターイメージ表示コマンドで業務システムの状態が”ready”になっていることを確認します。

csdmils

-n マスターイメージ名

4

項番3で確認した業務システムの状態が”failed(undeploy)”だった場合は，JP1/ITRMまたは仮想化ソフトウェアから該当の仮想ホストを削除します。さらに，マスターイメージ状態変更コマンドで構築に失敗した仮想ホストの状態を”reserved”に変更します。

仮想ホストの削除については，JP1/ITRMのマニュアルまたは仮想化ソフトウェアのマニュアルを参照してください。

仮想ホストの状態を変更するには，次のコマンドを実行します。

csdmivmstatus

-n マスターイメージ名

-p ホストID

-g undeployed

5

項番1でCosminexusを使用する仮想ホストの状態が”failed(deploy)”となっていた，かつミドルウェアの状態がnotsetupではなかった場合，マスターイメージ表示コマンドでマスターイメージIDを確認します。

csdmils

-n マスターイメージ名

6

項番1でCosminexusを使用する仮想ホストの状態が”failed(deploy)”となっていた，かつミドルウェアの状態がnotsetupではなかった場合，マスターイメージIDとコンポーネントIDに該当する管理ユニットの中から，仮想ホスト名に該当する仮想サーバグループを削除します。

仮想サーバグループを削除した後，管理ユニットの削除をPaaS管理者に依頼してください。管理ユニット名は「付録D　ミドルウェアのセットアップ手順」の表D-3を参照してください。

仮想サーバグループ名は「付録D　ミドルウェアのセットアップ手順」の表D-4を参照してください。

−

(3)　構築に失敗した仮想ホストの再構築

PaaS利用者が，構築に失敗した仮想ホストを再度構築する手順を表2-16に示します。

表2‒16　構築に失敗した仮想ホストの再構築手順

項番

手順

具体的な処理/コマンド例

1

仮想ホストの構築に失敗した要因を取り除きます。

ISCMのメッセージマニュアルを参照し，仮想ホスト構築失敗時に出力されたメッセージの対処に従ってください。

2

構築に失敗した仮想ホストを削除します。

構築に失敗した仮想ホストを削除する手順は表2-15を参照してください。

3

業務システム構築コマンドで削除した仮想ホストを再構築します。

csdmideploy

-n マスターイメージ名

2.5.4　ISCMがサポートするティア構成

Cosminexusのティア構成のうち，ISCMが構築する業務システムでサポートしている構成を次に示します。なお，各ティア構成の詳細については，Cosminexusのマニュアルを参照してください。

表2‒17　ISCMがサポートするティア構成

項番

サポート対象のティア構成

構成の説明

1

combined-tier構成

1台の仮想ホストにWebサーバとJ2EEサーバを構築するモデル

2

http-tier＋j2ee-tier構成

Webサーバ(http-tier)とJ2EEサーバ(j2ee-tier)を別々の仮想ホストに構築するモデル

http-tier＋j2ee-tier構成の場合，サンプルを修正する必要があります。修正方法については，「3.4　http-tier+j2ee-tier構成時の修正方法」を参照してください。

各ティア構成に対応するCosminexusのバージョンを次の表に示します。

表2‒18　各ティア構成に対応するCosminexusのバージョン

項番

ティア構成

ISCMがインストールされている管理サーバマシンのCosminexusのバージョン

ISCMが構築した仮想ホストのCosminexusのバージョン

1

combined-tier構成

09-00

09-00

2

09-50

09-00

3

09-50

09-50

4

http-tier＋j2ee-tier構成

09-50

09-50

(1)　構成パターンテンプレートの記載方法

ティア構成を定義するためには，構成パターンテンプレートに各ティア構成を記載する必要があります。各ティア構成別の構成パターンテンプレートの記載方法について次に示します。

(a)　combined-tier構成の記載方法

構成パターンテンプレートの要素の内，ティア構成に関連するAbstractSystemの構成と，マスターイメージ登録後のVirtualSystemの構成について，次に概念図を示します。

下記の構成では，AbstractSystem(WebServer+J2EEServer)を2台，AbstractSystem(DBServer)を1台にサイジングした場合を例に示しています。

図2‒6　combined-tier構成における構成パターンテンプレートとマスターイメージの関係

構成パターンテンプレートの記載例を次に示します。VirtualSystemCollection，およびAbstractSystemに着目した記載例のため，他の要素，属性は省略しています。

図2‒7　combined-tier構成における構成パターンテンプレートの記載例

(b)　http-tier＋j2ee-tier構成の記載方法

構成パターンテンプレートのAbstractSystemの構成と，マスターイメージ登録後のVirtualSystemの構成について，次に概念図を示します。

図2‒8　http-tier＋j2ee-tier構成における構成パターンテンプレートとマスターイメージの関係

構成パターンテンプレートの記載例を次に示します。VirtualSystemCollection，およびAbstractSystemに着目した記載例のため，他の要素，属性は省略しています。

図2‒9　http-tier＋j2ee-tier構成における構成パターンテンプレートの記載例

注意事項

AbstractSystemCollection内のAbstractSystemは，http-tier＋j2ee-tier構成だけを記載してください。combined-tierやCosminexsus以外の構成を記載しないでください。記載した場合，テンプレート登録時にエラーとはなりませんが，csdmireserveコマンド，またはcsdmideployコマンドで失敗，または正しくサイジングができません。

(2)　リソース予約時のネットワーク構成チェック

リソース予約時にhttp-tierとj2ee-tier間，またはj2ee-tierとDB間，combined-tierとDB間のネットワーク構成をチェックしています。したがって，次の(a)(b)両方の条件に一致する仮想ネットワークアダプタ（仮想NIC）が存在しない場合は，KFUD24229-Eメッセージを出力し，リソース予約処理はエラーとなります。

(a)仮想ネットワークデバイス用途が一致する仮想ネットワークアダプタ（仮想NIC）が存在する

(b)VLANIDが一致する仮想ネットワークアダプタ（仮想NIC）が存在する

(3)　アンデプロイ時のティアの状態

http-tier＋j2ee-tier構成の場合，構成内のティアのうち1つ以上がアンデプロイ状態となると，対象の仮想サーバグループ※は登録解除されます。これに伴い，同一構成内の他のティアについては，ミドルウェアのstatusを「notsetup」へ遷移させます。

注※　ISCMは仮想サーバマネージャのvmiunit attach／detachコマンドを実行して仮想サーバグループの登録／解除を行っています。vmiunit attach／detachコマンドで使用する仮想サーバグループ情報ファイルについては，「付録D　ミドルウェアのセットアップ手順」を参照してください。また，仮想サーバグループの詳細については，Cosminexusのマニュアルを参照してください。

(4)　パッチ適用時のティアの状態

http-tier＋j2ee-tier構成の場合，構成内のティアのうち1つ以上にマスターイメージ更新時に定義変更またはパッチが追加されると，同一構成内の他のティアも更新対象となります。これに伴い，定義更新が成功し，パッチ適用の成否にかかわらず，同一構成内の他のティアについては，ミドルウェアのステータスを「updated」へ遷移させます。

2.6　PaaS環境の運用

PaaS提供者，および，PaaS利用者の作業内容を次の表に示します。

表2‒19　PaaS環境の運用

項番

作業

内容

主に作業するアクター

参照先

1

テンプレート管理

テンプレート参照

テンプレート削除

PaaS提供者

2.6.1

2

マスターイメージ管理

マスターイメージのスナップショット作成

マスターイメージ削除

PaaS利用者

2.6.2

3

業務システム管理

業務システムのパラメータ変更

業務システムの仮想ホストのパスワード変更

OSのパッチ適用

ミドルウェアのパッチ適用

PaaS利用者

2.6.3

デプロイ先物理ホストの変更

（VMware vMotion後の移動検知）

PaaS提供者

2.6.3

4

ISCMシステム資源の管理

バックアップ

リストア

PaaS提供者

2.6.4

5

ISCMのトラブルシュート

資料採取

メッセージログ

PaaS提供者

2.6.5

次に，各作業の内容とその手順について説明します。

2.6.1　テンプレート管理

(1)　テンプレート参照

PaaS提供者，または，PaaS利用者がテンプレートを参照する手順を次の表に示します。

表2‒20　テンプレート参照手順

項番

手順

具体的な処理/コマンド例

1

テンプレート一覧表示コマンドで詳細を参照するテンプレートを見つけます。

csdtmpls

2

テンプレート詳細表示コマンドで指定したテンプレートの詳細情報を表示します。

csdtmpls

-n テンプレート名

(2)　テンプレート削除

PaaS提供者が，不要になったテンプレートを削除します。なお，削除対象とするテンプレートを使用したマスターイメージが存在しないことが前提です。手順を次の表に示します。

表2‒21　テンプレート削除手順

項番

手順

具体的な処理/コマンド例

1

テンプレート一覧表示コマンドで削除するテンプレートを見つけます。

csdtmpls

2

テンプレート詳細表示コマンドで指定したテンプレートの詳細情報を表示し，当該テンプレートを使用しているシステムがないことを確認します。

csdtmpls

-n テンプレート名

3

テンプレート属性変更コマンドで，テンプレートの公開属性を「非公開」にします。

csdtmpcontrol

-n テンプレート名

-a private

4

テンプレート削除コマンドでテンプレートを削除します。

なお，テンプレートを使用しているシステムが存在する場合はテンプレートを削除できません。

csdtmpdelete

-n テンプレート名

2.6.2　マスターイメージ管理

(1)　マスターイメージのスナップショット作成

業務システムを構成するマスターイメージからスナップショットを作成します。手順を次の表に示します。

表2‒22　マスターイメージのスナップショット作成手順

項番

手順

具体的な処理/コマンド例

1

マスターイメージ表示コマンドでマスターイメージを出力するマスターイメージのマスターイメージIDを確認します。

csdmils

2

マスターイメージのエクスポートコマンドで，マスターイメージをディレクトリに出力します。

csdmiexport

-i マスターイメージID

-d 出力先ディレクトリのパス

(2)　マスターイメージの削除

PaaS利用者は，不要になったマスターイメージを削除します。手順を次の表に示します。

なお，マスターイメージを削除する前に，業務システムが不要になっている必要があります。

表2‒23　マスターイメージの削除手順

項番

手順

具体的な処理/コマンド例

1

マスターイメージ表示コマンドで削除する業務システムのマスターイメージIDを確認します。

csdmils

2

業務システムの仮想ホスト削除コマンドで，該当する業務システムを構成する仮想ホストを削除します。

csdmiundeploy

-i マスターイメージID

3

マスターイメージの仮想ホストのリソース予約状態を解除します。

csdmirelease

-i マスターイメージID

4

マスターイメージを削除します。

csdmidelete

-i マスターイメージID

2.6.3　業務システム管理

(1)　業務システムのパラメータ変更

業務システムのパラメータを変更します。手順を次の表に示します。

表2‒24　業務システムのパラメータ変更手順

項番

手順

具体的な処理/コマンド例

1

マスターイメージ表示コマンドでパラメータを変更するマスターイメージのマスターイメージIDを見つけます。

csdmils

2

マスターイメージ表示コマンドでマスターイメージ定義ファイルを出力します。

csdmils

-i マスターイメージID

-o マスターイメージ定義ファイル出力ファイル名（パスを指定）

3

マスターイメージ定義ファイルを開き，マスターイメージのパラメータを変更します。

マスターイメージ定義ファイルの<Parameter type="fixed">要素にパラメータ名とパラメータ値を記述します。

4

マスターイメージ定義ファイルを開き，仮想マシンに転送するOS設定ファイル，またはミドルウェア定義ファイルを適切な場所に配置するためのパッチを追加します。

マスターイメージ定義ファイルの<Parameter type="patch">要素にパッチを記述します。

5

必要に応じて業務アプリケーションを停止します。※1

仮想マシンにログオン，またはリモートで，業務アプリケーションを停止してください。

6

パラメータ変更時に停止する必要があるミドルウェアかを確認し，停止する必要があれば対象ミドルウェアを手動で停止します。

仮想マシンにログオン，またはリモートで，ミドルウェアの停止コマンドを実行します。

7

マスターイメージ更新コマンドで，項番4で作成したマスターイメージを指定して，業務システムを更新します。※2※3

csdmiupdate

-i マスターイメージID

-f マスターイメージ定義ファイル

8

パラメータを変更したミドルウェアを再起動します。

仮想マシンにログオン，またはリモートで，ミドルウェアの開始コマンドを実行します。

9

項番5で停止した業務アプリケーションを開始してください。

仮想マシンにログオン，またはリモートで，業務アプリケーションを開始してください。

注※1　Cosminexusのパラメータを変更する場合，業務アプリケーションの停止に関して注意事項があります。

詳細については，「付録F　業務システムでCosminexusを使用する場合の注意事項」の「(3)　運用に関する注意事項」を参照してください。

注※2　Cosminexusの定義を直接仮想ホスト上で変更した場合の注意事項があります。

詳細については，「付録F　業務システムでCosminexusを使用する場合の注意事項」の「(3)　運用に関する注意事項」を参照してください。

注※3　Cosminexusのパラメータを変更する場合，更新失敗時の注意事項があります。

詳細については，「付録F　業務システムでCosminexusを使用する場合の注意事項」の「(1)　Cosminexusの定義更新失敗時の注意事項」を参照してください。

(2)　業務システムの仮想ホストのパスワード変更

業務システムの仮想ホストのパスワードを変更します。手順を次の表に示します。

表2‒25　業務システムの仮想ホストのパスワード変更手順

項番

手順

具体的な処理/コマンド例

1

マスターイメージ表示コマンドで，パスワードを変更する仮想マシンのホストIDを確認します。

csdmils

-i マスターイメージID

-l

2

仮想マシンのパスワードを変更します。

仮想マシンにログインし，OSのパスワード変更コマンドを実行します。

3

仮想ホストパスワード設定コマンドを実行し，ISCMが管理する仮想ホストのパスワードを変更します。

csdmisetpassword

-i マスターイメージID

-p ホストID

-w 仮想ホストパスワード

-k パスワードアクセスキー

(3)　OSのパッチ適用

OSのパッチ適用を行います。手順を次の表に示します。

表2‒26　OSのパッチ適用手順

項番

手順

具体的な処理/コマンド例

1

PaaS提供者から通知されたパッチ情報を参照し，業務システムに影響があるかを判断します。

＃OSに適用するパッチの準備，および，PaaS利用者への通知はPaaS提供者が行います。

−

2

マスターイメージ表示コマンドでパッチを適用する業務システムのマスターイメージIDを見つけます。

csdmils

3

マスターイメージ表示コマンドでマスターイメージ定義ファイルを出力します。

csdmils

-i マスターイメージID

-oマスターイメージ定義ファイル出力ファイル名（パスを指定）

4

マスターイメージ定義ファイルを開き，現在当たっているパッチを確認します。

マスターイメージ定義ファイルの<Parameter type="patch">要素の記述を確認します。

5

マスターイメージ定義ファイルにパッチ名と適用するパッチのパスを記述し，新たなマスターイメージ定義ファイルを作成します。

マスターイメージ定義ファイルの<Parameter type="patch">要素にパッチ名，パス，適用順序を記述します。

6

業務システムで稼働しているミドルを停止します。

各ミドルの停止運用を実施します。

7

マスターイメージ更新コマンドで，項番5で作成したマスターイメージ定義ファイルを指定して，マスターイメージを更新します。

csdmiupdate

-i マスターイメージID

-f マスターイメージ定義ファイル

(4)　ミドルウェアのパッチ適用

ミドルウェアのパッチ適用を行います。手順を次の表に示します。

ミドルウェアのパッチ適用機能では，パッチ形式の修正版，およびインストーラ形式の修正版の適用が可能です。下記手順内で記載している「パッチ」という用語を次のとおり読み替えて実行してください。

パッチ形式の修正版の場合：「パッチ」を「パッチ形式の修正版」と読み替える

インストーラ形式の修正版の場合：「パッチ」を「インストーラ形式の修正版」と読み替える

表2‒27　ミドルウェアのパッチ適用手順

項番

手順

具体的な処理/コマンド例

1

ミドルウェアに適用するパッチを準備します。

ミドルウェアのパッチを入手し，コマンドからアクセスできるディレクトリに置きます。

2

仮想ホストのOSに合わせてミドルウェアに適用するパッチ実行用バッチファイル，シェルスクリプトを準備します。

バッチファイル，シェルスクリプトを作成し，コマンドからアクセスできるディレクトリに置きます。

バッチファイル，シェルスクリプトの記述例は表2-28に示します。

3

マスターイメージ表示コマンドでパッチを適用するマスターイメージのマスターイメージIDを見つけます。

csdmils

4

マスターイメージ表示コマンドでマスターイメージ定義ファイルを出力します。

csdmils

-i マスターイメージID

-oマスターイメージ定義ファイル出力ファイル名（パスを指定）

5

マスターイメージ定義ファイルを開き，現在当たっているパッチを確認します。

マスターイメージ定義ファイルの<Parameter type="patch">要素の内容を確認します。

6

マスターイメージ定義ファイルにパッチ名と適用するパッチのパスを記述し，新たなマスターイメージ定義ファイルを作成します。

マスターイメージ定義ファイルの<Parameter type="patch">要素にパッチ名，パス，適用順序を記述します。

7

パッチ適用時に停止する必要があるミドルウェアかを確認し，停止する必要があれば対象ミドルウェアを手動で停止します。

仮想マシンにログオン，またはリモートで，ミドルウェアの停止コマンドを実行します。

8

マスターイメージ更新コマンドで，項番6で作成したマスターイメージを指定して，マスターイメージを更新します。

csdmiupdate

-i マスターイメージID

-f マスターイメージ定義ファイル

9

パラメータを変更したミドルウェアを再起動します。

仮想マシンにログオン，またはリモートで，ミドルウェアの開始コマンドを実行します。

(a)　パッチ適用スクリプトの記述方法

表2‒28　パッチを実行するバッチファイル，シェルスクリプトの記述例

項番

仮想ホストのOS種別

ミドルウェアの種別

記述内容※1

説明

1

Linux

Cosminexus

#!/bin/sh

−

cd /tmp/csd_tmp/patch/

パッチ格納先に移動※2

tar -xf ./middleDir/<ミドルウェアのパッチファイル名（ファイル拡張子が.tar）>

パッチを展開

uncompress ./PACK_TAR.Z

tar -xf ./PACK_TAR

echo y > ./__answer

アップデート実行確認応答用ファイル__answerを作成し，yを応答するように設定

./UPDATE < ./__answer

アップデート実行確認応答用ファイルを使用して，アップデートを実行※3

exit $?

アップデートの戻り値を返却

2

Linux

HiRDB

#!/bin/sh

−

cd /tmp/csd_tmp/patch/updatePatch

パッチ格納先に移動※2

gunzip ./middleDir/<ミドルウェアのパッチファイル名（ファイル拡張子が.tar.gz）>

パッチを展開

tar -xf ./middleDir/<ミドルウェアのパッチファイル名（ファイル拡張子が.tar）>

cd ./midleDir/<ミドルウェアのパッチファイル名>

展開したミドルウェアのパッチフォルダに移動

echo y > ./__answer

アップデート実行確認応答用ファイル__answerを作成し，yを応答するように設定

./UPDATE < ./__answer

アップデート実行確認応答用ファイルを使用して，アップデートを実行※3

exit $?

アップデートの戻り値を返却

3

Windows※4

Cosminexus

@echo off

−

middleDir¥<ミドルウェアのパッチファイル>　-D”middleDir”

パッチファイルを展開

PACK_ARC.EXEを直接取得した場合は不要です。※5

middleDir¥PACK_ARC.EXE -D”middleDir¥work”

パッチファイルを展開※5

middleDir¥work¥DISK1¥PACK_ARC.EXE -D"middleDir¥work¥DISK1"

middleDir¥work¥DISK1¥setup.exe /s

アップデータをサイレントモードで実行※6

exit /B %errorlevel%

アップデートの戻り値を返却

4

Windows※4

HiRDB

@echo off

−

echo [hirdb_server]>%SystemDrive%¥_hirdbinst.ini

echo setupid=---->>%SystemDrive%¥_hirdbinst.ini

HiRDBセットアップ種別指定ファイルの設定※7

middleDir¥<ミドルウェアのパッチファイル>　-D”middleDir”

パッチファイルを展開

PACK_ARC.EXEを直接取得した場合は不要です。※5

middleDir¥PACK_ARC.EXE -D”middleDir¥work”

パッチファイルを展開※5

middleDir¥work¥DISK1¥PACK_ARC.EXE -D"middleDir¥work¥DISK1"

middleDir¥work¥DISK1¥SETUP.EXE /s

アップデータをサイレントモードで実行※6

exit /B %errorlevel%

アップデートの戻り値を返却

注※1

次のようなフォルダ構成と仮定した記述例としています。

updatePatch

　├ <パッチ実行用バッチファイル，シェルスクリプト>

　└ middleDir

　　　└ <ミドルウェアのパッチファイル>

注※2

deploy.remote.tmppathの指定値は「/tmp/」（デフォルト値）と仮定しています。

注※3

UPDATEコマンドは次に示す返却値で終了します。

表2‒29　UPDATEコマンド返却値

返却値

意味

-1

アップデートに失敗しました。

0

アップデートは適用済みです。

1

アップデートに成功しました。

2

アップデートの実行ができない状態です。

3

アップデート対象の製品が見つかりませんでした。

4

前提パッチが適用されていません。

注※4

バッチファイル実行時のカレントディレクトリを<deploy.remote.tmppath.win指定値>¥cmd_tmp¥patch¥updatePathと仮定しています。

仮想ホストのOSがWindowsの場合，※5，※6のオプションを利用することで修正パッチの展開や実行ができます。

注※5

<ミドルウェアのパッチファイル> -D”<ディレクトリ名>”またはPACK_ARC.EXE -D”<ディレクトリ名>”

-D：ファイルを展開するディレクトリ

ディレクトリ名は””で囲み，-Dと”<ディレクトリ名>”の間に空白を入れないでください。

修正パッチの展開処理は次に示す返却値で終了します。

表2‒30　修正パッチ展開処理返却値

返却値

意味

-2

初期化に失敗しました。

0

ファイルの展開に成功しました。

1

ファイルが破壊されています。

2

オプションの指定が不正です。

3

ファイルの展開に失敗しました。

7

展開プログラムの起動に失敗しました。

注※6

SETUP.EXE /s またはsetup.exe /s

/s：サイレントモードで実行します。本オプションを設定した場合，アップデート確認ダイアログやエラーメッセージを表示しません。

アップデータの返却値は製品によって固有の値，要因がありますので，詳細は各製品のリリースノートなど付属ドキュメントを参照してください。次の表はHiRDBの返却値の例です。

表2‒31　アップデータ返却値

返却値

意味

0

アップデートに成功しました。または，すでに適用済みです。

1

アップデートに成功しました。再起動が必要です。

3

アップデート対象バージョンの製品が存在しません。

4

アップデート実行者に管理者権限がありません。

5

アップデートの前処理でエラーが発生しました。

6

アップデートの後処理でエラーが発生しました。

7

メモリ不足が発生しました。

8

ファイルのアクセスに失敗しました。

144

ファイルをほかのプロセスが使用中です。

145

前提製品がインストールされていません。

または，アップデート実行者の権限が不正です。

159

前提バージョンの製品がインストールされていません。

216

前提OSと異なるOSで実行されました。

注※7

Windows版HiRDBはインストール時に設定したセットアップ種別を指定したファイル_hirdbinst.iniをSystemDrive直下に作成することで，アップデータ実行時にセットアップ種別を応答することができます。記述内容は次のとおりです。

[hirdb_server]

setupid=----

インストール時に設定したセットアップ種別によって「setupid=----」の「----」を次のとおりに変更してください。

標準セットアップの場合：----

識別子付きセットアップの場合：<識別子>

（識別子がHRD1なら「setupid=HRD1」と設定する）

(b)　インストール形式の修正版適用スクリプトの記述方法

インストール形式の修正版を適用するには，ISCMが提供する「ミドルウェアインストールコマンド」をスクリプト上から実行します。「ミドルウェアインストールコマンド」では，内部的に日立PPインストーラを呼び出し，ミドルウェアのインストールを実行しています。

「ミドルウェアインストールコマンド」は，パッチ／インストール適用スクリプトファイルが送信されるタイミングで仮想ホストへ送信されます。「ミドルウェアインストールコマンド」のコマンド名称と，仮想ホスト上の送信先ディレクトリについては次を参照してください。

なお，「ミドルウェアインストールコマンド」の詳細については，マニュアル「Hitachi IT System Configuration Manager リファレンス」を確認してください。

コマンド名　　　　　：csdinstlin ※

送信先ディレクトリ　：<deploy.remote.tmppath定義の設定値>/csd_tmp/patch/

注※　ミドルウェアインストールコマンドは，仮想ホストがLinuxの場合だけサポートとなります（仮想ホストがWindowsの場合は未サポートです）。

注意事項

上記送信先ディレクトリにミドルウェアインストールコマンドと同名のファイル，またはディレクトリを置かないでください。置いた場合は，ミドルウェアインストールコマンドで上書きされるか，またはミドルウェアのインストールに失敗します。

「ミドルウェアインストールコマンド」はすでにインストールされているミドルウェアに対して，上書きインストールするコマンドとなります。したがって，ミドルウェアがインストールされていない仮想ホストに対して，「ミドルウェアインストールコマンド」を使用した新規インストールを行わないでください。新規インストールを実行した場合，csdmideployコマンド，またはcsdmiupdateコマンドがエラーとなる場合があります。

スクリプトファイルの記述例を次に示します。

#!/bin/sh

# 形名：P-9W43-7K91のCosminexusをインストール
./csdinstlin -k P-9W43-7K91 -s Cosmi/X64LIN
RETURN_C=$?

# インストールコマンドのリターンコードは0の場合は正常終了，それ以外は異常終了
if [ $RETURN_C -eq 0 ]
then

  # 形名：P-CC9W62-1591のHiRDBをインストール
  ./csdinstlin -k P-CC9W62-1591 -s HiRDBINST/X64LIN
  RETURN_C=$?
fi
exit $RETURN_C

注　上記は，CosminexusとHiRDBをインストールする記述例となります。

(5)　仮想ホストの再配備

構築済み仮想ホストを削除し，配備条件を変えて再度配備する手順を次の表に示します。

表2‒32　仮想ホストの再配備手順

項番

手順

具体的な処理/コマンド例

1

マスターイメージ表示コマンドで削除する仮想ホストのホストIDを確認します。

csdmils

-i マスターイメージID

-l

2

業務システムの仮想ホスト削除コマンドで，対象となる仮想ホストを削除します。

csdmiundeploy

-i マスターイメージID

-ｐ ホストID

3

対象となる仮想ホストのリソース予約を解除します。

csdmirelease

-i マスターイメージID

-ｐ ホストID

4

配備先などの物理配置を変更する場合やIPアドレスなどの割り当てたリソースを変更する場合，（必要に応じて）マスターイメージのエクスポートコマンドで，物理配置制約ファイルやリソース定義ファイルをディレクトリに出力します。

csdmiexport

-i マスターイメージID

-d 出力先ディレクトリのパス

5

配備先などの物理配置を変更する場合，物理配置の制約を検討し，項番4でエクスポートした物理配置制約ファイルを編集します。

エクスポートしていない場合は新規に物理配置制約ファイルを作成します。

XMLエディタなどで物理配置制約ファイルを編集

6

配備先などの物理配置を変更する場合，マスターイメージの物理配置候補コマンドを実行し配置候補を算出します。

csdmipos

-i マスターイメージID

-f 物理配置制約ファイル

7

IPアドレスなどの割り当てたリソースを変更する場合，項番4でエクスポートしたリソース定義ファイルを編集します。

エクスポートしていない場合は新規にリソース定義ファイルを作成します。

−

8

リソース予約コマンドで仮想ホストのリソースを予約します。

項番7でリソース定義ファイルを編集または作成した場合にはそのファイルをコマンド引数に指定します。

csdmireserve

-i マスターイメージID

(-f リソース定義ファイル)

9

業務システム構築コマンドで削除した仮想ホストを再構築します。

csdmideploy

-i マスターイメージID

(6)　デプロイ先物理ホストの変更（VMware vMotion後の移動検知）

(a)　前提条件

vMotionでデプロイ先物理ホストの変更を実行する場合の前提条件を次に示します。

項番

前提条件

説明

1

移動する対象はISCMがデプロイした仮想ホストであること。

ISCMがデプロイした仮想ホスト以外をISCMで管理する物理ホストやリソースプールに移動してもISCMの管理下には追加されません。

2

仮想ホストを移動する先の物理ホストまたはリソースプールがISCMの物理構成情報に登録されていること。

ISCMが管理していない物理ホストまたはリソースプールに移動した場合，ISCMはその仮想ホストの情報を更新しません。

3

移動元物理ホストと，移動先物理ホストの構成が一致していること。

vMotion実行後のcsdrscupdateコマンドで仮想ホストの移動の検知が正確に行えません。詳細は，表2-34を参照してください。

4

移動先物理ホストで物理配置制約，リソース制約の制約条件を満たしていること。

vMotion実行後のcsdrscupdateコマンドで仮想ホストの移動の検知が正確に行えません。詳細は，表2-34を参照してください。

5

vMotion実行中は物理構成定義ファイルを変更しないこと。

物理構成定義ファイルを変更するとvMotion実行後のcsdrscupdateコマンドで仮想ホストの移動の検知が正確に行えません。

6

移動する仮想ホストにインストールしている各種製品について，vMotionの運用評価と性能検証を十分に行っていること。

製品上で動作するアプリケーションも含めて十分に確認を行ってください。

(b)　vMotionでデプロイ先の物理ホストを変更する手順

PaaS提供者がvMotionでデプロイ先の物理ホストを変更します。

手順を表2-33に示します。

表2‒33　vMotionでデプロイ先の物理ホストを変更する手順

項番

手順

具体的な処理/コマンド

1

vMotion対応機能を使用するための定義にYが設定されていることを確認します。

csd.propertiesのresource.vmotion.use定義にYが設定されていることを確認します。設定されていない場合，Yを設定し，ISCMを再起動します。

2

物理構成情報の更新コマンドで物理構成情報を更新します。

csdrscupdate -vmotion forceコマンドを実行し，正常終了することを確認します。正常終了しなかった場合，エラー要因を取り除き再度csdrscupdate -vmotion forceコマンドを実行します。

3

vMotion対象の仮想ホストが所属するマスターイメージの物理配置制約を参照し，物理配置制約を満たす移動先※が存在することを確認します。

注※　移動先はISCM管理下の物理ホストまたはリソースプールだけをサポートします。

csdmiexport -i マスターイメージID -d フォルダ名

上記のコマンドで取得したマスターイメージのスナップショットの中にある物理配置制約ファイル(position.xml)を参照します。

4

vMotion対象の仮想ホストが使用するリソース量を確認します。

csdmils -i マスターイメージID -s

5

vMotion先の物理ホストのリソースの空き容量を参照し，vMotion対象の仮想ホストが移動しても問題ないことを確認します。

csdrscls -p物理ホストのIPアドレス -d

6

vMotion先の物理ホストにリソース予約されている仮想ホストの一覧を取得し，現在デプロイ中の仮想ホストがないかの確認，リソース予約しているPaaS利用者にデプロイ操作を行わないよう通知するなど，vMotionを実行しても問題がないことを確認します。

csdrscls -v 物理ホストのIPアドレス

7

物理リソースの状態変更コマンドでvMotion元とvMotion先の物理ホストを物理配置候補，リソース予約，デプロイの対象外にします。

csdrscstatus -p 物理ホストのIPアドレス -b -s PRD

8

再度，vMotion対象の仮想ホストが使用するリソース量を確認します。

csdmils -i マスターイメージID -s

9

再度vMotion先の物理ホストにリソース予約されている仮想ホストの一覧を取得し，現在デプロイ中の仮想ホストがなくvMotionを実行しても問題がないことを確認します。

csdrscls -v 物理ホストのIPアドレス

10

VMware vCenter Server またはJP1/ITRMからvMotionを実施します。

VMware vCenter Server，JP1/ITRMのGUIまたはjirmvmmigrateコマンド(-waitオプション指定)を使用しvMotionを実施します。

11

vMotionの正常終了を確認します。

VMware vCenter Server，JP1/ITRMのタスク画面またはjirmvmmigrateコマンド(-waitオプション指定)の正常終了を確認します。

12

VMware vCenter ServerからvMotionを実施した場合，JP1/ITRMとVMware vCenter Serverの構成情報を同期させます。

次の対象リソースに対して，JP1/ITRMのGUIからリソースの再収集を実行，またはJP1/ITRMのjirminfocollectコマンドを実行します。

vMotion対象の仮想ホスト

vMotion前の物理ホスト

vMotion後の物理ホスト

VMware vCenter Server

13

物理構成情報の更新コマンドでリソース情報の同期を行います。

csdrscupdate -vmotion force

14

物理リソースの状態変更コマンドでvMotion元とvMotion先の物理ホストを物理配置候補，リソース予約，デプロイの対象にします。

csdrscstatus -p 物理ホストのIPアドレス -c -s PRD

注　物理リソースをロック中（項番7〜項番14の間）にvMotion元とvMotion先の物理ホストに対して対象外の操作（物理配置候補，またはリソース予約，デプロイの操作）を実行した場合，各々の操作がエラーとなります。

(c)　注意事項

vMotionでデプロイ先の物理ホストを変更する場合の注意事項を次に示します。

（i）この機能は，VMware DRSやVMware HAのような仮想ホストの自動的な移動に同期してISCMの物理構成情報やリソース残量を自動的に更新する機能ではありません。VMware DRSやVMware HAを使用する物理ホストは物理構成定義ファイルでリソースの残量管理を行わないよう設定※することで，ISCMで管理するリソース残量が実態と合わない状態を回避することができます。

注※　リソースプールのCPUクロック数，メモリ容量に"0"を指定してください。

（ii）vMotionではISCM外の操作によって仮想ホストの配置が変わるため，実際のリソース残量もvMotionのタイミングで変化します。ISCMではメモリ，CPUクロックを残量管理していますが，ISCMの残量管理は実際の物理リソースと必ずしも一致しているとは限らないため，vMotionによってISCMが管理している許容量を超えることがあります。そうなった場合，表2-33項番13のcsdrscupdateコマンドが実行されたときにKFUD24728-Wメッセージを出力し，コマンドがエラーリターンします。

（iii）vMotion実行後，JP1/ITRMが管理している構成情報が未更新の場合，ISCMはvMotionによる移動を検知できません。そのため，vCenterからvMotionを実行した場合は，必ずJP1/ITRMの構成情報を更新してからcsdrscupdateコマンドを実行してください。

（iv）構成／制約不一致時のvMotion検知動作，およびユーザ対処

vMotionの前後で，ISCMが管理している物理ホストの構成が一致しなかった，または，移動先物理ホストで物理配置制約，リソース制約の制約条件を満たしていない場合のcsdrscupdateコマンドの動作，エラーとならなかった場合の後続処理への影響，およびユーザ対処を次に示します。

表2‒34　構成／制約不一致時のvMotion検知動作，およびユーザ対処

項番

構成・制約定義ファイル

構成不一致の状態

構成不一致が発生した場合の動作

エラー，警告とはならない場合の影響

ユーザ対処

1

物理構成定義ファイル

物理ホストへの移動で，移動先の物理ホストが定義されていない。

KFUD24732-Wメッセージ（要因=Pyhsicalhost Not Exist）を出力。

仮想ホストの移動は反映しない。

−

物理構成定義ファイルで定義している物理ホストかリソースプールに仮想ホストを移動する。

または，物理構成定義ファイルに移動先の物理ホスト，リソースプールを追加する。

2

リソースプールへの移動で，移動先のリソースプールまたは物理ホストが定義されていない。

KFUD24732-Wメッセージ

（要因=Resource Pool Not Exist）を出力。

仮想ホストの移動は反映しない。

3

仮想ホストを配置しているデータストアが移動先の物理ホストに定義されていない。

エラー，または警告は発生しない。

仮想ホストの移動は反映する。

特になし。

同じデータストアを定義している物理ホストに仮想ホストを移動する。

または，物理構成定義ファイルで移動先の物理ホストにデータストアの定義を追加する。

4

仮想ホストが使用している仮想ネットワークデバイスが移動先の物理ホストに定義されていない。

移動先の物理ホストに必要な数，用途の仮想ネットワークデバイスが定義されていない場合，対象マスターイメージに対して次のコマンドは実行できない。

csdmireserveコマンド※

KFUD24223-Eメッセージ（原因コード= Not Match VirtualNetworkDevice）を出力して失敗する。

仮想ネットワークデバイス構成が等しい物理ホストに仮想ホストを移動する。

または，対象物理ホストにリソース予約している仮想ホストをすべてリソース解放するか別の物理ホストに移動し，物理構成定義ファイルで移動先の物理ホストの仮想ネットワークデバイス定義を修正する。

5

仮想ホストが使用している仮想ネットワークデバイスと種別(MANAGEMENT，BUSINESS)が異なる。

6

仮想ホストが使用している仮想ネットワークデバイスと用途の指定が異なる。

7

リソース制約ファイル

移動先の物理ホストに仮想ホストが使用している仮想ネットワークデバイス名のリソース制約が定義されていない。

エラー，または警告は発生しない。

仮想ホストの移動は反映する。

仮想ホストが使用しているIPアドレスがリソース制約ファイルで許可されるまで，対象マスターイメージに対して次のコマンドは実行できない。

・csdmiupdateコマンド

KFUD23224-Eメッセージを出力して失敗する。

・csdmireserveコマンド※

KFUD24223-Eメッセージ

(原因コード= Not Match　IPAddressRange)を出力して失敗する。

リソース制約ファイルの移動先物理ホストの制約に仮想ホストが使用しているIPアドレスの許可を追加する。

8

移動先の物理ホスト，仮想ネットワークデバイス，ユーザ名，セクション名などの組み合わせで使用可能なIPアドレスが存在しない。

9

移動先の物理ホスト，仮想ネットワークデバイス，ユーザ名，セクション名などの組み合わせで使用可能なIPアドレスが現在仮想ホストで使用しているIPアドレスと異なる。

仮想ホストが使用しているIPアドレスがリソース制約ファイルで許可されるまで，対象マスターイメージに対して次のコマンドは実行できない。

・csdmiupdateコマンド

KFUD23224-Eメッセージを出力して失敗する。

10

物理配置制約ファイル

移動後の仮想ホストの配置がファイルで指定した配置制約を満たさない。

エラー，または警告は発生しない。

仮想ホストの移動は反映する。

特になし。

配置制約を満たす物理ホストに仮想ホストを移動する。

（現在の物理配置制約はcsdmiexportコマンドでエクスポートしたマスターイメージのusr¥position.xmlで確認する。）

注※　csdmiundeployコマンド，csdmireleaseコマンドでマスターイメージのアンデプロイ，リソース解放を行った後，csdmiposコマンドを実行せずに同じ物理構成で再度実行する場合のcsdmireserveコマンド。

2.6.4　ISCMシステム資源の管理

PaaS提供者が，ISCMのデータをバックアップ，および，リストアするための手順について説明します。

なお，ISCMシステム資源のバックアップを実行したマシンとは異なるマシンであってもISCMシステム資源をリストアすることもできます。

(1)　バックアップ

次の表にバックアップの手順を示します。

表2‒35　バックアップ手順

項番

手順

具体的な処理/コマンド例

1

ISCMのDB Service以外のサービスを停止します。

次のWindowsサービスを停止します。

Hitachi IT System Configuration Manager

Hitachi IT System Configuration Manager - Manager

2

ISCMのデータベースバックアップ取得コマンドを実行します。

csddbcopyコマンドを実行します。

3

テンプレート・マスターイメージなどのデータを保存するディレクトリ※下のすべてのファイルを，任意の場所にコピーします。

OSのコマンドまたはGUI操作を用いてコピーします。

4

＜インストール先ディレクトリ＞¥mgr¥conf下のすべてのファイルを，任意の場所にコピーします。

OSのコマンドまたはGUI操作を用いてコピーします。

5

ISCMのサービスを開始します。

次のWindowsサービスを開始します。

Hitachi IT System Configuration Manager

Hitachi IT System Configuration Manager - Manager

6

統合トレースログを参照し，エラー・警告メッセージが出力されていないことを確認します。

C:¥Program Files¥Hitachi¥HNTRLib2¥spool¥

hntr??log（??は数字）とC:¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥hntr??log（??は数字）を参照します。

注※　csd.properties定義ファイルのuserdata.filepathに指定したディレクトリです。デフォルトは”<インストール先ディレクトリ>¥mgr¥data”です。

(2)　リストア

次の表にリストアの手順を示します。

表2‒36　リストア手順

項番

手順

具体的な処理/コマンド例

1

ISCMのDB Service以外のサービスを停止します。

下記Windowsサービスを停止します。

Hitachi IT System Configuration Manager

Hitachi IT System Configuration Manager - Manager

2

＜インストール先ディレクトリ＞¥mgr¥conf下のすべてのファイルを削除したあと，バックアップした定義ファイルを，＜インストール先ディレクトリ＞¥mgr¥confにコピーします。

OSのコマンドまたはGUI操作を用いてコピーします。

3

バックアップ取得時の環境から変更する場合，変更後の環境に合わせてセットアップ定義ファイルを編集します。変更がない場合は編集不要です。ただし，ISCMのデータを格納するディレクトリ先（db_area_path）は変更できません。

環境に合わせてセットアップ定義ファイルを編集します。

4

セットアップオプションファイルの設定を反映させます。ただし，上記でセットアップオプションファイルの変更がない場合は不要です。

csdsetup

5

ISCMを起動するための定義ファイルを編集する。

ただし，バックアップ取得時と環境が変わらない場合は不要です。

環境に合わせてシステム定義ファイルを編集します。

6

テンプレート・マスターイメージなどのデータを保存するディレクトリ※下のすべてのファイルを削除したあと，バックアップしたテンプレート・マスターイメージなどのデータファイルを，バックアップ取得時に存在していたディレクトリにコピーします。

OSのコマンドまたはGUI操作を用いてコピーします。

7

ISCMのリストアコマンドを実行します。

csddbrstrコマンドを実行します。

8

ISCMのサービスを開始します。

下記Windowsサービスを開始します。

Hitachi IT System Configuration Manager

Hitachi IT System Configuration Manager - Manager

9

統合トレースログを参照し，エラー・警告メッセージが出力されていないことを確認します。

C:¥Program Files¥Hitachi¥HNTRLib2¥spool¥

hntr??log（??は数字）とC:¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥hntr??log（??は数字）を参照します。

注※　csd.properties定義ファイルのuserdata.filepathに指定したディレクトリです。デフォルトは”<インストール先ディレクトリ>¥mgr¥data”です。

2.6.5　ISCMのトラブルシュート

(1)　ISCMが出力するログ・トレースの概要

ISCMが出力するログ・トレースとその目的と出力先を次の表に示します。

表2‒37　ISCMが出力するログ・トレース一覧

項番

ログ・トレース名称

目的

出力先

1

セットアップログ

ISCMセットアップ時の情報を出力します。

<ISCMインストールディレクトリ>¥

mgr¥log¥csdsetup.log

2

アンセットアップログ

ISCMアンセットアップ時の情報を出力します。

<ISCMインストールディレクトリ>¥

mgr¥log¥csdunsetup.log

3

イベントログ

WindowsにインストールされたすべてのPPで共用するトレース情報出力ファイルです。問題発生個所の特定，回復のための情報提供などのために使用します。

Windows イベントログのアプリケーションログ

4

メッセージログ

ISCM固有のトレース情報出力ファイルです。サービスやコマンドの実行状況の確認，問題発生個所の特定，回復のための詳細な情報提供などのために使用します。

<ISCMインストールディレクトリ>¥

mgr¥log¥csdmessageXX.log

および

<ISCMインストールディレクトリ>¥

mgr¥log¥csdprocessmessageXX.log※1

5

アクセスログ

ユーザが運用コマンドを実行し，アクセスした記録を残します。不正アクセス検出，および，ISCMに不具合が起きた場合などのデバッグ情報として活用します。

<ISCMインストールディレクトリ>¥

mgr¥log¥csdaccessXX.log※1

6

コマンドトレースログ

ユーザが実行した運用コマンドをトレースするために活用します。

<ISCMインストールディレクトリ>¥

mgr¥log¥csdcmdtrcXX.log※1

7

統合トレースログ

日立ミドルPPで共用するトレース情報出力ファイルです。重要度が高い問題発生個所の特定，回復のための情報提供などのために使用します。

<HNTRLib2(64bit版)インストールディレクトリ>¥spool

および

HNTRLib2(32bit版)インストールディレクトリ>¥spool※2

注※1　XXは，世代管理番号を示します。

注※2　そのほか，日立ミドルPPによって統合トレースログがすでに組み込み済みである場合，出力先は既存ディレクトリの指定が優先されます。ISCMによって，新規に組み込まれる場合，<HNTRLib2インストールディレクトリ>は，<システムドライブ:¥Program Files¥HITACHI¥HNTRLib2¥spool>になります。

(2)　ISCMが出力するログ・トレースの運用

ISCMが出力するログ・トレースの運用を決めるために必要な情報を次の表に示します。各ログ・トレースに出力されるメッセージIDの詳細については，マニュアル「Hitachi IT System Configuration Manager メッセージ」を参照してください。

表2‒38　ISCMが出力するログ・トレースの運用

項番

ログ・トレース名称

面数

サイズ

管理形式

1

セットアップログ

1（固定）

最大1KB

セットアップ実行時に上書き

2

アンセットアップログ

1（固定）

最大1KB

アンセットアップ実行時に上書き

3

イベントログ

OSのイベントログ（アプリケーション）の設定

OSのイベントログ（アプリケーション）の設定

ラップアラウンド

4

メッセージログ

システム定義ファイルのlog.message.numoffiles

およびprocess.log.message.numoffilesプロパティで指定

システム定義ファイルのlog.message.filesize

およびprocess.log.message.filesizeプロパティで指定

ラップアラウンド

5

アクセスログ

システム定義ファイルのlog.access.numoffilesプロパティで指定

システム定義ファイルのlog.access.filesizeプロパティで指定

ラップアラウンド

6

コマンドトレースログ

システム定義ファイルのlog.cmdtrc.numoffilesプロパティで指定

システム定義ファイルのlog.cmdtrc.filesizeプロパティで指定

ラップアラウンド

7

統合トレースログ

統合トレースの設定値※

統合トレースの設定値※

ラップアラウンド

注※

設定を変更しない運用を推奨します。

(3)　障害発生時に採取する資料一覧

障害発生時には，次の資料を採取してください。

csdinfogetコマンド実行結果※

エラーが発生したマスターイメージの情報（csdmiexportコマンドで採取）

注※　ISCMでは障害発生時に資料を採取するためのcsdinfogetコマンドを提供しています。このコマンドを実行すると，障害の解決に必要な調査資料となる情報を採取できます。コマンドの詳細については，マニュアル「Hitachi IT System Configuration Manager リファレンス」を参照してください。

また，マスターイメージのデプロイ・アンデプロイコマンドがエラーとなった場合は次の情報も採取してください。

JP1/ITRMのトラブルシュート情報

詳細については，マニュアル「JP1/IT Resource Management - Manager 運用ガイド」を参照してください。

2.7　csd_receive_timeout設定値の算出手順

セットアップ定義ファイルに指定するcsd_receive_timeout設定値を算出する手順を説明します。

算出手順の概略を次の表に示します。

表2‒39　算出手順の概略

項番

手順

参照先

1

ユーザシステムに近い条件を選択し，パラメータ数を見積もります。

2.7.1

2

パラメータ数を基に，コマンドの実行時間を見積もります。

2.7.2

3

セットアップ定義ファイルに指定するcsd_receive_timeout設定値を算出します。

2.7.3

2.7.1　パラメータ数の見積もり

次に示す(1)〜(3)で，ユーザシステムに近い条件をそれぞれ選択し，パラメータ数を見積もります。

(1)　マスターイメージの登録・更新に影響するパラメータ

マスターイメージの登録・更新に影響するパラメータについて，仮想ホスト数とミドルウェア数の組み合わせで5つの条件を示します（次の表の下線部分）。

パラメータ数は，マスターイメージごとの上限値の約1/2に設定しています。各パラメータの上限値は「付録B　ISCMのデータベースに登録可能なパラメータ最大数と定義との対応」を参照してください。

項番

条件1

条件2

条件3

条件4

条件5

個数

合計

個数

合計

個数

合計

個数

合計

個数

合計

1

マスターイメージの登録・更新に影響するパラメータ

−

−

−

−

−

−

−

−

−

−

2

UOCパラメータ

10

10

10

10

10

10

10

10

10

10

3

接続先ネットワーク

2

2

2

2

2

2

2

2

2

2

4

仮想ホスト

1

1

5

5

10

10

10

10

20

20

5

OSのパラメータ

5

5

5

25

5

50

5

50

5

100

6

OSのサイジングパラメータ

5

5

5

25

5

50

5

50

5

100

7

OSのパッチ

60

60

60

300

60

600

60

600

60

1200

8

NICのネットワーク

2

2

2

10

2

20

2

20

2

40

9

ミドルウェア

1

1

2

10

2

20

5

50

5

100

10

ミドルウェアのパラメータ

50

50

50

500

50

1000

50

2500

50

5000

11

ミドルウェアのサイジングパラメータ

15

15

15

150

15

300

15

750

15

1500

12

ミドルウェアのパッチ

60

60

60

600

60

1200

60

3000

60

6000

13

PP形名

3

3

3

30

3

60

3

150

3

300

14

パラメータ数合計

213

1657

3302

7142

14272

パラメータ数合計の計算式：

パラメータ数合計 = UOCパラメータ＋接続先ネットワーク
＋((OSのパラメータ＋OSのサイジングパラメータ＋OSのパッチ＋NICのネットワーク)＋(ミドルウェアのパラメータ＋ミドルウェアのサイジングパラメータ＋ミドルウェアのパッチ＋PP形名)×ミドルウェア)×仮想ホスト

(2)　リソース情報（物理ホスト）の登録・更新に影響するパラメータ

リソース情報（物理ホスト）の登録・更新に影響するパラメータについて，物理構成定義ファイルに定義する物理ホストグループ数と物理ホスト数，JP1/ITRMで管理しているリソース数，物理容量定義ファイルに定義するデータストア数，IPアドレス設定ファイルに定義するIPアドレス数の組み合わせで5つの条件を示します。

項番

条件1

条件2

条件3

条件4

条件5

1

物理構成定義ファイル

−

−

−

−

−

2

物理ホストグループ数

1

1※1

10※1

50※1

100※1

3

物理ホスト数

1

10

100

500

1000

4

データストア

1

1

1

2

3

5

リソースプール

1

1

1

2

3

6

仮想ネットワークデバイス

2

2

2

5

10

7

JP1/ITRMの情報

−

−

−

−

−

8

管理リソース数

3

12

102

502

1002

9

物理容量定義ファイル

−

−

−

−

−

10

データストア数

1

10※2

100※2

500※2

1000※2

11

負荷分散機接続設定

プロパティファイル

−

−

−

−

−

12

LB数

2

2

2

2

2

13

IPアドレス，リソース制約定義ファイルを除くパラメータ数合計

13

75

717

6555

21105

14

IPアドレス設定ファイル

−

−

−

−

−

15

仮想ホストのIPアドレス数

2

11

110

550

1100

16

リソース制約定義ファイル

−

−

−

−

−

17

物理ホスト

1

1

10

10

100

18

仮想ネットワークデバイス

2

2

2

5

10

19

IPアドレス（範囲を被らせない）

1

1

1

4

8

20

管理ネットワーク

1

1

1

1

1

21

VLAN ID

1

40

410

2048

4096

22

コンポーネントテンプレート

1

3

30

150

300

23

IPアドレス（範囲を被らせない）

1

1

2

4

8

24

LB

2

2

2

2

2

25

IPアドレス（範囲を被らせない）

2

2

2

2

2

26

ユーザ

1

1

2

10

20

27

セクション

1

2

15

75

150

28

IPアドレス（範囲を被らせない）

1

1

2

4

8

29

VLAN ID

1

2

20

100

200

30

リソース情報パラメータ数合計

32

195

2164

27674

151040

注※1

物理ホストグループ1につき物理ホスト10を割り当て

注※2

物理ホスト1につきデータストア1を割り当て

パラメータ数合計の計算式：

IPアドレス，リソース制約を除くパラメータ数合計＝物理ホスグループ
　＋物理ホスト×（1 + データストア
　　＋仮想ネットワークデバイス×2
　＋リソースプール数）
　＋1 ＋JP1/ITRMの管理リソース数
　＋データストア数
　＋LB数

　リソース制約パラメータ数合計＝物理ホスト×（＋1＋仮想ネットワークデバイス×IPアドレス定義数）
　＋管理ネットワーク数×VLANID定義数
　＋コンポーネントテンプレート数×(1 + IPアドレス定義数)
　＋LB数×(1 + IPアドレス定義数)
　＋ユーザ数×
　　（1 ＋セクション数×(1 ＋IPアドレス定義数)＋VLANID定義数）

リソース情報パラメータ数合計＝IPアドレス，リソース制約を除くパラメータ数合計
　＋IPアドレス数
　＋リソース制約定義パラメータ数

(3)　リソース情報（IPアドレス）の登録・更新に影響するパラメータ

リソース情報（IPアドレス）の登録・更新に影響するパラメータについて，IPアドレス設定ファイルに定義するIPアドレス数の組み合わせで5つの条件を示します。

項番

条件1

条件2

条件3

条件4

条件5

1

IPアドレス設定ファイル

−

−

−

−

−

2

(2)の条件に追加する仮想ホストのIPアドレス数

2

100

1000

4000

7500

(2)の「リソース情報パラメータ数合計」の条件に，さらにIPアドレスを追加した場合のコマンドの実行時間は，(2)の該当する条件の実行時間に(3)の該当する条件から導いた実行時間を加算した値で見積もってください。

2.7.2　コマンド実行時間

次に示す(1)(2)のそれぞれについて，「2.7.1　パラメータ数の見積もり」で見積もったパラメータ数を基にコマンド実行時間を見積もります。

各グラフに示しているコマンド実行時間は，コマンド同時実行数1で測定した場合の時間です。

(1)　マスターイメージの登録・更新コマンド

マスターイメージの登録・更新コマンドcsdmiregister・csdmiupdateについて，2.7.1(1)の条件1〜5で実行したときのコマンド実行時間を次の図に示します。

(2)　リソース情報の登録・更新コマンド

(a)　物理ホスト数に依存するコマンド

コマンド実行時間が物理ホスト情報のパラメータ数と，JP1/ITRMに登録されている件数に依存するcsdrscupdateコマンドについて，2.7.1(2)の条件1〜5で実行したときのコマンド実行時間を次に示します。

リソース制約定義なし

リソース制約定義あり

(b)　物理ホスト数とマスターイメージ情報に依存するコマンド

コマンド実行時間が物理ホスト情報のパラメータ数とマスターイメージ情報のパラメータ数に依存するcsdmiposコマンドについて，2.7.1(2)のIPアドレス数を除いた数合計の条件と2.7.1(1)の条件を組み合わせて実行したときのコマンド実行時間を次に示します。

csdmiposコマンドの実行時間はIPアドレス数には依存しないで，物理構成定義ファイルに定義する物理ホストグループ数と物理ホスト数，JP1/ITRMで管理しているリソース数，物理容量定義ファイルに定義するデータストア数だけに依存するため，横軸のパラメータ数はIPアドレスを除くパラメータ数合計となります。

リソース制約定義なし

リソース制約定義あり

(c)　IPアドレス数に依存するコマンド

コマンド実行時間が登録するIPアドレス数に依存するcsdrscupdateコマンドについて，2.7.1(3)の条件1〜5で実行したときのコマンド実行時間を次に示します。

2.7.3　csd_receive_timeout設定値の算出

次に示す計算式で，csd_receive_timeout設定値を算出します。

csd_receive_timeout設定値 = max(a+30※ b) × c × d（単位：秒）

注※　"＋30"はサイジングUOCの最大実行時間

a〜dの内容は次のとおりです。

可変部

意味

説明

a

コマンドの最大実行時間（マスターイメージ）(秒)

2.7.2(1)から見積もったコマンドの最大実行時間

b

コマンドの最大実行時間（リソース）

(秒)

2.7.2(2)(a)と(c)の見積もり値を加算したコマンド実行時間と，(b)で見積もったコマンド実行時間とを比較して，大きい方の実行時間

c

コマンド同時実行数

(個)

ユーザシステムで同時に実行されるコマンドの最大数

d

安全係数

(倍)

外部要因による影響を考慮して1.2以上を推奨します。

2.7.4　測定環境

コマンド実行時間を測定した環境を参考情報として次に示します。

ハードウェア条件

ハードウェア

条件

CPU種別

Intel(R) Xeon(R) X5675

CPUクロック

3.07GHz

CPUコア数

4

ソフトウェア条件

ソフトウェア

条件(バージョン)

VMware ESX

4.1.0

uCSD

09-00

Cosminexus

09-00

JP1/ITRM

09-51

2.8　他製品との連携

他製品との連携について説明します。

2.8.1　JP1/AOとの連携

JP1/AOとの連携について説明します。

(1)　JP1/AOとの連携に必要な設定

JP1/AOとの連携に必要な設定について説明します。PaaS提供者が次に示す手順で設定を行ってください。

(a)　前提条件の確認

JP1/AOと連携するための条件を次に示します。

ISCMと同一の装置内での前提条件

ISCMと同一のホストに，JP1/AO 10-01以降がインストールされていること

管理用サーバマシンのログインパスワードの前提条件

JP1/AOと連携するPaaS提供者，PaaS利用者は，管理用サーバマシンのログインパスワードに次の文字を使用していないこと

「<」，「>」，「|」，「;」，「&」，「*」，「!」，「?」，「"」，「%」，「/」，「¥」

上記の文字を使用している場合は別のパスワードに変更してください。

(b)　管理共有の設定

管理用サーバマシンの管理共有を有効にします。次の表のレジストリを設定してOSを再起動してください。

表2‒40　管理共有のレジストリ設定

レジストリキー

エントリ

設定値

HKEY_LOCAL_MACHINE¥SYSTEM¥CurrentControlSet¥Services¥Lanmanserver¥parameters

AutoShareServer

1（DWORD）

レジストリの設定は次のコマンドでも可能です。

reg△add△HKEY_LOCAL_MACHINE¥SYSTEM¥CurrentControlSet¥Services¥Lanmanserver¥parameters△/v△AutoShareServer△/t△REG_DWORD△/d△1

△：半角空白を示します。

(c)　PaaS利用者用のJP1/AOユーザ，リソースグループ，ユーザグループの作成

PaaS利用者用のユーザ，リソースグループ，ユーザグループをJP1/AOで作成します。設定方法の詳細はJP1/AOのマニュアルを参照してください。

次に，PaaS利用者が追加したJP1/AOのサービスをほかのPaaS利用者が実行できないようにするユーザ設定の方法を説明します。

JP1/AOがJP1/Baseの認証機能と連携していない場合

JP1/AOにすべてのリソースグループ（All Resources）に対するAdminロールとUser Management権限を持つユーザでログインして，［管理］タブで次の設定を行います。

ユーザの作成

PaaS利用者ごとにJP1/AOのユーザを作成します。

リソースグループの作成

PaaS利用者ごとにリソースグループを作成します。

ユーザグループの作成

PaaS利用者ごとにユーザグループを作成します。

作成したユーザグループには，同じPaaS利用者用に作成したユーザ，リソースグループを追加します。追加するリソースグループのロールにはModifyを選択してください。

JP1/AOがJP1/Baseの認証機能と連携している場合

JP1/AOでJP1/Baseの認証機能と連携する方法は，JP1/AOのマニュアルを参照してください。

リソースグループの作成

JP1/AOにすべてのリソースグループ（All Resources）に対するAdminロールとUser Management権限を持つユーザでログインして，PaaS利用者ごとにリソースグループを作成します。

JP1ユーザの作成

JP1/Baseの環境設定でPaaS利用者ごとにJP1ユーザを作成します。

作成したJP1ユーザのJP1資源グループ別権限レベルには，次のとおりに設定してください。

表2‒41　JP1資源グループ別権限レベルの設定

グループ名

権限レベル

同じPaaS利用者用に作成したJP1/AOのリソースグループ名

JP1_AO_Modify

(d)　エージェント接続先定義の設定

(c)で作成した各リソースグループに，次の表のエージェントレス接続先設定を追加します。設定方法の詳細はJP1/AOのマニュアルを参照してください。

表2‒42　エージェントレス接続定義の設定

設定項目

設定値

接続先種別

ホスト名またはIPv4

IPv6は使用できません。

接続先

管理用サーバマシンのホスト名またはIPアドレス

PaaS利用者がJP1/AOにアクセスするURL，および各サービスの「ISCMのホスト名」プロパティに指定するホスト名，IPアドレスを指定しておく必要があります。

複数ある場合はそれぞれエージェントレス接続先定義を作成してください。

サービスのリソースグループ

(c)で作成したリソースグループ

リソースグループごとにエージェントレス接続先定義を作成してください。

認証情報

設定する。

プロトコル

WMI

ユーザID

PaaS提供者の管理用サーバマシン用ログインユーザ名（Administrator）

パスワード

PaaS提供者の管理用サーバマシン用ログインパスワード

最大で（管理サーバマシンのホスト名，IPアドレスの種類）×（リソースグループ数）のエージェントレス接続定義を作成する必要があります。

(e)　サービステンプレートのインポート

ISCMが提供するサービステンプレートをJP1/AOにインポートします。JP1/AOの次に示すコマンドを実行してください。

<JP1/AOインストールパス>¥bin¥importservicetemplate△
　/file△<ISCMインストールパス>¥mgr¥product_tool¥service_template¥uCSD_Operations.zip△
　/user△<PaaS提供者用JP1/AOユーザ名>△
　/password△<PaaS提供者用JP1/AOユーザパスワード>

△：半角空白を示します。

サービステンプレートのインポートが完了したらISCMの提供するサービステンプレートが使用できるようになります。各PaaS利用者に作成したJP1/AOユーザまたはJP1ユーザの情報を連絡してください。

(f)　サービステンプレートの入れ替え

ISCMが提供するサービステンプレートがバージョンアップした場合に，JP1/AOにインポートしたサービステンプレートを入れ替えます。次の手順に従い，サービステンプレートを入れ替えてください。リリースノートに記載したサービステンプレートの追加・変更内容を確認し，サービステンプレートのインポート，削除の要否を判断してください。なお，手順3.を実施する場合は，各PaaS利用者が入れ替え対象のサービステンプレートが基になるサービスおよびそのサービスから生成されたタスクをすべて削除しておく必要があります。

サービステンプレートのインポート

ISCMが提供するサービステンプレートをインポートします。JP1/AOの次に示すコマンドを実行してください。

<JP1/AOインストールパス>¥bin¥importservicetemplate△
  /file△<ISCMインストールパス>¥mgr¥product_tool¥service_template¥uCSD_Operations.zip△
  /user△<PaaS提供者用JP1/AOユーザ名>△
  /password△<PaaS提供者用JP1/AOユーザパスワード>

△：半角空白を示します。

バージョンアップしたサービステンプレートがインポートされます。バージョンアップしていないサービステンプレートのインポートはスキップされます。

サービステンプレート一覧の出力

旧バージョンのサービステンプレートを削除する際に必要な情報を取得します。JP1/AOの次に示すコマンドを実行してください。なお，サービステンプレートの削除を行わない場合は，実施する必要はありません。

<JP1/AOインストールパス>¥bin¥listservices△
  /output△servicetemplates△
  /file△<サービステンプレート一覧を出力するファイルのパス>△
  /user△<PaaS提供者用JP1/AOユーザ名>△
  /password△<PaaS提供者用JP1/AOユーザパスワード>

△：半角空白を示します。

出力結果のうち，Service ID列にサービステンプレートID，Vendor ID列にベンダーID，Version列にサービステンプレートバージョンが出力されるため，削除する旧バージョンのサービステンプレートのサービステンプレートID，ベンダーID，サービステンプレートバージョンを控えておきます。

サービステンプレートの削除

旧バージョンのサービステンプレートを削除します。JP1/AOの次に示すコマンドを実行してください。なお，サービステンプレートの削除を行わない場合は，実施する必要はありません。

<JP1/AOインストールパス>¥bin¥deleteservicetemplate△
  /name△<listservicesコマンドで確認したサービステンプレートID>△
  /vendor△<listservicesコマンドで確認したベンダーID>△
  /version△<listservicesコマンドで確認したサービステンプレートバージョン>△
  /user△<PaaS提供者用JP1/AOユーザ名>△
  /password△<PaaS提供者用JP1/AOユーザパスワード>

△：半角空白を示します。

旧バージョンのサービステンプレートが削除され，バージョンアップしたサービステンプレートだけを使用することができます。

(2)　ISCMが提供するサービステンプレート

ISCMが提供するJP1/AOのサービステンプレートについて説明します。

(a)　サービステンプレート一覧

ISCMが提供するサービステンプレートの一覧を次の表に示します。各テンプレートの詳細はJP1/AOの［サービス詳細説明表示］で表示する詳細説明画面を参照してください。

表2‒43　サービステンプレート一覧

項番

サービステンプレート名

説明

処理概要

1

業務システムの構築

業務システムを構築します。

次の処理を実行します。

(1) csdmiregisterコマンド

(2) csdmiposコマンド

(3) csdmireserveコマンド

(4) csdmideployコマンド

また，［応答入力］ダイアログボックスの表示で次の処理を実行します。

(1) csdmilsコマンド

［応答入力］ダイアログボックスで［Cancel］ボタンを選択した場合は次の処理を実行します。

(1) csdmireleaseコマンド（csdmireserveコマンド実行後だけ）

(2) csdmideleteコマンド

2

業務システムのコピー構築

既存の業務システムをコピーして業務システムを構築します。

次の処理を実行します。

(1) csdmiexportコマンド

(2) マスターイメージ定義ファイルの作成

(3) csdmiregisterコマンド

(4) csdmiposコマンド

(5) csdmireserveコマンド

(6) csdmideployコマンド

また，［応答入力］ダイアログボックスの表示で次の処理を実行します。

(1) csdmilsコマンド

［応答入力］ダイアログボックスで［Cancel］ボタンを選択した場合は次の処理を実行します。

(1) csdmireleaseコマンド(csdmireserveコマンド実行後だけ)

(2) csdmideleteコマンド

3

業務システムの削除

業務システムを削除します。

次の処理を実行します。

(1) csdmiundeployコマンド

(2) csdmireleaseコマンド

(3) csdmideleteコマンド

4

テンプレートの表示

テンプレートの一覧，詳細を参照します。

csdtmplsコマンドを実行します。

5

マスターイメージの登録

マスターイメージを登録します。

csdmiregisterコマンドを実行します。

6

マスターイメージの登録（設計書入力）

業務システムの設計書を使用してマスターイメージを登録します。

次の処理を実行します。

(1)csdmiregisterコマンド

(2)csdmireserveコマンド

(3)csdmilsコマンド

7

マスターイメージのコピー

マスターイメージをコピーします。

次の処理を実行します。

(1) csdmiexportコマンド

(2) マスターイメージ定義ファイルの作成

(3) csdmiregisterコマンド

8

マスターイメージの更新

マスターイメージを更新します。

csdmiupdateコマンドを実行します。

9

マスターイメージの更新（設計書入力）

業務システムの設計書を使用してマスターイメージを更新します。

csdmiupdateコマンドを実行します。

10

マスターイメージの削除

マスターイメージを削除します。

csdmideleteコマンドを実行します。

11

マスターイメージの表示

マスターイメージの一覧，詳細を参照します。

csdmilsコマンドを実行します。

12

物理配置候補の算出

マスターイメージの物理配置候補を算出します。

csdmiposコマンドを実行します。

13

リソースの予約

マスターイメージのリソースを予約します。

csdmireserveコマンドを実行します。

14

リソースの予約解除

マスターイメージのリソースを予約解除します。

csdmireleaseコマンドを実行します。

15

物理リソース情報の出力

物理リソース情報を参照します。

csdrsclsコマンドを実行します。

16

業務システムのデプロイ

業務システムをデプロイします。

csdmideployコマンドを実行します。

17

業務システムのアンデプロイ

業務システムをアンデプロイします。

csdmiundeployコマンドを実行します。

18

デプロイ処理の中断

デプロイ処理を中断します。

csdmistopdeployコマンドを実行します。

19

仮想ホスト，ミドルウェアのステータス変更

仮想ホスト，ミドルウェアのステータスを変更します。

csdmivmstatusコマンドを実行します。

20

仮想ホストパスワードの設定

仮想ホストのパスワードを設定します。

csdmisetpasswordコマンドを実行します。

(b)　画面詳細

ISCMが提供するサービステンプレートにおける，独自の画面表示および制限事項について説明します。

下記で説明した以外の画面表示，制限事項はJP1/AOが提供するサービステンプレートと同じになります。

［サービス設定］ダイアログボックス

図2‒10　［サービス設定］ダイアログボックス

制限事項

ISCMが提供するサービステンプレートは，次の表に示すプロパティを［サービス設定］ダイアログボックスでは表示しません。これらは［サービス実行］ダイアログボックスで指定します。

表2‒44　［サービス設定］ダイアログボックスで表示しないプロパティ

項番

プロパティ名

使用しているサービステンプレート

1

マスターイメージ定義ファイル

業務システムの構築

マスターイメージの登録

マスターイメージの更新

2

業務システムの設計書

マスターイメージの登録（設計書入力）

マスターイメージの更新（設計書入力）

3

UOC格納ZIPファイル

業務システムの構築

マスターイメージの登録

マスターイメージの更新

マスターイメージの登録（設計書入力）

マスターイメージの更新（設計書入力）

4

スナップショット格納ZIPファイル

業務システムの構築

マスターイメージの登録

5

物理配置制約ファイル

業務システムの構築

物理配置候補の算出

6

リソース定義ファイル

業務システムの構築

リソースの予約

上記のプロパティはプリセットプロパティで指定してもエラーにはなりませんが，値は反映しません。ただし，不正な値を指定した場合はエラーになりますので注意してください。

［サービス実行］ダイアログボックス

図2‒11　［サービス実行］ダイアログボックス

ファイル参照形式プロパティ

ISCMが提供するサービステンプレートの一部のプロパティは，［参照］ボタンをクリックしてファイル選択ダイアログボックスを開き，入力するファイルを選択することで指定します。

指定したファイルは，サービス実行時に管理用サーバマシンに送信して使用します。

図2‒12　ファイル参照形式プロパティ

テキストフィールドには選択したファイル名が表示されます。このテキストフィールドに直接ファイル名を入力することはできません。

［クリア］ボタンをクリックすると，現在選択しているファイルをリセットします。

ファイル参照形式のプロパティの一覧を次の表に示します。

表2‒45　ファイル参照形式プロパティ一覧

項番

プロパティ名

使用しているサービステンプレート

1

マスターイメージ定義ファイル

業務システムの構築

マスターイメージの登録

マスターイメージの更新

2

業務システムの設計書

マスターイメージの登録（設計書入力）

マスターイメージの更新（設計書入力）

3

UOC格納ZIPファイル

業務システムの構築

マスターイメージの登録

マスターイメージの更新

マスターイメージの登録（設計書入力）

マスターイメージの更新（設計書入力）

4

スナップショット格納ZIPファイル

業務システムの構築

マスターイメージの登録

5

物理配置制約ファイル

業務システムの構築

物理配置候補の算出

6

リソース定義ファイル

業務システムの構築

リソースの予約

ZIPファイルを指定するプロパティに指定するファイルの構成については，プロパティを使用するサービステンプレートの詳細情報説明画面を参照してください。

制限事項

ISCMが提供するサービステンプレートの一部は，［実行契機］として「定期実行」を選択できません。各サービステンプレートで使用できる［実行契機］の一覧を次の表に示します。

各実行契機の動作についてはJP1/AOのマニュアルを参照してください。

表2‒46　使用可能な［実行契機］一覧

項番

サービステンプレート名

即時実行

指定日実行

定期実行

1

業務システムの構築

○

○

×

2

業務システムのコピー構築

○

○

○

3

業務システムの削除

○

○

○

4

テンプレートの表示

○

○

○

5

マスターイメージの登録

○

○

×

6

マスターイメージの登録（設計書入力）

○

○

×

7

マスターイメージのコピー

○

○

○

8

マスターイメージの更新

○

○

×

9

マスターイメージの更新（設計書入力）

○

○

×

10

マスターイメージの削除

○

○

○

11

マスターイメージの表示

○

○

○

12

物理配置候補の算出

○

○

×

13

リソースの予約

○

○

×

14

リソースの予約解除

○

○

○

15

物理リソース情報の出力

○

○

○

16

業務システムのデプロイ

○

○

○

17

業務システムのアンデプロイ

○

○

○

18

デプロイ処理の中断

○

○

○

19

仮想ホスト，ミドルウェアのステータス変更

○

○

○

20

仮想ホストパスワードの設定

○

○

○

（凡例）

○：選択できる

×：選択できない（リストに表示されない）

JP1/AO 10-02以降でサポートするダイレクトアクセスURLの追加クエリパラメータ（タスク名，タスク説明，入力プロパティ）には対応していません。これらのクエリパラメータを指定しても［サービス実行］ダイアログボックスには反映されません。

ファイル参照形式プロパティには，100MBを超えるサイズのファイルは指定できません。指定した場合，［実行］ボタンをクリックしたときにKFUD27003メッセージを表示してサービスの実行に失敗します。

［タスク詳細］ダイアログボックス

図2‒13　［タスク詳細］ダイアログボックス

プロパティ

ISCMが提供するサービステンプレートは出力プロパティを表示しません。タスクの実行結果は［実行結果］開閉ボタンで表示するエリアに出力されます。

実行結果

タスクの実行結果を表示します。実行結果のフォーマットはサービステンプレートによって異なります。サービステンプレートごとの実行結果フォーマットを次の表に示します。

表2‒47　実行結果フォーマット一覧

項番

サービステンプレート名

フォーマット

1

業務システムの構築

通常フォーマット

2

業務システムのコピー構築

通常フォーマット

3

業務システムの削除

通常フォーマット

4

テンプレートの表示

テンプレート表示フォーマット

5

マスターイメージの登録

通常フォーマット

6

マスターイメージの登録（設計書入力）

通常フォーマット

7

マスターイメージのコピー

通常フォーマット

8

マスターイメージの更新

通常フォーマット

9

マスターイメージの更新（設計書入力）

通常フォーマット

10

マスターイメージの削除

通常フォーマット

11

マスターイメージの表示

マスターイメージ表示フォーマット

12

物理配置候補の算出

通常フォーマット

13

リソースの予約

通常フォーマット

14

リソースの予約解除

通常フォーマット

15

物理リソース情報の出力

物理リソース情報出力フォーマット

16

業務システムのデプロイ

通常フォーマット

17

業務システムのアンデプロイ

通常フォーマット

18

デプロイ処理の中断

通常フォーマット

19

仮想ホスト，ミドルウェアのステータス変更

通常フォーマット

20

仮想ホストパスワードの設定

通常フォーマット

通常フォーマット

ISCMが提供するサービステンプレートの通常フォーマットです。［実行結果］にタスクの結果を表示します。

図2‒14　通常フォーマット

［実行結果ダウンロード］ボタン

クリックすると，現在［実行結果］に表示している内容をファイル出力します。

テンプレート表示フォーマット

「テンプレートの表示」サービステンプレートの実行結果フォーマットです。

指定したユーザに公開されているテンプレートの一覧を［テンプレート一覧］に表示します。［テンプレート一覧］の表示項目を次に示します。

図2‒15　テンプレート表示フォーマット

表2‒48　［テンプレート一覧］表示項目

項番

項目名

内容

1

ID

テンプレートIDを表示します。

2

種別

テンプレートの種別を表示します。

Pattern：構成パターンテンプレート

Component：コンポーネントテンプレート

3

テンプレート名

テンプレートの名称を表示します。

4

最終更新時刻

テンプレートを最後に更新した時刻を表示します。

［テンプレート一覧］からテンプレートを1行選択すると，選択したテンプレートの情報を［詳細情報］に表示します。

［テンプレート一覧ダウンロード］ボタン

現在［テンプレート一覧］に表示している内容をCSV形式でファイル出力します。

［詳細情報ダウンロード］ボタン

現在［詳細情報］に表示している内容をファイル出力します。

［テンプレートファイルダウンロード］ボタン

現在［テンプレート一覧］で選択しているテンプレートのテンプレートファイルを出力します。

［付属ファイルダウンロード］ボタン

現在［テンプレート一覧］で選択しているテンプレートに付属する定義ファイル，バッチファイルなどをZIPファイルで出力します。

マスターイメージ表示フォーマット

「マスターイメージの表示」サービステンプレートの実行結果フォーマットです。

指定したユーザが登録したマスターイメージの一覧を［マスターイメージ一覧］に表示します。［マスターイメージ一覧］の表示項目を次に示します。

図2‒16　マスターイメージ表示フォーマット

表2‒49　［マスターイメージ一覧］表示項目

項番

項目名

内容

1

ID

マスターイメージIDを表示します。

2

マスターイメージ名

マスターイメージの名称を表示します。セクションを設定している場合は，"<マスターイメージ名>.<セクション>"の形式で表示します。

3

ステータス

マスターイメージの現在のステータスを表示します。

表示するステータスはcsdmilsコマンドの出力と同じです。

4

最終更新時刻

マスターイメージを最後に更新した時刻を表示します。

［マスターイメージ一覧］からマスターイメージを1行選択すると，選択したマスターイメージの情報を［詳細情報］に表示します。

［マスターイメージ一覧ダウンロード］ボタン

現在［マスターイメージ一覧］に表示している内容をCSV形式でファイル出力します。

［詳細情報ダウンロード］ボタン

現在［詳細情報］の各タブに表示している内容をファイル出力します。出力ファイルのフォーマットを次に示します。

図2‒17　［詳細情報ダウンロード］ファイルフォーマット

［マスターイメージ定義ファイルダウンロード］ボタン

現在［マスターイメージ一覧］で選択しているマスターイメージのマスターイメージ定義ファイルを出力します。

［付属ファイルダウンロード］ボタン

現在［マスターイメージ一覧］で選択しているマスターイメージに付属するサイジングUOCなどをZIPファイルで出力します。

［エクスポート］ボタン

現在［マスターイメージ一覧］で選択しているマスターイメージのスナップショットをZIPファイルで出力します。

物理リソース情報出力フォーマット

「物理リソース情報の出力」サービステンプレートの実行結果フォーマットです。各リソース情報を［実行結果］の対応するタブに表示します。サービスの実行時に取得しないことを選択した情報のタブは選択できません。

図2‒18　物理リソース情報出力フォーマット

［実行結果ダウンロード］ボタン

取得しなかった情報を除いて，現在［実行結果］の各タブに表示している内容をファイル出力します。出力ファイルのフォーマットを次に示します。

図2‒19　［実行結果ダウンロード］ファイルフォーマット

uCSDログダウンロード

ISCMが出力するログファイルをZIPファイルで出力します。出力ファイルの内容を次に示します。

表2‒50　［uCSDログダウンロード］取得ファイル一覧

項番

収集するログファイル

収集元ファイルパス

ダウンロードファイル内の格納パス

1

メッセージログ

<ISCMインストールディレクトリ>¥

mgr¥log¥csdmessageXX.log

log¥csdmessageXX.log

2

<ISCMインストールディレクトリ>¥

mgr¥log¥csdprocessmessageXX.log

log¥csdprocessmessageXX.log

3

アクセスログ

<ISCMインストールディレクトリ>¥

mgr¥log¥csdaccessXX.log

log¥csdaccessXX.log

4

コマンドトレースログ

<ISCMインストールディレクトリ>¥

mgr¥log¥csdcmdtrcXX.log

log¥csdcmdtrcXX.log

5

統合トレースログ

（32bit）

<HNTRLib2(32bit版)インストールディレクトリ>¥

spool¥hntr2X.log

hntrlib2¥32¥hntr2X.log

6

統合トレースログ

（64bit）

<HNTRLib2(64bit版)インストールディレクトリ>¥

spool¥hntr2X.log

hntrlib2¥64¥hntr2X.log

注　X：ファイル通番

タスクを実行した時点のログファイルの保存はしていません。取得するログファイルは［uCSDログダウンロード］ボタンをクリックした時点のファイルとなります。

制限事項

実行結果の一部は表示可能な文字数に制限があります。そのため，実行結果のデータ量が多い場合はすべての結果を表示できません。実行結果の表示文字数制限を次の表に示します。

表2‒51　実行結果の表示文字数制限

項番

サービステンプレート

表示項目

表示文字数制限

1

下記以外のサービステンプレート

テンプレートの表示

マスターイメージの表示

物理リソース情報の出力

実行結果

最大1024文字※

2

テンプレートの表示

詳細情報

なし

3

マスターイメージの表示

詳細情報

マスターイメージ情報

なし

4

サイジング情報

なし

5

ミドルウェア情報

なし

6

物理配置情報

なし

7

仮想NIC情報

なし

8

物理リソース情報の出力

実行結果

物理ホストグループ情報

なし

9

物理ホスト情報

なし

10

IPアドレス情報

なし

11

負荷分散機情報

なし

注※　改行コードなども含みます。超過する場合は先頭から1024文字までを表示します。

次に示すボタンでダウンロードできるファイルのサイズは100MBまでです。ダウンロードするファイルのサイズが100MBを超過する場合，ボタンをクリックしたときにKFUD27007メッセージを表示してダウンロードに失敗します。

［テンプレートファイルダウンロード］ボタン

［付属ファイルダウンロード］ボタン

「テンプレート表示フォーマット」および

「マスターイメージ表示フォーマット」

［マスターイメージ定義ファイルダウンロード］ボタン

［エクスポート］ボタン

［uCSDログダウンロード］ボタン

2.8.2　JP1/PFM，JP1/IMとの連携に必要な設定

JP1/PFMやJP1/IMとの連携機能はミドルセットアップUOCで実現しています。「3.3　ミドルセットアップUOC」を参照してください。

2.8.3　障害発生時の対処

(1)　JP1/AOとの連携における障害の対処

JP1/AOとの連携で，ISCMが提供するサービステンプレートから作成したサービスの実行に失敗した場合の対処を次に示します。

(a)　エラーダイアログを表示した場合

ダイアログに表示されたメッセージのIDがKFUDで始まる場合はISCMのメッセージマニュアルを，KNAEで始まる場合はJP1/AOのメッセージマニュアルを参照して，出力されたメッセージの対処に従ってください。

(b)　タスクの状態が「失敗」になった場合

［タスク詳細］ダイアログボックスで次の内容を確認してください。

［実行結果］または［詳細情報］にエラーメッセージを出力している場合

ISCMのメッセージマニュアルを参照して出力されたメッセージの対処に従ってください。詳細を確認したい場合は［uCSDログダウンロード］ボタンを使用してISCMのメッセージログを取得してください。

コマンドと共通のメッセージが出力された場合で対処にコマンドの再実行と記載されている場合は，コマンドの代わりにサービスの再実行を行ってください。ただし，「業務システムの構築」など一連の処理を実行するサービステンプレートの場合は途中の処理まで正常に実行している場合があります。現在のマスターイメージの状態を確認して，機能単位のサービステンプレートを使用して続きを実行するか，一度サービス実行前の状態に戻してから再実行を行ってください。

［実行結果］または［詳細情報］にメッセージの出力がないか，正常実行時のメッセージを出力している場合

［ログダウンロード］ボタンでJP1/AOのタスクログを取得してください。エラーメッセージを出力している場合は，JP1/AOのメッセージマニュアルを参照して対処に従ってください。

JP1/AOのタスクログにもエラーメッセージが出力されていない場合は，ISCMとJP1/AOのトラブルシュート情報を採取してください。

ISCMのトラブルシュート情報は「2.6.5　ISCMのトラブルシュート」を参照してください。

JP1/AOのトラブルシュート情報はマニュアル「JP1/Automatic Operation 運用ガイド」の「運用時のトラブルシューティング」の章を参照してください。

2.9　UOCの作成手順

この節ではUOCの作成手順を説明します。

UOC作成の際の注意事項についてはマニュアル「Hitachi IT System Configuration Manager リファレンス」を参照してください。

2.9.1　サイジングUOC

サイジングUOCの作成手順の例を次に示します。例として示すUOC 実装クラスでは，サンプルをベースに作成する場合，独自に作成する場合ともに次の情報を使用します。

パッケージ名= csd.sample

クラス名= AppServerDbSizingUoc

(1)　UOC実装クラスの作成

サンプルをベースに作成する場合は「(4)　UOC実装クラスの例」に記載したディレクトリに格納されているUOC実装クラスのサンプルファイルを編集してください。

独自に作成する場合は，UOC用の抽象クラス（jp.co.Hitachi.soft.csd.server.uoc.SizingUoc）を継承し，UOC実装クラスを作成します。UOC実装クラスでは必要なメソッドだけオーバーライドします。

(2)　UOC実装クラスのコンパイル

サンプルをベースに作成した場合は，次に示す環境変数を設定したコマンドプロンプトでISCMが提供するbuild.batを使用してください。build.batは「(4)　UOC実装クラスの例」に記載した各ディレクトリに格納しています。

表2‒52　build.batの実行に必要な環境変数

項番

環境変数

設定値

1

JDK_HOME

JDK（Java Development Kit）のホームディレクトリ

2

CSDUOCIF_JAR_PATH

ISCMが提供するUOCのjarファイルのパス

（<ISCMのインストールディレクトリ>¥mgr¥lib¥csduocif.jar）

UOC実装クラスを独自に作成した場合は，javacコマンドを使用して作成したUOC 実装クラスをコンパイルし，jarコマンドでクラスファイルを格納したjarファイルを作成します。

クラスパスには，ISCMが提供するライブラリ（csduocif.jar）を指定します。csduocif.jarは，次のディレクトリに格納されています。

<ISCMのインストールディレクトリ>¥mgr¥lib

【例】

javacコマンド，jarコマンドの実行例を次に示します。

>javac -g -classpath "<ISCMのインストールディレクトリ>¥mgr¥lib¥csduocif.jar" -sourcepath src -d classes src/csd/sample/AppServerDbSizingUoc.java
>jar cvf sizingUoc.jar -C classes .

(3)　UOC実装クラスの登録

UOC実装クラスは，jar形式で格納します。

UOCはマスターイメージに取り入れ，使用します。次に条件別にUOCの取り扱いについて説明します。

各コマンドについてはマニュアル「Hitachi IT System Configuration Manager リファレンス」を参照してください。

(a)　あらかじめ用意されたUOCを使用する場合

csdtmpls（-o，-dオプション付き）でテンプレートから構成パターンテンプレートファイルとUOCを取り出します。

構成パターンテンプレートファイルのUOCタグを参考にして，マスターイメージ定義ファイルに「UOCクラス名」「jarファイル名」「UOCパラメータ」を記入してください。jarファイル名は1.で作成されたディレクトリからの相対パスを記述してください。

csdmiregisterの-fオプションに2.で作成したマスターイメージ定義ファイル，-dオプションに1.で作成したディレクトリを指定してマスターイメージを登録してください。

(b)　利用者独自に作成したUOCを使用する場合

UOC（jarファイル）を作成してください。

csdmiregister -dで指定するディレクトリにUOCを格納します。

マスターイメージ定義ファイルに「UOCクラス名」「jarファイル名」「UOCパラメータ」を記入してください。jarファイル名は2.で作成したディレクトリからの相対パスを記述してください。

csdmiregisterの-fオプションに3.で作成したマスターイメージ定義ファイル，-dオプションに2.で作成したディレクトリを指定してマスターイメージを登録してください。

(4)　UOC実装クラスの例

UOC実装クラスの例について説明します。UOC実装クラスのサンプルファイルは次のディレクトリに格納されています。

<ISCMのインストールディレクトリ>¥mgr¥sample¥HVM¥Linux¥sizingUoc

<ISCMのインストールディレクトリ>¥mgr¥sample¥HVM¥Windows¥sizingUoc

<ISCMのインストールディレクトリ>¥mgr¥sample¥VMware¥Linux¥sizingUoc

<ISCMのインストールディレクトリ>¥mgr¥sample¥VMware¥Windows¥sizingUoc

2.9.2　ミドルセットアップUOC

ミドルセットアップUOCの作成手順については「3.3　ミドルセットアップUOC」を参照してください。

2.10　仮想ホストデプロイを行わない場合のPaaS環境の構築

この節では，仮想ホストデプロイを行わない場合のPaaS環境について説明します。

2.10.1　機能

PaaS提供者がコンポーネントテンプレートに仮想ホストのデプロイを行わない設定をすることで，PaaS提供者/PaaS利用者は仮想ホストのデプロイを行わないマスターイメージを作成できます。

仮想ホストのデプロイを行わないマスターイメージを使用することで，ベアマシンやISCM外で構築した仮想ホストに対してミドルウェアの定義配布やセットアップだけを行う業務システムの運用が可能となります。

ISCM内で，仮想ホストのデプロイを行うマスターイメージと，仮想ホストのデプロイを行わないマスターイメージを登録することは可能です。ただし，同一マスターイメージ内に，仮想ホストのデプロイ有無を混在することはできません。

(1)　物理リソース管理なしの許可

すべての業務システムで仮想ホストのデプロイを行わない場合，システム定義に次を指定することで物理リソース管理なしでISCMを起動できます。この定義を指定する場合，JP1/ITRMをインストールする必要がありません。

deploy.vmdeploy.use=n

ただし，デプロイを行う設定のコンポーネントテンプレートを使用したマスターイメージが登録されている場合，deploy.vmdeploy.useにnを指定するとKFUD24016-Eメッセージを出力してISCMの起動に失敗します。

2.10.2　業務システムの構築

コンポーネントテンプレートのVirtualSystemTypeタグにnoneを指定することで，そのテンプレートを使用したコンポーネントは仮想ホストのデプロイを行わないようになります。コンポーネントテンプレートの詳細については，マニュアル「Hitachi IT System Configuration Manager リファレンス」を参照してください。

仮想ホストデプロイを行うマスターイメージとの違いを次に示します。

手順

運用

実行者

仮想ホストのデプロイありの手順（従来）

仮想ホストのデプロイなしの手順

1

業務システムの構築

インフラ管理者

−

業務システムで使用するホスト（ベアマシンまたは仮想ホスト）を構築

2

PaaS

提供者

JP1/ITRMに仮想イメージテンプレートを登録

−

3

物理構成定義ファイルに仮想ホストをデプロイする物理ホストの情報を設定

−

4

物理容量定義ファイルに仮想ホストが使用するストレージの情報を設定

−

5

IPアドレス設定ファイルにISCMで使用するIPアドレスを設定

ISCMから払い出すIPアドレスを設定

構築先ホストのIPアドレスを設定

6

csdrscupdateコマンドでリソース情報を更新

7

コンポーネントテンプレートを作成して，csdtmpregisterコマンドでISCMに登録

使用する仮想イメージテンプレート名，接続ユーザ情報を設定する

構築先ホストの接続ユーザ情報を設定する

8

構成パターンテンプレートを作成して，csdtmpregisterコマンドでISCMに登録

9

csdtmpcontrolコマンドで，テンプレートを公開

10

PaaS

提供者，

PaaS

利用者

マスターイメージ定義ファイル，サイジングUOCを作成して，csdmiregisterコマンドでISCMに登録

11

csdmiposコマンドで物理配置候補を算出

−

12

csdmireserveコマンドでリソースを予約

ホスト名，IPアドレス，VLAN IDの指定は任意

省略時はISCMが払い出す。

ホスト名，IPアドレスの指定が必須。※

13

csdmideployコマンドで業務システムをデプロイ

14

業務システムの更新

マスターイメージ定義ファイルを変更，OSパッチ，ミドルウェアパッチを追加して，csdmiupdateコマンドで業務システムを構築

15

業務システムの削除

csdmiundeployコマンドで業務システムをアンデプロイ

16

csdmireleaseコマンドでリソースを解放

17

csdmideleteコマンドでマスターイメージを削除

18

インフラ管理者

−

業務システムで使用したホスト（ベアマシンまたは仮想ホスト）を削除

（凡例）

−：該当なし。

注※

ホスト名，IPアドレス，VLAN IDはマスターイメージの設計ドキュメント，またはリソース定義ファイルで指定してください。

指定値が実際のホスト名，IPアドレス，VLAN IDと一致しているかどうかのチェックは行いません。

2.11　設計書によるマスターイメージの登録・更新

2.11.1　概要

設計書によるマスターイメージの登録・更新機能は，マスターイメージ定義ファイルを使用しないで，設計書を入力としてマスターイメージを登録・更新できる機能です。そのため，容易に業務システムを構築でき，パラメータの設定ミスも防ぐことができます。

2.11.2　機能

設計書を入力することによって，次の操作が可能です。これらの操作はJP1/AOのサービスから操作することもできます。JP1/AOのサービステンプレートについては，「2.8.1(2)　ISCMが提供するサービステンプレート」を参照してください。

表2‒53　機能一覧

項番

タイトル

説明

1

設計書によるマスターイメージの登録

設計書を入力することによって，ISCMにマスターイメージを登録します。

2

設計書によるマスターイメージの更新

設計書を入力することによって，ISCMにすでに登録されているマスターイメージを更新します。

図2‒20　設計書を入力としたマスターイメージの構築

PaaS提供者は，ISCMにテンプレートを登録し，そのテンプレートを使用した業務システムの設計書を作成します。設計書は，任意のドキュメント管理システムで管理し，PaaS利用者に公開します。PaaS利用者は，必要に応じて設計書に最低限の変更を加えて，ISCMに入力することにより業務システムを構築します。

2.11.3　前提条件

設計書で構築できる業務システムは，仮想ホストをデプロイしないことが前提です。マスターイメージが使用するコンポーネントテンプレートのハイパーバイザ種別が”none”のテンプレートを使用する必要があります。

2.11.4　運用

ここでは，設計書によるマスターイメージ作成機能を使用する場合の運用について説明します。

ISCM導入後，PaaS提供者とPaaS利用者が行う作業の流れを次に示します。

表2‒54　設計書を用いた運用

項番

カテゴリ

作業内容

PaaS提供者

PaaS利用者

1

事前準備

テンプレートの作成と登録

テンプレートのカスタマイズ

スクリプトの作成

○

×

2

設計書の作成

サンプルファイルの場所

カスタマイズが必要な項目

○

×

3

設計書を用いた業務システムの構築とテスト

○

×

4

設計書の公開

○

×

5

マスターイメージの操作

設計書を用いたマスターイメージの登録

入力のカスタマイズ

○

○

6

ミドルウェアのセットアップ

サービスまたはコマンドの実行

○

○

7

ミドルウェアのアップデート

サービスまたはコマンドの実行

○

○

8

ミドルウェアのアンセットアップ

サービスまたはコマンドの実行

○

○

（凡例）

○：作業できます。

×：作業できません。

(1)　テンプレートの作成と登録

構成パターンテンプレートとコンポーネントテンプレートを作成し，ISCMに登録します。

(2)　設計書の作成

次のディレクトリに格納されている設計書のサンプルファイルを元に，設計書をカスタマイズします。

表2‒55　設計書のサンプルファイルのパス

項番

構築対象のOS

設計書のパス

1

Linux

<ISCMインストールディレクトリ>

¥mgr¥sample¥VMware¥Linux¥ddSystem01.xlsx

または

<ISCMインストールディレクトリ>

¥mgr¥sample¥HVM¥Linux¥ddSystem01.xlsx

2

Windows

<ISCMインストールディレクトリ>

¥mgr¥sample¥VMware¥Windows¥ddSystem01.xlsx

または

<ISCMインストールディレクトリ>

¥mgr¥sample¥HVM¥Windows¥ddSystem01.xlsx

設計書ファイルについて，事前準備で記載する必要がある項目を次に示します。なお，ここに示した内容は，最低限PaaS利用者が業務システムを構築する際に必要となる情報であり，下記以外を事前準備で記載していても問題ありません。

表2‒56　設計書の入力項目

項番

シート名

表

項目

説明

1

マスターイメージ基本情報シート

(1)マスターイメージ基本情報

項番5 構成パターンテンプレート名

このマスターイメージが使用する構成パターンテンプレートを指定します。

2

項番6 サイジングUOCクラス名

サイジングUOCを使用する場合は，サイジングUOCのクラス名を指定します。

3

項番7 サイジングUOCファイル名

サイジングUOCを使用する場合は，サイジングUOCのjarファイル名を指定します。

4

(2)コンポーネント情報

コンポーネントID

このマスターイメージが使用するコンポーネントのIDを指定します。

5

コンポーネントテンプレート名

このマスターイメージが使用するコンポーネントテンプレートの名前を指定します。

6

設定対象識別子

このマスターイメージが使用するコンポーネントテンプレートのミドルウェア識別子を指定します。

7

(3)サイジングUOC入力パラメータ

UOC入力パラメータ

サイジングUOCを使用する場合は，サイジングUOCに渡すパラメータを指定します。

8

パラメータ定義シート

(a)ISCM解析情報

コンポーネントID

このシートでパラメータを定義するコンポーネントのIDを指定します。

項番4で指定したコンポーネントIDと一致している必要があります。

9

設定対象識別子

このシートでパラメータを定義する設定対象識別子を指定します。

10

(2)パラメータと設定値情報

デフォルト設定値

項番11の可変部定義名に対応する，デフォルト値を指定します。

11

可変部定義名

テンプレートで定義した可変部定義名を指定します。

12

ネットワーク情報シート

(1)ネットワーク情報

コンポーネントID

このシートでネットワーク情報を定義するコンポーネントのIDを指定します。

項番4で指定したコンポーネントIDと一致している必要があります。

13

仮想ネットワークデバイス用途

このシートで定義するコンポーネントのNICに対応した仮想ネットワークデバイス用途を指定します。構成パターンテンプレートの仮想ネットワークデバイス用途と合わせる必要があります。

14

設定シート

(1)シート名定義

シート名定義

設計書で解析対象とするシートの名前を定義します。

15

(2)列名定義

列名定義

設計書で解析対象とする列名を定義します。列名を変更した場合は，その他のシートの列名も合わせて更新してください。

16

(3)特殊文字定義

特殊文字定義

パラメータと設定値情報表で使用する特殊文字を定義します。

17

(4)設計書オプション定義

設計書オプション定義

各シートの表を解析する際のルールを定義します。

(3)　設計書を用いた業務システムの構築とテスト

設計書をもとにマスターイメージを登録し，テストを行います。設計書に必要な情報を入力し，次の(5)〜(8)に示す方法で動作確認を行ってください。

設計書に記載する内容についてはマニュアル「Hitachi IT System Configuration Manager リファレンス」の「設計書」の章を参照してください。

(4)　設計書の公開

設計書をPaaS利用者が使用できるようにPaaS利用者に公開します。

(5)　設計書を用いたマスターイメージの登録

ISCMのコマンドまたはJP1/AOのサービスを用いてマスターイメージの登録とリソースの予約を行います。

表2‒57　設計書を用いたマスターイメージの登録手順

項番

手順

具体的な処理/コマンド例

1

構築する業務システムの目的や性能に応じた設計書を入手します。

PaaS提供者から提供された設計書の中から選択します。

2

構築対象ホストの数と設計書のパラメータを確認し，追加・変更する定義があるかを検討します。

定義がある場合は設計書に反映します。

−

3

設計書をもとに，仮想ホストを構築します。

−

4

設計書をもとに，マスターイメージを登録します。

「マスターイメージの登録」サービス

または，

csdmiregister -x 設計書

5

設計書に記載されたネットワークのリソースを予約します。マスターイメージの状態は，リソース確保状態になります。

「リソースの予約」サービス

または，

csdmireserve

-n マスターイメージ名

（凡例）

−：該当なし。

(6)　ミドルウェアのセットアップ

ISCMのコマンドまたはJP1/AOのサービスを用いてミドルウェアのセットアップを行います。

表2‒58　設計書を用いたミドルウェアのセットアップ手順

項番

手順

具体的な処理/コマンド例

1

構築対象となるマスターイメージの設計書を入手します。

右の手順で登録済みのマスターイメージから出力することも可能です。

「マスターイメージの表示」サービスのエクスポートボタンを押す

または，

csdmiexport

-n マスターイメージ名

-d ディレクトリ名

2

マスターイメージに含まれるミドルウェアのセットアップを行います。

「業務システムのデプロイ」サービス

または，

csdmideploy

-nマスターイメージ名

(7)　ミドルウェアのアップデート

ISCMのコマンドまたはJP1/AOのサービスを用いてミドルウェアのアップデートを行います。

表2‒59　設計書を用いたミドルウェアのアップデート手順

項番

手順

具体的な処理/コマンド例

1

更新対象となるマスターイメージの設計書を入手します。

右の手順で登録済みのマスターイメージから出力することも可能です。

「マスターイメージの表示」サービスのエクスポートボタンを押す

または，

csdmiexport

-n マスターイメージ名

-d ディレクトリ名

2

設計書でミドルウェアのパラメータを更新します。

−

3

マスターイメージに含まれるミドルウェアのアップデートを行います。

「業務システムの更新」サービス

または，

csdmiupdate

-nマスターイメージ名

-x 設計書

（凡例）

−：該当なし。

(8)　ミドルウェアのアンセットアップ

ISCMのコマンドまたはJP1/AOのサービスを用いてミドルウェアのアンセットアップを行います。

表2‒60　設計書を用いたミドルウェアのアンセットアップ手順

項番

手順

具体的な処理/コマンド例

1

マスターイメージに含まれるミドルウェアのアンセットアップを行います。

「業務システムのアンデプロイ」サービス

または，

csdmiundeploy

-nマスターイメージ名

2.11.5　注意事項

設計書を用いて業務システムを構築する場合，注意事項があります。詳細については，「付録G　設計書によるマスターイメージの登録・更新機能使用時の注意事項」を参照してください。

3　サンプル

この章では，ハイパーバイザ種別の環境構築やミドルセットアップUOCについて説明します。

3.1　ハイパーバイザ種別がVMwareのときに環境構築する場合

3.1.1　概要

このサンプルではハイパーバイザ種別がVMwareの場合の，前提製品のインストールからCosminexusとHiRDBで構成する業務システムをISCMで構築するまでの一とおりの手順を示します。

このサンプルにおける業務システムの仕様は次のようになります。

設定内容

設定値

最大TPS

medium

50[TPS]以下

DBに格納するデータ総量

medium

50[GByte]以下

1日あたりのデータ更新量

250[MByte]以下

リクエストタイムアウト時間

60[秒]

Webクライアントアクセスホスト

2.1.1.201

LB仮想サーバホスト

2.1.1.201

対象ホスト

設定内容

設定値

Cosminexus仮想ホスト

仮想ホスト数※1

4

J2EEサーバ・メモリサイズ※1

2444[MB]

CPUコア数

2

CPUクロック数

2.5[GHz]

メモリサイズ

4[GB]

HiRDB仮想ホスト

CPUコア数※1

3

ユーザDBサイズ※2

51200[MB]

データ用DBサイズ※2

32000[MB]

システムログサイズ※3

7680[MB]

CPUクロック数

2.5[GHz]

仮想ホスト数

1

注※1　性能要件(ScaleOfTps)の設定に対するサイジング結果

注※2　性能要件(ScaleOfUserDbArea)の設定に対するサイジング結果

注※3　性能要件(ScaleOfUpdatePerDay)の設定に対するサイジング結果

(1)　業務システムを実現するネットワーク構成図

業務システムを実現するネットワークシステムの構成図を示します。

図3‒1　業務システムを実現するネットワーク構成図

ISCMが構築する仮想ホストに付与するIPアドレスは次のとおりです。

管理LAN：1.1.1.101〜1.1.1.150

業務LAN：2.1.1.101〜2.1.1.150

(2)　製品のバージョン

手順は次に示すバージョンでの製品を想定しています。ほかのバージョンの場合には手順に違いが生じる場合があります。

表3‒1　関連製品の想定バージョン

項番

製品

バージョン

1

vCenter

5.0.0

2

ESX

4.1

3

JP1/ITRM

09-51-01

4

uCosminexus Application Server（仮想サーバマネージャ）

09-00

5

BIG-IP(LB)

10.2.3

6

構築する仮想ホスト・RedHat Enterprise Linux

5.6

7

構築する仮想ホスト・Windows srver 2008 R2

Enterprise

8

構築する仮想ホスト・uCosminexus Application Server

09-00

9

構築する仮想ホスト・HiRDB

09-03

(3)　サンプルの実行環境

ISCM・JP1/ITRM・仮想サーバマネージャ（Cosminexus）はデフォルトのインストール先にインストールします。

ISCMが提供するコマンドはC:¥Program Files¥Hitachi¥uCSD¥mgr¥binディレクトリに格納されています。コマンド名だけで実行できるように環境変数PathにC:¥Program Files¥Hitachi¥uCSD¥mgr¥binを追加します。

サンプルで使用するファイルはC:¥Program Files¥Hitachi¥uCSD¥mgr¥sampleディレクトリ以下に格納されています。このsampleディレクトリをC:¥にコピーします。C:¥sample¥VMwareディレクトリを使ってサンプルを実行します。

コマンドは仮想ホストのOSがLinuxの場合はC:¥sample¥VMware¥Linuxディレクトリ上で，仮想ホストのOSがWindowsの場合はC:¥sample¥VMware¥Windowsディレクトリ上で実行します。

(4)　アカウント情報とファイル名称

表3‒2　サンプルで使用する設定名称一覧

項番

名称名

設定名称

1

PaaS利用者OSグループ

CsdUsers

2

Cosminexus仮想サーバマネージャ管理者アカウントユーザ名

admin

3

Cosminexus仮想サーバマネージャ管理者アカウントパスワード

adminpassword

4

PaaS利用者アカウントユーザ名

CsdUser01

5

PaaS利用者CsdUser01のCosminexusシステム構築者アカウントユーザ名

CsdUser01

6

PaaS利用者CsdUser01のCosminexusシステム構築者アカウントパスワード

user01pass

7

ISCMがデプロイする仮想ホストのOSアカウントユーザ名（Linux）

root

8

ISCMがデプロイする仮想ホストのOSアカウントパスワード（Linux）

rootpassword

9

ISCMがデプロイする仮想ホストのOSアカウントユーザ名（Windows）

Administrator

10

ISCMがデプロイする仮想ホストのOSアカウントパスワード（Windows）

AdminPass01

11

構成パターンテンプレート名

asdb

12

コンポーネントテンプレート名（AppServerティア）

cosmi

13

コンポーネントテンプレート名（Dbティア）

hirdb

14

マスターイメージ名

system01

3.1.2　前提製品の準備

前提製品のインストールや設定を行います。

(1)　vCenter・ESX

マシンにESXとvCenterをインストールしてネットワークやデータストアなどを設定します。

ESXホストをvCenterの管理下に置きます。

操作方法はvSphereのドキュメントを参照してください。

このサンプルの仕様ではデータストアとリソースプールを次のように設定します。

ESXマシン管理LANのIPアドレス

データストア名

リソースプール名

1.1.1.1（ESXマシン1）

Shared_VMFS_Deploy

CSD_Resource1

1.1.1.2（ESXマシン2）

Shared_VMFS_Deploy

CSD_Resource2

新規仮想マシン作成メニュから仮想マシンを作成します。

(2)　OS

ISCMが前提とするWindows OSを管理用サーバマシンにインストールしてネットワークなどを適切に設定します。

操作方法はOSのドキュメントを参照してください。

(3)　JP1/ITRM

管理用サーバマシンでPaaS提供者（OSユーザ：Administrator）が行います。

JP1/ITRMのインストーラを使いインストールします。

jirmsetupコマンドを使いセットアップします。

vCenterとESXを管理対象にします。

JP1/ITRMのWeb画面で，ISCMでデプロイする仮想ホストに付与する管理LANのIPアドレスをJP1/ITRMの探索範囲に設定します。

JP1/ITRMのWeb画面で，今後構築する仮想ホストのOSアカウント情報をJP1/ITRMの認証情報に設定します。

操作方法はJP1/ITRMのドキュメントを参照してください。

(4)　仮想サーバマネージャ

管理用サーバマシンでPaaS提供者（OSユーザ：Administrator）が行います。

Cosminexusのインストーラを利用しインストールします。

仮想サーバマネージャとして動作する設定をするためにC:¥Program Files¥Hitachi¥Cosminexus¥manager¥config¥mserver.propertiesに次を加えます。

com.cosminexus.mngsvr.vmi.enabled=true

仮想サーバマネージャのセットアップと仮想サーバマネージャ管理者のアカウントを設定するため次のコマンドを実行します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥bin¥mngsvrctl" setup -u admin -p adminpassword

仮想サーバマネージャを開始するため次のコマンドを実行します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥bin¥mngsvrctl" start

OS再起動時に仮想サーバマネージャが自動起動するように次のコマンドを実行します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥bin¥mngautorun" server

PaaS提供者が環境の妥当性を検証する目的でCosminexusを構築できるように仮想サーバマネージャのシステム構築者アカウントを作成します。

システム構築者アカウントのユーザ名はOSユーザ名と同じAdministratorにする必要があります。パスワードは同一にする必要はなく任意の文字列を指定します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥vmi¥bin¥vmiaccount" create -m localhost -u admin -p adminpassword -user Administrator -password adminpassword

C:¥Program Files¥Hitachi¥Cosminexus¥manager¥logディレクトリにPaaS利用者OSグループCsdUsersに変更権限を付与します。

付与方法はOSのドキュメントを参照してください。操作方法はCosminexusのドキュメントを参照してください。

3.1.3　ISCMインストール・セットアップ

この作業はPaaS提供者であるAdministratorユーザが行います。

(1)　インストール

日立総合インストーラを使用して，ISCMをインストールします。

(2)　セットアップ

csdsetupコマンドを使いISCMをセットアップします。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdsetup
KFUD90330-I Hitachi IT System Configuration Manager - Manager DB Serviceのセットアップを開始します。
KFUD90331-I Hitachi IT System Configuration Manager - Manager DB Serviceのセットアップが完了しました。
KFUD90330-I Hitachi IT System Configuration Managerのセットアップを開始します。
KFUD90331-I Hitachi IT System Configuration Managerのセットアップが完了しました。
KFUD90330-I Hitachi IT System Configuration Manager - Managerのセットアップを開始します。
KFUD90331-I Hitachi IT System Configuration Manager - Managerのセットアップが完了しました。

KFUD90300-I セットアップが正常に完了しました。

セットアップが完了したら，Hitachi IT System Configuration Manager - Managerサービスを実行するユーザアカウントを設定します。設定手順については，「2.4.4　ISCMのサービス実行ユーザ設定」を参照してください。

(3)　ISCM稼働のための定義

ISCMの稼働に必要な情報を定義します。定義先は次の定義ファイルです。

表3‒3　ISCM稼働必須の定義ファイル

項番

定義ファイル

定義内容

1

システム定義ファイル

csd.properties

PaaS利用者OSグループを定義します。ほかにも定義できる項目はありますが，デフォルト動作とします。

2

IPアドレス定義ファイル

ipaddress.csv

仮想ホストに付与するIPアドレスを定義します。

3

物理構成定義ファイル

physical_configuration.xml

仮想ホストをデプロイする物理マシンを定義します。

4

物理容量定義ファイル

storage_capacity.xml

仮想ホストが使用するストレージを定義します。

5

負荷分散機接続設定プロパティファイル

lb¥lb1.properties

利用する負荷分散機を定義します。仮想サーバマネージャの負荷分散機接続設定プロパティファイルと同じ仕様です。

仕様はCosminexusのドキュメントを参照してください。

サンプルで使用する定義ファイルはC:¥Program Files¥Hitachi¥uCSD¥mgr¥sample¥VMware¥confディレクトリに格納しています。このディレクトリ以下の定義ファイルをC:¥Program Files¥Hitachi¥uCSD¥mgr¥confディレクトリにコピーします。

(4)　PaaS利用者のための設定

PaaS利用者がISCMを利用できるように次の2ディレクトリに対してPaaS利用者OSグループCsdUsersに変更権限を付与します。ディレクトリ権限の設定については表2-6を参照してください。

付与方法はOSのドキュメントを参照してください。

C:¥Program Files¥Hitachi¥uCSD¥mgr¥data

C:¥Program Files¥Hitachi¥uCSD¥mgr¥log

3.1.4　PaaS環境を準備

ここでの作業は管理用サーバマシンでPaaS提供者（OSユーザ：Administrator）が行います。

(1)　ISCM起動

Windowsサービスから表示名「Hitachi IT System Configuration Manager」を開始します。

ISCMを停止する場合には3.1.7の(2)をご覧ください。

(2)　仮想サーバマネージャ管理者のアカウントをISCMに通知

仮想サーバマネージャに設定した仮想サーバマネージャ管理者のアカウント情報をISCMに通知します。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdsetaccount -vcosmi -u admin -w adminpassword
KFUD15053-I 仮想サーバマネージャ管理者アカウントを設定しました。

(3)　構成パターンテンプレートの登録

Webブラウザからのリクエストに応じて処理を行うアプリケーションサーバとDBサーバを組み合わせた構成パターンテンプレートを登録します。

(a)　サイジングUOCのビルド（UOC変更時だけ必要な作業）

サイジングUOCのビルド方法を示します。サンプルにはビルドしたjarファイルが入っているため，通常はビルドを行う必要はありません。サイジングUOCを変更した場合にここに示すビルドを行う必要があります。

サイジングUOCに関するファイルはC:¥sample¥VMware¥<仮想ホストOS名>¥sizingUocディレクトリに格納しています。

C:¥sample¥VMware¥<仮想ホストOS名>¥sizingUoc¥srcディレクトリ以下にあるサイジングUOCのJavaソースを変更します。

コマンドプロンプトにてC:¥sample¥VMware¥<仮想ホストOS名>¥sizingUocディレクトリに移動します。

次の表のとおり2つの環境変数を設定します。

表3‒4　環境変数の設定

項番

環境変数

設定値

1

JDK_HOME

JDK（Java Development Kit）のホームディレクトリ

2

CSDUOCIF_JAR_PATH

ISCMが提供するUOCのjarファイル（C:¥Program Files¥Hitachi¥uCSD¥mgr¥lib¥csduocif.jar）

C:¥sample¥VMware¥<仮想ホストOS名>¥sizingUocディレクトリにあるbuild.batを実行します。

ビルドが成功すると，C:¥sample¥VMware¥<仮想ホストOS名>¥ptAsDbDir¥sizingUoc.jarに新たなjarファイルが生成されます。

(b)　構成パターンテンプレートファイルの作成

構成パターンテンプレートを定義するXMLファイルを作成します。サンプルで使用する構成パターンテンプレートファイルはC:¥sample¥VMware¥<仮想ホストOS名>¥ptAsDb.xmlです。

サンプルの構成パターンテンプレートファイルで定義する主要な内容は次の2つです。

AppServerとDbの2つのティアで構成

サイジングUOCの入力情報を定義

(c)　構成パターンテンプレートの登録

csdtmpregisterコマンドを使い構成パターンテンプレートを登録します。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdtmpregister -f ptAsDb.xml -d ptAsDbDir
KFUD13000-I テンプレートの登録が完了しました。テンプレート名=asdb，ID=1

(4)　コンポーネントテンプレート（AppServerティア）の登録

AppServerティアに対応するCosminexusを使用したコンポーネントテンプレートを登録します。

(a)　仮想イメージテンプレートの作成（Linux）

vCenterとESXを使い仮想ホストを作成します。

仮想ホストにはネットワークアダプタを2つ以上用意します。この仮想ホストはJP1/ITRM上で仮想イメージテンプレートとして登録します。そのため，JP1/ITRMのドキュメントを参照して仮想イメージテンプレートとしての条件を満たしてください。

OSおよびVMware Toolsをインストールします。

仮想ホストにrootユーザでログインします。

Cosminexusのドキュメントを参照しCosminexusの動作に必要なOSパラメータ設定やOSパッケージ適用や環境変数設定などを行います。

Cosminexusのインストーラを利用しインストールします。

Cosminexus用OSアカウント(Component Container管理者)を作成します。

次に示す情報で作成します。

ユーザ名：cosmiuser

パスワード：resuimsoc

グループ名：cosmigrp

コマンド例を次に示します。背景色がある部分は表示されません。

# groupadd cosmigrp
# useradd cosmiuser -g cosmigrp
# passwd cosmiuser
Changing password for user cosmiuser.
New password: resuimsoc
Retype new password: resuimsoc

サーバ通信エージェントの環境設定を行います。

操作方法はCosminexusのドキュメントを参照してください。

仮想サーバマネージャからの通信を許可します。

/opt/Cosminexus/sinagent/config/sinaviagent.propertiesファイルのsinaviagent.permitted.hostsパラメータに管理用サーバマシンのIPアドレスをJavaの正規表現で指定します。

sinaviagent.permitted.hosts=1¥¥.1¥¥.1¥¥.11

OS起動時にサーバ通信エージェントが起動する設定にします。

次に示すコマンドを実行します。

/opt/Cosminexus/sinagent/bin/snactl setauto

CosminexusのログやJ2EEサーバの作業用ディレクトリを作成し，所有者をComponent Container管理者に変更します。

作業用ディレクトリを作成します。

次に示すコマンドを実行します。

mkdir -p /SPOOL/Cosminexus/log/J2EEServer/admin

mkdir -p /SPOOL/Cosminexus/log/J2EEServer/stats

mkdir -p /SPOOL/Cosminexus/log/Manager

mkdir -p /SPOOL/Cosminexus/log/PRF

mkdir -p /SPOOL/Cosminexus/log/WebServer/redirector

mkdir -p /SPOOL/Cosminexus/snapshot

mkdir -p /SPOOL/Cosminexus/work/J2EEServer/public

mkdir -p /SPOOL/Cosminexus/work/J2EEServer/repository

mkdir -p /SPOOL/Cosminexus/work/WebServer/htdocs

所有者をComponent Container管理者に変更します。

コマンド例を次に示します。

chown -R cosmiuser.cosmigrp /SPOOL/Cosminexus

J2EEサーバ上の業務アプリケーションがデータベースを利用するために，JDBCドライバを配置します。

JDBCドライバ配置用のディレクトリを作成します。

次のコマンドを実行します。

mkdir -p /var/Cosminexus/lib/

/var/Cosminexus/lib/にJDBCドライバpdjdbc2.jarを配置します。JDBCドライバはデータベースのドキュメントを参照して入手してください。

所有者をComponent Container管理者に変更します。

コマンド例を次に示します。

chown -R cosmiuser.cosmigrp /var/Cosminexus

JP1/ITRMで仮想ホストを管理対象とするための設定を行います

詳細は，マニュアル「JP1/IT Resource Management - Manager 設計・構築ガイド」を参照してください。

付録Cに記載のカーネルパラメータを設定します。

仮想ホストをシャットダウンします。

JP1/ITRMで仮想ホストを仮想イメージテンプレートに登録します。

詳細な操作方法はJP1/ITRMのドキュメントを参照してください。

JP1/ITRMのjirmimageimportコマンドを使い，仮想イメージテンプレートを作成します。

jirmimageimportコマンドで指定する-vオプションには，「3.1.2　前提製品の準備」で作成した仮想マシン名を指定してください。

仮想イメージテンプレートをライブラリに追加します。

ここで設定する情報で，業務システムの構築時にISCMから変更できる情報については表2-8を参照してください。

(b)　仮想イメージテンプレートの作成（Windows）

vCenterとESXを使い仮想ホストを作成します。

仮想ホストにはネットワークアダプタを2つ以上用意します。この仮想ホストはJP1/ITRM上で仮想イメージテンプレートとして登録します。そのため，JP1/ITRMのドキュメントを参照して仮想イメージテンプレートとしての条件を満たしてください。

OS・VMware Toolsをインストールします。

仮想ホストにAdministratorユーザでログインします。

Cosminexusのドキュメントを参照しCosminexusの動作に必要なOSパラメータ設定やOSパッケージ適用や環境変数設定などを行います。

Cosminexusのインストーラを利用しインストールします。

サーバ通信エージェントの環境設定を行います。

操作方法はCosminexusのドキュメントを参照してください。

仮想サーバマネージャからの通信を許可します。

<Cosminexusインストールディレクトリ>¥sinagent¥config¥sinaviagent.propertiesファイルのsinaviagent.permitted.hostsパラメータに管理用サーバマシンのIPアドレスをJavaの正規表現で指定します。

sinaviagent.permitted.hosts=1¥¥.1¥¥.1¥¥.11

OS起動時にサーバ通信エージェントが起動する設定にします。

次のコマンドを実行します。

<Cosminexusインストールディレクトリ>¥sinagent¥bin¥snactl setauto

CosminexusのログやJ2EEサーバの作業用ディレクトリを作成します。

作業用ディレクトリを作成します。

次に示すコマンドを実行します。

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥J2EEServer¥admin

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥J2EEServer¥stats

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥Manager

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥PRF

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥WebServer¥redirector

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥snapshot

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥work¥J2EEServer¥public

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥work¥J2EEServer¥repository

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥work¥WebServer¥htdocs

J2EEサーバ上の業務アプリケーションがデータベースを利用するために，JDBCドライバを配置します。

JDBCドライバ配置用のディレクトリを作成します。

次に示すコマンドを実行します。

mkdir <Windowsインストールドライブ>¥var¥Cosminexus¥lib

<Windowsインストールドライブ>¥var¥Cosminexus¥libにJDBCドライバpdjdbc2.jarを配置します。

JDBCドライバはデータベースのドキュメントを参照して入手してください。

JP1/ITRMで仮想ホストを管理対象とするための設定を行います

詳細は，「JP1/IT Resource Management - Manager 設計・構築ガイド」を参照してください。

仮想ホストをシャットダウンします。

JP1/ITRMで仮想ホストを仮想イメージテンプレートに登録します。

詳細な操作方法はJP1/ITRMのドキュメントを参照してください。

JP1/ITRMのjirmimageimportコマンドを使い，仮想イメージテンプレートを作成します。

jirmimageimportコマンドで指定する-vオプションには，3.1.2で作成した仮想マシン名を指定してください。

仮想イメージテンプレートをライブラリに追加します。

ここで設定する情報で，業務システムの構築時にISCMから変更できる情報については表2-8を参照してください。

(c)　Cosminexusの定義ファイルの作成

Cosminexusの定義ファイルを作成します。サンプルで使用するCosminexus定義ファイルはC:¥sample¥VMware¥<仮想ホストOS名>¥ctCosmiDir¥configディレクトリ以下です。このconfigディレクトリにはCosminexusで定められた定義ディレクトリに格納するファイル・ディレクトリを配置します。定義ディレクトリについてはCosminexusのマニュアルを参照してください。

サイジングにより変更するパラメータ値は可変部として記載します。

仮想ホストのOSがWinsdowsで，WindowsのインストールドライブがC以外の場合は次に示す定義ファイルで指定しているディレクトリパスのドライブ文字を，使用するWindowsのインストールドライブ文字に変更します。

ctCosmiDir¥config¥combined_tier¥config¥Cosminexus¥DBConnector_HiRDB_Type4_CP_cfg.xml.default
ctCosmiDir¥config¥combined_tier¥config¥Cosminexus¥DefModel.xml.default
ctCosmiDir¥config¥combined_tier¥config¥Cosminexus¥DefModel.xml.fix
ctCosmiDir¥config¥combined_tier¥config¥Cosminexus¥CC¥admin¥usrconf¥usrconf.bat.fix
ctCosmiDir¥config¥combined_tier¥config¥Cosminexus¥manager¥config¥adminagent.properties.fix
ctCosmiDir¥config¥combined_tier¥config¥Cosminexus¥manager¥config¥manager.cfg.fix

注　Cosminexusの定義ファイル作成に関して注意事項があります。詳細については，「付録F　業務システムでCosminexusを使用する場合の注意事項」を参照してください。

(d)　コンポーネントテンプレートファイルの作成

コンポーネントテンプレートを定義するXMLファイルを作成します。サンプルで使用するコンポーネントテンプレートファイルはC:¥sample¥VMware¥<仮想ホストOS名>¥ctCosmi.xmlです。

(e)　コンポーネントテンプレートの登録

csdtmpregisterコマンドを使いコンポーネントテンプレートを登録します。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdtmpregister -f ctCosmi.xml -d ctCosmiDir
KFUD13000-I テンプレートの登録が完了しました。テンプレート名=cosmi，ID=2

(5)　コンポーネントテンプレート（Dbティア）の登録

Dbティアに対応するHiRDBを使用したコンポーネントテンプレートを登録します。

注意事項

ISCMがHiRDBとしてサポートしているのは，HiRDB/Single Serverだけです。

(a)　仮想イメージテンプレートの作成（Linux）

vCenterとESXを使い仮想ホストを作成します。

仮想ホストにはネットワークアダプタを2つ以上用意します。この仮想ホストはJP1/ITRM上で仮想イメージテンプレートとして登録します。そのため，JP1/ITRMのドキュメントを参照して仮想イメージテンプレートとしての条件を満たしてください。

OS ・VMware Toolsをインストールします。

仮想ホストにrootユーザでログインします。

HiRDBのドキュメントを参照しHiRDBの動作に必要なOSパラメータ設定やOSパッケージ適用や環境変数設定などを行います。

HiRDBのインストーラを利用しHiRDB/Single Serverをインストールします。

HiRDB用OSアカウントを作成します。

次に示す情報で作成します。

ユーザ名：hirdb00

パスワード：HiRDB

グループ名：hirdbgrp

コマンドでの実行例は次のとおりです。背景色がある部分は表示されません。

# groupadd hirdbgrp
# useradd hirdb00 -g hirdbgrp
# passwd hirdb00
Changing password for user hirdb00
New password: HiRDB
Retype new password: HiRDB

環境変数PDDIRを設定します。

/root/.bash_profileに次を追記します。

export PDDIR=/DB/hirdb

JP1/ITRMで仮想ホストを管理対象とするための設定を行います。

詳細については，マニュアル「JP1/IT Resource Management - Manager 設計・構築ガイド」を参照してください。

付録Cに記載のカーネルパラメータを設定します。

仮想ホストをシャットダウンします。

JP1/ITRMで仮想ホストを仮想イメージテンプレートに登録します。

詳細な操作方法はJP1/ITRMのドキュメントを参照してください。

JP1/ITRMのjirmimageimportコマンドを使い，仮想イメージテンプレートを作成します。jirmimageimportコマンドで指定する-vオプションには，3.1.2で作成した仮想マシン名を指定してください。

仮想イメージテンプレートをライブラリに追加します。ここで設定する情報で，業務システムの構築時にISCMから変更できる情報については表2-8を参照してください。

(b)　仮想イメージテンプレートの作成（Windows）

vCenterとESXを使い仮想ホストを作成します。

仮想ホストにはネットワークアダプタを2つ以上用意します。この仮想ホストはJP1/ITRM上で仮想イメージテンプレートとして登録します。そのため，JP1/ITRMのドキュメントを参照して仮想イメージテンプレートとしての条件を満たしてください。

OS・VMware Toolsをインストールします。

仮想ホストにAdministratorユーザでログインします。

WindowsではHiRDB管理者にAdministratorを使用します。

HiRDBのドキュメントを参照しHiRDBの動作に必要なOSパラメータ設定やOSパッケージ適用や環境変数設定などを行います。

HiRDBのインストーラを利用しHiRDB/Single Serverをインストールします。

環境変数PDDIRを設定します。

コマンドでの実行例は次のとおりです。

setx PDDIR %SystemDrive%¥win32app¥hitachi¥hirdb_s -m

サンプルを利用する場合は次に示す環境変数を登録します。

setx PDUXPLMSGTQL 6205
setx PDUXPLSEMMAX 108
setx PDUXPLSHMMAX 30087

JP1/ITRMで仮想ホストを管理対象とするための設定を行います。

詳細については，マニュアル「JP1/IT Resource Management - Manager 設計・構築ガイド」を参照してください。

仮想ホストをシャットダウンします。

JP1/ITRMで仮想ホストを仮想イメージテンプレートに登録します。

詳細な操作方法はJP1/ITRMのドキュメントを参照してください。

JP1/ITRMのjirmimageimportコマンドを使い，仮想イメージテンプレートを作成します。jirmimageimportコマンドで指定する-vオプションには，3.1.2で作成した仮想マシン名を指定してください。

仮想イメージテンプレートをライブラリに追加します。ここで設定する情報で，業務システムの構築時にISCMから変更できる情報については表2-8を参照してください。

(c)　HiRDB定義ファイル・セットアップスクリプトの作成

HiRDBの定義ファイルとセットアップスクリプトを作成します。サンプルで使用するHiRDB定義ファイルはC:¥sample¥VMware¥<仮想ホストOS名>¥ctHirdbDir¥configディレクトリ以下です。

セットアップスクリプトはC:¥sample¥VMware¥<仮想ホストOS名>¥ctHirdbDir¥scriptディレクトリ以下です。scriptディレクトリのsetup.shまたはsetup.batが業務システムの構築時に実行されるファイルです。

サイジングにより変更するパラメータ値は可変部として記載します。

仮想ホストのOSがWinsdowsで，WindowsのインストールドライブがC以外の場合は次に示す定義ファイルで指定しているディレクトリパスのドライブ文字を，使用するWindowsのインストールドライブ文字に変更します。

ctHirdbDir¥config¥pdsys.default
ctHirdbDir¥config¥pdutsys.default
ctHirdbDir¥config¥sds01.default
ctHirdbDir¥script¥mkinit.default

サンプルを使用した場合に次に示すHiRDBユーザが作成されます。

項番

認可識別子

パスワード

権限

1

hirdb00

hirdb00

DBA権限

2

USER1

USER1

CONNECT権限，スキーマ定義権限

(d)　コンポーネントテンプレートファイルの作成

コンポーネントテンプレートを定義するXMLファイルを作成します。サンプルで使用するコンポーネントテンプレートファイルはC:¥sample¥VMware¥<仮想ホストOS名>¥ctHirdb.xmlです。

(e)　コンポーネントテンプレートの登録

csdtmpregisterコマンドを使いコンポーネントテンプレートを登録します。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdtmpregister -f ctHirdb.xml -d ctHirdbDir
KFUD13000-I テンプレートの登録が完了しました。テンプレート名=hirdb，ID=3

(6)　テンプレートの公開

テンプレートの登録後は非公開となるのでPaaS利用者は使用できません。PaaS提供者は登録したテンプレートを使って業務システムを構築し，テンプレートが動作することを検証したあとにテンプレートを公開します。テンプレートを公開するにはcsdtmpcontrolコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdtmpcontrol -n asdb -a public
KFUD13002-I 正常に属性の変更が完了しました。

C:¥sample¥VMware¥Linux>csdtmpcontrol -n hirdb -a public
KFUD13002-I 正常に属性の変更が完了しました。

C:¥sample¥VMware¥Linux>csdtmpcontrol -n cosmi -a public
KFUD13002-I 正常に属性の変更が完了しました。

テンプレートを削除する場合については，「3.1.7(1)　テンプレートの削除」を参照してください。

(7)　PaaS利用者の登録

PaaS利用者を登録するには次の作業を行います。

PaaS利用者のOSアカウントを作成します。

作成したアカウントはPaaS利用者OSグループに所属させます。

OSアカウントのユーザ名と同一名で仮想サーバマネージャのシステム構築者アカウントを作成します。

パスワードは同一にする必要はなく任意の文字列を指定します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥vmi¥bin¥vmiaccount" create -m localhost -u admin -p adminpassword -user CsdUser01 -password user01pass

3.1.5　業務システムの構築

管理用サーバマシンでPaaS利用者CsdUser01ユーザが行います。

(1)　マスターイメージの登録・サイジング

(a)　テンプレートの情報取得

構成パターンテンプレートとコンポーネントテンプレートの情報を取得するためにcsdtmplsコマンドを使いテンプレートファイルを取得します。実行例を次に示します。

c:¥sample¥VMware¥Linux>csdtmpls
Pattern template:
ID  Date              Name
---------------------------
1   2012/10/01 19:44  asdb

Component template:
ID  Date              Name   HVType
-----------------------------------
3   2012/10/01 19:44  hirdb  VMware
2   2012/10/01 19:44  cosmi  VMware

c:¥sample¥VMware¥Linux>csdtmpls -n asdb -o myAsdb.xml
KFUD93011-I テンプレートファイルの出力が正常に完了しました。

c:¥sample¥VMware¥Linux>csdtmpls -n cosmi -o myCosmi.xml
KFUD93011-I テンプレートファイルの出力が正常に完了しました。

c:¥sample¥VMware¥Linux>csdtmpls -n hirdb -o myHirdb.xml
KFUD93011-I テンプレートファイルの出力が正常に完了しました。

(b)　UOCのjarファイル取得

構成パターンテンプレートに付属するUOCのjarファイルを取得します。取得にはcsdtmplsコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdtmpls -n asdb -d miSystem01Dir
KFUD93012-I テンプレートに付属するファイルの出力が正常に完了しました。

(c)　マスターイメージ定義ファイルの作成

テンプレートの情報を参考にマスターイメージ定義ファイルを作成します。サンプルで使用するマスターイメージ定義ファイルはC:¥sample¥VMware¥<仮想ホストOS名>¥miSystem01.xmlです。

(d)　マスターイメージの登録・サイジング

マスターイメージの登録・サイジングを行います。csdmiregisterコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdmiregister -f miSystem01.xml -d miSystem01Dir -s
CID  Num  CPU   Core  Memory  Tier
-----------------------------------------
1    4    2.50  2     4.00    AppServer
2    1    2.50  3     8.55    Db
KFUD13100-I マスターイメージの登録が完了しました。マスターイメージ名=system01，I
D=1

(2)　仮想ホスト配置算出

サイジング結果の仮想ホストを構築できるリソースがあるかを算出します。csdmiposコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdmipos -n system01
master image id: 1
VMID  Result     OSName                          TemplateName  Pattern    PhysicalHostGroupName  PhysicalHostIPAddress  LbSettingFileName
-----------------------------------------------------------------------------------------------------------------------------------------
1     Succeeded  RedHat Enterprise Linux 64-Bit  cosmi         AppServer  PhysicalHostGroup1     1.1.1.1                lb1.properties
2     Succeeded  RedHat Enterprise Linux 64-Bit  cosmi         AppServer  PhysicalHostGroup1     1.1.1.2                lb1.properties
3     Succeeded  RedHat Enterprise Linux 64-Bit  cosmi         AppServer  PhysicalHostGroup1     1.1.1.1                lb1.properties
4     Succeeded  RedHat Enterprise Linux 64-Bit  cosmi         AppServer  PhysicalHostGroup1     1.1.1.2                lb1.properties
5     Succeeded  RedHat Enterprise Linux 64-Bit  hirdb         Db         PhysicalHostGroup1     1.1.1.1                -
KFUD14400-I 物理配置候補算出が完了しました。マスターイメージID=1

(3)　リソース予約

算出したリソースを予約します。csdmireserveコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdmireserve -n system01
KFUD14403-I リソース予約が完了しました。マスターイメージID=1

(4)　業務システム構築

業務システムを構築します。csdmideployコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdmideploy -n system01
KFUD15054-I 業務システムの構築を受け付けました。マスターイメージID=1

csdmideployコマンドは非同期コマンドのため，コマンドが終了しても構築は完了していません。

(5)　構築完了の確認

業務システムの状態を確認します。csdmilsコマンドを使います。実行例を次に示します。

c:¥sample¥VMware¥Linux>csdmils -n system01
ID                 : 1
Name               : system01
Version            : 01-00
User               : Administrator
Status             : deployed
Create             : 2012/10/01 19:59
Modify             : 2012/10/01 19:59
Pattern template   : asdb
Component template : cosmi
                     hirdb

Parent             : ***
Version            : ***

Child              : ***

構築中はStatusの値はdeploying です。構築が成功するとdeployedに遷移します。

業務システムが稼働できるか検証するには業務システムの検証をご覧ください。

業務システムを削除する場合には「3.1.6　業務システムの削除」を参照してください。

3.1.6　業務システムの削除

管理用サーバマシンで，マスターイメージを登録したPaaS利用者が行います。

(1)　業務システムのアンデプロイ

業務システムをアンデプロイします。csdmiundeployコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdmiundeploy -n system01
KFUD95013-Q 指定したマスターイメージの仮想ホスト削除処理を続行してもよいですか？(y/n)y
KFUD15055-I 業務システムの構築解放を受け付けました。マスターイメージID=1

csdmiundeployコマンドは非同期コマンドのため，コマンド終了後も削除は完了していません。

(2)　アンデプロイ完了の確認

業務システムの状態を確認します。csdmilsコマンドを使います。実行例を次に示します。

c:¥sample¥VMware¥Linux>csdmils -n system01
ID                 : 1
Name               : system01
Version            : 01-00
User               : Administrator
Status             : ready
Create             : 2012/10/01 19:59
Modify             : 2012/10/01 19:59
Pattern template   : asdb
Component template : cosmi
                     hirdb

Parent             : ***
Version            : ***

Child              : ***

削除中はStatusの値はundeploying です。アンデプロイが成功するとreadyに遷移します。

(3)　リソース予約解除

リソース予約を解除します。csdmireleaseコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdmirelease -n system01
KFUD94009-Q 指定したマスターイメージのリソース予約の解除処理を続行してもよいですか？(y/n)y
KFUD14404-I リソース予約解除が完了しました。マスターイメージID=1

(4)　マスターイメージの削除

マスターイメージを削除します。csdmideleteコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdmidelete -n system01
KFUD93120-Q 指定したマスターイメージの削除処理を続行してもよいですか？(y/n)y
KFUD13101-I マスターイメージを削除しました。

3.1.7　PaaS環境の停止

管理用サーバマシンで，PaaS提供者が行います。

(1)　テンプレートの削除

テンプレートの削除はcsdtmpdeleteコマンドを使います。実行例を次に示します。

C:¥sample¥VMware¥Linux>csdtmpdelete -n hirdb
KFUD93021-Q 指定したテンプレートの削除処理を続行してもよいですか？(y/n)y
KFUD13001-I テンプレートの削除が完了しました。

C:¥sample¥VMware¥Linux>csdtmpdelete -n cosmi
KFUD93021-Q 指定したテンプレートの削除処理を続行してもよいですか？(y/n)y
KFUD13001-I テンプレートの削除が完了しました。

C:¥sample¥VMware¥Linux>csdtmpdelete -n asdb
KFUD93021-Q 指定したテンプレートの削除処理を続行してもよいですか？(y/n)y
KFUD13001-I テンプレートの削除が完了しました。

(2)　ISCMの停止

Windowsサービスから表示名「Hitachi IT System Configuration Manager - Manager」を停止します。

3.1.8　サンプルサイジングUOC概説

サンプルとして提供しているサイジングUOCは，Web+DBシステムをサイジングする場合の一例です。AppServerティアのアプリケーションサーバ（Cosminexus Application Server）は，CPUスペックとメモリサイズを固定として，必要なアプリケーションサーバ台数と関連するパラメータ値を算出します。

Dbティア（HiRDB）は，シングル構成としてサーバ台数を固定（1台）し，CPUスペックとメモリサイズと関連するパラメータ値を算出します。

サンプルのサイジングUOCに必要な入力項目と算出される出力項目の関係は，次の表のとおりです。

入力値から固定値を選択するサイジング情報

項番

入力

出力

サイジング対象

出力内容

（UOC中のキー名）※

値

small

medium

large

1

ScaleOfTps

最大TPS（秒間当たりのリクエスト処理数）

【small/medium/large】から指定

small：10[TPS]以下

medium：50[TPS]以下

large：100[TPS]以下

Cosminexus

Application Server

仮想ホスト数

(numberOfHost)

1

4

8

J2EEサーバ

メモリサイズ[MB]

(CsdU_J2eeMemoryMegabyte)

2006

2444

1406

J2EEサーバ

Explicitヒープ[MB]

(CsdU_EHeapMemoryMegabyte)

264

212

266

J2EEサーバ

スレッド数

(CsdU_J2eeThreadSize)

10

13

13

J2EEサーバ

実行待ちキューサイズ

(CsdU_J2eeRequestQueueSize)

10

13

13

HTTPサーバ

クライアント同時接続最大数

(CsdU_WebClientSize)

51

81

81

J2EEサーバ

コネクションプールのコネクション数

(CsdU_DBConnectionPoolSize)

10

13

13

HiRDB

CPUコア数

(numberOfCpucore)

2

3

4

ロックプールサイズ

[KB]

(CsdU_LockPoolKilobyte)

303104

477184

774144

2

ScaleOfUserDbArea

DBに格納するデータの総量

【small/medium/large】から指定

small：10[GB]以下

medium：50[GB]以下

large：100[GB]以下

HiRDB

ユーザDBサイズ[MB]

(CsdU_UserDBSizeMegabyte)

10240

51200

102400

データ用DBセグメントサイズ[セグメント数]

(CsdU_UserDBSegmentSize)

6400

32000

64000

インデクス用DBセグメントサイズ[セグメント数]

(CsdU_IndexDBSegmentSize)

6400

32000

64000

データ用DBバッファページサイズ[ページ数]

(CsdU_UserDBBufferPageSize)

32000

160000

320000

インデクス用DBバッファページサイズ[ページ数]

(CsdU_IndexDBBufferPageSize)

32000

160000

320000

ワーク用DBサイズ[MB]

(CsdU_WorkDBSizeMegabyte)

1024

5120

10240

3

ScaleOfUpdatePerDay

1日当たりのデータ更新量（insert, update, delete）

【small/medium/large】から指定

small：50[MB]以下

medium：250[MB]以下

large：500[MB]以下

HiRDB

システムログサイズ[MB]

(CsdU_DBLogSizeMegabyte)

1536

7680

15360

システムログファイルのレコード数

(CsdU_DBLogFileRecordSize)

76800

384000

768000

注※　CsdU_から始まる「キー名」は，先頭に次のプレフィックスの付与が必要ですが，上記の表の中では省略しています。

Cosminexusの場合："middleware.hitachi.Cosminexus.param."

HiRDBの場合："middleware.hitachi.HiRDB.param."

入力値と算出式から求めるサイジング情報

項番

入力

出力

サイジング対象

出力内容

（UOC中のキー名）※

算出式

1

RequestTimeoutSec

リクエストをタイムアウトする秒数

【10から3000までの整数】で指定

Cosminexus

Application Server

通信タイムアウト時間[秒]

(CsdU_RedirectorTimeoutSec)

=RequestTimeoutSec

トランザクションタイムアウト時間[秒]

(CsdU_TransactionTimeoutSec)

=RequestTimeoutSec*0.9

クライアントの最大待ち時間[秒]

(CsdU_DBResponseTimeoutSec)

=トランザクションタイムアウト時間[秒]*1.3

トランザクション処理中のサーバの最大待ち時間[秒]

(CsdU_DBServerTimeoutSec)

=トランザクションタイムアウト時間[秒]*1.3

2

ScaleOfTps

最大TPS（秒間当たりのリクエスト処理数）

【small/medium/large】 から指定

small：10[TPS]以下

medium：50[TPS]以下

large：100[TPS]以下

HiRDB

メモリサイズ[MB]

(sizeOfMemory)

=(26.1 * connectionSize + 1.05 * globalBufferMegabyte + 1215) * 1.2 + 1024

注　connectionSizeとglobalBufferMegabyteは入力値ScaleOfTpsにより，次の値となります。

connectionSize：

small/medium/large = 20/100/200

globalBufferMegabyte：

small/medium/large = 500/2500/5000

注※　CsdU_から始まる「キー名」は，先頭に次のプレフィックスの付与が必要ですが，上記の表の中では省略しています。

Cosminexusの場合："middleware.hitachi.Cosminexus.param."

HiRDBの場合："middleware.hitachi.HiRDB.param."

3.2　ハイパーバイザ種別がHVMのときに環境構築する場合

3.2.1　概要

このサンプルではハイパーバイザ種別がHVMの場合の，前提製品のインストールからCosminexusとHiRDBで構成する業務システムをISCMで構築するまでの一とおりの手順を示します。

このサンプルにおける業務システムの仕様は次のようになります。

設定内容

設定値

最大TPS

medium

50[TPS]以下

DBに格納するデータ総量

medium

50[GByte]以下

1日当たりのデータ更新量

250[MByte]以下

リクエストタイムアウト時間

60[秒]

Webクライアントアクセスホスト

2.1.1.201

LB仮想サーバホスト

2.1.1.201

対象ホスト

設定内容

設定値

Cosminexus仮想ホスト

仮想ホスト数※1

4

J2EEサーバ・メモリサイズ※1

2444[MB]

CPUコア数

2

CPUクロック数

2.5[GHz]

メモリサイズ

4[GB]

HiRDB仮想ホスト

CPUコア数※1

3

ユーザDBサイズ※2

51200[MB]

データ用DBサイズ※2

32000[MB]

システムログサイズ※3

7680[MB]

CPUクロック数

2.5[GHz]

仮想ホスト数

1

注※1　性能要件（ScaleOfTps）の設定に対するサイジング結果

注※2　性能要件（ScaleOfUserDbArea）の設定に対するサイジング結果

注※3　性能要件（ScaleOfUpdatePerDay）の設定に対するサイジング結果

(1)　業務システムを実現するネットワーク構成図

業務システムを実現するネットワークシステムの構成図を示します。

図3‒2　業務システムを実現するネットワーク構成図

(2)　製品のバージョン

手順は次の表に示すバージョンでの製品を想定しています。ほかのバージョンの場合には手順に違いが生じるときがあります。

表3‒5　関連製品の想定バージョン

項番

製品

バージョン

1

HVM（BladeSymphony BS320）

17-85

2

JP1/ITRM

09-51

3

JP1/SC/DPM

09-03-/B

4

HDvM

7.3.0-00

5

uCosminexus Application Server（仮想サーバマネージャ）

09-00

6

BIG-IP(LB)

10.2.3

7

構築する仮想ホスト・RedHat Enterprise Linux

5.6

8

構築する仮想ホスト・Windows Server 2008 R2

Enterprise

9

構築する仮想ホスト・uCosminexus Application Server

09-00

10

構築する仮想ホスト・HiRDB

09-03

(3)　サンプルの実行環境

ISCM・JP1/ITRM・仮想サーバマネージャ（Cosminexus）はデフォルトのインストール先にインストールします。

ISCMが提供するコマンドはC:¥Program Files¥Hitachi¥uCSD¥mgr¥binディレクトリ以下に格納されています。コマンド名だけで実行できるように環境変数PathにC:¥Program Files¥Hitachi¥uCSD¥mgr¥binを追加します。

サンプルで使用するファイルはC:¥Program Files¥Hitachi¥uCSD¥mgr¥sampleディレクトリに格納されています。このsampleディレクトリをC:¥にコピーします。C:¥sampleディレクトリを使ってサンプルを実行します。

コマンドは仮想ホストのOSがLinuxの場合はC:¥sample¥HVM¥Linuxディレクトリ上で，仮想ホストのOSがWindowsの場合はC:¥sample¥HVM¥Windowsディレクトリ上で実行します。

(4)　アカウント情報とファイル名称

表3‒6　サンプルで使用する設定名称一覧

項番

名称名

設定名称

1

PaaS利用者OSグループ

CsdUsers

2

Cosminexus仮想サーバマネージャ管理者アカウント

ユーザ名

admin

3

Cosminexus仮想サーバマネージャ管理者アカウント

パスワード

adminpassword

4

PaaS利用者アカウントユーザ名

CsdUser01

5

PaaS利用者CsdUser01のCosminexusシステム構築者アカウントユーザ名

CsdUser01

6

PaaS利用者CsdUser01のCosminexusシステム構築者アカウントパスワード

user01pass

7

ISCMがデプロイする仮想ホストのOSアカウントユーザ名（Linux）

root

8

ISCMがデプロイする仮想ホストのOSアカウントパスワード（Linux）

rootpassword

9

ISCMがデプロイする仮想ホストのOSアカウントユーザ名（Windows）

Administrator

10

ISCMがデプロイする仮想ホストのOSアカウントパスワード（Windows）

AdminPass01※

11

構成パターンテンプレート名

asdb

12

コンポーネントテンプレート名(AppServerティア)

cosmi

13

コンポーネントテンプレート名(Dbティア)

hirdb

14

マスターイメージ名

system01

注※　デプロイする仮想ホストのハイパーバイザ種別がHVMで，OSがWindowsの場合，仮想ホストのOSアカウントパスワードに制限があります。詳細はJP1/ITRMのマニュアルを参照してください。

3.2.2　前提製品の準備

前提製品のインストールや設定を行います。

(1)　HVM

必要に応じてLPARを作成します。

ネットワークやストレージなどを設定します。

操作方法はHVMのドキュメントを参照してください。

このサンプルの仕様ではストレージのリソース名とストレージプールを次のように設定します。

HVMマシン管理LANのIPアドレス

リソース名

ストレージプール名

1.1.1.1（HVMマシン1）

AMS2100@1.1.1.50

ThinProvisioningPool:1

1.1.1.2（HVMマシン2）

AMS2100@1.1.1.50

ThinProvisioningPool:1

(2)　OS

ISCMが前提とするWindows OSを管理用サーバマシンにインストールしてネットワークなどを適切に設定します。

操作方法はOSのドキュメントを参照してください。

(3)　JP1/ITRM

管理用サーバマシンでPaaS提供者（OSユーザ：Administrator）が行います。

JP1/ITRMのインストーラを使いインストールします。

jirmsetupコマンドを使いセットアップします。

HVMとHDvMが管理するストレージを管理対象にします。

JP1/ITRMのWeb画面で，ISCMでデプロイする仮想ホストに付与する管理LANのIPアドレスをJP1/ITRMの探索範囲に設定します。

JP1/ITRMのWeb画面で，今後構築する仮想ホストのOSアカウント情報をJP1/ITRMの認証情報に設定します。

操作方法はJP1/ITRMのドキュメントを参照してください。

(4)　HDvM

HDvMのインストーラを使いインストールします。

デプロイ先ストレージをHDvMの管理対象にします。

HDvMで,JP1/ITRM用のユーザを作成します。

操作方法はHDvMのドキュメントを参照してください。

(5)　JP1/SC/DPM

JP1/SC/DPMのインストーラを使用して，HV管理用サーバにインストールします。また，管理対象となるマシンについての設定を行います。

操作方法はJP1/SC/DPMのドキュメントを参照してください。

(6)　仮想サーバマネージャ

管理用サーバマシンでPaaS提供者(OSユーザ:Administrator)が行います。

Cosminexusのインストーラを利用しインストールします。

仮想サーバマネージャとして動作する設定をするためにC:¥Program Files¥Hitachi¥Cosminexus¥manager¥config¥mserver.propertiesに次を加えます。

com.cosminexus.mngsvr.vmi.enabled=true

仮想サーバマネージャのセットアップと仮想サーバマネージャ管理者のアカウントを設定するため次のコマンドを実行します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥bin¥mngsvrctl" setup -u admin -p adminpassword

仮想サーバマネージャを開始するため次のコマンドを実行します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥bin¥mngsvrctl" start

OS再起動時に仮想サーバマネージャが自動起動するように次のコマンドを実行します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥bin¥mngautorun" server

PaaS提供者が環境の妥当性を検証する目的でCosminexusを構築できるように仮想サーバマネージャのシステム構築者アカウントを作成します。

システム構築者アカウントのユーザ名はOSユーザ名と同じAdministratorにする必要があります。パスワードは同一にする必要はなく任意の文字列を指定します。

"C:¥Program Files¥Hitachi¥Cosminexus¥manager¥vmi¥bin¥vmiaccount" create -m localhost -u admin -p adminpassword -user Administrator -password adminpassword

C:¥Program Files¥Hitachi¥Cosminexus¥manager¥logディレクトリに対して，PaaS利用者OSグループCsdUsersに変更権限を付与します。

付与方法はOSのドキュメントを参照してください。

操作方法はCosminexusのドキュメントを参照してください。

3.2.3　ISCMインストール・セットアップ

(1)　インストール

ハイパーバイザ種別がVMwareの場合と同じです。3.1.3(1)をご覧ください。

(2)　セットアップ

ハイパーバイザ種別がVMwareの場合と同じです。3.1.3(2)をご覧ください。

(3)　ISCM稼働のための定義

ハイパーバイザ種別がVMwareの場合と同じです。3.1.3(3)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

(4)　PaaS利用者のための設定

ハイパーバイザ種別がVMwareの場合と同じです。3.1.3(4)をご覧ください。

3.2.4　PaaS環境を準備

(1)　ISCM起動

ハイパーバイザ種別がVMwareの場合と同じです。3.1.4(1)をご覧ください。

(2)　仮想サーバマネージャ管理者のアカウントをISCMに通知

ハイパーバイザ種別がVMwareの場合と同じです。3.1.4(2)をご覧ください。

(3)　構成パターンテンプレートの登録

ハイパーバイザ種別がVMwareの場合と同じです。3.1.4(3)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

(4)　コンポーネントテンプレート（AppServerティア）の登録

AppServerティアに対応するCosminexusを使用したコンポーネントテンプレートを登録します。

(a)　仮想イメージテンプレートの作成（Linux）

HVMとHDvMを使い仮想ホストを作成します。

仮想ホストにはネットワークアダプタを2つ以上用意します。この仮想ホストはJP1/ITRM上で仮想イメージテンプレートとして登録します。そのため，JP1/ITRMのドキュメントを参照して仮想イメージテンプレートとしての条件を満たしてください。

OSをインストールします。

仮想ホストにrootユーザでログインします。

Cosminexusのドキュメントを参照しCosminexusの動作に必要なOSパラメータ設定やOSパッケージ適用や環境変数設定などを行います。

Cosminexusのインストーラを利用しインストールします。

Cosminexus用OSアカウント（Component Container管理者）を作成します。

次に示す情報で作成します。

ユーザ名：cosmiuser

パスワード：resuimsoc

グループ名：cosmigrp

コマンド例を次に示します。背景色がある部分は表示されません。

# groupadd cosmigrp
# useradd cosmiuser -g cosmigrp
# passwd cosmiuser
Changing password for user cosmiuser.
New password: resuimsoc
Retype new password: resuimsoc

サーバ通信エージェントの環境設定を行います。

操作方法はCosminexusのドキュメントを参照してください。

仮想サーバマネージャからの通信を許可します。

/opt/Cosminexus/sinagent/config/sinaviagent.propertiesファイルの

sinaviagent.permitted.hosts パラメータに管理用サーバマシンのIPアドレスをJavaの正規表現で指定します。

sinaviagent.permitted.hosts=1¥¥.1¥¥.1¥¥.11

OS起動時にサーバ通信エージェントが起動する設定にします。

次のコマンドを実行します。

/opt/Cosminexus/sinagent/bin/snactl setauto

CosminexusのログやJ2EEサーバの作業用ディレクトリを作成し，所有者をComponent Container管理者に変更します。

作業用ディレクトリを作成します。

次のコマンドを実行します。

mkdir -p /SPOOL/Cosminexus/log/J2EEServer/admin

mkdir -p /SPOOL/Cosminexus/log/J2EEServer/stats

mkdir -p /SPOOL/Cosminexus/log/Manager

mkdir -p /SPOOL/Cosminexus/log/PRF

mkdir -p /SPOOL/Cosminexus/log/WebServer/redirector

mkdir -p /SPOOL/Cosminexus/snapshot

mkdir -p /SPOOL/Cosminexus/work/J2EEServer/public

mkdir -p /SPOOL/Cosminexus/work/J2EEServer/repository

mkdir -p /SPOOL/Cosminexus/work/WebServer/htdocs

所有者をComponent Container管理者に変更します。

コマンド例を次に示します。

chown -R cosmiuser.cosmigrp /SPOOL/Cosminexus

J2EEサーバ上の業務アプリケーションがデータベースを利用するために，JDBCドライバを配置します。

JDBCドライバ配置用のディレクトリを作成します。

次のコマンドを実行します。

mkdir -p /var/Cosminexus/lib/

/var/Cosminexus/lib/にJDBCドライバpdjdbc2.jarを配置します。JDBCドライバはデータベースのドキュメントを参照して入手してください。

所有者をComponent Container管理者に変更します。

コマンド例を次に示します。

chown -R cosmiuser.cosmigrp /var/Cosminexus

JP1/SC/DPMでディスク複製インストールの準備を行います。

詳細はJP1/SC/DPMのドキュメントを参照してください。

仮想ホストの複製用情報ファイルを取得します。

仮想ホストにディスク複製用の設定を行った後，バックアップを取得します。

JP1/ITRMで仮想ホストを管理対象とするための設定を行います。

詳細については，マニュアル「JP1/IT Resource Management - Manager 設計・構築ガイド」を参照してください。

付録Cに記載のカーネルパラメータを設定します。

仮想ホストをシャットダウンします。

JP1/ITRMで仮想ホストを仮想イメージテンプレートに登録します。

詳細な操作方法はJP1/ITRMのドキュメントを参照してください。

JP1/ITRMのjirmimageimportコマンドを使い，仮想イメージテンプレートを作成します。jirmimageimportコマンドで指定する-vオプションには，3.1.2で作成した仮想マシン名を指定してください。

仮想イメージテンプレートをライブラリに追加します。ここで設定する情報で，業務システムの構築時にISCMから変更できる情報については表2-8を参照してください。

(b)　仮想イメージテンプレートの作成（Windows）

HVMとHDvMを使い仮想ホストを作成します。

仮想ホストにはネットワークアダプタを2つ以上用意します。この仮想ホストはJP1/ITRM上で仮想イメージテンプレートとして登録します。そのため，JP1/ITRMのドキュメントを参照して仮想イメージテンプレートとしての条件を満たしてください。

OSをインストールします。

仮想ホストにAdministratorユーザでログインします。

Cosminexusのドキュメントを参照しCosminexusの動作に必要なOSパラメータ設定やOSパッケージ適用や環境変数設定などを行います。

Cosminexusのインストーラを利用しインストールします。

サーバ通信エージェントの環境設定を行います。

操作方法はCosminexusのドキュメントを参照してください。

仮想サーバマネージャからの通信を許可します。

<Cosminexusインストールディレクトリ>¥sinagent¥config¥sinaviagent.propertiesファイルのsinaviagent.permitted.hosts パラメータに管理用サーバマシンのIPアドレスをJavaの正規表現で指定します。

sinaviagent.permitted.hosts=1¥¥.1¥¥.1¥¥.11

OS起動時にサーバ通信エージェントが起動する設定にします。

次のコマンドを実行します。

<Cosminexusインストールディレクトリ>¥sinagent¥bin¥snactl setauto

CosminexusのログやJ2EEサーバの作業用ディレクトリを作成します。

作業用ディレクトリを作成します。

次のコマンドを実行します。

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥J2EEServer¥admin

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥J2EEServer¥stats

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥Manager

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥PRF

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥log¥WebServer¥redirector

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥snapshot

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥work¥J2EEServer¥public

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥work¥J2EEServer¥repository

mkdir <Windowsインストールドライブ>¥SPOOL¥Cosminexus¥work¥WebServer¥htdocs

J2EEサーバ上の業務アプリケーションがデータベースを利用するために，JDBCドライバを配置します。

JDBCドライバ配置用のディレクトリを作成します。

次のコマンドを実行します。

mkdir <Windowsインストールドライブ>¥var¥Cosminexus¥lib

<Windowsインストールドライブ>¥var¥Cosminexus¥libにJDBCドライバpdjdbc2.jarを配置します。

JDBCドライバはデータベースのドキュメントを参照して入手してください。

JP1/SC/DPMでディスク複製インストールの準備を行います。

詳細はJP1/SC/DPMのドキュメントを参照してください。

仮想ホストの複製用情報ファイルを取得します。

仮想ホストにディスク複製用の設定を行った後，バックアップを取得します。

JP1/ITRMで仮想ホストを管理対象とするための設定を行います

詳細については，マニュアル「JP1/IT Resource Management - Manager 設計・構築ガイド」を参照してください。

仮想ホストをシャットダウンします。

JP1/ITRMで仮想ホストを仮想イメージテンプレートに登録します。詳細な操作方法はJP1/ITRMのドキュメントを参照してください。

JP1/ITRMのjirmimageimportコマンドを使い，仮想イメージテンプレートを作成します。jirmimportコマンドで指定する-vオプションには，3.1.2で作成した仮想マシン名を指定してください。

仮想イメージテンプレートをライブラリに追加します。ここで設定する情報で，業務システムの構築時にISCMから変更できる情報については表2-8を参照してください。

(5)　コンポーネントテンプレート（Dbティア）の登録

Dbティアに対応するHiRDBを使用したコンポーネントテンプレートを登録します。

注意事項

ISCMがHiRDBとしてサポートしているのは，HiRDB/Single Serverだけです。

(a)　仮想イメージテンプレートの作成（Linux）

HVMとHDvMを使い仮想ホストを作成します。

仮想ホストにはネットワークアダプタを2つ以上用意します。この仮想ホストはJP1/ITRM上で仮想イメージテンプレートとして登録します。そのため，JP1/ITRMのドキュメントを参照して仮想イメージテンプレートとしての条件を満たしてください。

OSをインストールします。

仮想ホストにrootユーザでログインします。

HiRDBのドキュメントを参照しHiRDBの動作に必要なOSパラメータ設定やOSパッケージ適用や環境変数設定などを行います。

HiRDBのインストーラを利用しHiRDB/Single Serverをインストールします。

HiRDB用OSアカウントを作成します。

次の情報で作成します。

ユーザ名：hirdb00

パスワード：HiRDB

グループ名：hirdbgrp

コマンドでの実行例は次のとおりです。背景色がある部分は表示されません。

# groupadd hirdbgrp
# useradd hirdb00 -g hirdbgrp
# passwd hirdb00
Changing password for user hirdb00
New password: HiRDB
Retype new password: HiRDB

環境変数PDDIRを設定します。

/root/.bash_profileに次を追記します。

export PDDIR=/DB/hirdb

JP1/SC/DPMでディスク複製インストールの準備を行います。

詳細はJP1/SC/DPMのドキュメントを参照してください。

仮想ホストの複製用情報ファイルを取得します。

仮想ホストにディスク複製用の設定を行ったあと，バックアップを取得します。

JP1/ITRMで仮想ホストを管理対象とするための設定を行います。

詳細については，マニュアル「JP1/IT Resource Management - Manager 設計・構築ガイド」を参照してください。

付録Cに記載のカーネルパラメータを設定します。

仮想ホストをシャットダウンします。

JP1/ITRMで仮想ホストを仮想イメージテンプレートに登録します。

詳細な操作方法はJP1/ITRMのドキュメントを参照してください。

JP1/ITRMのjirmimageimportコマンドを使い，仮想イメージテンプレートを作成します。jirmimageimportコマンドで指定する-vオプションには，3.1.2で作成した仮想マシン名を指定してください。

仮想イメージテンプレートをライブラリに追加します。ここで設定する情報で，業務システムの構築時にISCMから変更できる情報については表2-8を参照してください。

(b)　仮想イメージテンプレートの作成（Windows）

HVMとHDvMを使い仮想ホストを作成します。

仮想ホストにはネットワークアダプタを2つ以上用意します。この仮想ホストはJP1/ITRM上で仮想イメージテンプレートとして登録します。そのため，JP1/ITRMのドキュメントを参照して仮想イメージテンプレートとしての条件を満たしてください。

OSをインストールします。

仮想ホストにAdministratorユーザでログインします。WindowsではHiRDB管理者にAdministratorを使用します。

HiRDBのドキュメントを参照しHiRDBの動作に必要なOSパラメータ設定やOSパッケージ適用や環境変数設定などを行います。

HiRDBのインストーラを利用しHiRDB/Single Serverをインストールします。

環境変数PDDIRを設定します。

コマンドでの実行例は次のとおりです。

setx PDDIR %SystemDrive%¥win32app¥hitachi¥hirdb_s -m

サンプルを利用する場合は次の環境変数を登録します。

setx PDUXPLMSGTQL 6205
setx PDUXPLSEMMAX 108
setx PDUXPLSHMMAX 30087

JP1/SC/DPMでディスク複製インストールの準備を行います。

詳細はJP1/SC/DPMのドキュメントを参照してください。

仮想ホストの複製用情報ファイルを取得します。

仮想ホストにディスク複製用の設定を行った後，バックアップを取得します。

JP1/ITRMで仮想ホストを管理対象とするための設定を行います。

詳細については，マニュアル「JP1/IT Resource Management - Manager 設計・構築ガイド」を参照してください。

仮想ホストをシャットダウンします。

JP1/ITRMで仮想ホストを仮想イメージテンプレートに登録します。

詳細な操作方法はJP1/ITRMのドキュメントを参照してください。

JP1/ITRMのjirmimageimportコマンドを使い，仮想イメージテンプレートを作成します。jirmimageimportコマンドで指定する-vオプションには，3.1.2で作成した仮想マシン名を指定してください。

仮想イメージテンプレートをライブラリに追加します。ここで設定する情報で，業務システムの構築時にISCMから変更できる情報については表2-8を参照してください。

(c)　HiRDB定義ファイル・セットアップスクリプトの作成

ハイパーバイザ種別がVMwareの場合と同じです。

3.1.4(5)(c)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

(d)　コンポーネントテンプレートファイルの作成

ハイパーバイザ種別がVMwareの場合と同じです。

3.1.4(5)(d)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください

(e)　コンポーネントテンプレートの登録

ハイパーバイザ種別がVMwareの場合と同じです。

3.1.4(5)(e)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください

(6)　テンプレートの公開

ハイパーバイザ種別がVMwareの場合と同じです。3.1.4(6)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

(7)　PaaS利用者の登録

ハイパーバイザ種別がVMwareの場合と同じです。詳細については，「3.1.4(7)　PaaS利用者の登録」を参照してください。

3.2.5　業務システムの構築

管理用サーバマシンでPaaS利用者CsdUser01ユーザが行います。

(1)　マスターイメージの登録・サイジング

(a)　テンプレートの情報取得

構成パターンテンプレートとコンポーネントテンプレートの情報を取得するためにcsdtmplsコマンドを使いテンプレートファイルを取得します。実行例を次に示します。

c:¥sample¥HVM>csdtmpls
Pattern template:
ID  Date              Name
---------------------------
1   2012/10/01 19:52  asdb

Component template:
ID  Date              Name   HVType
-----------------------------------
3   2012/10/01 19:52  hirdb  HVM
2   2012/10/01 19:52  cosmi  HVM

c:¥sample¥HVM>csdtmpls -n asdb -o myAsdb.xml
KFUD93011-I テンプレートファイルの出力が正常に完了しました。

c:¥sample¥HVM>csdtmpls -n cosmi -o myCosmi.xml
KFUD93011-I テンプレートファイルの出力が正常に完了しました。

c:¥sample¥HVM>csdtmpls -n hirdb -o myHirdb.xml
KFUD93011-I テンプレートファイルの出力が正常に完了しました。

(b)　UOCのjarファイル取得

構成パターンテンプレートに付属するUOCのjarファイルを取得します。取得にはcsdtmplsコマンドを使います。実行例を次に示します。

C:¥sample¥HVM>csdtmpls -n asdb -d miSystem01Dir
KFUD93012-I テンプレートに付属するファイルの出力が正常に完了しました。

(c)　マスターイメージ定義ファイルの作成

テンプレートの情報を参考にマスターイメージ定義ファイルを作成します。サンプルで使用するマスターイメージ定義ファイルはC:¥sample¥HVM¥<仮想ホストのOS種別>¥miSystem01.xmlです。

(d)　マスターイメージの登録・サイジング

マスターイメージを登録・サイジングを行います。csdmiregisterコマンドを使います。実行例を次に示します。

C:¥sample¥HVM>csdmiregister -f miSystem01.xml -d miSystem01Dir -s
CID  Num  CPU   Core  Memory  Tier
-----------------------------------------
1    4    2.50  2     4.00    AppServer
2    1    2.50  3     8.55    Db
KFUD13100-I マスターイメージの登録が完了しました。マスターイメージ名=system01，ID=1

(2)　仮想ホスト配置算出

ハイパーバイザ種別がVMwareの場合と同じです。3.1.5(2)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

(3)　リソース予約

ハイパーバイザ種別がVMwareの場合と同じです。3.1.5(3)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

(4)　業務システム構築

ハイパーバイザ種別がVMwareの場合と同じです。3.1.5(4)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

(5)　構築完了の確認

ハイパーバイザ種別がVMwareの場合と同じです。3.1.5(5)をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

3.2.6　業務システムの削除

ハイパーバイザ種別がVMwareの場合と同じです。3.1.6をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

3.2.7　PaaS環境の停止

ハイパーバイザ種別がVMwareの場合と同じです。3.1.7をご覧ください。

ただし，ディレクトリはC:¥sample¥VMwareをC:¥sample¥HVMに置き換えてください。

3.2.8　サンプルサイジングUOC概説

ハイパーバイザ種別がVMwareの場合と同じです。3.1.8をご覧ください。

3.3　ミドルセットアップUOC

この節ではミドルセットアップUOC，および，ミドルセットアップUOCのサンプルで提供しているJP1/PFM，JP1/IM監視設定機能について説明します。

3.3.1　概要

ミドルセットアップUOCはミドルのセットアップが完了したあとに，業務システムの単位で実行するUOCです。ミドルセットアップUOCを使用することで，JP1/PFMやJP1/IMへの監視設定や監視解除を自動で行うことができます。さらに，ミドルセットアップUOCは，ユーザがJavaでコーディングをすることによりカスタマイズが可能です。

3.3.2　機能

(1)　機能概要

ミドルセットアップUOCのサンプルではJP1/PFM，JP1/IMと連携することにより，次に示す機能を実現しています。

表3‒7　ミドルセットアップUOCで提供する機能一覧

項番

タイトル

説明

1

JP1/PFM自動監視設定

業務システムをデプロイしたあとで，デプロイしたVMを自動的にJP1/PFMの監視対象に登録します。

2

JP1/PFM自動監視解除

業務システムをアンデプロイする前に，デプロイしたVMを自動的にJP1/PFMの監視対象から解除します。

3

JP1/IM自動監視設定

業務システムをデプロイしたあとで，デプロイしたVMを自動的にJP1/IM - Managerの監視対象に登録します。

4

JP1/IM自動監視解除

業務システムをアンデプロイする前に，デプロイしたVMを自動的にJP1/IMの監視対象から解除します。

(2)　構成図

JP1/PFMと連携する構成を次の図で示します。

図3‒3　JP1/PFMと連携する場合の構成

JP1/PFM連携機能は「図3-3　JP1/PFMと連携する場合の構成」を想定しています。なお，上記の構成では分離できるJP1/PFM製品はすべて別ホストにインストールした構成を表しています。JP1/PFM-Manager，JP1/PFM-WebConsole，JP1/PFM-RM for Platformは同一ホストにインストールすることも可能です。

JP1/IMと連携する場合の構成を次に示します。

図3‒4　JP1/IMと連携する場合の構成（マネージャを複数のユーザで共有する場合）

「図3-4　JP1/IMと連携する場合の構成（マネージャを複数のユーザで共有する場合）」はすべて業務システムを１つのJP1/IM-Managerで管理する構成です。そのため，JP1/IM-Manager上はすべての業務システムの情報が参照でき，PaaS提供者だけがJP1/IM-Managerを使用する場合に適している構成です。

図3‒5　JP1/IMと連携する場合の構成（マネージャを複数のユーザで共有しない場合）

「図3-5　JP1/IMと連携する場合の構成（マネージャを複数のユーザで共有しない場合）」はPaaS利用者ごとにJP1/IM-Managerを用意し，さらにそれらを管理するPaaS提供者用のJP1/IM-Managerを設けた構成です。

PaaS利用者ごとにJP1/IM-Managerを用意するため，他のユーザが作成した業務システムの情報にはアクセスできず，PaaS利用者もJP1/IM-Managerを用いて監視を行う場合に適した構成です。

(3)　前提条件

JP1監視設定の設定対象製品は次のとおりです。

JP1/PFM - Manager

JP1/PFM - RM for Platform

JP1/PFM - Agent for Cosminexus

JP1/PFM - Agent for HiRDB

JP1/Base（認証サーバ，および，JP1/IMのエージェント監視サーバ）

JP1/PFMの監視設定を行う場合の，各製品の数の範囲を次に示します。

表3‒8　連携する製品の数の範囲

製品名

最小値

最大値

JP1/PFM - Manager

1

4

JP1/PFM - RM for Platform

1

8

JP1/PFM - Agent for XX※

0

1000

注※　XXはCosminexus または HiRDB

JP1/IMの監視設定を行う場合の，各製品の数の範囲を次に示します。

表3‒9　連携する製品の数の範囲

製品名

最小値

最大値

JP1/IM - Manager

1

8

JP1/Base

1

1000

IPv6形式のIPアドレスを使用することはできません。

JP1/PFM - ManagerをインストールするOSはWindowsだけサポートしています。

JP1/PFM - RM for PlatformをインストールするOSはWindowsだけサポートしています。

JP1/PFMの認証モードは，必ずJP1認証モードを使用してください。

JP1/PFMでは必ずアラームテーブル複数バインド機能を使用してください。

JP1/PFMにおける複数のLANを用いて接続IP経路を切り替える機能は未サポートです。

デプロイ完了後，JP1/PFM-Agent for XX（XX:CosminexusまたはHiRDB）のサービスを起動しますが，自動起動の設定は行っていません。必要に応じて自動起動の設定を行ってください。

JP1/Baseのクラスタ運用は未サポートです。

JP1監視設定機能を使用する場合，1つのマスターイメージに含まれるVMの数は50以下としてください。50よりも多い場合は，デプロイに失敗します。

(4)　実行タイミング

ミドルセットアップUOCは，次のタイミングで動作します。

表3‒10　ミドルセットアップUOCの実行タイミング

項番

実行契機

説明

1

デプロイ完了後

ISCMが業務システムを構成するすべてのVMをデプロイし，すべてのミドルウェアのセットアップ処理が完了後に1度だけ実行します。

2

アンデプロイ実行前

ISCMが業務システムを構成する1つまたはすべてのVMをアンデプロイする場合に，VMのアンデプロイ前に1度だけ実行します。

各タイミングで実行する処理の流れを次に示します。

図3‒6　デプロイ時のJP1/PFM，JP1/IM連携機能の処理の流れ

項番

処理の説明

1.

ISCMがVMのデプロイを行います。

各VMには，あらかじめJP1/PFM-Agent for Cosminexus/HiRDBをインストールしておきます。

2.

JP1/Baseの設定を行います。ここでJP1/IMのログトラップなどの設定を行います。

3.

JP1/Baseに，業務システムに対応する資源グループと権限レベルの登録を行います。

4.

JP1/PFM - Managerに業務グループを登録します。1つの業務システムが１つの業務グループに対応します。

5.

JP1/PFM - RM for Platformに業務システムに所属するVMを登録します。ここで，OSなどのパフォーマンス監視の設定を行います。

6.

JP1/PFM - Agent for Cosminexus/HiRDBの設定を行います。ここで，各ミドルウェアのパフォーマンス監視の設定を行います。

図3‒7　アンデプロイ時のJP1/PFM，JP1/IM連携機能の処理の流れ

項番

処理の説明

1.

JP1/PFM - RM for Platformに登録されている，業務システム内のVMの監視を解除します。

2.

JP1/PFM - Agent for Cosminexus/HiRDBのサービスの停止を行います。

3.

JP1/PFM - Managerから業務グループや監視対象の情報を削除します。

4.

JP1/Baseから，業務システムに対応する資源グループと権限レベルの削除を行います。

5.

業務システム内のVMのアンデプロイを行います。

(5)　JP1/PFM監視設定

JP1/PFM監視設定では次に示す機能を提供しています。

表3‒11　JP1/PFM監視設定の機能

項番

機能

説明

1

登録先JP1/PFM - Managerの選択

複数のJP1/PFM - Managerがある場合，デプロイ時には監視対象のエージェント数が最も少ないJP1/PFM - Managerを選択します。

また，すでにデプロイするマスターイメージの一部のエージェントが登録されている場合は，同一のJP1/PFM - Managerを選択します。

2

登録先JP1/PFM - RM for Platformの選択

上記項番1で選択したJP1/PFM - Manager下に複数のJP1/PFM - RM for Platformが登録されている場合，デプロイ時には監視対象のホスト数が最も少ないJP1/PFM - RM for Platformを選択します。

また，すでにデプロイするマスターイメージの一部のホストが登録されている場合は，同一のJP1/PFM - RM for Platformを選択します。

3

JP1/PFM - Managerへの業務グループの登録・削除

デプロイの延長で実行するミドルセットアップUOCでは，1つのマスターイメージに対して1つの業務グループを作成し，登録します。

業務グループの名前は，マスターイメージ名.セクション名とします。

アンデプロイの延長で実行するミドルセットアップUOCでは業務グループからアンデプロイ対象のホストを削除します。すべてのホストが削除される場合は，業務グループを削除します。

この機能の延長で，JP1/PFM - Managerホスト上のhostsファイルに，対象ホストのホスト名とIPアドレスを追加・削除します。※

4

JP1/PFM - RM for Platformへの登録・削除

デプロイの延長で実行するミドルセットアップUOCでは，上記項番1,2で選択したJP1/PFM - RM for Platformに監視対象のVMを登録します。

このとき，1つのマスターイメージに含まれるすべてのホストは，１つのインスタンスに登録します。登録される監視対象名は"CSD"+マスターイメージID（0詰め8桁）+"-"+ホストID（0詰め6桁）で登録します。（例：CSD00000001-000001）

負荷分散のために，登録する対象のインスタンスは，すでに登録されているホスト数が最も少ないものを選択します。

アンデプロイの延長で実行するミドルセットアップUOCでは，アンデプロイ対象のホストを削除します。

この機能の延長で，JP1/PFM - RM for Platformホスト上のhostsファイルに，対象ホストのホスト名とIPアドレスを追加・削除します。※

5

JP1/PFM - Agent for Cosminexus/HiRDBの設定

デプロイの延長で実行するミドルセットアップUOCでは，JP1/PFM - Agent for Cosminexus/HiRDBをセットアップし，項番1で選択したJP1/PFM - Managerの監視対象にします。

この機能の延長で，監視対象ホストのhostsファイルに項番1で選択したJP1/PFM - Managerホストのホスト名とIPアドレスを追加します。※

6

JP1/Base（認証サーバ）への登録・削除

デプロイの延長で実行するミドルセットアップUOCでは，認証サーバとなるJP1/BaseにJP1資源グループと権限レベルを登録します。

JP1資源グループ名は"CSD"+マスターイメージID（0詰め8桁）で登録します。（例：CSD00000001）

アンデプロイの延長で実行するミドルセットアップUOCでは，対応するJP1資源グループと権限レベルを削除します。

注※　ホスト名の大文字・小文字は区別します。

(6)　JP1/IM監視設定

JP1/IM監視設定では次に示す機能を提供しています。

表3‒12　JP1/IM監視設定の機能

項番

機能

説明

1

JP1/Baseの設定

デプロイの延長で実行するミドルセットアップUOCでは，JP1/Baseをセットアップし，イベントログ，または，SYSLOGのログトラップの設定を行います。

(7)　ミドルセットアップUOCの状態

ミドルセットアップUOCの状態はcsdmilsコマンドの「個別のマスターイメージ表示」で確認することができます。

ミドルセットアップUOCの状態一覧を次に示します。

表3‒13　ミドルセットアップUOCの状態一覧

項番

状態

説明

1

−

定義にミドルセットアップUOCが指定されておらず，ミドルセットアップUOCが利用できない状態

2

executable

ミドルセットアップUOCを実行可能な状態

3

executing(deploy)

デプロイコマンドの延長で実行されるミドルセットアップUOCが実行中の状態

4

succeeded(deploy)

デプロイコマンドの延長で実行されるミドルセットアップUOCが正常終了した状態

5

failed(deploy)

デプロイコマンドの延長で実行されるミドルセットアップUOCが異常終了，または，中止した状態※

6

executing(undeploy)

アンデプロイコマンドの延長で実行されるミドルセットアップUOCが実行中の状態

7

failed(undeploy)

アンデプロイコマンドの延長で実行されるミドルセットアップUOCが異常終了，または，中止した状態※

注※　ミドルセットアップUOCの状態が，executing（deploy）またはexecuting（undeploy）のときにcsdmistopdeployコマンドを実行することで処理を中止できます。

3.3.3　環境構築

(1)　定義

csd.propertiesの次に示すプロパティを変更します。定義の詳細はマニュアル「Hitachi IT System Configuration Manager リファレンス」を参照してください。

表3‒14　ミドルセットアップUOCで使用する定義

項番

定義ファイル

プロパティ名

説明

1

システム定義

uoc.path.middlesetup

UOCのファイルパスを指定します。

2

uoc.path.middlesetup.class

UOCのクラスパスを指定します。

3

uoc.timer.middlesetup

UOCのタイムアウト時間を指定します。この時間を過ぎてもUOCが終了しない場合は，UOC実行スレッドへの割り込みが発生します。

4

uoc.timer.lock

ロックを取得するためのタイムアウト時間を指定します。この時間を過ぎてもロック取得できない場合は，例外が発生します。

(2)　ユーザ登録

ミドルセットアップUOCを使用する前に，JP1/Baseにユーザを登録しておく必要があります。PaaS提供者，利用者のユーザを登録してください。なお，ユーザ名はOSアカウントのユーザ名に合わせてください。

表3‒15　PaaS提供者が設定する項目と内容

項番

ロール

登録ユーザ名

JP1資源グループ

権限レベル

1

PaaS提供者

Administrator

*

【JP1/PFM監視設定を行う場合】

JP1_PFM_Admin

【JP1/IM監視設定を行う場合】

JP1_Console_Admin

JP1_CF_Admin

2

PaaS利用者

PaaS利用者名

設定しない

設定しない

ミドルセットアップUOCでは，PaaS提供者が業務システムをデプロイした場合は，JP1資源グループと権限レベルを操作しません。PaaS利用者が業務システムをデプロイした場合は，JP1/Baseに登録されているユーザに対して資源グループと権限レベルを追加します。ISCMが追加する資源グループと権限レベルを示します。

表3‒16　ISCMが設定する項目と内容

項番

ロール

登録ユーザ名

JP1資源グループ

権限レベル

1

PaaS提供者

追加・削除しない

追加・削除しない

追加・削除しない

2

PaaS利用者

追加・削除しない

"CSD"+マスターイメージID（0詰め8桁）

例：CSD00000001

【JP1/PFM監視設定を行う場合】

JP1_PFM_Operator

【JP1/IM監視設定を行う場合】

JP1_Console_User

JP1_CF_User

なお，業務システムのアンデプロイ時には，ISCMが上記で追加した内容を削除します。

さらに，JP1/Baseのユーザ認証機能を利用するためにはJP1/PFM-Managerの定義を編集する必要があります。次に示す定義を行ってください。

定義ファイル：<JP1/PFM-Managerインストール先フォルダ>¥mgr¥viewsvr¥jpcvsvr.ini

定義内容：UserServer.authenticationMode=JP1

(3)　業務グループによるアクセスコントロール機能の有効化

業務グループを使用するには，JP1/PFM - Managerでアクセスコントロール機能を有効化する必要があります。次に示す定義を行ってください。詳細は，マニュアル「JP1/Performance Management 運用ガイド」を参照してください。

定義ファイル：<JP1/PFM-Managerインストール先フォルダ>¥jpccomm.ini

定義内容：Business Group Monitor Mode=1

(4)　JP1/PFM - RM for Platformのインスタンス作成

ISCMが使用するJP1/PFM - RM for PlatformのインスタンスをすべてのJP1/PFM - RM for Platformに登録します。ISCMが使用するインスタンスはあらかじめすべて作成しておく必要があります。

登録するコマンドの例を次に示します。詳細はマニュアル「JP1/Performance Management リファレンス」を参照してください。

ここでは"CSDInst01"という名前のインスタンスを作成する例を示します。

図3‒8　インスタンスの作成例

(5)　ミドルセットアップUOCのカスタマイズ

ミドルセットアップUOCを使用するためには，JP1/PFM-Manager，JP1/PFM-RM for Platform，JP1/IM-Manager，JP1/Baseがインスールされているホストの情報をミドルセットアップUOCに定義する必要があります。次のディレクトリ内のSetupInfoHolder.javaを編集します。

<ISCMインストールディレクトリ>¥mgr¥uoc¥sample¥middle_setup_uoc¥src¥csd¥sample

図3‒9　ミドルセットアップUOCの設定個所のコーディング例

登録する情報を次に示します。

表3‒17　ミドルセットアップUOCに設定する情報

項番

登録対象

設定項目

説明

1

JP1/PFM - RM for Platform

ホスト名

JP1/PFM-RM for Platformのホスト名を定義します。

2

IPアドレス

JP1/PFM-RM for PlatformのホストのIPアドレスを定義します。

3

ユーザ名

JP1/PFM-RM for Platformのホストにログインするためのユーザ名を定義します。

4

パスワード

JP1/PFM-RM for Platformのホストにログインするためのパスワードを定義します。

5

インストールディレクトリ

JP1/PFM-RM for Platformのインストールディレクトリを定義します。

6

JP1/PFM - Manager

ホスト名

JP1/PFM - Managerのホスト名を定義します。

7

IPアドレス

JP1/PFM - ManagerのホストのIPアドレスを定義します。

8

ユーザ名

JP1/PFM - Managerのホストにログインするためのユーザ名を定義します。

9

パスワード

JP1/PFM - Managerのホストにログインするためのパスワードを定義します。

10

インストールディレクトリ

JP1/PFM - Managerのインストールディレクトリを定義します。

11

JP1/IM - Manager

ホスト名

JP1/IM - Managerのホスト名を定義します。

12

IPアドレス

JP1/IM - ManagerのホストのIPアドレスを定義します。

13

ユーザ名

JP1/IM - Managerのホストにログインするためのユーザ名を定義します。

14

パスワード

JP1/IM - Managerのホストにログインするためのパスワードを定義します。

15

インストールディレクトリ

JP1/IM - Managerのインストールディレクトリを定義します。

16

JP1/Base

ホスト名

JP1/Baseのホスト名を定義します。

17

IPアドレス

JP1/BaseのホストのIPアドレスを定義します。

18

ユーザ名

JP1/Baseのホストにログインするためのユーザ名を定義します。

19

パスワード

JP1/Baseのホストにログインするためのパスワードを定義します。

20

インストールディレクトリ

JP1/Baseのインストールディレクトリを定義します。

21

ユーザとJP1/IM - Managerの関係

ユーザ名

複数のユーザが別々のJP1/IM - Managerを使用する場合に，登録対象のJP1/IM - Managerのユーザ名を指定します。

22

IPアドレス

複数のユーザが別々のJP1/IM - Managerを使用する場合に，登録対象のJP1/IM - ManagerのIPアドレスを指定します。

23

JP1/PFM - RM for Platformの登録先インスタンス

インスタンス名

JP1/PFM - RM for Platformに登録されているインスタンス名を指定します。

ミドルセットアップUOCはここで定義されたインスタンスのどれかにVMを登録します。

24

JP1/PFM - RM for Platformの監視接続情報

ユーザ名

JP1/PFM - RM for Platformが監視対象のVMに接続するためのユーザ名を指定します。

25

パスワード

JP1/PFM - RM for Platformが監視対象のVMに接続するためのパスワードを指定します。

26

JP1/PFM - Managerへの業務グループ登録

登録要否

JP1/PFM - Managerに業務グループを自動で登録するかどうかを指定します。

true：登録する

false：登録しない

(6)　ミドルセットアップUOCのコンパイル

ミドルセットアップUOCを使用するには，ミドルセットアップUOCを作成し，コンパイルする必要があります。コンパイルには，ISCMが提供するbuild.batを使用します。

build.batは次のディレクトリに格納されています。

<ISCMのインストールディレクトリ>¥mgr¥uoc¥sample¥middle_setup_uoc

(a)　環境変数の設定

ミドルセットアップUOCのコンパイルを行うためには，環境変数を設定する必要があります。次に示す環境変数を設定してください。

表3‒18　ミドルセットアップUOCのコンパイルに必要な環境変数

項番

環境変数

説明

1

JDK_HOME

JDK(Java Development Kit)のホームディレクトリを設定してください。

例：

C:¥Program Files¥HITACHI¥Cosminexus¥jdk

2

CSDUOCIF_JAR_PATH

ISCMが提供するUOCのJarファイルを設定してください。

例：

C:¥Program Files¥Hitachi¥uCSD¥mgr¥lib¥csduocif.jar

3

VELOCITY_JAR_PATH

ISCMが提供するvelocityのJarファイルを設定してください。

例：

C:¥Program Files¥Hitachi¥uCSD¥mgr¥lib¥velocity-1.7.jar

(b)　build.batの実行

build.batの実行例を次に示します。

<ISCMインストールディレクトリ>¥mgr¥uoc¥sample¥middle_setup_uocに移動して，次に示すコマンドを実行します。

ミドルセットアップUOCのコンパイルの例

>SET JDK_HOME=C:¥Program Files¥HITACHI¥Cosminexus¥jdk
>SET CSDUOCIF_JAR_PATH=C:¥Program Files¥Hitachi¥uCSD¥mgr¥lib¥csduocif.jar
>SET VELOCITY_JAR_PATH=C:¥Program Files¥Hitachi¥uCSD¥mgr¥lib¥velocity-1.7.jar
>build.bat
：

カレントディレクトリにmiddleSetupUoc.jarという名前でファイルが作成されますので，ISCMのシステム定義のuoc.path.middlesetupプロパティで指定したディレクトリにコピーします。

(7)　定義ファイルの作成

JP1/PFMやJP1/IMへの監視設定を行うための定義ファイルを準備します。必要なファイルを次に示します。

表3‒19　準備する定義ファイル

項番

ミドルウェア

定義ファイル

サンプルファイルのパス※3

配置先

備考

1

JP1/PFM - Manager

業務グループ定義ファイル

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_manager_jp1base¥bg_template

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥pfm_manager_jp1base¥bg_temlate

2

JP1/PFM - RM for Platform

監視対象登録の定義ファイル

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_rm_platform¥target_template_linux.vm

<ISCMインストールパス>

¥mgr¥uoc¥

middle_setup_uoc¥pfm_rm_platform¥target_template_linux.vm

※1，※2

3

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_rm_platform¥target_template_win.vm

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥pfm_rm_platform¥target_template_win.vm

※1，※2

4

JP1/PFM - Agent for Cosminexus

インスタンス定義ファイル

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_cosminexus¥linux¥inst_sample

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥pfm_cosminexus¥linux¥inst_sample

5

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_cosminexus¥windows¥inst_sample

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥pfm_cosminexus¥windows¥inst_sample

6

JP1/PFM - Agent for HiRDB

インスタンス定義ファイル

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_hirdb¥linux¥inst_sample

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥pfm_hirdb¥linux¥inst_sample

7

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_hirdb¥windows¥inst_sample

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥pfm_hirdb¥windows¥inst_sample

8

インスタンス設定ファイル

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_hirdb¥linux¥jpcagtbdef.ini

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥pfm_hirdb¥linux¥jpcagtbdef.ini

9

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥pfm_hirdb¥windows¥jpcagtbdef.ini

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥pfm_hirdb¥windows¥jpcagtbdef.ini

※1，※2

10

JP1/IM

セットアップスクリプトファイル

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥im_jp1base¥linux¥setup.sh

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥linux¥setup.sh

11

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥im_jp1base¥windows¥setup.bat

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥windows¥setup.bat

12

起動順序定義ファイル

なし

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥linux¥JP1SVPRM.DAT

JP1/Baseのサンプルファイルを配置先にコピーしてください。

13

なし

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥windows¥JP1SVPRM.DAT

14

転送設定ファイル

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥im_jp1base¥linux¥forward.vm

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥linux¥forward.vm

※1，※2

15

<ISCMインストールパス>

¥mgr¥uoc¥sample¥middle_setup_uoc¥im_jp1base¥windows¥forward.vm

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥windows¥forward.vm

※1，※2

16

イベントログトラップ動作定義ファイル

（Windowsの場合だけ）

なし

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥windows¥ntevent.conf

17

ログファイルトラップ動作定義ファイル

（Linuxの場合だけ）

なし

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥linux¥jevlog_SYSLOG.conf

18

ログファイルトラップ起動定義ファイル

（Linuxの場合だけ）

なし

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥im_jp1base¥linux¥jevlog_start.conf

注※1　下表の変換前文字列に示す文字列がファイル中に記述されている場合，ミドルセットアップUOCでVelocityを用いた文字列変換を行います。

注※2　Velocityによる変換対象となるファイルは，文字コードを”MS932”，改行コードを"CR+LF"としてください。

注※3　サンプルファイルは，<ISCMインストールパス>¥mgr¥uoc¥sampleディレクトリ下にあります。配置先のパスと似ているため，注意してください。

表3‒20　ミドルセットアップUOCで行う文字列変換

項番

定義ファイル

変換対象ファイルのパス

変換前文字列

変換後文字列の説明

1

監視対象登録の定義ファイル

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥

pfm_rm_platform¥

target_template_linux.vm

${CsdS_HostName}

JP1/PFM - RM for Platformが監視対象とする仮想ホストのホスト名

2

${CsdS_VmUser}

JP1/PFM - RM for Platformが監視対象のVMに接続するためのユーザ名

3

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥

pfm_rm_platform¥

target_template_win.vm

${CsdS_HostName}

JP1/PFM - RM for Platformが監視対象とする仮想ホストのホスト名

4

${CsdS_VmUser}

JP1/PFM - RM for Platformが監視対象のVMに接続するためのユーザ名

5

${CsdS_VmPass}

JP1/PFM - RM for Platformが監視対象のVMに接続するためのパスワード

6

インスタンス設定ファイル

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥

pfm_hirdb¥

windows¥jpcagtbdef.ini

${CsdS_HostName}

JP1/PFM - Managerの監視対象となる，JP1/PFM - Agent for HiRDBがインストールされた仮想ホストのホスト名

7

転送設定ファイル

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥

im_jp1base¥

linux¥forward.vm

${CsdS_IpAddress}

デプロイした仮想ホストの監視登録先となるJP1/IM - ManagerのIPアドレス

8

<ISCMインストールパス>

¥mgr¥uoc¥middle_setup_uoc¥

im_jp1base¥

windows¥forward.vm

${CsdS_IpAddress}

デプロイした仮想ホストの監視登録先となるJP1/IM - ManagerのIPアドレス

(8)　WMIと管理共有の設定

ファイル転送や，リモートホストのコマンドを実行するためにWMIと管理共有の設定を行う必要があります。次の手順に従って設定を行ってください。（次の手順は，Windows Server 2008 R2での設定例を示しています。OSによって，実施手順や設定方法が異なることがあります。）

(a)　WMIの設定

(i)ISCMホストでの設定

DCOMの設定

スタートメニューから［ファイル名を指定して実行］を選択し，「dcomcnfg.exe」を実行する。

コンポーネントサービスのツリーを展開し，コンピューターを選択する。

マイコンピューターを選択し右クリックからプロパティを選択する。

［既定のプロパティ］タブを選択し，［このコンピューター上で分散COMを有効にする］をチェックする。

マシンを再起動する。

(ii) JP1/PFM-RM for Platform・JP1/PFM-Managerホストでの設定

DCOMの設定

スタートメニューから［ファイル名を指定して実行］を選択し，「dcomcnfg.exe」を実行する。

コンポーネントサービスのツリーを展開し，コンピューターを選択する。

マイコンピューターを選択し右クリックからプロパティを選択する。

［既定のプロパティ］タブを選択し，［このコンピューター上で分散COMを有効にする］をチェックする。

［COMセキュリティ］タブを選択し，［アクセス許可］の［制限の編集］をクリックする。

JP1/PFM-RM for Platformに接続するユーザまたは対象ユーザが所属するグループを選択し，「リモートアクセス」の［許可］がチェックされていることを確認する。

［COMセキュリティ］タブを選択し，［起動とアクティブ化のアクセス許可］の「制限の編集」をクリックする。

JP1/PFM-RM for Platformに接続するユーザまたは対象ユーザが所属するグループを選択し，「リモートからの起動」と「リモートからのアクティブ化」の「許可」がチェックされていることを確認する。

マシンを再起動する。

ファイアウォールの設定

スタートメニューから［ファイル名を指定して実行］を選択し，「gpedit.msc」を実行する。

［コンピューターの構成］−［管理用テンプレート］−［ネットワーク］−［ネットワーク接続］および［Windowsファイアウォール］をクリックし，ツリーを展開する。

［標準プロファイル］をクリックして，右ペインにある［Windowsファイアウォール：着信リモート管理の例外を許可する］の右クリックメニューから［編集］を選択する。

開いたウィンドウで［有効］を選択する。

「Windowsファイアウォール：着信リモート管理の例外を許可する」のダイアログを閉じる。

WMIの名前空間の設定

スタートメニューから［ファイル名を指定して実行］を選択し，「wmimgmt.msc」を実行する。

［WMIコントロール(ローカル)］を選択し，右クリックから［プロパティ］を選択する。

［セキュリティ］タブを選択し，［Root］［CIMV2］をクリックする。

［セキュリティ］ボタンをクリックし，JP1/PFM-RM for Platformホストに接続するユーザまたは対象ユーザが所属するグループを選択し，「アカウントの有効化」と「リモートの有効化」の「許可」がチェックされていることを確認する。

［Windows Management Infrastructure(WMI)］を終了する。

(b)　管理共有の設定

JP1/PFM-RM for Platformホストで次のコマンドを実行します。

reg add HKEY_LOCAL_MACHINE¥SYSTEM¥CurrentControlSet¥
Services¥Lanmanserver¥parameters /v AutoShareServer /t REG_DWORD /d 1

(9)　コンポーネントテンプレートの設定

JP1/PFM - Agent for Cosminexus/HiRDBはあらかじめ仮想イメージテンプレートにインストールしておく必要があります。さらに，インストールしたJP1/PFM - Agent for Cosminexus/HiRDBに対応する定義をコンポーネントテンプレートに記載します。

表3‒21　コンポーネントテンプレートに記載する内容

項番

タグ名

属性

記述内容

1

ProductSection（class=pp.ミドルウェア識別子）

ovf:class

pp.optional.PFM_AgentforCosminexus

または

pp.optional.PFM_AgentforHirdb

2

info

−

PFMAgentCosminexus

または

PFMAgentHirdb

3

property（key=tier）

−

−

4

ovf:key

tier

5

ovf:type

string

6

ovf:value

PFMAgentCosminexus

または

PFMAgentHirdb

注意事項

ProductSection（class=pp.ミドルウェア識別子）タグの子要素にはinfo，Property（key=tier）タグのほかにProduct，Vendor，Version，FullVersion，ProductUrl，VendorUrl，Property（key=ppname.PP形名），Property（key=dirname），Property（key=errorProcess），Property（key=LoadBalancer），Property（key=script.スクリプト名）がありますが表3-21のタグ以外は定義しません。

次に，コンポーネントテンプレートの記述例を示します。

コンポーネントテンプレートの記載例（JP1/PFM - Agent for Cosminexusの場合）

<VirtualSystem ovf:id="VirtualSystemId01">
　　　　　　　　　　・
　　　　　　　　　　・
  <ProductSection ovf:class="pp.hitachi.Cosminexus">
    <Info>Cosminexus</Info>
    <Property ovf:key="tier" ovf:type="string" ovf:value="AppServer"/>
    <Property ovf:key="dirname" ovf:type="string" ovf:value="config"/>
    <Property ovf:key="LoadBalancer" ovf:type="boolean" ovf:value="true"/>
  </ProductSection>
  <ProductSection ovf:class="pp.optional.PFM_AgentforCosminexus">
    <Info>PFMAgentCosminexus</Info>
    <Property ovf:key="tier" ovf:type="string" ovf:value="PFMAgentCosminexus"/>
  </ProductSection>

コンポーネントテンプレートの記載例（JP1/PFM - Agent for HiRDBの場合）

<VirtualSystem ovf:id="VirtualSystemId01">
　　　　　　　　　　・
　　　　　　　　　　・
  <ProductSection ovf:class="pp.hitachi.HiRDB">
    <Info>Cosminexus</Info>
    <Property ovf:key="tier" ovf:type="string" ovf:value="DbServer"/>
    <Property ovf:key="dirname" ovf:type="string" ovf:value="config"/>
    <Property ovf:key="LoadBalancer" ovf:type="boolean" ovf:value="true"/>
  </ProductSection>
  <ProductSection ovf:class="pp.optional.PFM_AgentforHirdb">
    <Info>PFMAgentHirdb</Info>
    <Property ovf:key="tier" ovf:type="string" ovf:value="PFMAgentHirdb"/>
  </ProductSection>

JP1/IMの監視設定機能を使用する場合，JP1/Baseはあらかじめ仮想イメージテンプレートにインストールしておく必要があります。さらに，インストールしたJP1/Baseに対応する定義をコンポーネントテンプレートに記載します。

表3‒22　コンポーネントテンプレートに記載する内容（JP1/IMの監視設定機能を使用する場合）

項番

タグ名

属性

記述内容

1

ProductSection（class=pp.ミドルウェア識別子）

ovf:class

pp.optional.Jp1Base

2

info

−

Jp1Base

3

property（key=tier）

−

−

4

ovf:key

tier

5

ovf:type

string

6

ovf:value

Jp1Base

注意事項

ProductSection（class=pp.ミドルウェア識別子）タグの子要素にはinfo，Property（key=tier）タグのほかにProduct，Vendor，Version，FullVersion，ProductUrl，VendorUrl，Property（key=ppname.PP形名），Property（key=dirname），Property（key=errorProcess），Property（key=LoadBalancer），Property（key=script.スクリプト名）がありますが表3-22のタグ以外は定義しません。

次に，JP1/IMの監視設定機能を使用する場合のコンポーネントテンプレートの記述例を示します。

コンポーネントテンプレートの記載例（JP1/IMの監視設定機能を使用する場合）

<VirtualSystem ovf:id="VirtualSystemId01">
　　　　　　　　　　・
　　　　　　　　　　・
    <ProductSection ovf:class="pp.optional.Jp1Base">
      <Info>Jp1Base</Info>
      <Property ovf:key="tier" ovf:type="string" ovf:value="Jp1Base"/>
    </ProductSection>

(10)　仮想イメージテンプレートの作成

ここでは「3.1.4　PaaS環境を準備」，または，「3.2.4　PaaS環境を準備」で説明しているISCM用の仮想イメージテンプレートを作成済みとして，ミドルセットアップUOCを利用するための追加の手順を説明します。仮想イメージテンプレート作成時に次の設定を実施してください。

(a)　JP1/PFM-Agent for XX（XX：Cosminexus or HiRDB）に関する設定

(i) インストール

JP1/PFM-Base，および，インストール済みのミドルウェアに対応したJP1/PFM製品を仮想イメージテンプレートにインストールしてください。なお，インストールする際は必ずJP1/PFM-Base，JP/PFM-Agent for XXの順に実行してください。

さらに，インストール後，JP1/PFM関連のサービスが起動している場合は，次に示すサービス停止コマンドですべてのサービスを停止してください。

例：

jpcspm stop -key all

(ii) サービスの自動起動解除の設定

この設定は仮想イメージテンプレートがWindowsの場合だけ必要です。JP1/PFMサービスの［スタートアップの種類］を［手動］に設定します。なお，次の設定を該当するすべてのサービスについて行ってください。

［スタート］−［管理ツール］−［サービス］一覧で表示される"PFM - XXX"（XXXは任意の文字列）を右クリックする。

［プロパティ］を選択し，［スタートアップの種類］を［手動］に変更する。

(iii) エイリアス名の設定

ミドルセットアップUOCによるJP1/PFMへの監視登録を行うためには，仮想イメージテンプレートにホスト名のエイリアス名を設定しておく必要があります。設定方法は次のとおりです。

hostsファイルのlocalhost行の末尾にエイリアス名を追加する。

項番

OS

編集するhostsファイルのパス

修正例

1

Linux

/etc/hosts

この例では，エイリアス名としてlocalhost-aliasを追加します。※

[変更前]

127.0.0.1 localhost

[変更後]

127.0.0.1 localhost localhost-alias

2

Windows

<Windowsのシステムドライブ>¥Windows¥System32¥drivers¥etc¥hosts

注※　ホスト名と同一の名称，および，"localhost"は指定しないでください。

次のコマンドを実行する。

jpcconf host hostmode -mode alias -aliasname エイリアス名 -d バックアップディレクトリパス
　エイリアス名：1.で設定したエイリアス名
　バックアップディレクトリパス：バックアップ先のディレクトリのパス名
　　　　　　　（存在する，空のディレクトリを指定してください。）

(b)　JP1/PFM-RM for Platformに関する設定

(i) 監視用ユーザの設定

JP1/PFM-RM for Platformによる監視を行うためには，仮想イメージテンプレートで監視用のユーザを作成する必要があります。

(ii) SSHの設定

この設定は仮想イメージテンプレートがLinuxの場合だけ必要です。JP1/PFM-RM for PlatformによるLinuxホストの監視を行うためには，仮想イメージテンプレートでSSHサーバの設定と公開鍵の配置が必要です。詳細は，マニュアル「JP1/Performance Management - Remote Monitor for Platform」を参照してください。

(c)　JP1/Baseに関する設定

(i) インストール

インストーラを使用し，JP1/Baseをインストールしてください。

Windowsの場合はインストール中に表示される自動セットアップのチェックボックスのチェックを外してインストールを実行してください。

(ii) サービスの自動起動解除の設定

この設定は仮想イメージテンプレートがWindowsの場合だけ必要です。JP1/Base Control Serviceの［スタートアップの種類］を［手動］に設定します。設定は次のとおりです。

［スタート」→［管理ツール」→［サービス］一覧の中の"JP1/Base Control Service"を右クリックする。

［プロパティ］を選択し，［スタートアップの種類］を［手動］に変更する。

3.3.4　トラブルシュート

UOCで異常が発生した場合，KFUD26002-Eをメッセージログに出力します。このメッセージではミドルセットアップUOC内で発生した例外のスタックトレースを出力しますが，その中に，例外の情報と共に次に示すメッセージを出力します。それぞれのメッセージの意味と対処方法を示します。

表3‒23　ミドルセットアップUOCが出力するメッセージ

項番

出力するメッセージ

意味

対処

1

Cannot delete file. File={0}

ファイルの削除に失敗

{0}：削除に失敗したファイルのパス

ファイルが使用されていないか，操作権限があるかを確認してください。

2

Cannot rename file. Target file={0}, Source file={1}

ファイルのリネームに失敗

{0}：リネーム後のパス

{1}：リネームに失敗したファイルのパス

ファイルが使用されていないか，操作権限があるかを確認してください。

3

Cannot make directory. Directory={0}

ディレクトリの作成に失敗

{0}：ディレクトリのパス

次の事項を確認してください。

同名のディレクトリやファイルがすでにあるか

作成するディレクトリへの操作権限があるか

作成するディレクトリの親ディレクトリが存在するか

作成先ディレクトリの容量があるか

4

IO error. Target file={0}, Source file={1}, Temporary file={2}

I/Oエラーが発生

{0}：操作先のファイル

{1}：操作元のファイル

{2}：一時ディレクトリのファイル

なお，該当しない部分については'*'（アスタリスク）を出力する。

操作元，操作先のファイルがあるか，操作権限があるか，ディレクトリではないかを確認してください。

5

Remote command error. Command={0}, Error code={1}, IP address={2},

Host name={3}

リモートコマンドで異常が発生

{0}：リモートで実行するコマンドのパス

{1}：コマンドのリターンコード

{2}：通信対象ホストのIPアドレス

{3}：通信対象ホストのホスト名

リモートコマンドのマニュアルを参照し，該当するリターンコードの原因を調査してください。

6

Illegal encoding. File={0}

ファイルの文字コード不正

{0}：ファイルのパス

対象ファイルの文字コードが正しいかどうかを確認してください。

7

File not found. File={0}

ファイルがないか，オープンできない

{0}：ファイルのパス

ファイルが存在するか，操作権限があるかを確認してください。

8

Internal error.

内部矛盾が発生

システム管理者に連絡してください。

9

Host not found. Host={0}

ホストが未定義

{0}：ホストの種類

次のどれかを出力する。

JP1/Base

JP1/PFM-Manager

JP1/PFM-RM for Platform

次の環境設定が正しいかどうかを確認してください。

ホスト情報を定義しているか

PFM - RM for Platformのインスタンスを作成しているか

10

Cannot edit file. Target file={0}, Source file={1}, Reason={2}

ファイルの編集に失敗

{0}：編集対象ファイルのパス

{1}：編集対象ファイルの元になったファイルのパス

{2}：原因

次のいずれかを出力。

Parse Error

Convert Error

原因がParse Errorの場合，編集対象ファイルの元になったファイルに構文誤りがないかを確認してください。

原因がConvert Errorの場合，システム管理者に連絡してください。

11

Setup infomation not found.

連携製品のホスト情報が設定されていない

次の環境設定が正しいかどうかを確認してください。

ユーザとIM-Managerの関連を定義しているか

12

Interrupted error

csdmistopdeployコマンドによるデプロイまたはアンデプロイの中断により，割り込みが発生した。

または，システム定義ファイルのuoc.timer.middlesetupで設定したタイムアウト時間を超えたため，割り込みが発生した。

csdmistopdeployコマンドにより処理を中断した場合は，コマンドを再実行してください。

タイムアウトした場合は，タイムアウトの要因を調査し，原因を取り除いてからコマンドを再実行してください。または，必要に応じてuoc.timer.middlesetupの設定値を見直してください。

13

Illegal file. File={0}

ファイルのフォーマットが不正

{0}：編集対象ファイルのパス

対象ファイルの記述形式が正しいかどうかを確認してください。

14

User information not defined.

ミドルセットアップUOCにユーザの情報が設定されていない

次の環境設定が正しいかどうかを確認してください。

デプロイを実行したユーザが，ユーザとIM-Managerの関連に定義されているか

3.3.5　提供インタフェース

ミドルセットアップUOCで提供しているインタフェースについては，マニュアル「Hitachi IT System Configuration Manager リファレンス」を参照してください。

また，サンプルのソースコードの詳細につきましては，サンプルソースコード内のJavadocコメントを参照してください。

3.4　http-tier+j2ee-tier構成時の修正方法

ISCMで提供しているサンプルをhttp-tier + j2ee-tier構成用に修正する方法を示します。例として，Linuxデプロイ用のサンプルの修正方法を示します。

3.4.1　構成パターンテンプレート

「2.5.4　(1)　(b) http-tier + j2ee-tier構成の記載方法」にある記載例にあわせて構成パターンテンプレートを修正してください。

3.4.2　コンポーネントテンプレート

修正した構成パターンテンプレートに記載されているティア名を持つコンポーネントテンプレート（Cosminexus用）を作成してください（ティア名がWebServerのコンポーネントテンプレートとJ2EEServerのコンポーネントテンプレートが必要です）。

HiRDB用のコンポーネントテンプレートは修正しません。

3.4.3　マスターイメージ定義ファイル

構成パターンテンプレートに記載したコンポーネント数が増加しましたので，それにあわせてマスターイメージ定義ファイルのコンポーネント数も増やしてください。

3.4.4　サイジングUOC

マスターイメージ定義ファイルに記載した全コンポーネントがサイジングされるよう修正してください。例を次に示します（点線で囲まれた部分が変更個所です）。

3.4.5　ファイル構成の変更

サンプル提供ファイルからの変更は次に示します。

(1)　http-tierで指定する定義ファイル

削除するファイル

(ティア別定義格納ディレクトリ)¥config¥Cosminexus¥DBConnector_HiRDB_Type4_CP_cfg.xml.default

(ティア別定義格納ディレクトリ)¥config¥Cosminexus¥DBConnector_HiRDB_Type4_CP_cfg.xml.vm

(2)　j2ee-tierで指定する定義ファイル

削除するファイル

(ティア別定義格納ディレクトリ)¥vmi¥tier.properties.fix

(ティア別定義格納ディレクトリ)¥vmi¥tier.properties.vm

ファイル名を変更するファイル

tier.properties.vmからtier.propertiesへ変更（詳細については，「3.4.6(4)　mngsvrutilコマンドのクライアント側共通定義ファイル」を参照してください。）

3.4.6　ファイル記載内容の変更

(1)　簡易構築定義ファイルのパラメータファイル（固定値）

ファイル：(ティア別定義格納ディレクトリ)¥config¥Cosminexus¥DefModel.xml.fix

http-tierで指定する定義ファイル

次の固定値を追加してください。

CsdU_Sharp=###

j2ee-tierで指定する定義ファイル

次の固定値を追加してください。

CsdU_Sharp=###

次の固定値を削除してください。

CsdU_GatewayPort=80

(2)　簡易構築定義ファイルのパラメータファイル（デフォルト値）

ファイル：(ティア別定義格納ディレクトリ)¥config¥Cosminexus¥DefModel.xml.default

http-tierで指定する定義ファイル

次のデフォルト値を削除してください。

CsdU_TransactionTimeoutSec=90
CsdU_J2eeThreadSize=13
CsdU_J2eeRequestQueueSize=13
CsdU_J2eeMemoryMegabyte=2444
CsdU_EHeapMemoryMegabyte=212

j2ee-tierで指定する定義ファイル

次のデフォルト値を削除してください。

CsdU_WebClientSize=81
CsdU_RedirectorTimeoutSec=100

(3)　簡易構築定義ファイルのテンプレートファイル

ファイル：(ティア別定義格納ディレクトリ)¥config¥Cosminexus¥DefModel.xml.vm

http-tierで指定する定義ファイル

追加・変更個所を点線で囲み，削除個所は取り消し線を使用しています。

j2ee-tierで指定する定義ファイル

(4)　mngsvrutilコマンドのクライアント側共通定義ファイル

ファイル：(ティア別定義格納ディレクトリ)¥config¥Cosminexus¥manager¥config¥mngsvrutilcl.properties

http-tierで指定する定義ファイル

下記プロパティキーに指定した値を修正してください。

mngsvrutil.target_name=WebServer

j2ee-tierで指定する定義ファイル

変更はありません。

(5)　ティア別プロパティファイルのテンプレートファイル

ファイル：(ティア別定義格納ディレクトリ)¥vmi¥tier.properties.vm

http-tierで指定する定義ファイル

次の定義を追加してください。

tier.startup.no=80

j2ee-tierで指定する定義ファイル

次の定義を追加してください。

tier.startup.no=60

次の定義を削除し，ファイル名を"tier.properties"に変更してください。

lb.use=:unit:
lb.virtualserver.host=${CsdU_LBVirtualServerHost}
lb.virtualserver.port=${CsdU_LBVirtualServerPort}
lb.persistence.method=cookie-insert

文字コードを"UTF-8"，改行コードを"LF"に変更してください（Windowsの場合は文字コード・改行コードの変更は不要です）。

(6)　その他の定義ファイル

変更は不要です。

3.5　仮想ホストデプロイ無しの場合の修正方法

この章では，仮想ホストデプロイ無しの場合の修正方法について説明します。

なお，仮想ホストデプロイ無しの場合，LBを使用できません。

例として，対象ホストのOSがLinuxでミドルウェアがCosminexusの場合のサンプルの修正方法を示します。

3.5.1　コンポーネントテンプレートの変更

(1)　コンポーネントテンプレート

ファイル：(ISCMインストールディレクトリ) ¥mgr¥sample¥VMware¥Linux ¥ctCosmi.xml

追加・変更個所を点線で囲み，削除個所は取り消し線を使用しています。

Item(CPU)/Item(メモリ)タグについては，削除しなくてもエラーとはなりませんが，値は反映されず無視されます。

HiRDBの場合は，LoadBalancerに関する指定は存在しないので修正不要です。それ以外の個所について同様に修正してください。

(2)　ティア別プロパティファイルのテンプレートファイル

ファイル：(ティア別定義格納ディレクトリ)¥vmi

¥tier.properties.vm

次の定義を削除してください。

lb.use=:unit:
lb.virtualserver.host=${CsdU_LBVirtualServerHost}
lb.virtualserver.port=${CsdU_LBVirtualServerPort}
lb.persistence.method=cookie-insert

HiRDBの場合は，本ファイルは存在しないので修正不要です。

付録

付録A　業務システムの検証

構築した業務システムを検証するために業務アプリケーションを動作させます。業務アプリケーションはCosminexusのjsptobeanサンプルを使用します。

付録A.1　業務アプリケーションの用意

jsptobeanサンプルはC:¥Program Files¥Hitachi¥Cosminexus¥CC¥examples¥ejb¥ejb20¥jsptobeanディレクトリに格納されています。このjsptobeanディレクトリをC:¥sampleディレクトリにコピーします。

付録A.2　DBテーブルの作成

仮想ホストにログイン

HiRDBの仮想ホストにHiRDB用OSアカウントでログインします。

環境変数設定

このあとに実行するコマンドが必要とする環境変数を設定します。コマンド例を次に示します（Linuxはbashでの例を記載します）。

＜Linuxの場合＞

export PDDIR=/DB/hirdb
export PDCONFPATH=/DB/hirdb/conf
export PATH=${PATH}:/DB/hirdb/bin
export LD_LIBRARY_PATH=/DB/hirdb/lib
export PDHOST=`hostname`
export PDNAMEPORT=20000
export PDLANG=UTF-8
export PDUSER='"USER1"/"USER1"'

＜Windowsの場合＞

set PDHOST=ホスト名 ⇒ホスト名（hostnameコマンドで確認可能）を記載してください。
set PDNAMEPORT=20000
set PDUSER='"USER1"/"USER1"'

注　HiRDBのインストール時にシステムの環境変数にHiRDBの環境変数を設定する選択をしなかった場合，次の環境変数も必要となります。設定するパスはインストールディレクトリにより異なります。

set PDDIR=C:¥win32app¥hitachi¥hirdb_s
set PDCONFPATH=C:¥win32app¥hitachi¥hirdb_s¥CONF
set Path=%Path%;%PDDIR%¥BIN;%PDDIR%¥CLIENT¥UTL
set PDUXPLDIR=%PDDIR%¥UXPLDIR

HiRDB起動

HiRDBを起動します。pdstartコマンドを使います。コマンド例を次に示します。

pdstart

スキーマの作成

スキーマを作成します。pddefコマンドを使います。コマンド例を次に示します。

＜Linuxの場合＞

echo "create schema;" | pddef

＜Windowsの場合＞

echo create schema; | pddef

テーブル作成

テーブル作成SQL（管理用サーバマシンのC:¥sample¥jsptobean¥createTable_HiRDB.sql）を参考にしてSQLをカスタマイズします。SQLをHiRDBのpddefコマンドを使い実行します。コマンド例を次に示します。

＜Linuxの場合＞

echo "create table account (id varchar(3) primary key in rdindx01, firstname varchar(24),lastname varchar(24),balance double precision) in rddata01;" | pddef

＜Windowsの場合＞

echo create table account (id varchar(3) primary key in rdindx01, firstname varchar(24),lastname varchar(24),balance double precision) in rddata01; | pddef

付録A.3　業務アプリケーションの稼働

管理用サーバマシンでPaaS利用者CsdUser01ユーザが行います。

業務アプリケーションの変更

Cosminexusアプリケーション属性ファイル

（C:¥sample¥jsptobean¥DD¥META-INF¥cosminexus.xml）をテキストエディタで開き，文字列「DB_Connector_for_Cosminexus_Driver」を「DB_Connector_for_HiRDB_Type4」に置き換えます。

業務アプリケーションのコンパイル

コマンドプロンプトを開き，C:¥sample¥jsptobeanディレクトリに移動し，compile.batを実行します。コンパイルが行われaccount.earが作成されます。

業務アプリケーションの開始

仮想サーバマネージャを介して業務アプリケーションを業務システムに組み込みます。PaaS利用者が行います。

コマンドプロンプトを開く

管理用サーバマシンでコマンドプロンプトを開きます。

パス設定

仮想サーバマネージャのコマンドへのパスを追加します。コマンド例を次に示します。

set Path=%Path%;C:¥Program Files¥Hitachi¥Cosminexus¥manager¥vmi¥bin

定義ディレクトリを取得

現状の定義ディレクトリを取得するためvmiunit exportコマンドを実行します。

コマンド例を次に示します。

vmiunit export -m localhost -u CsdUser01 -p user01pass -unit u0000000100001 -dir C:¥sample¥unitDir

「u0000000100001」は管理ユニット名です。管理ユニット名は「u + <マスターイメージID(0詰め8桁)> + <コンポーネントID(0詰め5桁)>」です。

業務アプリケーションを定義ディレクトリに格納

C:¥sample¥unitDir¥combined_tier¥ディレクトリにappディレクトリを作成します。

業務アプリケーション（C:¥sample¥jsptobean¥account.ear）をC:¥sample¥unitDir¥combined_tier¥app¥account.earにコピーします。

変更の取り込み

変更を仮想サーバマネージャに取り込むためvmiunit importコマンドを実行します。コマンド例を次に示します。

vmiunit import -m localhost -u CsdUser01 -p user01pass -unit u0000000100001 -dir C:¥sample¥unitDir

変更を仮想ホストへ反映

変更を仮想ホストに反映するためvmiunit updateコマンドを実行します。コマンド例を次に示します。

vmiunit update -m localhost -u CsdUser01 -p user01pass -unit u0000000100001

業務アプリケーションの開始

業務システムを開始するためvmiunit startコマンドを実行します。

業務システムを開始すると業務アプリケーションも開始されます。コマンド例を次に示します。

vmiunit start -m localhost -u CsdUser01 -p user01pass -unit u0000000100001 -lb

付録A.4　業務システムの利用

LBの外部ネットワークに接続されたパソコンにて，ブラウザを使いhttp://2.1.1.201/jsptobean/account_war/Account.jspにアクセスします。

次のようにアカウントが作成できればCosminexus・HiRDBを含む業務システムの稼働ができています。

付録B　ISCMのデータベースに登録可能なパラメータ最大数と定義との対応

ISCMに登録可能な各パラメータの最大数を次に示します。

表B‒1　ISCMに登録可能なパラメータの最大数

項番

パラメータ

最大登録数

1マスターイメージ当たりの上限値

1物理ホスト当たりの上限値

定義ファイルとの対応※1

1

テンプレート

500

−

−

−

2

マスターイメージ

3000

−

−

−

3

UOC

3000

1

−

−

4

UOCパラメータ

60000

20

−

表2-20 項番13

5

接続先ネットワーク

48000

16

−

表2-13 項番42

6

仮想ホストグループ

9000

60

−

表2-13 項番29

表2-16 項番10

7

仮想ホスト

3000

20

−

表3-9 項番2

8

仮想ネットワークデバイス

48000

−

16

表2-13 項番42

9

OSのサイジングパラメータ

30000

200

−

表3-9 項番6

10

物理配置候補

（csdmiposコマンドでの算出が完了しているマスターイメージ）

3000

1

−

−

11

NICのネットワーク

48000

320

−

表2-16 項番122

12

OSのパラメータ

30000

200

−

表2-20 項番36

13

OSのパッチ

360000

2400

−

表2-20 項番41

14

ミドルウェア

15000

100

−

表2-20 項番21

15

ミドルウェアのパラメータ

150000000

1000000

−

表2-20 項番25

16

ミドルウェアのパッチ

1800000

12000

−

表2-20 項番30

17

ミドルウェアのサイジングパラメータ

150000000

1000000

−

表3-9 項番7

18

PP形名

75000

500

−

表2-16 項番46

19

物理ホストグループ

125

−

−

表2-7 項番3

20

物理ホスト

1000

−

−

表2-7 項番5

21

データストア

3000

−

3

表2-8 項番3，6

22

負荷分散機接続設定プロパティファイル

100

−

−

負荷分散機接続設定プロパティファイル

23

仮想ホストのIPアドレス

31500

−

−

表2-6 項番1

24

FC-HBA（HVMの場合だけ）

48000

320

−

表2-16 項番127

25

データストア対応管理

3000

−

3

表2-7 項番12，17，20

26

リソースプール管理

3000

−

3

表2-7 項番9，13

注※1　定義ファイルとの対応列にはマニュアル「Hitachi IT System Configuration Manager リファレンス」の定義ファイルとの対応を記載しています。

付録C　カーネルパラメータ

ISCMが提供するサンプルを使用してLinuxの仮想イメージテンプレートを作成する場合，必要に応じてカーネルパラメータを変更する必要があります。

付録C.1　Cosminexusの場合

次の条件を満たす値を指定してください。

項番

カーネルパラメータ

値

設定ファイル

1

fs.file-max

654以上

/etc/sysctl.conf

2

kernel.shmmax

9,424,960以上

/etc/sysctl.conf

3

kernel.threads-max

710以上

/etc/sysctl.conf

付録C.2　HiRDBの場合

次の条件を満たす値を指定してください。

項番

カーネルパラメータ

値

設定ファイル

1

hard nofile

8,192以上

/etc/security/limits.conf

2

hard nproc

6,134以上

/etc/security/limits.conf

3

fs.file-max

303,855,157以上

/etc/sysctl.conf

4

kernel.threads-max

3,154以上

/etc/sysctl.conf

5

kernel.msgmni

45以上

/etc/sysctl.conf

6

kernel.shmmax

5,576,712,192以上

/etc/sysctl.conf

7

kernel.shmmni

2,000以上

/etc/sysctl.conf

8

kernel.shmall

6,920,502以上

/etc/sysctl.conf

9

SEMMNI※1

1,024以上

/etc/sysctl.conf

10

SEMMNS※1

8,063以上

/etc/sysctl.conf

注※1　kernel.semの値です。

左からSEMMSL SEMMNS SEMOPM SEMMNIを表します。

例えば，SEMMNIを修正する場合は，kernel.semパラメータの左から４番目の値を変更します。

付録D　ミドルウェアのセットアップ手順

業務システムの構築でISCMが行うミドルウェアのセットアップ手順を次に示します。

表D‒1　ミドルウェアセットアップ手順

項番

ミドルウェア種別

セットアップ手順

1

Cosminexus

仮想サーバマネージャおよびCosminexusのコマンドを表D-2に示す順序で実行します。

各コマンドの詳細はマニュアル「Cosminexus アプリケーションサーバ リファレンス コマンド編」を参照してください。

マスターイメージ定義ファイルで指定したパッチスクリプトを適用順に実行します。

2

HiRDB

そのほかのミドルウェア

コンポーネントテンプレートで指定したセットアップスクリプトを実行します。

マスターイメージ定義ファイルで指定したパッチスクリプトを適用順に実行します。

3

共通

すべてのミドルウェアのセットアップが完了したあと，ミドルセットアップUOCが登録されている場合は実行します。

ミドルセットアップUOCの詳細は「3.3　ミドルセットアップUOC」を参照してください。

表D‒2　Cosminexusセットアップ手順

項番

処理

実行コマンド※3

csdmideploy

のオプション

-cなし

-cあり

1

管理ユニットの存在確認

vmiunitadmin listコマンド

○

○

2

仮想サーバマネージャへの管理ユニットの作成

vmiunitadmin createコマンド※1

○

○

3

管理ユニットの所有者変更

vmiunitadmin changeownerコマンド

○

○

4

仮想サーバグループの存在確認

vmiunit listコマンド

○※6

○※6

5

管理ユニットから仮想サーバグループの削除

vmiunit detachコマンド※5

○※6

○※6

6

管理ユニットへのCosminexus定義取り込み

vmiunit importコマンド

○

○

7

管理ユニットへの仮想サーバグループの登録

vmiunit attachコマンド

○

○

8

通信エージェントの稼働確認と定義更新要否の確認

vmiunit statusコマンド

○

○

9

Cosminexusのセットアップ状況を確認

rasetup コマンド

○

×

10

運用管理エージェントの起動

adminagentctl startコマンド

○

×

11

運用管理エージェントの稼働確認

adminagentcheckコマンド※4

○

×

12

Management Serverの起動

mngsvrctl startコマンド

○

×

13

Management Serverの稼働確認

mngsvrutil check mngsvrコマンド※4

○

×

14

J2EEサーバ起動

mngsvrutil start serverコマンド

○

×

15

バックアップ対象のリソースアダプタ名取得

cjlistrarコマンド

○

×

16

リソースアダプタのエクスポート

cjexportrarコマンド

○

×

17

バックアップ対象の業務アプリケーション名取得

cjlistappコマンド

○

×

18

業務アプリケーションのエクスポート

cjexportappコマンド

○

×

19

J2EEサーバの停止

mngsvrutil stop serverコマンド

○

×

20

Management Serverの停止

mngsvrctl stopコマンド

○

×

21

運用管理エージェントの停止

adminagentctl stopコマンド

○

×

22

仮想ホストへの一括反映

vmiunit updateコマンド

○

○

23

仮想ホストへの定義反映確認

vmiunit statusコマンド

○

○

24

Cosminexusのセットアップ状況を確認

rasetup コマンド

○

×

25

運用管理エージェントの起動

adminagentctl startコマンド

○

×

26

運用管理エージェントの稼働確認

adminagentcheckコマンド※4

○

×

27

Management Serverの起動

mngsvrctl startコマンド

○

×

28

Management Serverの稼働確認

mngsvrutil check mngsvrコマンド※4

○

×

29

J2EEサーバ起動

mngsvrutil start serverコマンド

○

×

30

デプロイ済みリソースアダプタの確認

cjlistrarコマンド

○

×

31

リソースアダプタのインポート

cjimportresコマンド

○

×

32

リソースアダプタのデプロイ

cjimportrarコマンド

○

×

33

インポート済み業務アプリケーションの確認

cjlistappコマンド

○

×

34

業務アプリケーションのインポート

cjimportappコマンド

○

×

35

業務アプリケーションの起動

cjstartappコマンド

○※2

×

36

J2EEサーバの停止

mngsvrutil stop serverコマンド

○

×

37

Management Serverの停止

mngsvrctl stopコマンド

○

×

38

運用管理エージェントの停止

adminagentctl stopコマンド

○

×

（凡例）

○：実行します。

×：実行しません。

注※1　仮想サーバマネージャのコマンドを実行して，表D-3に示す管理ユニットを作成します。

注※2　業務アプリケーションが展開ディレクトリ形式，かつバックアップ前の状態が”running”の場合に実行します。

注※3　項番1〜8，項番22〜23のコマンドは仮想サーバマネージャのコマンドを実行します。項番9〜21，項番24〜38は仮想ホスト上のCosminuexusのコマンドを実行します。

注※4　起動完了を確認するため，コマンド実行を1秒間隔で繰り返します。システム定義ファイルのdeploy.sshexcutetimerプロパティで指定した時間が経過した場合は，コマンドの実行を中止します。

注※5　登録対象の仮想サーバグループが存在する場合にコマンドを実行します。

注※6　-rなしの場合は×となります。

表D‒3　管理ユニットの設定

項番

設定項目

設定値

1

管理ユニット名

"u" + <マスターイメージID(0詰め8桁)> + <コンポーネントID(0詰め5桁)>※」（例：u0000000100001）を設定します。

注※　http-tier + j2ee-tier構成の場合は，http-tierのコンポーネントIDが使用される。

2

所有者

業務システムの構築を実行したOSアカウントと同名のシステム構築者アカウントを設定します。

3

定義ディレクトリ

コンポーネントテンプレートのミドルウェア定義格納ディレクトリで指定したディレクトリを登録します。

4

仮想サーバグループ

図D-1/図D-2，表D-4に示すフォーマットで仮想サーバグループ情報ファイルを作成して登録します。

図D‒1　ISCMが作成する仮想サーバグループ情報ファイルの記載例（combined-tier構成）

<?xml version="1.0" encoding="utf-8"?>
<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0">
  <group name="AA...AA_group">
    <virtualserver tier="BB...BB" ip="CCC.CCC.CCC.CCC" serviceip="DDD.DDD.DDD.DDD" />
  </group>
      :
</virtualserver-info>

図D‒2　ISCMが作成する仮想サーバグループ情報ファイル記載例（http-tier + j2ee-tier構成）

<?xml version="1.0" encoding="utf-8"?>
<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0">
  <group name="AA...AA_group">
    <virtualserver tier="BB...BB" ip="CCC.CCC.CCC.CCC" serviceip="DDD.DDD.DDD.DDD" />
    <virtualserver tier="EE...EE" ip="FFF.FFF.FFF.FFF" serviceip="GGG.GGG.GGG.GGG" />
    <virtualserver tier="HH...HH" ip="III.III.III.III" serviceip="JJJ.JJJ.JJJ.JJJ" />
  </group>

表D‒4　ISCMが作成する仮想サーバグループ情報ファイルの設定値

タグ名

属性名

指定数

指定値

virtualserver-info

1

−

xmlns

1

指定値は固定です。（上図参照）

group

仮想ホスト数

−

name

1

<仮想ホスト名※> + "_group"を指定します。

注※　http-tier + j2ee-tier構成の場合は，http-tierの仮想ホスト名が使用される。

virtualserver

1

−

tier

1

コンポーネントテンプレートで指定したミドルウェア定義格納ディレクトリに格納されているティア別定義ディレクトリ名を指定します。

http-tier + j2ee-tier構成の場合，ティア別定義ディレクトリ名は「"t"+コンポーネントID(0詰め5桁)」となります。

ip

1

管理用IPアドレスを指定します。

serviceip

0または1

combined-tier構成の場合，ロードバランサで使用する業務用IPアドレスを指定します。ロードバランサを使用しない場合は指定を省略(デフォルトのip属性指定値を使用)します。

http-tier + j2ee-tier構成の場合，tier属性が”http-tier”のvirtualserverタグには，serviceip属性にロードバランサで使用する業務用IPアドレスを指定します。ロードバランサを使用しない場合は指定を省略(デフォルトのip属性指定値を使用)します。tier属性が”j2ee-tier”のvirtualserverタグには，serviceip属性にWebサーバと接続可能な業務用IPアドレス※を指定します。

注※　管理LANだけの構成の場合は，管理用IPアドレスを指定します。

port

0

ISCMで作成する仮想サーバグループ情報ファイルは指定を省略（デフォルトの20580を使用）します。

仮想サーバグループ情報ファイルの詳細はマニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

付録E　負荷分散機に設定する情報と確認方法

仮想サーバマネージャを使用せずに負荷分散機にロードバランシングの設定を行う場合，ISCMが管理している情報が必要となります。表E-1に負荷分散機に設定する情報，および，確認方法を次に示します。表中の項目以外の設定については，負荷分散機のドキュメントを参照してください。なお，Virtual ServerとReal Serverの名称は，負荷分散機の製品によって異なります。

表E‒1　負荷分散機に設定する情報と確認方法

項番

負荷分散機に設定する情報

説明

確認方法

1

Real ServerのIPアドレス

負荷分散機に設定したVirtual Serverが受けたリクエストの，振り分け先IPアドレスです。

csdmils {-i マスターイメージID |-n マスターイメージ名[.セクション]} -e

コマンドを実行

2

Real Serverのポート番号

負荷分散機に設定したVirtual Serverが受けたリクエストの，振り分け先ポート番号です。

Cosminexusの簡易構築定義ファイルのListen要素を参照※

（コンポーネントテンプレートのサンプルファイルでは80です）

3

Real ServerのVLAN ID

負荷分散機に設定したVirtual Serverが受けたリクエストの，振り分け先サーバとの通信で使用するVLAN IDです。

csdmils {-i マスターイメージID |-n マスターイメージ名[.セクション]} -e

コマンドを実行

4

Virtual Serverの名称

Virtual Serverの名称です。任意の名称です。

−

5

Virtual ServerのIPアドレス

クライアントがリクエストを送信する宛先のIPアドレスです。

任意のアドレスです。

−

6

Virtual Serverのポート番号

サービスのポート番号です。

任意のポート番号です。

−

7

cookie名

cookieパーシステンスを使用する場合，cookieパーシステンスのテンプレート名です。

任意の名称です。

−

注※

Cosminexusの簡易構築定義ファイルにおける，<param-name>タグの要素が"Listen"の個所に対応した<param-value>タグの要素です。簡易構築定義ファイルにおけるRealServerのポート番号の指定個所は，次の背景色がある個所となります。

<?xml version="1.0" encoding="UTF-8"?>
：
  <web-system>
：
    <unit>
：
      <allocated-host>
：
        <define-server>
：
          <configuration>
：
            <param>
              <param-name>Listen</param-name>
              <param-value>80</param-value>
            </param>
：

注意事項

複数のWebシステムで負荷分散機を共有する場合は，共有するWebシステムでVirtual Server名が重複しないように指定してください。

複数のWebシステムで負荷分散機を共有する場合は，共有するWebシステムでVirtual ServerのIPアドレスが重複しないように指定してください。

付録F　業務システムでCosminexusを使用する場合の注意事項

業務システムでCosminexusを使用する場合，次に示す注意事項があります。

付録F.1　Cosminexusの定義更新失敗時の注意事項

マスターイメージ更新コマンド（csdmiupdate）によるCosminexusの定義更新に失敗し，メッセージログにKFUD25083-Wが出力された場合，仮想ホスト上の業務アプリケーションまたはリソースアダプタが削除されている可能性があるため，次の(a)(b)(c)の手順を実施してください。

(1)　業務アプリケーションの再登録手順

業務アプリケーションを再登録する手順を次に示します。

手順の実施には，J2EEサーバ名とCORBAネーミングサービスが使用しているポート番号が必要なので，事前に確認してください。

表F‒1　業務アプリケーションの再登録手順

項番

手順

具体的な処理/コマンド例

1

仮想ホストにログインしてCosminexusのコマンドを実行し，Cosminexusに登録済みの業務アプリケーションを確認します。

cjlistapp

J2EEサーバ名

-nameserver corbaname::localhost:ポート番号

2

backup_list.txt※1※2の内容とcjlistappコマンドの出力結果を比較し，backup_list.txtに記載されている業務アプリケーションの中から，Cosminexusに登録されていない業務アプリケーションを確認します。

−

3

未登録の業務アプリケーションがある場合，Cosminexusのコマンドでインポートします。

アーカイブ形式の場合，backup_list.txtの内容から対応するバックアップファイル名を確認し，backup_list.txtと同じディレクトリ内に格納されているバックアップファイル※1をCosminexusのコマンドに指定してください。

展開ディレクトリ形式の場合，backup_list.txtの内容から対応するアプリケーションのパスを確認し，Cosminexusのコマンドに指定してください。

(アーカイブ形式の場合)

cjimportapp

J2EEサーバ名

-nameserver corbaname::localhost:ポート番号

-f バックアップファイル

(展開ディレクトリ形式の場合)

cjimportapp

J2EEサーバ名

-nameserver corbaname::localhost:ポート番号

-a アプリケーションのパス

4

展開ディレクトリ形式の場合，インポート後に業務アプリケーションは起動しません。

必要に応じて，Cosminexusのコマンドで業務アプリケーションを起動してください。

バックアップ取得前の業務アプリケーションの状態はbackup_list.txtに出力しています。

cjstartapp

J2EEサーバ名

-nameserver corbaname::localhost:ポート番号

-name アプリケーション名

注※1　ファイルは次のディレクトリに格納しています。

(仮想ホストのOSがLinuxの場合)

<定義deploy.remote.tmppathの値>/csd_backup/application

(仮想ホストのOSがWindowsの場合)

<定義deploy.remote.tmppath.winの値>¥csd_backup¥application

注※2　backup_list.txtの出力フォーマットを次に示します。

出力例のパスは仮想ホストのOSがLinuxの場合です。Windowsの場合は，パス区切り文字を"¥"に読み替えてください。

(アーカイブ形式の場合)

<バックアップファイル名>,<アプリケーション名>,

バックアップファイル名：

　同一ディレクトリに作成したバックアップファイル名を出力する。

　（ファイル名だけ。途中のパスは出力しない。）

アプリケーション名：

　対象バックアップファイルにバックアップした業務アプリケーションの名称を出力する。

出力例を次に示します。

app001.ear,App1,

app002.ear,App2,

(展開ディレクトリ形式の場合)

<展開ディレクトリ形式のアプリケーションのパス>,<アプリケーション名>,<アプリケーションの状態>

展開ディレクトリ形式のアプリケーションのパス：

　展開ディレクトリ形式のアプリケーションの格納先パスを出力する。

アプリケーション名：

　対象バックアップファイルにバックアップした業務アプリケーションの名称を出力する。

アプリケーションの状態：

　バックアップ時のアプリケーションの状態を出力する。

　状態は"stopped"か"running"のどちらかを出力する。

出力例を次に示します。

/extractdir/App1Dir,App1,stopped

/extractdir/App2Dir,App2,running

アーカイブ形式の業務アプリケーションと展開ディレクトリ形式の業務アプリケーションが混在している場合の出力例を次に示します。

app001.ear,App1,

/extractdir/App2Dir,App2,running

(2)　リソースアダプタの再デプロイ手順

リソースアダプタを再デプロイする手順を次に示します。

手順の実施には，J2EEサーバ名とCORBAネーミングサービスが使用しているポート番号が必要なので，事前に確認してください。

表F‒2　リソースアダプタの再デプロイ手順

項番

手順

具体的な処理/コマンド例

1

仮想ホストにログインしてCosminexusのコマンドを実行し，Cosminexusに登録済みのリソースアダプタを確認します。

cjlistrar

J2EEサーバ名

-nameserver corbaname::localhost:ポート番号

2

backup_list.txt※1※2の内容とcjlistappコマンドの出力結果を比較し，backup_list.txtに記載されている業務アプリケーションの中から，デプロイされていないリソースアダプタを確認します。

−

3

デプロイされていないリソースアダプタがある場合，Cosminexusのコマンドでインポートします。

backup_list.txtの内容から対応するバックアップファイル名を確認し，backup_list.txtと同じディレクトリ内に格納されているバックアップファイル※1をCosminexusのコマンドに指定してください。

cjimportres

J2EEサーバ名

-nameserver corbaname::localhost:ポート番号

-type rar

-f バックアップファイル

4

インポートしたリソースアダプタをCosminexusのコマンドでデプロイします。

cjdeployrar

J2EEサーバ名

-nameserver corbaname::localhost:ポート番号

-resname リソースアダプタ名

注※1　ファイルは次のディレクトリに格納しています。

(仮想ホストのOSがLinuxの場合)

<定義deploy.remote.tmppathの値>/csd_backup/resource_adapter

(仮想ホストのOSがWindowsの場合)

<定義deploy.remote.tmppath.winの値>¥csd_backup¥resource_adapter

注※2　backup_list.txtの出力フォーマットを次に示します。

<バックアップファイル名>,<リソースアダプタ名>

バックアップファイル名：

　同一ディレクトリに作成したバックアップファイル名を出力する。

　（ファイル名だけ。途中のパスは出力しない。）

リソースアダプタ名：

　対象バックアップファイルにバックアップしたリソースアダプタの名称を出力する。

出力例を次に示します。

res001.rar,DB_Connector_A

res002.rar,DB_Connector_B

(3)　マスターイメージ更新コマンド（csdmiupdate）の再実行手順

マスターイメージ更新コマンドの再実行手順を次に示します。

表F‒3　マスターイメージ更新コマンド（csdmiupdate）の再実行手順

項番

手順

具体的な処理/コマンド例

1

前回のマスターイメージ更新コマンド実行時に指定したマスターイメージID，マスターイメージ定義ファイルを指定して，マスターイメージ更新コマンドを実行します。

csdmiupdate

-i マスターイメージID

-f マスターイメージ定義ファイル

付録F.2　システム作成上の注意事項

システム作成上，次の注意事項があります。

Cosminexus上の業務アプリケーションに，WARアプリケーションを使用することはできません。

付録F.3　運用に関する注意事項

運用に関して，次の注意事項があります。

次の表に示すCosminexusの定義のパラメータ値を変更する場合は，必ずISCMのcsdmiupdateコマンドで変更してください。

なお，ISCMのcsdmiupdateコマンドでパラメータ値を変更するためには，コンポーネントテンプレートで，パラメータ値を可変部(${CsdU_XXXXX}と記述)にしておく必要があります。

表F‒4　csdmiupdateコマンドで変更する必要があるCosminexusの定義パラメータ値一覧

項番

定義ファイル名

パラメータ名

説明

1

mserver.properties

(Management Server環境設定ファイル)

webserver.connentor.http.port

Management Serverの接続HTTPポート番号

2

com.cosminexus.mngsvr.management_user_account.enabled

Management Serverのユーザアカウントの有効／無効

3

vmsetup.properties

(管理者設定用プロパティファイル)

setup.mng.administrator.userid

Management Serverの管理ユーザアカウントのユーザID

4

setup.mng.administrator.password

Management Serverの管理ユーザアカウントのパスワード

5

DefModel.xml

(簡易構築定義ファイル)

<logical-server-name>タグ

J2EEサーバ名

6

ejbserver.naming.port※

CORBAネーミングサービスのポート番号

注※　Cosminexusのティア構成がhttp-tier + j2ee-tier構成でhttp-tierで指定する定義ファイルの場合，csdmiupdateコマンドでパラメータ値を変更する必要はありません。

デプロイした仮想ホスト上で直接パラメータ値を変更した場合，ISCMが保持するパラメータ値と差異が生じるため，変更するパラメータによっては，業務アプリケーションまたはリソースアダプタのバックアップに失敗することがあります。

Cosminexusの定義を更新するため，ISCMは定義更新の処理の中で，仮想マシン上のCosminexusを起動し，定義更新後にCosminexusを停止します。

業務アプリケーションがアーカイブ形式の場合，Cosminexusは，停止前の業務アプリケーションの状態を引き継ぎます。そのため，業務アプリケーションが起動している状態でCosminexusを停止した場合，定義更新の途中で業務アプリケーションが起動します。

Cosminexusの定義更新中に業務アプリケーションが起動すると問題になる場合は，マスターイメージ更新コマンド（csdmiupdate）を実行する前に，業務アプリケーションを停止してから，Cosminexusを停止してください。

マスターイメージ更新コマンド(csdmiupdate)によるCosminexusの定義更新では，仮想ホスト上のCosminexusの定義を，ISCMに登録されたCosminexusの定義で上書きします。

直接仮想ホスト上で加えたCosminexusの定義変更を引き継ぎたい場合は，マスターイメージ更新コマンド（csdmiupdate）実行前に定義のバックアップを取得し，定義更新完了後に取得したバックアップを使って定義を元に戻してください。

ただし，業務アプリケーション，および，リソースアダプタについては，ISCMが次のディレクトリにバックアップを取得しています。

業務アプリケーション：表F-1の※1を参照してください

リソースアダプタ：表F-2の※1を参照してください

Cosminexusのティア構成がhttp-tier + j2ee-tier構成の場合，http-tierに該当する仮想ホストでは，業務アプリケーション，リソースアダプタのバックアップおよびリストアを行いません。

Cosminexusを使用する仮想ホストに対してcsdmideployコマンドまたはcsdmiupdateコマンドを実行する場合，業務アプリケーション，Management Serverおよび運用管理エージェントを停止しておく必要があります。

付録F.4　Cosminexusの定義ファイル作成に関する注意事項

Cosminexusの定義ファイル作成に関して，次の注意事項があります。

J2EEサーバ名(DefModel.xmlのlogical-server-nameタグに指定する値)は省略しないでください。

次に示すパラメータは指定を省略してください。

mserver.propertiesのwebserver.connector.http.bind_host

DefModel.xmlのvbroker.se.iiop_tp.host

付録G　設計書によるマスターイメージの登録・更新機能使用時の注意事項

設計書によるマスターイメージ登録・更新機能を使用する場合，次に示す注意事項があります。

付録G.1　運用上の注意事項

設計書を使用してマスターイメージの登録・更新を行う場合は，ミドルウェアとOSのパッチは使用できません。

設計書を使用してマスターイメージの登録・更新を行う場合は，OS設定用テンプレートファイルおよびOS設定用パラメータファイルを用いたOSパラメータの設定を行うことができません。

OSパラメータを設定したい場合は，コンポーネントテンプレートにダミーのミドルウェアを定義し，ミドルウェアの定義パラメータとしてOSパラメータを指定してください。ただし，OSパラメータの設定はミドルセットアップのタイミングで実施します。

指定方法を次に示します。

次のようにコンポーネントテンプレートを作成する。

・ダミーのミドルウェア(ミドルウェア識別子”optional.OS”など)を追加する。

・OS設定用テンプレートファイルおよびOS設定用パラメータファイルを格納したディレクトリをミドルウェア定義格納ディレクトリに指定する。

・OS設定ファイルを適切な場所に配置するためのスクリプトをミドルウェアのセットアップスクリプトに指定する。

次のように設計書を作成する。

・パラメータ定義シートの設定対象識別子に，コンポーネントテンプレートに指定したミドルウェア識別子を指定する。

・パラメータ定義シートのパラメータと設定値情報表に，OSパラメータを定義する。

設計書を使用して構築したマスターイメージに対してcsdmiexportコマンドを実行して取得したマスターイメージ定義ファイルは，マスターイメージの登録・更新には使用できません。設計書を用いた運用としてください。

付録H　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

付録H.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

Hitachi IT System Configuration Manager リファレンス（3021-3-472）

Hitachi IT System Configuration Manager メッセージ（3021-3-473）

JP1 Version 9 JP1/IT Resource Management - Manager 設計・構築ガイド（3020-3-S41）

JP1 Version 9 JP1/IT Resource Management - Manager 運用ガイド（3020-3-S42）

JP1 Version 9 JP1/IT Resource Management - Manager リファレンス（3020-3-S43）

JP1 Version 10 JP1/Automatic Operation 運用ガイド（3021-3-083）

JP1 Version 10 JP1/IT Resource Management - Manager 設計・構築ガイド（3021-3-231）

JP1 Version 10 JP1/IT Resource Management - Manager 運用ガイド（3021-3-232）

JP1 Version 10 JP1/IT Resource Management - Manager リファレンス（3021-3-233）

JP1 Version 10 JP1/Performance Management 運用ガイド（3021-3-042）

JP1 Version 10 JP1/Performance Management - Remote Monitor for Platform（3021-3-047）

Cosminexus V9 アプリケーションサーバ リファレンス コマンド編 （3020-3-Y15）

Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)（3020-3-Y16）

なお，このマニュアルでは，バージョン番号を省略して表記しています。マニュアルの正式名称とこのマニュアルでの表記を次の表に示します。

このマニュアルでの表記

正式名称

JP1/IT Resource Management - Manager 設計・構築ガイド

JP1 Version 9 JP1/IT Resource Management - Manager 設計・構築ガイド

JP1 Version 10 JP1/IT Resource Management - Manager 設計・構築ガイド

JP1/IT Resource Management - Manager 運用ガイド

JP1 Version 9 JP1/IT Resource Management - Manager 運用ガイド

JP1 Version 10 JP1/IT Resource Management - Manager 運用ガイド

JP1/IT Resource Management - Manager リファレンス

JP1 Version 9 JP1/IT Resource Management - Manager リファレンス

JP1 Version 10 JP1/IT Resource Management - Manager リファレンス

JP1/Automatic Operation 運用ガイド

JP1 Version 10 JP1/Automatic Operation 運用ガイド

JP1/Performance Management 運用ガイド

JP1 Version 10 JP1/Performance Management 運用ガイド

JP1/Performance Management - Remote Monitor for Platform

JP1 Version 10 JP1/Performance Management - Remote Monitor for Platform

Cosminexus アプリケーションサーバ リファレンス コマンド編

Cosminexus V9 アプリケーションサーバ リファレンス コマンド編

Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)

Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)

付録H.2　このマニュアルでの表記

このマニュアルでは，製品名を次のように表記しています。

表記

製品名

Cosminexus

uCosminexus Application Server

HiRDB

HiRDB Server Version 9

HDvM

Hitachi Device Manager

HVM

Hitachi Virtualization Manager

ISCM

Hitachi IT System Configuration Manager

JP1/AO

JP1/Automatic Operation

JP1/PFM

JP1/Performance Management

JP1/IM

JP1/Integrated Management

JP1/ITRM

JP1/IT Resource Management - Manager

JP1/SC/DPM

JP1/ServerConductor/Deployment Manager

uCSD

uCosminexus Service Director

※ISCMはuCSDの後継製品です。

vCenter

VMware(R) vCenter Server

VMware

ESX

VMware(R) ESX

VMware(R) vSphere ESXi

付録H.3　英略語

このマニュアルで使用する英略語を次に示します。

英略語

英字での表記

AP

Application Program

ASCII

American Standard Code for Information Interchange

CD-ROM

Compact Disc - Read Only Memory

CPU

Central Processing Unit

CSV

Comma Separated Value

DB

Database

FC-HBA

Fibre Channel - Host Bus Adapter

GMT

Greenwich Mean Time

GUI

Graphic User Interface

HTTP

Hyper Text Transfer Protocol

ID

Identifier

IP

Internet Protocol

IPv4

Internet Protocol version 4

J2EE

Java 2 Enterprise Edition

LAN

Local Area Network

LB

Load Balancer

NIC

Network Interface Card

OS

Operating System

PaaS

Platform as a Service

PCI

Peripheral Components Interconnect

PP

Program Product

SSH

Secure Shell

UNC

Universal Naming Convention

UOC

User Own Coding

URL

Uniform Resource Location

UTF-8

8-bit UCS Transfer Protocol

VLAN

Virtual LAN

VM

Virtual Machine

XML

Extensible Markup Language

付録H.4　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録I　用語解説

（英字）

PaaS提供者

PaaS環境構築者のことです。必要なリソースをそろえ，PaaS環境を構成するミドルウェアを決定します。PaaS利用者に対して，安定したPaaS環境を提供する責任があります。

PaaS利用者

業務システム構築担当者および責任者のことです。PaaS提供者から提供されるテンプレートを基に業務システムを構築し，テスト工程を経て，本番環境にリリースします。業務システムの運用も担当します。

UOC

ISCMで構築するシステムのサイジングルールまたはミドルセットアップ処理を，ユーザ自身がJavaで実装することができます。その実装クラスを格納したjar形式のファイル，およびその機能の総称のことをいいます。

（カ行）

仮想イメージテンプレート

JP1/ITRMが管理するテンプレートのことです。仮想ホストのデプロイ元になるデータであり，ライブラリで管理されます。

仮想サーバマネージャ

uCosminexus Application Serverが提供する仮想サーバマネージャのことです。

（サ行）

サイジング

業務用件に基づき，仮想ホスト数，メモリ所要量，CPUスペックとコア数，OSおよびミドルウェア定義を決定する処理のことです。

スナップショット

マスターイメージをエクスポートしたファイルのことです。PaaS利用者はこのファイルを再利用およびカスタマイズして，マスターイメージを作成できます。

設計書

テンプレートの組み合わせ，使用するUOCの情報，IPアドレスなど，マスターイメージ構築に使う情報，およびネットワーク情報を定義するファイルです。

（タ行）

デプロイ

JP1/ITRMで，仮想化ソフトウェア上に仮想ホストを構築する操作のことです。また，ISCMでは，PaaS環境の構築を実現するためにOSとミドルウェアの定義配布およびセットアップ処理までを含めます。

テンプレート

仮想ホスト構成情報，ミドルウェア構成およびUOCを持つファイル一式のことです。PaaS提供者が作成して，PaaS利用者に提供します。ISCMがサンプルとしても提供します。

（マ行）

マスターイメージ

PaaS利用者が，テンプレートを基に業務システム固有情報を付けて作成した業務システム情報一式のことです。ISCMの構成管理で管理されていて，スナップショットをISCMにインポートして作成できます。また，PaaS利用者は，マスターイメージに付けた業務システム名称を指定して，デプロイ指示を行います。

索引

記号

［サービス実行］ダイアログボックス[1]

［サービス設定］ダイアログボックス[1]

［実行結果ダウンロード］ファイルフォーマット[1]

［詳細情報ダウンロード］ファイルフォーマット[1]

［タスク詳細］ダイアログボックス[1]

C

csd_receive_timeout設定値の算出[1]

csd_receive_timeout設定値の算出手順[1]

D

DBテーブルの作成[1]

H

http-tier+j2ee-tier構成時の修正方法[1]

I

ISCM

アンインストール[1]

アンセットアップ[1]

インストール[1]

サービス開始[1]

サービス停止[1]

システム資源の管理[1]

セットアップ[1]

トラブルシュート[1]

ISCMインストール・セットアップ

ハイパーバイザ種別がHVMの場合[1]

ISCMがサポートするティア構成[1]

ISCMサーバ定義[1]

ISCMのアンセットアップ[1]

ISCMのサービス実行ユーザ設定[1]

ISCMのセットアップ[1]

ISCMの停止[1]

ISCMのデータベースに登録可能なパラメータ最大数と定義との対応[1]

J

JP1/AOとの連携[1]

JP1/AOとの連携における障害の対処[1]

JP1/PFM，JP1/IMとの連携に必要な設定[1]

JP1/PFM - RM for Platformのインスタンス作成[1]

JP1/PFM連携機能

構成図[1]

P

PaaS環境

運用[1]

構築[1]

PaaS提供者[1]、[2]

PaaS提供者〔用語解説〕[1]

PaaS利用者[1]、[2]

PaaS利用者〔用語解説〕[1]

U

UOC実装クラス

コンパイル[1]

作成[1]

登録[1]

例[1]

UOCの作成手順[1]

UOC〔用語解説〕[1]

W

WMIと管理共有の設定[1]

あ

アカウント情報の登録[1]

アクター[1]

アンインストール[1]

い

インストール[1]

か

カーネルパラメータ[1]

仮想イメージテンプレートの作成[1]

仮想イメージテンプレート〔用語解説〕[1]

仮想サーバマネージャ〔用語解説〕[1]

仮想ホストデプロイ無しの場合の修正方法[1]

仮想ホストデプロイを行わない場合のPaaS環境の構築[1]

画面詳細[1]

環境構築

ハイパーバイザ種別がHVMの場合[1]

ハイパーバイザ種別がVMwareの場合[1]

き

機器構成[1]

機能概要[1]

業務アプリケーションの稼働[1]

業務アプリケーションの用意[1]

業務グループによるアクセスコントロール機能の有効化[1]

業務システム

アンデプロイ完了の確認〔VMware〕[1]

アンデプロイ〔VMware〕[1]

仮想ホスト配置算出〔HVM〕[1]

仮想ホスト配置算出〔VMware〕[1]

管理[1]

構築[1]

構築完了の確認〔HVM〕[1]

構築完了の確認〔VMware〕[1]

構築〔HVM〕[1]

構築〔VMware〕[1]

削除〔VMware〕[1]

マスターイメージの削除〔VMware〕[1]

マスターイメージの登録・サイジング〔HVM〕[1]

マスターイメージの登録・サイジング〔VMware〕[1]

リソース予約解除〔VMware〕[1]

リソース予約〔HVM〕[1]

リソース予約〔VMware〕[1]

業務システムでCosminexusを使用する場合の注意事項[1]

業務システムの検証[1]

業務システムの利用[1]

こ

コマンド実行時間[1]

コンポーネントテンプレート（AppServerティア）

Cosminexusの定義ファイルの作成[1]

仮想イメージテンプレートの作成（Linux）[1]、[2]

仮想イメージテンプレートの作成（Windows）[1]、[2]

作成[1]

登録[1]、[2]、[3]

コンポーネントテンプレート（Dbティア）

HiRDB定義ファイル・セットアップスクリプトの作成[1]、[2]

仮想イメージテンプレートの作成（Linux）[1]、[2]

仮想イメージテンプレートの作成（Windows）[1]、[2]

登録[1]、[2]

コンポーネントテンプレート（Dbティア）の登録

コンポーネントテンプレートの登録[1]、[2]

コンポーネントテンプレートファイルの作成[1]、[2]

コンポーネントテンプレートの設定[1]

さ

サービステンプレート一覧[1]

サイジング〔用語解説〕[1]

サイジングUOC[1]

作業手順[1]

作業範囲[1]

し

システム定義[1]

システム定義ファイル[1]

障害発生時の対処[1]

す

スナップショット作成[1]

スナップショット〔用語解説〕[1]

せ

設計書によるマスターイメージの登録・更新[1]

設計書によるマスターイメージの登録・更新機能使用時の注意事項[1]

設計書〔用語解説〕[1]

設定

アクセス許可[1]

環境変数[1]

セットアップ定義ファイル[1]

前提作業[1]

前提条件[1]

前提製品

ハイパーバイザ種別がHVMの場合[1]

ハイパーバイザ種別がVMwareの場合[1]

そ

測定環境[1]

ソフトウェア構成[1]

つ

通常フォーマット[1]

て

定義ファイルの作成[1]

提供インタフェース[1]

デプロイ〔用語解説〕[1]

テンプレート管理[1]

テンプレート登録[1]

テンプレートの削除[1]

テンプレート表示フォーマット[1]

テンプレート〔用語解説〕[1]

と

導入手順[1]

トラブルシュート[1]

は

ハイパーバイザ種別がHVMの場合

HDvM[1]

HVM[1]

ISCM稼働のための定義[1]、[2]

ISCM起動[1]

JP1/ITRM[1]

JP1/SC/DPM[1]

OS[1]

PaaS環境の停止[1]

PaaS環境を準備[1]

PaaS利用者のための設定[1]

PaaS利用者の登録[1]

アカウントの通知[1]

インストール[1]

概要[1]

仮想サーバマネージャ[1]

業務システムの構築[1]

業務システムの削除[1]

構成パターンテンプレートの登録[1]

コンポーネントテンプレート（AppServerティア）の登録[1]

コンポーネントテンプレート（Dbティア）の登録[1]

サンプルサイジングUOC概説[1]

セットアップ[1]

前提製品の準備[1]

テンプレートの公開[1]

ハイパーバイザ種別がVMwareの場合

ISCMインストール・セットアップ[1]

ISCM起動[1]

JP1/ITRM[1]

OS[1]

PaaS環境の停止[1]

PaaS環境を準備[1]

PaaS利用者のための設定[1]

PaaS利用者の登録[1]

vCenter・ESX[1]

アカウントの通知[1]

インストール[1]

概要[1]

仮想サーバマネージャ[1]

業務システムの構築[1]

業務システムの削除[1]

構成パターンテンプレートの登録[1]

コンポーネントテンプレート（AppServerティア）の登録[1]

コンポーネントテンプレート（Dbティア）の登録[1]

サンプルサイジングUOC概説[1]

セットアップ[1]

前提製品の準備[1]

テンプレートの公開[1]

パラメータ

マスターイメージの登録・更新[1]

リソース情報（IPアドレス）の登録・更新[1]

リソース情報（物理ホスト）の登録・更新[1]

パラメータ数の見積もり[1]

ひ

日立総合インストーラ[1]

ふ

負荷分散機に設定する情報と確認方法[1]

物理リソース情報出力フォーマット[1]、[2]

ま

マスターイメージ管理[1]

マスターイメージ登録[1]

マスターイメージの削除[1]

マスターイメージの登録・更新コマンド[1]

マスターイメージ表示フォーマット[1]

マスターイメージ〔用語解説〕[1]

み

ミドルウェアのセットアップ手順[1]

ミドルセットアップUOC[1]、[2]

JP1/IM監視設定[1]

JP1/PFM監視設定[1]

概要[1]

環境構築[1]

機能概要[1]

実行タイミング[1]

前提条件[1]

ミドルセットアップUOCのカスタマイズ[1]

ミドルセットアップUOCのコンパイル[1]

ミドルセットアップUOCの状態[1]

ゆ

ユーザ登録[1]

り

リソース情報の登録・更新コマンド[1]