10.4 esmkunit

名前

esmkunit －ユニットの作成

形式

esmkunit [-uf unitfile] [-w] [-M system]

機能説明

不揮発チャネル運用時のユニットを作成します。ユニットは、ユニット定義ファイルの内容に従って作成されます。
指定できるオプションとパラメタを以下に示します。

-uf unitfile: ユニット定義ファイルunitfileを指定します。ユニット定義ファイルの記述形式および各項目の設定内容については、“ユニット定義ファイルの記述形式”を参照してください。

-w: クラスタサービス機能の運用で待機系サーバのセットアップを行う場合に指定します。

-M system:   拡張システムを生成した場合に、運用の対象となるシステム名systemを指定します。本オプションを省略すると、デフォルトシステムでの運用が対象となります。
  本オプションは、以下の製品で指定可能です。
  －  Interstage Application Server Enterprise Edition
  －  Interstage Business Application Server

ユニット定義ファイルの記述形式

ユニット定義ファイル（def拡張子を持つファイル）の記述形式および各項目の設定内容を示します。

ユニット定義ファイルの雛型ファイル（esunit01.def）について
  雛形ファイルは、以下に格納されています。必要に応じて編集して使用してください。

  C:\Interstage\eswin\etc\def\esunit01.def

  /opt/FJSVes/etc/def/esunit01.def
-ufオプションを省略した場合
上記の雛型ファイルが格納されているディレクトリ配下のユニット定義ファイル（def拡張子を持つファイル）を使用してユニットを作成します。なお、ユニット定義ファイルが複数存在する場合は、すべてのファイルに対してユニットを作成します。

[記述形式]

unitid      = unit01
unitmode    = std
trandir     = D:\NOTIFY_DIR
tranmax     = 1024
sysdir      = D:\NOTIFY_DIR
syssize     = 10
sysqnum     = 100
syswarning  = 70 - 90
userdir     = D:\NOTIFY_DIR
usersize    = 30
userqnum    = 50
userwarning = 70 - 90
shmmax      = 80

[記述形式]

unitid      = unit01
unitmode    = std
trandir     = /NOTIFY_DIR
tranmax     = 100
tranunitmax  = 1024
sysdir      = /NOTIFY_DIR
syssize     = 10
sysqnum     = 100
syswarning  = 70 - 90
userdir     = /NOTIFY_DIR
usersize    = 30
userqnum    = 50
userwarning = 70 - 90
shmmax      = 80

[設定項目]

