|
|
dsm.ini |
主にDSMCGI・DSMSRVの設定を行うためのファイル「dsm.ini」に関する説明です。
| セクション | 設定内容 |
| [DSMCGI] | DSMCGI関連の設定 |
| [DSMSRV] | 分散設定 （Ver6.0ではサポート外です） リソース管理設定 スタンドアロン環境でのリソース管理設定 |
| [DSMPR] | パフォーマンス・レポート設定 |
| [CHECK] | 自動監視設定 |
| [BATCH] | バッチ設定 |
| [WKSCH] | APP運用スケジュール設定 |
| [MESSAGE] | エラーカスタマイズ |
| [JAVA] | Java関連の設定 |
| [DSMM] | DSM管理者のパスワード |
| [DSMMEXT] | 外部アプリケーション設定 |
| [MQIG] | MQの設定 |
| その他 | 環境変数の設定における注意事項 |
このファイルは、Windows環境/UNIX環境によって配置する位置が違います。
Windowsディレクトリ（デフォルトでは"C:\winnt"）に配置します。
"/etc"ディレクトリに配置します。
また、Windows環境とUNIX環境では以下の点が異なります。
セミコロン";"で区切ります。
コロン":"で区切ります。
[DSMCGI]
bnInstPath=C:\nomad\software
bnCurPath=C:\nomad\nomwork
bnWWWPath=C:\nomad\wwwroot
AclGroup=User1:User2:Guests
MaxBNOMAD=6
MaxCoexistHost=100
TaskWaitTimeMin=5
bnCacheClear=YES
bnCONVERSION=NO
bnErrorQuit=NO
CreateIDByUSERID=NO
TimeOutMin=5
QuitDelayMin=30
MaxBNOMADonMEM=1
TimeOutReset=1
HomeClearUsers=30
DeleteErrorLog=YES
LogFileOutPut=1
MaxLogSizeMB=4
LogFilePath=C:\nomad\nomwork
[DSMCGI]
bnInstPath=/nomad/software
bnCurPath=/nomad/nomwork
bnWWWPath=/nomad/wwwroot
MaxBNOMAD=6
MaxCoexistHost=100
TaskWaitTimeMin=5
bnCacheClear=YES
bnCONVERSION=YES
bnErrorQuit=NO
CreateIDByUSERID=NO
TimeOutMin=5
QuitDelayMin=30
MaxBNOMADonMEM=1
TimeOutReset=1
HomeClearUsers=30
DeleteErrorLog=YES
LogFileOutPut=1
MaxLogSizeMB=4
LogFilePath=/nomad/nomwork
以下の各項目において「*」の印がある項目は、DSMSRV起動時にでも設定を変更することができます。変更は、NOMADアプリケーションの呼び出し時にリアルタイムに反映されます。
それ以外の項目は、DSMSRVが起動しているときに変更してはいけません。
必須パラメータ
NOMADのインストールされているディレクトリを指定します。
「nomad.ini」ファイルはこのディレクトリ内に存在している必要があります。
NOMADの実行ディレクトリを指定します。
複数指定はできません。
AclGroup
DSMCGIの使用を許可するユーザーとグループを記入します。
複数の場合はコロン":"で区切ってください。
この項目は、Windows環境専用です。UNIX環境では使用しません。
なお、ネットワークユーザーの場合は「ドメイン名\ユーザー名」と正しく設定してください。
この項目は、IP2HTML使用時にのみ使用します。
ひな形HTMLファイルのあるディレクトリです。
パスを複数指定するときの区切り記号に、
Windows環境の場合、セミコロン";"を使用します。
UNIXの場合は、区切り記号にコロン":"を使用します。
B/NOMADの最大起動数です。
デフォルトは2です。
セッションの実行を、最大指定時間（分）まで待ちます。
デフォルトは4（分）です。
0または-1を指定すると1440（=24時間）を設定したことになります。
当設定時間を超えても結果が返ってこない場合、そのセッションが実行不能になったと見なし、次の後処理を行います。
1．スレッドを停止します。これによってDSMCGI全体の自動回復が行われます。
2．
3．共有メモリーにある管理情報をクリアします。
※TaskWaitTimeMinはwebサーバのタイムアウト時間より短くすることを、強く推奨します。
分散環境の場合は、RPCのタイムアウト時間をTaskWaitTimeMinの値によって設定します。
RPCのタイムアウト時間は「TaskWaitTimeMin + 2分」となります（2分はB/NOMAD起動時のタイムアウト時間）。
その他、スレッドプール数の指定や、特定のB/NOMADプロセスに対して異なる値を設定することが可能です。
詳しくはマルチスレッド動作環境の設定を参照してください。
ブラウザのキャッシュ機能の設定します。
YES（デフォルト）
ブラウザのキャッシュ機能を無効にする操作を行います。NO
キャッシュ機能に関する操作は行いません。
文字コードを自動変換します。
YES
DSMCGIが文字コードを自動認識して、ネイティブコードに変換します。NO（デフォルト）
文字コードの自動認識を行いません。
初期処理用のプロシージャ（プロファイル）、または実プロシージャの実行に失敗した場合はQUITします。
YES
プロシージャの実行に失敗した場合はQUITします。NO（デフォルト）
プロシージャの実行に失敗しても、B/NOMADとのセッションの解放のみ行います。
DSMCGIのセッションIDの生成方法を指定します。
YES
DSMCGIのセッションIDを「Webサーバーの認証ID_乱数」にします。
NO（デフォルト）
DSMCGIのセッションIDを「ホスト名（IPアドレス）_乱数」にします。
B/NOMADのタイムアウト（メモリー上からB/NOMAD情報を消す）時間（分）を指定します。
デフォルトは5（分）です。
タイムアウトになってから自己終了（B/NOMADプロセスの終了）までの時間を指定します。
デフォルトは30（分）です。
この指定により新しいアクセスによるB/NOMADの起動回数を減らすことができ、応答時間が早くなります。
タイムアウトのタイミングは、[CHECK]セクションの「CheckerTimer」間隔でDsmSrvCheckerにより監視されています。
Webからのアクセス、「dsm /i」「dsm /m」などのアクセスがあったときにもタイムアウトのチェックが行われます。
Windows環境の場合は、B/NOMADのプロセスにタイマー機能を持たせているため、指定の時間になるとタイムアウトし、自己終了します。
DSMSRV起動時に立ち上がり、常駐するB/NOMADの数です。
デフォルトは1です。
0以上の数値を指定してください。0を指定した場合も1になります。
無効な値（数値以外、負の値など）が設定された場合や設定されていない場合は1になります。
B/NOMADを常駐させておくことによりB/NOMADの起動を省略できるため、応答時間が早くなります。
タイムアウト時のリセット処理を行うかどうかを指定します。
0
TIME_OUTのENTRYをCALLするだけでリセット処理を行いません。1（デフォルト）
TIME_OUTのENTRYをCALLしてからリセット処理も行います。
ひとつのB/NOMADプロセスで連続的に利用されたユーザー（セッション）の数が設定値に達した場合、すべてのセッションが終了した時点で使用していたB/NOMADプロセスを終了させます。
設定値に達したB/NOMADは終了するまで、次のタスクを受け付けません。新しいタスクは別のB/NOMADへ割り振られます。
ユーザーの数（アクセス回数）は、そのB/NOMADセッションが保持から待機状態となった時点で1アクセスとカウントします。
この情報は、コンソール上で「dsm /m」と入力することで確認することができます。
次のユーザーからリクエストを受ける時はそのB/NOMADを再起動することによって安定性のアップが期待できます。
マルチスレッド時のデフォルトは500です。ただし、HomeClearUsers < MaxCoexistHostの場合には、MaxCoexistHostの値に達するまではプロセスは終了しません。
シングルスレッド時のデフォルトは100です。
NativeKanji
DSMMonitorとの通信を行うとき（DSMRMIServerからDSMRMIClientに文字列を渡すとき）の漢字の文字コード形式を指定します。
Windows環境の場合は、漢字はShiftJISですのでNativeKanjiの指定は不要です。
SJIS（デフォルト）
文字コードをShiftJISで認識します。EUC
文字コードをEUCで認識します。
NOMADプロシージャの処理中、NOMADが「error_user.log」を出力した場合、そのファイルを削除するかどうかを指定します。
YES（デフォルト）
処理終了後、エラーファイルを削除します。NO
処理終了後、エラーファイルを削除しません。
DSMSRVの履歴ファイル「dsmcgi.log」の記録レベルを設定します。
0（デフォルト）
エラー情報など、最低限の情報のみを履歴ファイル「dsmcgi.log」に書き出します。1〜10
LogFileOutPutの数値が大きいほど詳細な情報を記録します。
「dsmcgi.log」ファイルの最大ファイルサイズ（単位はMB）を指定します。
デフォルトの値は、空きディスクスペースが2GB以内の場合は空きディスクスペースとなり、空きディスクスペースが2GB以上の場合は2GBとなります。0を指定した場合もデフォルト値になります。
ただし、ファイルの最大サイズは、ここで指定したファイルサイズの半分になります。
（「dsmcgi.log」と「dsmcgi.log_0」両方の最大ファイルサイズの合計がMaxLogSizeMBの指定になります）
「dsmcgi.log」が設定したファイルサイズの半分になれば、「dsmcgi.log_0」にバックアップをします。「dsmcgi.log」は履歴の記録を新たに始めます。
「dsmcgi.log」ファイルを作成するディレクトリを設定します。
デフォルトはbnCurPath（NOMADの実行ディレクトリ）に作成します。
メインサーバー（分散環境）での設定
分散のメインサーバー機能を有効にします。
ON
分散のメインサーバーとして設定します。
DsmHostXとして列挙するサーバーの最大数を指定します。
デフォルトは2です（DsmHost0〜DsmHost1までが有効）。
分散環境のメインサーバー・スタンドアロン環境のサーバーにおいて、各サーバーに設定可能なアプリケーションIDの最大数を指定します。
DsmHostxの末尾のAppIDs、LocalAppListのアプリケーションIDの列挙最大数を指定します。
デフォルトは16です。
分散サーバーの情報を設定します。DsmHost0はメインサーバーに対する設定です。
HostName
ホスト名（サーバー名）を指定します。 DsmHost0の場合（メインサーバーの場合）は、「localhost」と指定してください。Status *
サーバーを有効にするか（Run）無効にするか（Stop）の指定（RまたはS、RunまたはStop）をします。CurBNOMAD *
サーバーの負荷を調整するパラメータで、各メインサーバー・サブサーバー上では初めはこのCurBNOMADの数の分だけB/NOMADを同時に立ちあげることができます。
それ以上のアクセスがあった場合は、別の空いているサーバーに処理が分散されることになります。
すべてのサーバーで CurBNOMADの値分のB/NOMADセッションを使用している場合は、MaxBNOMADの値までB/NOMADセッションを使用します。MaxBNOMAD
サーバーで起動可能な最大のB/NOMAD数です。この値はサブサーバー側のMaxBNOMAD値と同じ値を指定してください。※ただし、メインサーバーでは、[DSMCGI]セクションのMaxBNOMAD値を参照します。[DSMSRV]セクションのDsmHost0（localhost）のMaxBNOMAD値は使われません。
AppIDs
このサーバーにアクセスできるアプリケーションIDまたはアプリケーション名を指定します。
複数ある場合は、コロン":"で区切って指定してください。
ここで指定できるアプリケーションIDの数は、MaxAPPIDの値が最大です。
この指定がない場合は、すべてのアプリケーションがこのサーバーにアクセスできます。
※DSM Ver4.70までは、ここにアプリケーション名を指定できませんでしたが、Ver5.0からは指定できるようになりました。これにより、アプリケーション名を指定しての分散も可能になります。
DsmHostxでの各パラメータの役割・例については、分散環境における仕様も参照してください。
分散のメインサーバー機能を無効にします。
OFF
分散のサブサーバーではOFFにしてください。
分散のメインサーバー名を指定します。
分散のメインサーバー機能を無効にします。
OFF
スタンドアロン環境として使用する場合はOFFにしてください。
スタンドアロン環境で、DSMサービス（DSMSRV）を停止する場合は、「dsm.ini」の[DSMSRV]セクションのDsmHost0において以下のような指定をしてください。
DsmHost0=localhost , S
リソース管理設定
Rsv_App1=5-10:2 , d:\wk\nom , e:\wk\htm\App1 Rsv_App1=5-10:2 , /nomad/wk/nom , /nomad/wk/htm/App1
リソースの設定は、DSMSRV起動時にでも設定を変更することができます。変更は、NOMADアプリケーションの呼び出し時にリアルタイムに反映されます。
指定のアプリケーションIDまたはアプリケーション名に対するリソース設定を行います。
AppID
アプリケーションIDまたはアプリケーション名を指定します。startBnomIndex
予約するB/NOMADインデックスの最小番号を指定します。endBnomIndex
予約するB/NOMADインデックスの最大番号を指定します。onMem
常駐するB/NOMADの数を指定します。searchBNOMAD
NOMADソースのサーチパスを指定します。searchHTML
HTMLソースのサーチパスを指定します（IP2HTML使用時に参照されます）。
この場合、LocalAppListで指定したアプリケーションIDがリソース設定として保持されます。LocalAppListで指定のないアプリケーションIDは、リソース設定が保持されません（アプリケーションが起動したときに、動的にB/NOMADを予約します）。
スタンドアロン環境において、DsmHost0でのアプリケーションIDの指定と、
LocalAppListのアプリケーションIDの指定との両方がある場合は、DsmHost0での指定が優先されます。
リソースの設定は、DSMSRV起動時にでも設定を変更することができます。変更は、NOMADアプリケーションの呼び出し時にリアルタイムに反映されます。
ここで指定できるアプリケーションIDの数は、MaxAPPID の値が最大です。
以下の各項目において「*」の印がある項目は、DSMSRV起動時にでも設定を変更することができます。変更は、NOMADアプリケーションの呼び出し時にリアルタイムに反映されます。
パフォーマンス・レポート機能を有効にするかどうかの設定を行います（ON/OFF）。
この項目を指定しない場合（デフォルト）はOFFです（パフォーマンス・レポート機能を無効にします）。
レポートの対象になるアプリケーションIDまたはアプリケーション名を指定します。複数ある場合は、":"で区切ってください。
この項目を指定しない場合（デフォルト）は、すべてのアプリケーションがレポート対象になります。
設定できる最大文字数は255バイトです。
レポートする「CALL procedure/entry」レベルを設定します。0〜15階層まで設定可能です。
この項目を指定しない場合（デフォルト）は0です。
リモートデータベース（RDB）へのSQLアクセスをレポート対象にするかどうかを設定します（ON/OFF）。
この項目を指定しない場合（デフォルト）はOFFです。
B/NOMADごとにレポートを作成するかどうかを設定します（ON/OFF）。
ONの場合は、共通のdsmcgi.prの他にdsmcgi.pr0、dsmcgi.pr1、dsmcgi.pr2...へも出力します。
この項目を指定しない場合（デフォルト）はOFFです。
dsmcgi.pr、dsmcgi.pr0、dsmcgi.pr1、...それぞれの最大ファイルサイズ（MB）の設定をします。
この項目を指定しない場合は、ファイルの最大サイズは無制限です。0を指定した場合も無制限になります。
ただし、個々のファイルの最大サイズは、ここで指定したファイルサイズの半分になります。（「dsmcgi.pr」と「dsmcgi.pr_0」両方の最大ファイルサイズの合計がMaxPrSizeMBの指定になります）
なお、アプリケーションの規模やレポートの出力内容によっては、特にMaxPrSizeMBの設定値が小さい場合に、レポートファイルのサイズが瞬間的にMaxPrSizeMBで設定された半分の値を大幅に上回ることもありますので注意してください。
デフォルトが無制限のため、この項目がなかった場合インストーラでは「2」を設定してファイルの膨大化を防いでいます。
DsmSrvCheckerによる監視の間隔（秒）を指定します。
デフォルトは60（秒）です。
また、サーバーにかかる負荷を制限するために、設定できる最小値は15（秒）です。
自動監視機能の警告または危険の状態を検出した場合は、設定されたメールアドレスに関連の情報を送ります。 複数のメールアドレスを設定する場合は、":"（コロン）で区切ってください。
メールアドレスは、「メールアカウント@サーバー名」のように指定してください。
メールを送信するときのSMTPサーバー名（メール送信サーバー）を指定します。ここでSMTPサーバー名を指定した場合は、「EmailList」では任意のメールアドレスを指定することができます。
「EmailSMTP」を省略した場合、「EmailList」で指定するメールアドレスでは、サーバー名の部分（「＠」の後ろ）がSMTPサーバー名である必要があります。
メールを送る最小の時間間隔（分）を設定します。監視項目はそれぞれ独立しているので、指定の時間（分）内に1つの監視項目でメールを1通しか送らないように制限をかけます。これにより、状況が悪化し続けている時でも、CheckerTimerの間隔ごとに同じ監視項目のメールが連続して送信されるのを抑えることができます。
複数の監視項目の状況が悪化し、しきい値を超えた場合には、メール受信者から見るとEmailSendMinの間隔より短い時間でメールを受け取ることもあります。
デフォルト値は10（分）、最小値は1（分）です。
バッチ周期を分単位で設定します。デフォルトは1320分です
（1320分（22×60分）をデフォルトのバッチ周期とし、運用周期を24時間に想定しています）。
バッチ周期はバッチタスクの重複起動を制限するパラメータで、すべてのバッチタスクが設定されたバッチ周期ごとに1回しか起動できません。通常の運用周期（最初のバッチタスクの運用スケジュールにより設定）内ですべてのバッチを終了させることが不可欠であるため、バッチ周期を通常の運用周期よりも小さい値を設定する必要があります。
詳細はバッチ起動を参照してください。
DSMSRVから起動するバッチを登録します。
複数登録する場合は、カンマ","で区切ってください。
DSMSRVは、一定の時間間隔（デフォルトは60秒。CheckerTimerの設定によって変更可能）で、BatchAppListに登録されたバッチAPPの運用スケジュールをチェックし、稼動状態になったバッチAPPを起動させます。
指定のWebタスク（アプリケーションIDまたはアプリケーション名で指定）の後に起動させるバッチ設定を記述します。
「Bch_バッチ名」は、「BatchAppList」で指定されている必要があります。バッチ名には、一意のバッチ名をしてください。
「Cmd_バッチタスク名」では、実際に起動させるバッチのコマンドラインを指定します。
必要に応じて実行時のカレントディレクトリの指定も可能です（##で区切る）。##を省略した場合は、DSMSRVのカレントディレクトリになります。
スケジュールの設定は、DSMSRV起動時にでも設定を変更することができます。変更は、NOMADアプリケーションの呼び出し時にリアルタイムに反映されます。
指定のアプリケーションIDまたはアプリケーション名に対するスケジュール設定を行います。
指定のない場合は、1年中24時間運用することになります。
AppID
アプリケーションIDまたはアプリケーション名を指定します。WorkHour
運用する時間の設定を行います（0〜23までの数値。0.0〜23.59までの数値）。
「0-2:5」と指定すると、00:00〜02:59・05:00〜05:59に運用する指定になります。
指定のない場合は、すべての時間が有効になります。WorkWday
運用する曜日の設定を行います（0〜6までの数値：0が日曜・1が月曜・2が火曜・・・6が土曜）。
「0-3:6」と指定すると、日曜〜水曜・土曜に運用する指定になります。
指定のない場合は、すべての曜日が有効になります。WorkMday
運用する日付の設定を行います（1〜31までの数値）。
「1-15:20-25」とすると、1〜15日・20〜25日に運用する指定になります。
指定のない場合は、すべての日付が有効になります。WorkMon
運用する月の設定を行います（1〜12までの数値）。
「4-6:10」とすると、4〜6・10月に運用する指定になります。
指定のない場合は、すべての月が有効になります。SpecialDay
運用または停止する日付時間を指定します。
R/mm/dd/hh:S/mm/dd/hh指定期間（時間）にAPP稼動の停止：頭文字に’S’
指定期間（時間）にAPP稼動の許可：頭文字に’R’
mmは時間、ddは月、hhは時間の設定です。「S/1/1-4:S/1/15」とすると、1月1日〜1月4日・1月15日は停止する指定になります。
0（デフォルト）
アプリケーションのスケジュールが停止の状態になった時点でも接続中のセッションがあればそのセッションが自分で終了、またはタイムアウトするまで維持され、一連の作業を完了させることができます。
もしも、このオンラインのWebタスクの終了を待つバッチがある場合、DSMSRVはオンラインのWebタスクが完全の停止状態（接続中のセッションがすべて終了）になるまでそのバッチを起動しません。
ただし、セッション保持中のアプリケーションスケジュールが停止状態になった場合でも、セッションは保持されたままになります（タイムアウトになるまで保持）。
Webアプリケーションでボタンが押された、などのトランザクションが発生した場合は、ブラウザ上に「スケジュールで停止に設定されています」というエラーメッセージが表示されます。
1
アプリケーションの運用スケジュールが停止の状態になった時点で接続中のセッションがあってもそれを強制的に終了させ、即時に完全の停止状態になります。
この設定は、アプリケーションの設計によっては更新したデータの整合性が取れない危険性があるので、必ず安全かどうかを確認してから設定してください。
[MESSAGE]
CGIERROR1=/nomad/error/err01.html
App1_CGIERROR1=/nomad/error/app1/err01.html
すべてのアプリケーションにて、エラー番号xxのときにブラウザに返されるHTMLファイルをフルパスで指定します。
指定のAppIDにおいて、エラー番号xxのときにブラウザに返されるHTMLファイルをフルパスで指定します。
CGIERRORxxの設定よりもこちらの方が優先されます。
Java(DSMRMIServer)の設定
[JAVA]
DSMRMIServer=ON
JavaBinPath=C:\Program Files\JavaSoft\JRE\1.2\bin
CLASSPATH=C:\nomad\software\DSMSrv.jar;C:\nomad\software
USERPOLICY=C:\nomad\software\DSM.pol
[JAVA]
DSMRMIServer=ON
JavaBinPath=/JDK12/bin
CLASSPATH=/nomad/software/DSMSrv.jar:/nomad/software
USERPOLICY=/nomad/software/DSM.pol
この設定がONの場合、DSMSRV起動時に、DSMRMIServerも自動起動します。
OFFの場合は、DSMRMIServerを自動起動しません。
「DSMRMIServer=ON」のとき、「dsm.ini」ファイルの[DSMCGI]セクションのbnCurPath内で指定されたディレクトリ内に「DSMAPIJ.DLL（UNIXの場合、libdsmapij.so/libdsmapij.a）」が存在する場合はDSMRMIServerの起動に失敗します。
bnCurPathで指定されたディレクトリ内には、「DSMAPIJ.DLL（UNIXの場合、libdsmapij.so/libdsmapij.a）」ファイルは置かないようにしてください。
JREのインストールパスの下のbinパスを指定します。
これは、rmiregistry、java（JVM）を検索するために必要です。
指定のない場合はシステムのPATH環境変数で検索します。
DSMSrv.jarを検索するために指定します。
指定された情報をシステムのCLASSPATH環境変数へ追加します。
指定のない場合はシステムのCLASSPATH環境変数のみを使用します。
「DSMSrv.jar」を使用する場合（DSMMonitorを使用する場合）は、以下のようにCLASSPATHの指定を行ってください。CLASSPATHに「DSMSrv.jar」自身もフルパスで指定する必要があります。
パスを複数指定するときの区切り記号に、
Windows環境の場合、セミコロン";"を使用します。
UNIXの場合は、区切り記号にコロン":"を使用します。
CLASSPATH=C:\nomad\software\DSMSrv.jar;C:\nomad\software
CLASSPATH=/nomad/software/DSMSrv.jar:/nomad/software
ポリシーファイルを作成した場合はここにそのファイルのフルパスを指定します。
指定のない場合は「DSM.pol」になります。通常は指定しないでください。
ポリシーファイルとは、Java（JavaApplet）においてセキュリティの許可を行うための設定ファイルです。
DSMを管理するユーザーの乱数化されたパスワードです。
「admin」という名のユーザーは必須となります。
「admin」ユーザーが存在しない場合、B/NOMADを終了（dsm /c）することができませんので、「dsm /r」にて登録してください。
DSMで監視できる外部アプリケーション数を指定します。
この設定は、「dsm /x」、バッチ起動、自動監視のチェックによるアクションの合計以上にしてください。
デフォルトは10です。
MQ Internet Gatewayで使用するQueueManager名を指定します。
MQ Internet Gatewayで使用するQueueManager内のローカルキュー名を指定します。