WebLogic Deploy Toolingには、拡張可能なドメイン・タイプ・システムがあります。 3つの組込みドメイン・タイプ(WLS、RestrictedJRFおよびJRF)は、WLSDEPLOY_HOME/lib/typedefsディレクトリ内の同じ名前のJSONファイルで定義されます。 たとえば、JRFドメイン・タイプは、次に示すように、WLSDEPLOY_HOME/lib/typedefs/JRF.jsonファイルに同様のコンテンツが定義されます。
{
"copyright": "Copyright (c) 2017, 2020, Oracle Corporation and/or its affiliates.",
"license": "Licensed under the Universal Permissive License v 1.0 as shown at https://oss.oracle.com/licenses/upl",
"name": "JRF",
"description": "JRF type domain definitions",
"versions": {
"12.1.2": "JRF_1212",
"12.1.3": "JRF_1213",
"12.2.1.0": "JRF_12CR2",
"12.2.1.1": "JRF_12C_DYN",
"12.2.1.2": "JRF_12C_DYN",
"12.2.1.3": "JRF_12C_DYN",
"12.2.1.4": "JRF_12214"
},
"definitions": {
"JRF_1212" : {
"baseTemplate": "@@WL_HOME@@/common/templates/wls/wls.jar",
"extensionTemplates": [
"@@ORACLE_HOME@@/oracle_common/common/templates/wls/oracle.jrf_template_12.1.2.jar",
"@@ORACLE_HOME@@/oracle_common/common/templates/wls/oracle.jrf.ws.async_template_12.1.2.jar",
"@@ORACLE_HOME@@/oracle_common/common/templates/wls/oracle.wsmpm_template_12.1.2.jar",
"@@ORACLE_HOME@@/em/common/templates/wls/oracle.em_wls_template_12.1.2.jar"
],
"serverGroupsToTarget" : [ "JRF-MAN-SVR", "WSMPM-MAN-SVR" ],
"rcuSchemas": [ "MDS", "IAU", "IAU_VIEWER", "IAU_APPEND", "OPSS" ]
},
"JRF_1213" : {
"baseTemplate": "@@WL_HOME@@/common/templates/wls/wls.jar",
"extensionTemplates": [
"@@ORACLE_HOME@@/oracle_common/common/templates/wls/oracle.jrf_template_12.1.3.jar",
"@@ORACLE_HOME@@/oracle_common/common/templates/wls/oracle.jrf.ws.async_template_12.1.3.jar",
"@@ORACLE_HOME@@/oracle_common/common/templates/wls/oracle.wsmpm_template_12.1.3.jar",
"@@ORACLE_HOME@@/em/common/templates/wls/oracle.em_wls_template_12.1.3.jar"
],
"serverGroupsToTarget" : [ "JRF-MAN-SVR", "WSMPM-MAN-SVR" ],
"rcuSchemas": [ "MDS", "IAU", "IAU_VIEWER", "IAU_APPEND", "OPSS" ]
},
"JRF_12CR2": {
"baseTemplate": "Basic WebLogic Server Domain",
"extensionTemplates": [
"Oracle JRF WebServices Asynchronous services",
"Oracle WSM Policy Manager",
"Oracle Enterprise Manager"
],
"serverGroupsToTarget": [ "JRF-MAN-SVR", "WSMPM-MAN-SVR" ],
"rcuSchemas": [ "MDS", "IAU", "IAU_VIEWER", "IAU_APPEND", "OPSS" ]
},
"JRF_12C-DYN": {
"baseTemplate": "Basic WebLogic Server Domain",
"extensionTemplates": [
"Oracle JRF WebServices Asynchronous services",
"Oracle WSM Policy Manager",
"Oracle Enterprise Manager"
],
"serverGroupsToTarget": [ "JRF-MAN-SVR", "WSMPM-MAN-SVR" ],
"dynamicClusterServerGroupsToTarget": [ "WSMPM-DYN-CLUSTER" ],
"rcuSchemas": [ "WLS", "MDS", "IAU", "IAU_VIEWER", "IAU_APPEND", "OPSS" ]
},
"JRF_12214": {
"baseTemplate": "Basic WebLogic Server Domain",
"extensionTemplates": [
"Oracle JRF WebServices Asynchronous services",
"Oracle WSM Policy Manager",
"Oracle Enterprise Manager"
],
"serverGroupsToTarget": [ "JRF-MAN-SVR", "WSMPM-MAN-SVR" ],
"dynamicClusterServerGroupsToTarget": [ "WSMPM-DYN-CLUSTER", "WSM-CACHE-DYN-CLUSTER" ],
"rcuSchemas": [ "WLS", "MDS", "IAU", "IAU_VIEWER", "IAU_APPEND", "OPSS" ]
}
}
}
このファイルは、ドメインの作成に使用するテンプレート、ターゲットにするサーバー・グループ、および作成するRCUスキーマを、すべてWebLogic Serverのインストール済バージョンに基づいて作成するようにCreate Domain Toolに指示します。
新しいドメイン・タイプは、WLSDEPLOY_HOME/lib/typedefsディレクトリに同じ構造の新しいJSONファイルを作成することで定義できます。
別のオプションとして、このファイルを「カスタム構成」ディレクトリ$WDT_CUSTOM_CONFIG/typedefsに作成します。
たとえば、12.2.1.3のSOAドメイン・タイプを定義するには、次に示すように、同様のコンテンツを含むtypedefs/SOA.jsonファイルを追加します。
{
"name": "SOA",
"description": "SOA type domain definitions",
"versions": {
"12.2.1.3": "SOA_12213"
},
"definitions": {
"SOA_12213": {
"baseTemplate": "Basic WebLogic Server Domain",
"extensionTemplates": [
"Oracle SOA Suite"
],
"serverGroupsToTarget": [ "JRF-MAN-SVR", "WSMPM-MAN-SVR", "SOA-MGD-SVRS" ],
"rcuSchemas": [ "STB", "WLS", "MDS", "IAU", "IAU_VIEWER", "IAU_APPEND", "OPSS", "UCSUMS", "SOAINFRA" ]
}
}
}
新しいドメインtypedefファイルが存在した後、必要なコンポーネントがインストールされたOracle Homeを必ず参照するように、createDomainスクリプトに新しいドメイン・タイプ名を指定します。 12.2.1より前のバージョンでは、-wlst_path引数を使用して、適切なWLSTシェル・スクリプトが存在する製品ホームを指定する必要があります。たとえば、SOA 12.1.3の場合は、-wlst_path <ORACLE_HOME>/soaを追加して、ツールがSOAドメインに適した環境でWLSTシェル・スクリプトを使用するようにします。 12.2.1以降では、標準の<ORACLE_HOME>oracle_common/common/binディレクトリのWLSTシェル・スクリプトによってOracle Home内のすべてのコンポーネントが自動的にロードされるため、これは必要なくなりました。 新しいドメイン・タイプを使用して、次のコマンドを実行し、RCUを実行し、すべてのリソースおよびアプリケーションをデプロイしてSOAドメインを作成します。
weblogic-deploy\bin\createDomain.cmd -oracle_home d:\SOA12213 -domain_type SOA -domain_parent d:\demo\domains -model_file DemoDomain.yaml -archive_file DemoDomain.zip -variable_file DemoDomain.properties -run_rcu
customExtensionTemplates属性を使用して、ドメインに適用するカスタム拡張テンプレートを指定できます。 これらは絶対ファイル・パスとして指定する必要があり、トークンを使用できます。
{
"name": "MyCustom",
"description": "My custom type domain definitions",
"versions": {
"12.2.1.3": "My_12213"
},
"definitions": {
"My_12213": {
"baseTemplate": "Basic WebLogic Server Domain",
"extensionTemplates": [ ],
"customExtensionTemplates": [
"/user/me/templates/my-template.jar",
"@@ORACLE_HOME@@/user_templates/other-template.jar"
],
"serverGroupsToTarget": [ "MY-MAN-SVR" ],
"rcuSchemas": [ ]
}
}
}
管理対象サーバーにターゲット指定する必要があるサーバー・グループがカスタム・テンプレートにある場合は、前述の例のMY_MAN_SVRと同様に、serverGroupsToTarget属性で指定する必要があります。
topologyProfileフィールドを使用して、各テンプレートの特定のプロファイルを使用してドメインを作成できます。 この部分例は、指定された各テンプレートにコンパクト・プロファイルを適用します。
{
"copyright": "Copyright (c) 2022, 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",
"name": "JRF-Compact",
"description": "JRF type domain with a compact profile definitions",
"topologyProfile": "Compact",
...
}
WebLogic Deploy Toolingには、コンパクト・プロファイルを使用してJRFドメインを作成するために使用できるJRF-Compact.jsonタイプ定義ファイルがあります。
12.2.1より前のWebLogic Serverバージョンのテンプレートでは、applyJRF WLSTコマンドを使用してリソースを正しいクラスタおよびサーバーに正しくターゲット指定する必要がある場合があります。 WebLogic Deploy Toolingのデフォルトの動作では、extensionTemplatesリストにJRFテンプレートが含まれている場合にのみapplyJRFが起動されます。
カスタム・タイプ定義ファイルでは、テンプレートの追加後にapplyJRFを起動する必要があります。 これは、次の例のように、targeting属性をAPPLY_JRFに設定することによって行われます:
{
"name": "MyCustom",
"description": "My custom type domain definitions",
"versions": {
"10.3.6": "My_11G"
},
"definitions": {
"My_11G": {
"baseTemplate": "@@WL_HOME@@/common/templates/wls/wls.jar",
"extensionTemplates": [
"/user/me/templates/my-template.jar"
],
"targeting": "APPLY_JRF",
"serverGroupsToTarget": [ "MY-MAN-SVR" ],
"rcuSchemas": [ ]
}
}
}
targeting属性は、WebLogic Serverバージョン12.2.1以降では無効です。
Discover Domain Toolは、デフォルト値の属性を含まないような戦略を採用することで、スパース・モデルを提供しようとします。 モデルを使用してテンプレート・リソースをインストールしないことが重要です。 まず、テンプレートはターゲット・ドメインに同じリソースをインストールします。 2つ目は、オンプレミス・ドメインから新しいWebLogicバージョンのターゲット・ドメインにリソースをインストールすると、競合が発生する可能性があります。 Discover Domain Toolでは、typedefファイルのdiscover-filtersセクションを使用して、検出されたオブジェクトをフィルタで除外し、モデル・ファイルおよびアーカイブ・ファイルから除外します。
リストには、除外するリソースのタイプごとにエントリが、除外する指定されたタイプの名前または正規表現のリストとともに含まれます。
次の例は、JRF.json typedefファイルのdiscover-filtersリストです。 キーは、最上位フォルダから始まるモデル名であることに注意してください(グループ構成名topology、resourcesおよびappDeploymentsは除きます)。
"discover-filters": {
"/Application": [
"^coherence-transaction-rar$",
"^DMS Application.*",
"^em$",
"^FMW Welcome Page Application.*",
"^opss-rest$",
"^state-management-provider-memory-rar.*",
"^wsil-wls.*",
"^wsm-pm$"
],
"/CoherenceClusterSystemResource": [
"^defaultCoherenceCluster$"
],
"/JDBCSystemResource": [
".*LocalSvcTblDataSource$",
".*mds-owsm$",
".*opss-audit-DBDS$",
".*opss-audit-viewDS$",
".*opss-data-source$",
".*opss-ds$",
".*WLSSchemaDataSource$"
],
"/FileStore": [
"^JRFWSAsyncFileStore$",
"^mds-owsm$"
],
"/JMSSystemResource": [
"^JRFWSAsyncJmsModule$"
],
"/JMSServer": [
"^JRFWSAsyncJmsServer$"
],
"/Library": [
"^adf\\.oracle\\.businesseditor.*",
"^adf\\.oracle\\.domain.*",
"^adf\\.oracle\\.domain\\.webapp.*",
"^em_common.*",
"^em_core_ppc_pojo_jar$",
"^em_error.*",
"^em_sdkcore_ppc_public_pojo_jar$",
"^emagentsdk_jar.*",
"^emagentsdkimpl_jar.*",
"^emagentsdkimplpriv_jar.*",
"^emas$",
"^emcore$",
"^emcore_jar$",
"^emcoreclient_jar$",
"^emcorecommon_jar$",
"^emcoreconsole_jar$",
"^emcoreintsdk_jar.*",
"^emcorepbs_jar$",
"^emcoresdk_jar.*",
"^emcoresdkimpl_jar.*",
"^jsf.*",
"^jstl.*",
"^log4j_jar.*",
"^odl\\.clickhistory.*",
"^odl\\.clickhistory\\.webapp.*",
"^ohw-rcf.*",
"^ohw-uix.*",
"^oracle\\.adf\\.dconfigbeans.*",
"^oracle\\.adf\\.desktopintegration.*",
"^oracle\\.adf\\.desktopintegration\\.model.*",
"^oracle\\.adf\\.management.*",
"^oracle\\.bi\\.adf\\.model\\.slib.*",
"^oracle\\.bi\\.adf\\.view\\.slib.*",
"^oracle\\.bi\\.adf\\.webcenter\\.slib.*",
"^oracle\\.bi\\.composer.*",
"^oracle\\.bi\\.jbips.*",
"^oracle\\.dconfig-infra.*",
"^oracle\\.jrf\\.system\\.filter$",
"^oracle\\.jsp\\.next.*",
"^oracle\\.pwdgen.*",
"^oracle\\.sdp\\.client.*",
"^oracle\\.sdp\\.messaging.*",
"^oracle\\.webcenter\\.composer.*",
"^oracle\\.webcenter\\.skin.*",
"^oracle\\.wsm\\.console.*",
"^oracle\\.wsm\\.idmrest.*",
"^oracle\\.wsm\\.seedpolicies.*",
"^orai18n-adf.*",
"^owasp\\.esapi.*",
"^UIX.*"
],
"/ShutdownClass": [
"^DMSShutdown$",
"^JOC-Shutdown$"
],
"/StartupClass": [
"^JMX Framework Startup Class$",
"^JOC-Startup$",
"^JPS Startup Class$",
"^JPS Startup Post-Activation Class$",
"^WSM Startup Class$",
"^Web Services Startup Class$",
"^JRF Startup Class$",
"^ODL-Startup$",
"^DMS-Startup$",
"^AWT Application Context Startup Class$"
],
"/WLDFSystemResource": [
"^Module-FMWDFW$"
]
}
このメカニズムでは、/JDBCStoreや/MailSessionなどの他の名前付きトップレベル・フィールドもサポートされます。 また、ネストされている自己チューニング関連リソースを除外するために使用することもできます。 例えば:
"discover-filters": {
"/SelfTuning/WorkManager": [
"^wm/SOAWorkManager$",
"^SOA_Default_WM$",
"^SOA_DataSourceBound_WM$",
"^SOA_Notification_WM$",
"^SOA_Request_WM$",
"^SOA_EDN_WM$"
]
}