項目	内容	省略値	指定範囲
unitid	ユニット名(英数字のみ、大文字／小文字の区別なし)	省略不可	6バイト以内の文字列
unitmode	ユニットのモード std：標準ユニット ext：拡張ユニット	std	std, ext
trandir	トランザクション用ファイルを格納するディレクトリとして、NTFSファイルシステム上のディレクトリを指定します。トランザクション用ファイルを格納するディレクトリとして、通常ファイルシステム上のディレクトリ、またはローデバイスを指定します(処理の高速化のためにローデバイスを指定することを推奨)。注1）以下のサイズの容量が必要となります。 ((tranmax×4)＋256＋(tranunitmax×2))×16(Kバイト) 注2）ローデバイスを指定する場合は、パーティションのサイズが2ギガバイト以内のローデバイスをあらかじめ作成しておく必要があります。注3）複数ユニットのファイルを混在できません。ユニットを複数生成する場合は、異なる格納ディレクトリを指定してください。注4）絶対パスで指定してください。環境変数を使用したパスは指定できません。注5）クラスタ運用時はローデバイスではなく、sysdirおよびuserdirと同じ共用ディスク上の格納ディレクトリを指定してください。	省略不可	240バイト以内の文字列
tranmax	トランザクションの多重度ユニット内のイベントチャネルに対して、同時にトランザクション運用を行う多重度を指定します。	1024 100	1～1024
tranunitmax	1トランザクション内で操作することができる最大メッセージサイズをブロック数で指定します(1ブロック:16Kバイト(固定))。例）1024と指定すると、1024×16Kバイト=16Mバイト	1024	1～4096
sysdir	システム用(ユニット制御用)ファイルを格納するディレクトリ(Windows(R)システムでは、NTFSファイルシステム上のディレクトリを指定)。注1）複数ユニットのファイルを混在できません。ユニットを複数生成する場合は、異なる格納ディレクトリを指定してください。注2）絶対パスで指定してください。環境変数を使用したパスは指定できません。	省略不可	240バイト以内の文字列
syssize	システム用(ユニット制御用)ファイルの容量以下の計算式を参考にして見積もってください。「固定領域＋チャネル使用領域＋proxy使用領域＋インデックス用領域」固定領域：32K チャネル使用領域：(n:不揮発チャネル数) (16K＋(2K×(n－1)))×1.5 proxy使用領域： ((コンシューマ数＋サプライヤ数)／32＋1)×16K×1.5 インデックス用領域： (5＋(最大蓄積メッセージ件数／340)＋2)×2×16K	10	1～2047(メガバイト)
sysqnum	システム用(ユニット制御用)データ格納域（キュー）の数注）以下の値が必要となります。不揮発チャネル数×2＋2以上	100	4～32768
syswarning	システム用(ユニット制御用)ファイルの容量に対する安全値と警告値(安全値と警告値は、ハイフン“-”で区切る) 安全値：警告状態が解除される基準値警告値：データ格納域が警告状態となる基準値注）メッセージ格納域の使用率が一定値以上になった場合、メッセージ格納域の状態は警告状態となります(警告メッセージes20003)。その後、メッセージ格納域の使用率が低下し、一定値以下となった場合、メッセージ格納域の警告状態は解除されます(通知メッセージes20004)。	安全値：70 警告値：90	安全値：1～99(%) 警告値：2～100(%) (警告値＞安全値)
userdir	イベントデータ用ファイルを格納するディレクトリ(Windows(R)システムでは、NTFSファイルシステム上のディレクトリを指定)。注1）複数ユニットのファイルを混在できません。ユニットを複数生成する場合は、異なる格納ディレクトリを指定してください。注2）絶対パスで指定してください。環境変数を使用したパスは指定できません。	省略不可	240バイト以内の文字列
usersize	イベントデータ用ファイルの容量メッセージ使用領域により、以下の計算式を参考にして見積もってください。イベントサービスメッセージ使用領域の平均が512バイト以下の場合 (最大蓄積メッセージ件数／32＋1)×16K×1.5＋16K メッセージ使用領域の平均が1Kバイト以下の場合 (最大蓄積メッセージ件数／16＋1)×16K×1.5＋16K メッセージ使用領域の平均が2Kバイト以下の場合 (最大蓄積メッセージ件数／8＋1)×16K×1.5＋16K 平均が2Kバイトを超える場合 ((最大蓄積メッセージ件数／8＋1)×16K＋(メッセージ長－2K)×最大蓄積メッセージ件数)×1.5＋16K JMS（メッセージセレクタ機能使用時）メッセージ使用領域の平均が200バイト以下の場合最大蓄積メッセージ件数×16K×1.5＋16K メッセージ使用領域の平均が200バイトを超える場合最大蓄積メッセージ件数×16K×((メッセージ長－2K＋16K)/16K＋1)×1.5＋16K JMS（メッセージセレクタ機能未使用時）メッセージ使用領域の平均が200バイト以下の場合 (最大蓄積メッセージ件数／8＋1)×16K×1.5＋16K メッセージ使用領域の平均が200バイトを超える場合 ((最大蓄積メッセージ件数／8＋1)×16K＋(メッセージ長－2K)×最大蓄積メッセージ件数)×1.5＋16K	30	1～2047(メガバイト)
userqnum	イベントデータ用データ格納域(キュー)の数注）接続情報だけ不揮発チャネル運用を行う場合、イベントデータ用データ格納域は不要です。接続情報およびイベントデータの不揮発チャネル運用を行う場合は、不揮発チャネル数分の値を指定する必要があります。	50	0～32768
userwarning	イベントデータ用ファイルの容量に対する安全値と警告値(安全値と警告値は、ハイフン“-”で区切る) 安全値：警告状態が解除される基準値警告値：データ格納域が警告状態となる基準値注）メッセージ格納域の使用率が一定値以上になった場合、メッセージ格納域の状態は警告状態となります(警告メッセージes20003)。その後、メッセージ格納域の使用率が低下し、一定値以下となった場合、メッセージ格納域の警告状態は解除されます(通知メッセージes20004)。	安全値：70 警告値：90	安全値：1～99(%) 警告値：2～100(%) (警告値＞安全値)
shmmax	ユニットで使用する共用メモリサイズ (アプリケーションが1トランザクションで扱うメッセージ長の最大値)×(同一ユニットを使用するチャネル数)×2	80	1～1024(メガバイト)

