プロパティー・ファイルを使用して、データ複製サービス (DRS) プロパティーおよびカスタム・プロパティーの作成、変更、削除を行えます。
始める前に
DRS 構成またはその構成オブジェクトに行う変更を決定します。
wsadmin スクリプト・ツールを開始します。
Jython 言語を使用して wsadmin を開始する場合は、サーバー・プロファイルの bin ディレクトリーから wsadmin -lang jython コマンドを実行します。
このタスクについて
プロパティー・ファイルを使用して、DRS インスタンスの作成、変更、削除を行えます。
また、サーブレット・キャッシュ・カスタム・プロパティーの作成、変更、削除も可能です。
wsadmin を使用して管理コマンドを実行し、
DRS インスタンス・プロパティー・ファイルの作成または変更、プロパティーの検証、プロパティーの構成への適用を行います。
表 1. DRS プロパティー・ファイルのアクション. DRS プロパティーは作成、変更、および削除できます。アクション |
手順 |
作成 |
必要に応じてプロパティーを設定し、applyConfigProperties コマンドを実行します。 |
modify |
applyConfigProperties コマンドを実行して、カスタム・プロパティーの値を変更します。 |
delete |
deleteConfigProperties コマンドを実行してプロパティーを削除します。削除するプロパティーにデフォルト値がある場合、プロパティーはデフォルト値に設定されます。DRSSettings オブジェクト全体を削除するには、#DELETE=true のコメントを外し、deleteConfigProperties コマンドを実行します。 |
プロパティーの作成 |
該当なし |
プロパティーの削除 |
該当なし |
表 2. DRS カスタム・プロパティーのアクション. DRS カスタム・プロパティーは作成、変更、および削除できます。アクション |
手順 |
作成 |
該当なし |
modify |
applyConfigProperties コマンドを実行して、既存のカスタム・プロパティーの値を変更します。 |
delete |
該当なし |
プロパティーの作成 |
applyConfigProperties コマンドを実行して、カスタム・プロパティーを作成します。 |
プロパティーの削除 |
deleteConfigProperties コマンドを実行して、既存のカスタム・プロパティーを削除します。プロパティー・ファイルには、削除するプロパティーのみが含まれている必要があります。 |
オプションで、以下のコマンドを使用して、対話モードを使用することができます。
AdminTask.command_name('-interactive')
手順
- DRSSettings オブジェクトのプロパティー・ファイルを作成します。
- 必要に応じて DRSSettings プロパティーを設定します。
エディターで DRSSettings プロパティー・ファイルを開きます。
ご使用のシステムと一致するよう環境変数セクションを変更し、変更が必要なプロパティー値を設定します。カスタム・プロパティーを指定する場合は、AttributeInfo 値とプロパティー値を編集します。以下は、DRSSettings プロパティー・ファイルの例です。
#
# Header
#
ResourceType=DRSSettings
ImplementingResourceType=ServletCacheInstance
ResourceId=Cell=!{cellName}:CacheProvider=myCacheProvider:ServletCacheInstance=jndiName#myServletCacheJndiName:DRSSettings=
AttributeInfo=cacheReplication
#DELETE=true
#
#
#Properties
#
overrideHostConnectionPoints={}
ids={} #integer*
messageBrokerDomainName=null
dataReplicationMode=BOTH #ENUM(SERVER|CLIENT|BOTH),default(BOTH)
preferredLocalDRSBrokerName=null
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
- applyConfigProperties コマンドを実行して、DRS 構成を作成または変更します。
applyConfigProperties コマンドを実行すると、構成にプロパティー・ファイルが適用されます。以下の Jython の例では、オプションの -reportFileName パラメーターによって report.txt という名前のレポートが作成されます。
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- 既存のプロパティー・ファイルを変更します。
- 変更する DRSSettings のプロパティー・ファイルを取得します。
extractConfigProperties コマンドを使用して、DRSSettings オブジェクトのプロパティー・ファイルを抽出することができます。
- エディターでプロパティー・ファイルを開き、必要に応じてプロパティーを変更します。
プロパティー・ファイル内の環境変数が、ご使用のシステムと一致していることを確認してください。
カスタム・プロパティーを指定する場合は、AttributeInfo 値とプロパティー値を編集します。以下に例を示します。
#
# Header
#
ResourceType=DRSSettings
ImplementingResourceType=ServletCacheInstance
ResourceId=Cell=!{cellName}:CacheProvider=myCacheProvider:ServletCacheInstance=jndiName#myServletCacheJndiName:DRSSettings=
AttributeInfo=properties(name,value)
#
#Properties
#
existingProp=newValue
newProp=value
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myNode04Cell
- applyConfigProperties コマンドを実行します。
- サーブレット・キャッシュまたは既存のカスタム・プロパティーがもう必要ない場合には、
サーブレット・キャッシュ・オブジェクト全体またはカスタム・プロパティーを削除することができます。
タスクの結果
プロパティー・ファイルを使用して、DRS オブジェクトとそのプロパティーを構成および管理することができます。