プロパティー・ファイルを使用して、Web サーバー・プラグイン・プロパティーおよびカスタム・プロパティーの作成、変更、削除を行えます。
始める前に
プラグイン・プロパティー構成またはその構成オブジェクトに行う変更を決定します。
wsadmin スクリプト・ツールを開始します。
Jython 言語を使用して wsadmin を開始する場合は、サーバー・プロファイルの bin ディレクトリーから wsadmin -lang jython コマンドを実行します。
このタスクについて
プロパティー・ファイルを使用して、プラグイン・オブジェクトの作成、変更、削除を行えます。
また、プラグイン・カスタム・プロパティーの作成、変更、削除も可能です。
wsadmin を使用して管理コマンドを実行し、
プラグイン・プロパティー・ファイルの変更、プロパティーの検証、プロパティーの構成への適用を行います。
表 1. プラグイン・プロパティー・ファイルのアクション. プラグイン・オブジェクトは変更および削除できます。アクション |
手順 |
作成 |
該当なし |
modify |
プロパティーを編集し、applyConfigProperties コマンドを実行してカスタム・プロパティーの値を変更します。 |
delete |
deleteConfigProperties コマンドを実行してプロパティーを削除します。削除するプロパティーにデフォルト値がある場合、プロパティーはデフォルト値に設定されます。 |
プロパティーの作成 |
該当なし |
プロパティーの削除 |
該当なし |
表 2. プラグイン・カスタム・プロパティーのアクション. プラグイン・カスタム・プロパティーは作成、変更、および削除できます。アクション |
手順 |
作成 |
該当なし |
modify |
プロパティーを編集し、applyConfigProperties コマンドを実行して既存のカスタム・プロパティーの値を変更します。 |
delete |
該当なし |
プロパティーの作成 |
プロパティーを設定し、applyConfigProperties コマンドを実行してカスタム・プロパティーを作成します。 |
プロパティーの削除 |
削除するプロパティーをプロパティー・ファイル内で指定し、deleteConfigProperties コマンドを実行して既存のカスタム・プロパティーを削除します。プロパティー・ファイルには、削除するプロパティーのみが含まれている必要があります。 |
オプションで、以下のコマンドを使用して、対話モードを使用することができます。
AdminTask.command_name('-interactive')
手順
- Web サーバー・プラグイン・プロパティー・ファイルを作成または編集します。
- 必要に応じて PluginProperties オブジェクト・プロパティーを設定します。
エディターで PluginProperties プロパティー・ファイルを開きます。
ご使用のシステムと一致するよう環境変数セクションを変更し、変更が必要なプロパティー値を設定します。以下は、PluginProperties プロパティー・ファイルの例です。
#
# Header
#
ResourceType=PluginProperties
ImplementingResourceType=WebServer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:WebServer=:PluginProperties=
AttributeInfo=pluginProperties
#
#
#Properties
#
LogFilename="c:¥Program Files¥IBM¥HTTPServer¥Plugins¥logs¥IHS¥http_plugin.log"
ConfigFilename=plugin-cfg.xml #default(plugin-cfg.xml)
RemoteKeyRingFilename="c:¥Program Files¥IBM¥HTTPServer¥Plugins¥config¥IHS¥plugin-key.kdb"
LogLevel=ERROR #ENUM(DETAIL|DEBUG|ERROR|WARN|STATS|TRACE),default(ERROR)
PluginPropagation=AUTOMATIC #ENUM(MANUAL|AUTOMATIC),default(AUTOMATIC)
AcceptAllContent=false #boolean,default(false)
PluginInstallRoot="c:¥Program Files¥IBM¥HTTPServer¥Plugins"
IgnoreDNSFailures=false #boolean,default(false)
ESIInvalidationMonitor=false #boolean,default(false)
IISDisableNagle=false #boolean,default(false)
RemoteConfigFilename="c:¥Program Files¥IBM¥HTTPServer¥Plugins¥config¥IHS¥plugin-cfg.xml"
PluginGeneration=AUTOMATIC #ENUM(MANUAL|AUTOMATIC),default(AUTOMATIC)
ResponseChunkSize=64 #integer,default(64)
RefreshInterval=60 #integer,default(60)
VHostMatchingCompat=false #boolean,default(false)
ASDisableNagle=false #boolean,default(false)
IISPluginPriority=HIGH #ENUM(MEDIUM|HIGH|LOW),default(HIGH)
KeyRingFilename=plugin-key.kdb #default(plugin-key.kdb)
ChunkedResponse=false #boolean,default(false)
ESIEnable=true #boolean,default(true)
ESIMaxCacheSize=1024 #integer,default(1024)
AppServerPortPreference=HOSTHEADER #ENUM(WEBSERVERPORT|HOSTHEADER),default(WEBSERVERPORT)
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myNode04CellnodeName=myNode04
serverName=IHS
- applyConfigProperties コマンドを実行して、プラグイン・プロパティー構成を作成または変更します。
applyConfigProperties コマンドを実行すると、構成にプロパティー・ファイルが適用されます。以下の Jython の例では、オプションの -reportFileName パラメーターによって report.txt という名前のレポートが作成されます。
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- Web サーバー・プラグイン・カスタム・プロパティーを作成または編集します。
- 必要に応じて PluginProperties カスタム・プロパティーを設定します。
エディターで PluginProperties プロパティーを開きます。
ご使用のシステムと一致するよう環境変数セクションを変更し、変更が必要なプロパティー値を設定します。カスタム・プロパティーを指定する場合は、AttributeInfo 値とプロパティー値を編集します。以下に例を示します。
#
# Header
#
ResourceType=PluginProperties
ImplementingResourceType=WebServer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:WebServer=:PluginProperties=
AttributeInfo=properties(name,value)
#
#Properties
#
existingProp=newValue
newProp=newValue
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myNode04CellnodeName=myNode04
serverName=IHS
- applyConfigProperties コマンドを実行します。
- Web サーバー・プラグイン・プロパティーを削除します。
タスクの結果
プロパティー・ファイルを使用して、プラグイン・オブジェクトとそのプロパティーを構成および管理することができます。