注意事項

本コマンドは、管理者権限で実行してください。
標準ユニットは、1つのシステムで1つだけ作成可能です。
ユニット定義ファイルで指定する格納ディレクトリ（trandir、sysdir、userdir）に以下の使用禁止文字を含めて設定した場合、Interstage管理コンソールを使用してユニットの一覧を表示すると、エラーメッセージ“es39996”または“es39999”が出力され操作することができません。Interstage管理コンソールを使用する場合は、格納ディレクトリには、以下の使用禁止文字を含めないでください。
- アンパーサンド(&)
- 小なり(<)
ユニット作成後は、ユニット定義ファイルで指定した格納ディレクトリ（trandir、sysdir、userdir）配下の資源を更新しないでください。

ローデバイスの作成手順

■RHEL-AS4の場合

オペレーティングシステムのpartedコマンド／fdiskコマンドで、ローデバイスのパーティションを作成します。
partedコマンドを使用した実行例を以下に示します。

# parted /dev/sda
(parted) p
/dev/sdaの Disk geometry: 0.000-34732.890 メガバイト
ディスクラベルの種類: gpt
マイナー 開始        終了    ファイルシステム 名前                  フラグ
1          0.017   2048.002  linux-swap
2       2048.002  12048.002  ext3
3      12048.002  13072.000
(parted) q
# udevinfo -q path -n /dev/sda3
/block/sdb/sda3
# udevinfo -q symlink -p /block/sdb/sda3
disk/by-path/pci-0000:20:01.0-scsi-0:0:1:0p3 disk/by-id/SHP_36.4GST336753LC_3HX2BF0R000074446H48p3

rawコマンドを使用して、作成したパーティションのバインドを行います。
アクセスメソッド指定(by-path)の場合、アクセスメソッド指定(by-id)の場合のそれぞれについての実行例を以下に示します。

＜アクセスメソッド指定(by-path)の場合＞
# raw /dev/raw/raw1 /dev/disk/by-path/pci-0000:20:01.0-scsi-0:0:1:0p3

＜アクセスメソッド指定(by-id)の場合＞
# raw /dev/raw/raw1 /dev/disk/by-id/SHP_36.4GST336753LC_3HX2BF0R000074446H48p3

なお、システムを再起動した場合は、rawコマンドを再度実行する必要があります。この処理を自動化する場合は、“/etc/sysconfig/rawdevices”に以下の設定を記載してください。

＜アクセスメソッド指定(by-path)の場合＞
# /dev/raw/raw1 /dev/disk/by-path/pci-0000:20:01.0-scsi-0:0:1:0p3

＜アクセスメソッド指定(by-id)の場合＞
# /dev/raw/raw1 /dev/disk/by-id/SHP_36.4GST336753LC_3HX2BF0R000074446H48p3

udevによりローデバイスのアクセス権限が正しく設定されるように、/etc/udev/permissions.d配下の追加パーミッションルールファイルを必要に応じて編集します。

