WebLogic Deploy Toolでは、一連のJSON構成ファイルを使用して、モデル内のフォルダおよび属性を対応するWLST MBeansおよびその属性にマップします。 これらのマッピングは、プロジェクト・コードおよびドキュメント全体で別名と呼ばれます。 別名定義ファイルの各要素には、このマッピングに役立つ詳細なプロパティがあります。
モデルのフォルダ名と属性名は、通常、WLST内の対応する要素の名前と一致します。 WLST要素の名前がWebLogic Serverリリース間で変更される場合、名前は12.2.1.3リリースの名前と一致する必要があります。 ユニット・テストAttributesTestCaseは、この規則が使用されていることを確認し、いくつかの例外を識別します。
12.2.1.3リリース後に導入された属性は、ほとんどの場合、表示される最初のWebLogic Serverリリースの名前と一致する必要があります。 ユニット・テストAttributesTestCaseでは、これらが12.2.1.3別名構造に存在しないため、この時点では無視されます。
別名定義ファイルは、次のディレクトリにあります:
$WLSDEPLOY_HOME/core/src/main/resources/oracle/weblogic/deploy/aliases/category_module
各定義ファイルは、モデル内の第2レベルのフォルダ(JDBCSystemResourceなど)に対応します。 第2レベルのフォルダの下にある要素は、その親のファイルに定義されます。 たとえば、モデル要素resources/JDBCSystemResource/JdbcResource/JDBCConnectionPoolParamsについては、JDBCSystemResource.jsonを参照してください。
topologyやresourcesなどのトップレベル要素は、組織目的のためであり、別名定義ファイルには表示されません。
モデルのdomainInfoセクションに要素は、WLST要素に直接対応しないため、別名定義に表されません。
この例では、ファイルJDBCSystemResource.jsonから、次の説明の参照として使用されます:
{
"copyright": "Copyright (c) 2017, 2018, Oracle Corporation and/or its affiliates. All rights reserved.",
"license": "Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl",
"wlst_type": "JDBCSystemResource${:s}",
"child_folders_type": "multiple",
"folders": {
"JdbcResource" : {
"wlst_type": "${Jdbc:JDBC}Resource",
"folders": {
"JDBCConnectionPoolParams": {
"wlst_type": "JDBCConnectionPoolParams",
"folders": {},
"attributes": {
"CapacityIncrement": [ {"version": "[10,)",
"wlst_mode": "both",
"wlst_name": "CapacityIncrement",
"wlst_path": "WP001",
"default_value": "${__NULL__:1}",
"wlst_type": "integer",
"get_method": "LSA"} ],
"ConnectionCreationRetryFrequencySeconds": [ {"version": "[10,)",
"wlst_mode": "both",
"wlst_name": "ConnectionCreationRetryFrequencySeconds",
"wlst_path": "WP001",
"default_value": "${__NULL__:0}",
"wlst_type": "integer",
"get_method": "LSA"} ]
},
"wlst_attributes_path": "WP001",
"wlst_paths": {
"WP001": "/JDBCSystemResource${:s}/%DATASOURCE%/${Jdbc:JDBC}Resource/%DATASOURCE%/JDBCConnectionPoolParams/${NO_NAME_0:%DATASOURCE%}"
}
},
...
${Jdbc:JDBC}Resourceのような表記は、この例とその他の別名定義ファイル全体に表示されます。 オフラインとオンラインのWLST間で値が異なる場合、一般的な状況ではわかりやすくなります。 コロンがオフライン処理で使用される前の値、および後の値がオンラインで使用されます。 この例では、wlst_typeの値はオフラインではJdbcResource、オンラインではJDBCResourceです。 この表記法は、モデルのほとんどの場所の値に使用できます。 wlst_typeなどのキー値には使用できません。
folders要素のキーこれらのJSONキーは、最上位要素(JDBCSystemResourceなど)およびネストされた各folders要素(JdbcResourceやJdbcResource/JDBCConnectionPoolParamsなど)に適用されます。
wlst_typeこの値は、モデル・フォルダに対応するWLST MBeanのタイプ名です。 ここで説明した${x:y}表記は、オフライン・フォルダ名とオンライン・フォルダ名を区別するためによく使用されます。
child_folders_typeこの値は、ツールがドメイン・モデル要素を1つ以上のWLST MBeansにマップする方法を指定します。 値は次のとおりです。
single (default) - この要素は単一のMBeanを表し、MBean名は既知です。
single-unpredictable - この要素は単一のMBeanを表しますが、MBean名は実行時に導出する必要があります。
multiple - この要素には複数の名前付き要素(dataSource1、dataSource2など)が含まれ、それぞれが単一のMBeanを表します。
folders現在のMBeanのネストされたWLST MBeanタイプがここにリストされます。 それぞれにドメイン・モデル・タイプ名があり、その後に独自のJSONキー要素が続きます。
wlst_attributes_pathこのキー要素は、MBean属性フォルダに移動するために使用するパス式の名前を指定します。 実際のパス式は、後で"wlst_paths": { }要素で定義されます。
wlst_pathsディクショナリ・キーは、このフォルダの定義の他の場所で使用される様々なWLSTパス値を定義します。 各エントリは、名前を完全なWLSTのMBeanパスにマップします。 この例では、JDBCConnectionPoolParamsに単一パスがあります:
"WP001": "/JDBCSystemResource${:s}/%DATASOURCE%/${Jdbc:JDBC}Resource/%DATASOURCE%/JDBCConnectionPoolParams/${NO_NAME_0:%DATASOURCE%}"
%DATASOURCE%テキストはトークン・プレースホルダーです。 これは、ツールによって実際のデータ・ソースの名前に置き換えられます。
attributes要素のキーattributes要素の各子は単一のMBean属性を表し、そのキーは対応するモデル名(CapacityIncrementなど)です。 次のJSONキーを含む説明要素が少なくとも1つ含まれています。 構成が異なるWebLogic Serverバージョン範囲で異なる場合や、オフラインとオンラインのWLSTで異なる場合、複数の説明要素が存在する場合があります。
versionこのキー要素は、特定のMBean属性の説明に適用可能なバージョンを定義します。 Mavenのバージョニング規則は、範囲と制限を記述するために使用されます。 例えば:
"version": "[10,)"
MBean属性の説明がWebLogic Serverバージョン10以降に関連することを指定
wlst_modeこのキー要素は、MBean属性の説明に適用可能なWLSTモードを指定します。 値は"offline"、"online"または"both"です。
wlst_nameこのキー要素は、MBean属性のWLST名を指定します。
wlst_typeこのキー要素は、WLSTのMBean属性の設定に使用するデータ型を指定します。 有効な値は、integer, long, string, delimited_string, booleanおよびjarrayです。 wlst_read_typeが設定されていない場合、これはWLSTから値を読み取るために使用されるデータ型でもあります。
wlst_read_typeこのキー要素は、WLSTのMBean属性の読取りに使用するデータ型を指定します。 指定しない場合、wlst_typeの値が読取りに使用されます。
get_methodこのキー要素は、MBean属性の値を取得するために使用するメソッドを指定します。 有効な値は次のとおりです。
GET は、WLST getメソッドを使用して属性の値を取得LSA は、ls(type=‘a’)を使用して属性の値を取得NONE は属性値を取得しませんaccessデフォルトでは、属性はWLSTとMODELの両方で読取り/書込みになります。 この要素は、属性を読み取り専用または無視に設定するために使用されます。 次の2つの属性値があります:
RO は、属性が読取り専用であり、ドメインに書き込まれないことを示します。ただし、Discover Domain Toolによって検出され、モデルに書き込まれます。IGNORED は、属性がモデル内で認識され許容されるが、検出またはドメインに書き込まれないことを示します。preferred_model_typeこのキー要素は、検出時にモデルにデータを配置するために使用される優先データ型を指定します。 例として、リスト値は、"value1, value2"などのカンマ区切りテキストとして、または["value1", "value2"]などのYAMLリストとしてモデルで表すことができます。 リスト値にカンマが含まれている場合は、YAMLリストを使用する必要があります。
wlst_pathこのキー要素は、MBean属性のフォルダへのナビゲートに使用されるパス式の名前を指定します。 この名前は、親フォルダの"wlst_paths": { }リスト内のエントリにマップされます。
default_valueこのキー要素は、MBean属性のデフォルト値を指定します。 例えば:
"default_value": "text"
"default_value": 99
"default_value": null
"default_value": "${__NULL__:1}"
__NULL__キーは、"${a:b}"表記を使用してオフライン値とオンライン値を指定する場合のnull値を表します。
production_defaultこのキー要素は、本番モードのドメインに使用するデフォルト値を指定します。 値の形式は、default_valueの値と似ています。 null値は、production_defaultを無視し、default_valueを使用する必要があることを示します。
secure_defaultこのキー要素は、セキュア・モードのドメインに使用するデフォルト値を指定します。 値の形式は、default_valueの値と似ています。 null値は、secure_defaultを無視し、default_valueを使用する必要があることを示します。
secure_default_nullこのキー要素は、nullをセキュア・モードのドメインのデフォルト値として使用することを指定します。 これは、secure_defaultをnullに設定することとは異なります。これにより、値は無視されます。
set_method属性を単純なタイプで設定できない場合、カスタム・メソッドを使用して値を設定する必要がある場合があります。 たとえば、ほとんどのTarget属性では、オンライン・モードでMBeansのリストとして値を設定する必要があります。 これは、次のように定義できます:
"attributes": {
"Target": [ {
"set_method": "MBEAN.set_target_mbeans",
"set_mbean_type": "weblogic.management.configuration.TargetMBean"} ],
},
メソッドset_target_mbeansは、この値を設定するためにJythonメソッドattribute_setter.set_target_mbeansをコールするツールに指示します。
set_mbean_typeset_methodキーが指定されている場合、使用するsetメソッドにMBeanタイプを指定する必要があります(set_methodの例を参照)。