第8章定義項目一覧

本章では、GlassFishの定義項目について説明します。

定義項目

定義項目は以下のようにカテゴリごとに階層化されており、カテゴリとプロパティ名はピリオド(.)で区切られます。

server.category1.category3.property1
server.category1.category4.property2
server.category2.category5.property3
server.category2.category6.property4
server.category2.category7.property5
server.category2.category8.property6
server.category2.category8.category9.property7
server.category2.category8.category9.property8

定義項目の設定/参照

GlassFishの定義項目の多くは、asadminコマンドのset/get/listサブコマンドで操作できます。
これらのサブコマンドには、以下の特徴があります。

setサブコマンドを使用することで、定義項目の値を設定できます。
getサブコマンドを使用することで、定義項目の値を参照できます。
listサブコマンドを使用することで、カテゴリの一覧を参照できます。
getやlistサブコマンドで指定する定義項目名がわからない場合でも、ワイルドカード(*)により、複数の定義情報を一括で参照できます。ただし、ワイルドカード(*)により、未サポートの定義項目が表示される可能性があります。

注意

プロパティの値は、以下のように参照(getサブコマンド)/設定(setサブコマンド)します。

C:\Interstage\glassfish5\glassfish\bin\asadmin get resources.jdbc-connection-pool.JNDI名.property.参照するプロパティ名
C:\Interstage\glassfish5\glassfish\bin\asadmin set resources.jdbc-connection-pool.JNDI名.property.設定するプロパティ名=設定値

/opt/FJSViaps/glassfish5/glassfish/bin/asadmin get resources.jdbc-connection-pool.JNDI名.property.参照するプロパティ名
/opt/FJSViaps/glassfish5/glassfish/bin/asadmin set resources.jdbc-connection-pool.JNDI名.property.設定するプロパティ名=設定値

プロパティ値が設定されていない場合、参照時にエラーとなります。
プロパティの参照/設定方法の詳細は、以下の説明を参照してください。

setサブコマンド
getサブコマンド
listサブコマンド

定義変更後の再起動について

GlassFish Serverクラスターの定義変更をする場合は、定義変更前に必ずGlassFish Serverクラスターを停止し、定義変更後にGlassFish Serverクラスターを再起動してください。DASの定義変更をする場合は、定義変更後に再起動してください。

指定可能な最大文字列長について

各定義項目のうち、ユーザーが任意の文字列を指定可能な定義項目の最大文字列長は、特に断りのない限り512文字となります。512文字以外の最大文字列長の制限がある定義項目に関しては、各定義項目の説明に文字列長の制限を記載しています。
なお、特定の値(true/falseなど)しか指定できない項目や、特定の範囲の数値(0～2147483647など)を指定する項目に関しては、文字列長の制限はありません。

システムプロパティ利用時の入力値チェックについて

定義項目の値にシステムプロパティを利用した場合、文字列長や指定可能文字などの入力値チェックは動作しません。
定義値にシステムプロパティを利用する場合、システムプロパティで指定する値の妥当性に注意してください。システムプロパティについては、「8.8.1 定義時に利用できるプロパティ」を参照してください。

DOSデバイス名の指定ついて

ファイル名やディレクトリ名として使用される設定項目には、DOSデバイス名を指定しないでください。

例

ファイル名やディレクトリ名として使用される設定項目

GlassFish Serverクラスター名
GlassFish Serverインスタンス名
ログ出力ディレクトリ
各アプリケーションの名前
データベースの名前
メッセージブローカインスタンス名

他

定義項目の説明について

定義項目は、以下の形式で説明しています。

定義項目の日本語名

カテゴリの場合は、「■リソース参照」のように行頭に「■」を付けています。

定義項目名

カテゴリ、またはプロパティを「server.category1.category3.property1」の形式で記載しています。

また、GlassFish Serverクラスター名やGlassFish Serverインスタンス名は、以下のような表記を使用しています。

表記	意味
${clusterName}	GlassFish Serverクラスター名を指定できます。
${instanceName}	GlassFish Serverインスタンス名を指定できます。
${clusterName_instanceName}	GlassFish Serverクラスター名またはGlassFish Serverインスタンス名を指定できます。
${clusterName_instanceName_configName}	GlassFish Serverクラスター名、GlassFish Serverインスタンス名、または設定名を指定できます。

説明: プロパティの説明です。カテゴリの場合は、説明はありません。

範囲: setサブコマンドが使用できるプロパティの場合に、設定可能な範囲を記載しています。

初期値

インストール時に設定される値です。

なお、基本的に、定義項目はasadmin setサブコマンドで値を省略(定義項目名と「=」だけを指定)しないでください。例外的に、定義項目の値を省略可能な定義項目については、該当する定義項目で個別に説明します。

第8章 定義項目一覧

第8章定義項目一覧