■RHEL5の場合

# parted /dev/sda
(parted) p
      :

番号  開始    終了    サイズ  タイプ      ファイルシステム  フラグ
1     32.3kB  107MB   107MB   プライマリ  ext3              boot
2     107MB   9656MB  9550MB  プライマリ                    lvm
3     9656MB  10.7GB  1078MB  プライマリ                    lvm

(parted) q
# udevinfo -q path -n /dev/sda3
/block/sda/sda3
# udevinfo -q env -p /block/sda/sda3 | grep ID_PATH
ID_PATH=pci-0000:00:10.0-scsi-0:0:0: 
# udevinfo -q env -p /block/sda/sda3 | grep ID_SERIAL
ID_SERIAL=SFUJITSU_MAN3367MC_UFD8P2602PTJ

udevの設定ファイル(/etc/udev/rules.d/60-raw.rules)を編集し、作成したパーティションをバインドします。
アクセスメソッド指定(by-path)の場合、アクセスメソッド指定(by-id)の場合のそれぞれについての実行例を以下に示します。

＜アクセスメソッド指定(by-path)の場合＞
ACTION=="add", KERNEL=="sda3", ENV{ID_PATH}=="pci-0000:00:10.0-scsi-0:0:0:0", RUN+="/bin/raw /dev/raw/raw1 %N"

＜アクセスメソッド指定(by-id)の場合＞
ACTION=="add", KERNEL=="sda3", ENV{ID_SERIAL}=="SFUJITSU_MAN3367MC_UFD8P2602PTJ", RUN+="/bin/raw /dev/raw/raw1 %N"

udevによりローデバイスのアクセス権限が正しく設定されるように、/etc/udev/rules.d/配下の追加パーミッションルールファイルを必要に応じて編集します。

■RHEL6の場合

# parted /dev/sda
(parted) p
      : 

番号  開始    終了    サイズ  タイプ      ファイルシステム  フラグ
 1    1049kB  525MB   524MB   primary     ext4              boot
 2    525MB   21.5GB  20.9GB  primary                       lvm
      :
 8    77.5GB  78.5GB  974MB   logical     ext2

(parted) q
# udevadm info --query=path --name=/dev/sda8
/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda8
# udevadm info --query=property --path=/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda8 | grep ID_PATH
ID_PATH=pci-0000:00:1f.2-scsi-0:0:0:0
# udevadm info --query=property --path=/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda/sda8 | grep ID_SERIAL
ID_SERIAL=FUJITSU_MHY2080BH_K41XT84279M1

＜アクセスメソッド指定(by-path)の場合＞
ACTION=="add", KERNEL=="sda8", ENV{ID_PATH}=="pci-0000:00:1f.2-scsi-0:0:0:0", RUN+="/bin/raw /dev/raw/raw1 %N"

＜アクセスメソッド指定(by-id)の場合＞
ACTION=="add", KERNEL=="sda8", ENV{ID_SERIAL}=="FUJITSU_MHY2080BH_K41XT84279M1", RUN+="/bin/raw /dev/raw/raw1 %N"

udevによりローデバイスのアクセス権限が正しく設定されるように、/etc/udev/rules.d/配下の追加パーミッションルールファイルを必要に応じて編集します。

ローデバイスをバインドするブロックデバイスは、パーティションを指定してください。パーティション番号のないハードディスクデバイス（/dev/sdgなど）は、ディスクラベル（パーティションテーブル）を含んでいるため、ローデバイスとして使用しないでください。
rawコマンドは、マウントされているシステム用デバイスを指定しても、正常にキャラクタデバイスへのバインド処理を実施します。rawコマンドの第2パラメタには、正しいデバイス名を指定してください。
誤ったデバイス名を指定した場合、システムおよびユーザ資産を破壊する可能性があります。
直接指定での運用を行うこともできますが、ハード構成が変更されるとシステム／ユーザ資産を破壊する可能性があるため、アクセスメソッド指定で設定することを推奨します。