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

<この項の構成>
(1) 形式
(2) ファイル名
(3) 格納先ディレクトリ
(4) 説明
(5) 指定項目
(6) 記述例

(1) 形式

マスターイメージ定義ファイルはXML形式で記述します。

サポートするXMLファイルの文字コードはUTF-8とします。XMLファイルにはXML宣言を記述し,XML宣言におけるencodingの値にUTF-8を指定してください。

タグは,「表2-20 マスターイメージ定義ファイルのXML文法」の順番に従って記述してください。従わない場合,エラーとなることがあります。

(2) ファイル名

マスターイメージ定義ファイルのファイル名は任意です。

(3) 格納先ディレクトリ

マスターイメージ定義ファイルの格納先は任意です。

(4) 説明

マスターイメージ定義ファイルは,テンプレートの組み合わせや使用するUOCの情報など,マスターイメージ構築で使用する情報を定義するファイルです。マスターイメージ登録を行うcsdmiregisterコマンドと,マスターイメージ更新を行うcsdmiupdateコマンドで利用します。

(5) 指定項目

次にマスターイメージ定義ファイルで定義する項目を示します。

表2-18 マスターイメージ定義ファイルの定義項目

項番項目
1マスターイメージ名,セクション,バージョン
2マスターイメージの説明
3構成パターンテンプレートとコンポーネントテンプレートの組み合わせ
4サイジングUOC
5ミドルウェアの固定パラメータ情報
6OS設定ファイルの固定パラメータ情報
7パッチ情報

表2-19 マスターイメージ定義ファイルのパラメータと指定方式

項番項目形式説明
1マスターイメージ名英数字記号
1~32文字
マスターイメージ名を指定します。
2セクション英数字記号
1~32文字
セクションを指定します。
セクションとはマスターイメージ名の付加的な名称です。例えば,あるマスターイメージを2つの異なる物理配置に構築する場合に,マスターイメージ名が同じでも異なるセクションを設定すれば,2つの異なるマスターイメージとして登録することができます。
なお,uCSDでは,マスターイメージをマスターイメージ名+セクションの組み合わせで区別します。
注 セクション省略を含む
3バージョンVV-RR
V:数字
R:数字
マスターイメージのバージョンを指定します。
4マスターイメージの説明文字列(日本語可)
1~255文字
マスターイメージの説明(コメント)を記述します。
5構成パターンテンプレート名英数字記号
1~32文字
マスターイメージのひな形として使う構成パターンテンプレート名を指定します。
6UOCクラス名英数字,ピリオド(.),ドル記号($)およびアンダースコア(_)
注 ただし,パッケージ名およびクラス名の先頭は英数字1~1024文字
UOCのクラス名(パッケージ名を含む)を指定します。
7jarファイル名相対パス名。ただし,半角空白は指定できません。
1~160文字
UOCで使用するjarファイルを指定します。
csdmiregisterコマンドまたはcsdmiupdateコマンドの-dオプションで指定するディレクトリに配置します。
8UOCパラメータ名英数字記号
1~32文字
UOCの入力パラメータの名称を指定します。
9UOCパラメータ値文字列(日本語可)1~1024文字UOCの入力パラメータの名称に対応する値を指定します。
10コンポーネントID1~65535の整数構成パターンテンプレートのコンポーネントIDを指定します。
構成パターンテンプレートに存在するすべてのコンポーネントIDに対応するComponent要素を記述します。
11コンポーネントテンプレート名英数字記号
1~32文字
コンポーネントIDに当てはめるコンポーネントテンプレートを指定します。
12ミドルウェア識別子CosminexusまたはHiRDBの場合,次の値です。
hitachi.Cosminexushitachi.HiRDBその他の場合,次の形式で指定する(optional.を含めて10~32文字の文字列)
optional.任意の製品名任意の製品名:英数字と_.#-@()から成る文字列
コンポーネントテンプレートのミドルウェアの識別子(hitachi.Cosminexusなど)を指定します。
13パラメータ名CsdU_A...A
CsdU_:固定文字列
A...A: 英数字と_-
1~25文字
コンポーネントテンプレートに登録された定義情報/OS設定ファイル情報の中で,固定化したいパラメータ名を指定します。
パラメータ名とは,ミドルウェア定義用・OS設定用テンプレートファイル,ミドルウェア定義用・OS設定用パラメータファイルで使用する可変部名称のことです。
14パラメータ値文字列(日本語可)
1~1024文字
固定したいパラメータ名に対応する値を指定します。
15パッチ名相対パス名。ただし,半角空白は指定できません。
1~247文字
パッチ・ディレクトリからの相対パスでパッチスクリプトを指定します。
マスターイメージまたはVM単位で異なる可能性のあるものはコンポーネントテンプレートのミドルセットアップスクリプトではなくこちらに記載してください。
16パッチ・ディレクトリ絶対パス名。ただし,半角空白は指定できません。
定義に指定したパッチ・ディレクトリのパス長と,ディレクトリ内に格納したファイルのパス(パッチ・ディレクトリからの相対パス)の最大長を足した値が247文字以内に収まる長さ。
パッチ・ディレクトリのパス。絶対パスを指定します。
パッチ・ディレクトリはuCSDで管理しない(uCSDには取り込まれない)ため,PaaS提供者,またはPaaS利用者が適切に管理してください。
17適用順序1~65535の整数パッチの適用順序を指定します。
適用順序はマスターイメージの一連のライフサイクル(登録・更新~削除まで)の中で,OSごとまたはミドルごとにユニークな番号とします。適用順序に65535を割り当てた場合,それ以降はパッチの追加ができなくなるので,小さい番号から順番に指定します。
なお,デプロイ後のマスターイメージにcsdmiupdateコマンドでパッチを追加する場合は,すでに指定した番号よりも大きい番号を指定します。
OS内またはミドル内での適用順序を指定するものであり,OS間またはミドル間の適用順序については,「表1-13 アップデート処理でのOS更新・ミドルウェア更新処理」「表1-36 デプロイ処理の流れ」を参照してください。
18VLAN ID0~4095の整数業務LANで使用するVLAN IDを指定します。
リソース制約定義ファイルを使用している場合,利用者条件リソース制約定義ファイルの範囲内の値だけ指定できます。
範囲外を指定した場合はマスターイメージの登録が失敗します(KFUD23114-E)。
VLAN IDを指定しないで,かつリソース定義ファイルも指定しない場合は,次の値が仮定されます。
リソース制約定義ファイルを使用している場合:
リソース制約定義ファイルで指定された値のうち最小値
リソース制約定義ファイルを使用していない場合:
VLAN IDは0(VLAN使用無し)とする

