From a32dcf24e697e37dfe9df9c600a53dff6e5a0343 Mon Sep 17 00:00:00 2001 From: Rosemary Marano Date: Tue, 24 Jan 2023 16:03:32 -0500 Subject: [PATCH] Update RNs Update RNs and move previously existing RN content. --- documentation/3.0/content/concepts/model.md | 53 +++++++++- .../3.0/content/release-notes/_index.md | 97 +++---------------- .../content/release-notes/release-2.4.0.md | 4 +- .../content/release-notes/release-2.4.1.md | 4 +- .../content/release-notes/release-2.4.2.md | 4 +- .../userguide/limitations/limitations.md | 50 ++++++++++ 6 files changed, 116 insertions(+), 96 deletions(-) create mode 100644 documentation/3.0/content/userguide/limitations/limitations.md diff --git a/documentation/3.0/content/concepts/model.md b/documentation/3.0/content/concepts/model.md index cdff805093..1da1900cd8 100644 --- a/documentation/3.0/content/concepts/model.md +++ b/documentation/3.0/content/concepts/model.md @@ -15,6 +15,7 @@ weight: 1 - [Model semantics](#model-semantics) - [Declaring named MBeans to delete](#declaring-named-mbeans-to-delete) - [Using multiple models](#using-multiple-models) +- [Upgrading from WDT 1.x to WDT 2.x YAML files](#upgrading-from-wdt-1x-to-wdt-2x-yaml-files) ### Overview @@ -264,7 +265,7 @@ In addition to deleting named mbeans, you can remove items from a list. Most pra JMSSystemResource: BPMJMSModule: Target: soa_cluster,'!AdminServer' - + ``` In this example, the BPMJMSModule has the AdminServer target removed from the target list. @@ -360,3 +361,53 @@ topology: ListenPort: 7000 Notes: Server 1 ``` + +### Upgrading from WDT 1.x to WDT 2.x YAML files + +Beginning in 2.0, WebLogic Deploy Tooling now incorporates the SnakeYAML parser for reading and writing model files. +This may require some changes to existing models in order to be parsed correctly. + - Model elements that use [delete notation]({{< relref "/concepts/model#declaring-named-mbeans-to-delete" >}}) need to be escaped in single or double quotation marks. + ```yaml + topology: +     Server: +         '!ms1': +         ms2: + ``` + + + - Model elements under the same parent should be indented to the exact same level. The previous YAML parser did not enforce this restriction, + but it is standard for YAML. In this example, each cluster is indented four spaces. + ```yaml + topology: +     Cluster: +         cluster1: +             ClientCertProxyEnabled: True +         cluster2: +             WeblogicPluginEnabled: true + ``` + + + +- Object lists in the `kubernetes` section of the model now should be specified in a hyphenated list format, +similar to how they appear in the domain resource file produced for [WebLogic Kubernetes Operator](https://oracle.github.io/weblogic-kubernetes-operator/managing-domains/domain-resource/). + + ```yaml +     clusters: +     - clusterName: 'cluster1' +       allowReplicasBelowMinDynClusterSize: true +     - clusterName: 'cluster2' +       allowReplicasBelowMinDynClusterSize: true + ``` + + - The "named object list" format is deprecated now, and will cause warning messages to be displayed. + ```yaml +     clusters: +       'cluster1': +         allowReplicasBelowMinDynClusterSize: true +       'cluster2': +         allowReplicasBelowMinDynClusterSize: true + ``` + + +- The deprecated argument `-model_sample` has been removed from the Model Help Tool. +The Model Help Tool has used model sample format, by default, since release 1.9.2. diff --git a/documentation/3.0/content/release-notes/_index.md b/documentation/3.0/content/release-notes/_index.md index 03889c4db5..d8e2b9822e 100644 --- a/documentation/3.0/content/release-notes/_index.md +++ b/documentation/3.0/content/release-notes/_index.md @@ -5,96 +5,21 @@ weight = 5 pre = " " +++ -Review the following release notes for recent changes to WebLogic Deploy Tooling and known issues. -- WebLogic Deploy Tooling now incorporates the SnakeYAML parser for reading and writing model files. -This may require some changes to existing models in order to be parsed correctly. - - Model elements that use [delete notation]({{< relref "/concepts/model#declaring-named-mbeans-to-delete" >}}) need to be escaped in single or double quotation marks. - ```yaml - topology: -     Server: -         '!ms1': -         ms2: - ``` +### Changes in Release 3.0.0 +- [Major New Features](#major-new-features) +- [Other Changes](#other-changes) +- [Bugs Fixes](#bug-fixes) +- [Known Issues](#known-issues) - - Model elements under the same parent should be indented to the exact same level. The previous YAML parser did not enforce this restriction, - but it is standard for YAML. In this example, each cluster is indented four spaces. - ```yaml - topology: -     Cluster: -         cluster1: -             ClientCertProxyEnabled: True -         cluster2: -             WeblogicPluginEnabled: true - ``` +#### Major New Features +None +#### Other Changes +None +#### Bug Fixes -- Object lists in the `kubernetes` section of the model now should be specified in a hyphenated list format, -similar to how they appear in the domain resource file produced for [WebLogic Kubernetes Operator](https://oracle.github.io/weblogic-kubernetes-operator/managing-domains/domain-resource/). - ```yaml -     clusters: -     - clusterName: 'cluster1' -       allowReplicasBelowMinDynClusterSize: true -     - clusterName: 'cluster2' -       allowReplicasBelowMinDynClusterSize: true - ``` - - - The "named object list" format is deprecated now, and will cause warning messages to be displayed. - ```yaml -     clusters: -       'cluster1': -         allowReplicasBelowMinDynClusterSize: true -       'cluster2': -         allowReplicasBelowMinDynClusterSize: true - ``` - - -- The deprecated argument `-model_sample` has been removed from the Model Help Tool. -The Model Help Tool has used model sample format by default since release 1.9.2. - -## Known issues for WebLogic Deploy Tooling - -The following list contains known issues. Each issue may contain a workaround or an associated issue number. - -#### Discover Domain Tool `SEVERE` messages - -**ISSUE**: -The `discoverDomain` STDOUT contains many SEVERE messages about `cd()` and `ls()` when it is run against a 12.2.1.0 domain. The Discover Domain Tool navigates through the domain MBeans using WLST to determine which MBeans are present in a domain. When it tests an MBean that is not present, an error message is logged by WLST. There is no 12.2.1.0 PSU available to address this WLST problem. It is resolved in 12.2.1.1. - -**ACTION**: -Ignore the following messages logged during discovery of a 12.2.1.0 domain. -``` - <> - <> -``` - -#### Create Domain Tool with 11g JRF domains - -**ISSUE**: -The Create Domain Tool cannot initialize RCU for 11g JRF domains. The tool will issue error messages in the log and terminate the create process. - -**ACTION**: -Run the WLS `rcu` command before executing `createDomain` for JRF domains - -#### Credential in security configuration - -**ISSUE**: For WLS versions prior to 14.1.1, there is a problem setting the `CredentialEncrypted` attribute in the `topology/SecurityConfiguration` folder. The value is not encrypted properly in the configuration and the domain will fail to start with the error: -``` -java.lang.IllegalArgumentException: In production mode, it's not allowed to set a clear text value to the property: CredentialEncrypted of SecurityConfigurationMBean -``` -**ACTION**: Contact Oracle Support to obtain the patch for bug number 30874677 for your WebLogic Server version before running the tool. - -#### Assigning security groups to users - -**ISSUE**: For WLS versions prior to 14.1.1, there is a problem setting the `GroupMemberOf` attribute in the `topology/Security/User` folder. The value is not persisted correctly, and the assignment will not be present when the domain is started. - -**ACTION**: Contact Oracle Support to obtain the patch for bug number 30319071 for your WebLogic Server version before running the tool. - -#### Problems setting `RotateLogOnStartup` attribute - -**ISSUE**: For existing WLS versions, there is a problem setting the `RotateLogOnStartup` attribute in various log file folders. The value is not persisted correctly, and the assignment will not be present when the domain is started. - -**ACTION**: Contact Oracle Support to obtain the patch for bug number 29547985 for your WebLogic Server version before running the tool. +#### Known Issues diff --git a/documentation/3.0/content/release-notes/release-2.4.0.md b/documentation/3.0/content/release-notes/release-2.4.0.md index 1e1ca8efa2..9f460dc05f 100644 --- a/documentation/3.0/content/release-notes/release-2.4.0.md +++ b/documentation/3.0/content/release-notes/release-2.4.0.md @@ -1,7 +1,7 @@ +++ title = "Release 2.4.0" date = 2022-11-02T15:27:38-05:00 -weight = 5 +weight = 3 pre = " " +++ @@ -34,5 +34,3 @@ pre = " " #### Known Issues - Due to the changes made for WDT-663, the resulting remotely discovered model contains extra fields that would not normally be there. This is an area of ongoing work to clean up the online aliases to not depend on these extra remote calls to produce a clean model. - - diff --git a/documentation/3.0/content/release-notes/release-2.4.1.md b/documentation/3.0/content/release-notes/release-2.4.1.md index fcd2661f03..eee0cbd27a 100644 --- a/documentation/3.0/content/release-notes/release-2.4.1.md +++ b/documentation/3.0/content/release-notes/release-2.4.1.md @@ -1,7 +1,7 @@ +++ title = "Release 2.4.1" date = 2022-11-03T15:27:38-05:00 -weight = 5 +weight = 2 pre = " " +++ @@ -24,5 +24,3 @@ None #### Known Issues - Due to the changes made for WDT-663 in WDT 2.4.0, the resulting remotely discovered model contains extra fields that would not normally be there. This is an area of ongoing work to clean up the online aliases to not depend on these extra remote calls to produce a clean model. - - diff --git a/documentation/3.0/content/release-notes/release-2.4.2.md b/documentation/3.0/content/release-notes/release-2.4.2.md index 62721d88f5..05d532eba9 100644 --- a/documentation/3.0/content/release-notes/release-2.4.2.md +++ b/documentation/3.0/content/release-notes/release-2.4.2.md @@ -1,7 +1,7 @@ +++ title = "Release 2.4.2" date = 2022-11-10T15:27:38-05:00 -weight = 5 +weight = 1 pre = " " +++ @@ -25,5 +25,3 @@ None #### Known Issues - Due to the changes made for WDT-663 in WDT 2.4.0, the resulting remotely discovered model contains extra fields that would not normally be there. This is an area of ongoing work to clean up the online aliases to not depend on these extra remote calls to produce a clean model. - - diff --git a/documentation/3.0/content/userguide/limitations/limitations.md b/documentation/3.0/content/userguide/limitations/limitations.md new file mode 100644 index 0000000000..cff7eb2f7c --- /dev/null +++ b/documentation/3.0/content/userguide/limitations/limitations.md @@ -0,0 +1,50 @@ +--- +title: "Limitations" +date: 2019-02-23T17:19:24-05:00 +draft: false +weight: 4 +description: "Review existing WDT limitations." +--- + + +The following sections describe known limitations for WebLogic Deploy Tooling. Each issue may contain a workaround or an associated issue number. + +#### Discover Domain Tool `SEVERE` messages + +**ISSUE**: +The `discoverDomain` STDOUT contains many SEVERE messages about `cd()` and `ls()` when it is run against a 12.2.1.0 domain. The Discover Domain Tool navigates through the domain MBeans using WLST to determine which MBeans are present in a domain. When it tests an MBean that is not present, an error message is logged by WLST. There is no 12.2.1.0 PSU available to address this WLST problem. It is resolved in 12.2.1.1. + +**ACTION**: +Ignore the following messages logged during discovery of a 12.2.1.0 domain. +``` + <> + <> +``` + +#### Create Domain Tool with 11g JRF domains + +**ISSUE**: +The Create Domain Tool cannot initialize RCU for 11g JRF domains. The tool will issue error messages in the log and terminate the create process. + +**ACTION**: +Run the WLS `rcu` command before executing `createDomain` for JRF domains + +#### Credential in security configuration + +**ISSUE**: For WLS versions prior to 14.1.1, there is a problem setting the `CredentialEncrypted` attribute in the `topology/SecurityConfiguration` folder. The value is not encrypted properly in the configuration and the domain will fail to start with the error: +``` +java.lang.IllegalArgumentException: In production mode, it's not allowed to set a clear text value to the property: CredentialEncrypted of SecurityConfigurationMBean +``` +**ACTION**: Contact Oracle Support to obtain the patch for bug number 30874677 for your WebLogic Server version before running the tool. + +#### Assigning security groups to users + +**ISSUE**: For WLS versions prior to 14.1.1, there is a problem setting the `GroupMemberOf` attribute in the `topology/Security/User` folder. The value is not persisted correctly, and the assignment will not be present when the domain is started. + +**ACTION**: Contact Oracle Support to obtain the patch for bug number 30319071 for your WebLogic Server version before running the tool. + +#### Problems setting `RotateLogOnStartup` attribute + +**ISSUE**: For existing WLS versions, there is a problem setting the `RotateLogOnStartup` attribute in various log file folders. The value is not persisted correctly, and the assignment will not be present when the domain is started. + +**ACTION**: Contact Oracle Support to obtain the patch for bug number 29547985 for your WebLogic Server version before running the tool.