Interstage Application Server/Interstage Web Server リファレンスマニュアル(コマンド編)

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	ユニット名(英数字のみ、大文字／小文字の区別なし)	省略不可	1〜6(文字数)
unitmode	ユニットのモード 　std：標準ユニット 　ext：拡張ユニット	std	std, ext
trandir	トランザクション用ファイルを格納するディレクトリとして、NTFSファイルシステム上のディレクトリを指定します。 トランザクション用ファイルを格納するディレクトリとして、通常ファイルシステム上のディレクトリ、またはローデバイスを指定します(処理の高速化のためにローデバイスを指定することを推奨)。 注1）以下のサイズの容量が必要となります。 ((tranmax×4)＋256＋(tranunitmax×2))×16(Kバイト) 注2）ローデバイスを指定する場合は、パーティションのサイズが2ギガバイト以内のローデバイスをあらかじめ作成しておく必要があります。 注3）複数ユニットのファイルを混在できません。ユニットを複数生成する場合は、異なる格納ディレクトリを指定してください。 注4）絶対パスで指定してください。環境変数を使用したパスは指定できません。 注5）クラスタ運用時はローデバイスではなく、sysdirおよびuserdirと同じ共用ディスク上の格納ディレクトリを指定してください。	省略不可
tranmax	トランザクションの多重度 ユニット内のイベントチャネルに対して、同時にトランザクション運用を行う多重度を指定します。	1024 100	1〜1024
tranunitmax	1トランザクション内で操作することができる最大メッセージサイズをブロック数で指定します(1ブロック:16Kバイト(固定))。 例）1024と指定すると、1024×16Kバイト=16Mバイト	1024	1〜4096
sysdir	システム用(ユニット制御用)ファイルを格納するディレクトリ(Windows(R)システムでは、NTFSファイルシステム上のディレクトリを指定)。 注1）複数ユニットのファイルを混在できません。ユニットを複数生成する場合は、異なる格納ディレクトリを指定してください。 注2）絶対パスで指定してください。環境変数を使用したパスは指定できません。	省略不可
syssize	システム用(ユニット制御用)ファイルの容量 以下の計算式を目安に見積もってください。 固定領域＋チャネル使用領域＋proxy使用領域＋インデックス用領域 固定領域：32K チャネル使用領域：(n:不揮発チャネル数) 　(16K＋(2K×(n−1)))×1.5 proxy使用領域： 　((コンシューマ数＋サプライヤ数)／32＋1)×16×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）絶対パスで指定してください。環境変数を使用したパスは指定できません。	省略不可
usersize	イベントデータ用ファイルの容量 以下の計算式を目安に見積もってください。 固定領域＋メッセージ使用領域 固定領域：16K メッセージ使用領域： ・平均512バイト以下の場合 　(最大蓄積メッセージ件数／32＋1)×16K×1.5 ・平均1Kバイト以下の場合 　(最大蓄積メッセージ件数／16＋1)×16K×1.5 ・平均2Kバイト以下の場合 　(最大蓄積メッセージ件数／8＋1)×16K×1.5 ・平均が2Kバイトを超える場合 　((最大蓄積メッセージ件数／8＋1)×16K＋(メッセージ長−2K)×最大蓄積メッセージ件数)×1.5 注）JMSを使用する場合は、メッセージ使用領域の計算式にメッセージ長として1.8Kバイトを加算して、見積もってください。	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管理コンソールを使用する場合は、格納ディレクトリには、以下の使用禁止文字を含めないでください。
  • アンパーサンド(&)
  • 小なり(<)

　ローデバイスの作成手順を以下に示します。

1. 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

2. 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 /dev/raw/raw1 /dev/sda3

   　なお、システムを再起動した場合は、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
   ＜直接指定の場合＞
   # /dev/raw/raw1 /dev/sda3

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

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