表2-20 マスターイメージ定義ファイルのXML文法

項番タグ名属性出現回数説明
1MasterImage1
2xmlns1"http://www.hitachi.co.jp/soft/xml/csd/service/masterimage_define"を指定してください。
3name1マスターイメージ名を指定します。
4section0-1マスターイメージのセクションを指定します。
マスターイメージ名+セクションの組み合わせは,他マスターイメージと重複できません。
5version1マスターイメージのバージョンを指定します。
6 Description0-1テキストノードにマスターイメージの説明を指定します。
7PatternTemplate1テキストノードに構成パターンテンプレート名を指定します。
表2-13の項番6で設定した値と同じ値を設定してください。
8Parameter(uoc.UOC種別)0-1
9type1uoc.sizingを指定します。
サイジングUOCであることを表します。
10 Property1
11key1UOCクラス名 を指定します。
12value1jarファイル名 を指定します。
csdmiregisterまたはcsdmiupdate(-d)コマンドで指定するディレクトリからの相対パスを指定します。
13 Value0-20複数指定する場合には,親要素Property内でkeyの値が重複してはいけません。
14key1UOCへの入力パラメータのキーを指定します。
15value1キーに対応する,入力パラメータの値を指定します。
16Component1-20
17id1構成パターンテンプレート内でこのコンポーネントを指すAbstractSystemのovf:idの値(コンポーネントID)を指定します。親要素内で重複してはいけません。
表2-13の項番30で設定した値と同じ値を設定してください。
18template1コンポーネントテンプレート名を指定します。
表2-16の項番8で設定した値と同じ値を設定してください。
19Vlan0-1
20businessId1業務LANで使用するVLAN IDを指定します。
21 Middleware0-5ミドルウェアの情報を設定します。
親要素Component内でidの値が重複してはいけません。
22id1コンポーネントテンプレート内でこのミドルウェアを指すProductSectionのovf:classから”pp.”を取り除いた値を指定します。(例:hitachi.HiRDB)
表2-16の項番34で設定した値と同じ値を設定してください。
23 Parameter(fixed)0-1ミドルウェア定義情報を設定します。
24type1fixedを指定します。
定義の固定化パラメータの情報であることを表します。
25 Property1-100固定化パラメータ情報を設定します。複数指定する場合には,親要素Parameter内でkeyの値が重複してはいけません。
26key1固定化パラメータ名を指定します。
27value1固定パラメータ名に対応した値を指定します。
28Parameter(patch)0-1ミドルウェアのパッチ情報を設定します。
29type1patchを指定します。
パッチの情報であることを表します。
30 Property1-120パッチの情報を設定します。
複数指定する場合には,親要素Parameter内でkeyおよびorderの値が重複してはいけません。
31key1パッチ名を指定します。
32value1パッチ・ディレクトリを指定します。
33order1パッチ適用順序を指定します。
34Parameter(fixed)0-1OS設定ファイル情報を指定します。
35type1fixedを指定します。
固定化パラメータの情報であることを表します。
36 Property1-10固定化パラメータ情報を設定します。複数指定する場合には,親要素Parameter内でkeyの値が重複してはいけません。
37key1固定化パラメータ名を指定します。
38value1固定パラメータ名に対応した値を指定します。
39Parameter(patch)0-1OSのパッチ情報を指定します。
40type1patchを指定します。
パッチの情報であることを表します。
41 Property1-120パッチの情報を設定します。複数指定する場合には,親要素Parameter内でkeyおよびorderの値が重複してはいけません。
42key1パッチ名を指定します。
43value1パッチ・ディレクトリを指定します。
44order1パッチ適用順序を指定します。

