xmlファイル形式です。
格納先およびファイル名称は任意です。
mngsvrutilコマンドで論理ユーザサーバを追加するときに作成します。
論理ユーザサーバ定義ファイルに記述できる内容を次の表に示します。
要素名 | 説明 | デフォルト値 | |||
---|---|---|---|---|---|
<user-server-definition> | 名前空間として次のパスを指定します。http://www.cosminexus.com/mngsvr/schema/UserServerDefinition-1.1 | - | |||
<service> | サービスの定義。 必ず指定してください。 | - | |||
<type> | 起動方法を直接起動にするか間接起動にするかを指定します。
| direct | |||
<startup-order> | 起動順序を-1~999の整数で指定します。-1を指定した場合は,指定なしとなります。 | 900 | |||
<start-watch-time> | 起動監視時間を次の数値(単位:秒)で指定します。0を指定した場合は,監視しません。 0,60,300,600,3600 | 60 | |||
<stop-watch-time> | 停止監視時間を次の数値(単位:秒)で指定します。0を指定した場合は,監視しません。 0,60,300,600,1800 | 60 | |||
<force-watch-time> | 強制停止監視時間を次の数値(単位:秒)で指定します。0を指定した場合は,監視しません。 0,60,300,600,1800 | 60 | |||
<retry-count> | 自動再起動回数を次の数値で指定します。 0,1,5,10,1000 | 1 | |||
<retry-interval> | 自動再起動リトライ間隔を次の数値(単位:秒)で指定します。0を指定した場合は,即時リトライします。 0,60,300,600,1800 | 60 | |||
<watch-interval> | 監視間隔を,1~86400の整数(単位:秒)で指定します。 | 1 | |||
<start-time-watch-interval> | 起動時監視間隔を,1~86400の整数(単位:秒)で指定します。 | 1 | |||
<env> | 環境変数の定義。 複数指定できます。 | - | |||
name | 環境変数名を指定します。 必ず指定してください。 | - | |||
value | 環境変数値を指定します。 必ず指定してください。 環境変数の指定値に次の文字列「${cosminexus.home}」が含まれている場合は,<Cosminexusのインストールディレクトリ>に置換されます。 | - | |||
<working-dir> | ワーキングディレクトリを絶対パスで指定します。 | <Cosminexusのインストールディレクトリ>/manager/bin | |||
<user-id> | コマンド実行時のユーザIDを指定します。 この要素は,UNIX用です。 | - | |||
<group-id> | コマンド実行時のグループIDを指定します。 この要素は,UNIX用です。 | - | |||
<command> | コマンドの定義 必ず指定してください。また,複数指定できます。 | - | |||
type | コマンド種別※1を指定します。指定できる値は,次のとおりです。
| - | |||
timeout | タイムアウト時間を,1~86400の整数(単位:秒)で指定します。 ただし,コマンド種別がgetProcessIDまたはisAliveのときだけ有効となります。 | 180 | |||
<arg> | コマンド引数を指定します。※2 必ず指定してください。 コマンドに引数および引数値を付加する場合は,<arg>タグを複数指定してください。 <arg>タグの指定例を次に示します。 <arg>コマンド</arg> <arg>引数1</arg> <arg>引数1の指定値</arg> <arg>引数2(値の指定なし)</arg> <arg>引数3</arg> <arg>引数3の指定値</arg> | - | |||
<server> | 論理ユーザサーバ定義。 必ず指定してください。また,複数指定できます。 | - | |||
<logical-server-name> | 論理サーバ名を128文字以下で指定します。使用できる文字は半角文字の英数字(A~Z,a~z,0~9),アンダースコア(_),およびハイフン(-)です。 必ず指定してください。 | - | |||
<display-name> | 論理サーバの表示名を128文字以下で指定します。 | - | |||
<description> | 論理サーバの説明を1024文字以下で指定します。 | - | |||
<host-ref> | あらかじめ定義されたホスト名を255文字以下で指定します。使用できる文字は半角文字の英数字(A~Z,a~z,0~9),アンダースコア(_),ハイフン(-)およびピリオド(.)です。 必ず指定してください。 | - |
起動種別 | コマンド種別 | 指定条件 | 要件 | 備考 |
---|---|---|---|---|
直接起動 | start | 必須 | サーバ起動用コマンドが監視対象となります。 | - |
stop | 任意 | サーバ停止用コマンドの正常終了時には,監視対象プロセスが終了しています。 | 指定していない場合は次の動作をします。
| |
forceStop | 任意 |
| 指定していない場合は次の動作をします。
| |
getProcessID | 指定不可 | - | 指定した場合はエラーとなります。 | |
isAlive | 任意 | サービスが稼働中の場合は終了コードが0,稼働中ではない場合は終了コードが0以外となります。 | 指定した場合はサービス監視を行います。 | |
間接起動 | start | 必須 |
| - |
stop | 任意 | サーバ停止用コマンドの正常終了時には,監視対象プロセスが終了しています。 | 指定していない場合は次の動作をします。
| |
forceStop | 任意 |
| 指定していない場合は次の動作をします。
| |
getProcessID | 必須 |
9 9 9 6 ¥n | - | |
isAlive | 任意 | サービスが稼働中の場合は終了コードが0,稼働中ではない場合は終了コードが0以外となります。 | 指定した場合はサービス監視を行います。 |
置換前の文字列 | 置換後の文字列 | 備考 |
---|---|---|
${cosminexus.home} | Cosminexusインストールディレクトリ | - |
%{XXX} | 環境変数XXXの値 | 環境変数XXXが存在しない場合は空白文字列に置換されます。 |
${server.name} | 論理サーバ名 | - |
<?xml version="1.0" encoding="UTF-8" ?> |