(6) 記述例

次にマスターイメージ定義ファイルの記述例を示します。

マスターイメージ定義ファイルの記述例

<?xml version="1.0" encoding="UTF-8"?>
<MasterImage
xmlns="http://www.hitachi.co.jp/soft/xml/csd/service/masterimage_define"
name="WEBDBsystem" section="kaihatsu" version="01-01">
 <Description>Sample web db system</Description>
 <PatternTemplate>webdbpattern</PatternTemplate>

 <Parameter type="uoc.sizing">
   <!-- sizing uoc -->
   <Property key="com.sample.WebDbSizing" value="sizing.jar">
     <!-- input parameters -->
     <Value key="pattern" value="webdb1"/>
     <Value key="dbdisksize" value="60"/>
   </Property>
 </Parameter>

 <Component id="1" template="webtemplate1">
   <Middleware id="hitachi.Cosminexus">
     <Parameter type="fixed">
       <!-- fixed parameters(middleware) -->
       <Property key="CsdU_xxxxx" value="1"/>
       <Property key="CsdU_yyyyy" value="no"/>
     </Parameter>
     <Parameter type="patch">
       <!--  M/W patch -->
       <Property key="patch1.sh" value="e:¥patch¥db¥cosmi¥patch1"
                  order="1"/>
     </Parameter>
   </Middleware>
   <Parameter type="fixed">
     <!-- fixed parameters(os files) -->
     <Property key="CsdU_zzzz" value="100"/>
   </Parameter>
   <Parameter type="patch">
     <!-- OS patch -->
     <Property key="fix1.sh" value="e:¥patch¥db¥fix1" order="1"/>
     <Property key="fix2.sh" value="e:¥patch¥db¥fix2" order="2"/>    
   </Parameter>
 </Component>

 <Component id="2" template="dbtemplate3">
   <Middleware id="hitachi.HiRDB">
     <Parameter type="fixed">
       <!-- fixed parameters(middleware) -->
       <Property key="CsdU_bbbbb" value="3"/>
     </Parameter>
   </Middleware>
 </Component>

 <Vlan businessId="10" />

</MasterImage>