Skip to content

Commit 2ef211c

Browse files
rosemarymaranorosemarymarano
authored
Update RNs (#1364)
Update RNs and move previously existing RN content.
1 parent 82d8d62 commit 2ef211c

File tree

6 files changed

+116
-96
lines changed

6 files changed

+116
-96
lines changed

‎documentation/3.0/content/concepts/model.md

Lines changed: 52 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ weight: 1
1515
- [Model semantics](#model-semantics)
1616
- [Declaring named MBeans to delete](#declaring-named-mbeans-to-delete)
1717
- [Using multiple models](#using-multiple-models)
18+
- [Upgrading from WDT 1.x to WDT 2.x YAML files](#upgrading-from-wdt-1x-to-wdt-2x-yaml-files)
1819

1920
### Overview
2021

@@ -264,7 +265,7 @@ In addition to deleting named mbeans, you can remove items from a list. Most pra
264265
JMSSystemResource:
265266
BPMJMSModule:
266267
Target: soa_cluster,'!AdminServer'
267-
268+
268269
```
269270
In this example, the BPMJMSModule has the AdminServer target removed from the target list.
270271

@@ -360,3 +361,53 @@ topology:
360361
ListenPort: 7000
361362
Notes: Server 1
362363
```
364+
365+
### Upgrading from WDT 1.x to WDT 2.x YAML files
366+
367+
Beginning in 2.0, WebLogic Deploy Tooling now incorporates the SnakeYAML parser for reading and writing model files.
368+
This may require some changes to existing models in order to be parsed correctly.
369+
- Model elements that use [delete notation]({{< relref "/concepts/model#declaring-named-mbeans-to-delete" >}}) need to be escaped in single or double quotation marks.
370+
```yaml
371+
topology:
372+
    Server:
373+
        '!ms1':
374+
        ms2:
375+
```
376+
377+
378+
- Model elements under the same parent should be indented to the exact same level. The previous YAML parser did not enforce this restriction,
379+
but it is standard for YAML. In this example, each cluster is indented four spaces.
380+
```yaml
381+
topology:
382+
    Cluster:
383+
        cluster1:
384+
            ClientCertProxyEnabled: True
385+
        cluster2:
386+
            WeblogicPluginEnabled: true
387+
```
388+
389+
390+
391+
- Object lists in the `kubernetes` section of the model now should be specified in a hyphenated list format,
392+
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/).
393+
394+
```yaml
395+
    clusters:
396+
    - clusterName: 'cluster1'
397+
      allowReplicasBelowMinDynClusterSize: true
398+
    - clusterName: 'cluster2'
399+
      allowReplicasBelowMinDynClusterSize: true
400+
```
401+
402+
- The "named object list" format is deprecated now, and will cause warning messages to be displayed.
403+
```yaml
404+
    clusters:
405+
      'cluster1':
406+
        allowReplicasBelowMinDynClusterSize: true
407+
      'cluster2':
408+
        allowReplicasBelowMinDynClusterSize: true
409+
```
410+
411+
412+
- The deprecated argument `-model_sample` has been removed from the Model Help Tool.
413+
The Model Help Tool has used model sample format, by default, since release 1.9.2.

‎documentation/3.0/content/release-notes/_index.md

Lines changed: 11 additions & 86 deletions
Original file line numberDiff line numberDiff line change
@@ -5,96 +5,21 @@ weight = 5
55
pre = "<b> </b>"
66
+++
77

8-
Review the following release notes for recent changes to WebLogic Deploy Tooling and known issues.
98

10-
- WebLogic Deploy Tooling now incorporates the SnakeYAML parser for reading and writing model files.
11-
This may require some changes to existing models in order to be parsed correctly.
12-
- Model elements that use [delete notation]({{< relref "/concepts/model#declaring-named-mbeans-to-delete" >}}) need to be escaped in single or double quotation marks.
13-
```yaml
14-
topology:
15-
    Server:
16-
        '!ms1':
17-
        ms2:
18-
```
9+
### Changes in Release 3.0.0
10+
- [Major New Features](#major-new-features)
11+
- [Other Changes](#other-changes)
12+
- [Bugs Fixes](#bug-fixes)
13+
- [Known Issues](#known-issues)
1914

2015

21-
- Model elements under the same parent should be indented to the exact same level. The previous YAML parser did not enforce this restriction,
22-
but it is standard for YAML. In this example, each cluster is indented four spaces.
23-
```yaml
24-
topology:
25-
    Cluster:
26-
        cluster1:
27-
            ClientCertProxyEnabled: True
28-
        cluster2:
29-
            WeblogicPluginEnabled: true
30-
```
16+
#### Major New Features
17+
None
3118

19+
#### Other Changes
20+
None
3221

22+
#### Bug Fixes
3323

34-
- Object lists in the `kubernetes` section of the model now should be specified in a hyphenated list format,
35-
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/).
3624

37-
```yaml
38-
    clusters:
39-
    - clusterName: 'cluster1'
40-
      allowReplicasBelowMinDynClusterSize: true
41-
    - clusterName: 'cluster2'
42-
      allowReplicasBelowMinDynClusterSize: true
43-
```
44-
45-
- The "named object list" format is deprecated now, and will cause warning messages to be displayed.
46-
```yaml
47-
    clusters:
48-
      'cluster1':
49-
        allowReplicasBelowMinDynClusterSize: true
50-
      'cluster2':
51-
        allowReplicasBelowMinDynClusterSize: true
52-
```
53-
54-
55-
- The deprecated argument `-model_sample` has been removed from the Model Help Tool.
56-
The Model Help Tool has used model sample format by default since release 1.9.2.
57-
58-
## Known issues for WebLogic Deploy Tooling
59-
60-
The following list contains known issues. Each issue may contain a workaround or an associated issue number.
61-
62-
#### Discover Domain Tool `SEVERE` messages
63-
64-
**ISSUE**:
65-
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.
66-
67-
**ACTION**:
68-
Ignore the following messages logged during discovery of a 12.2.1.0 domain.
69-
```
70-
<Jan 14, 2019 1:14:21 PM> <SEVERE> <CommandExceptionHandler> <handleException> <> <Error: cd() failed.>
71-
<Jan 14, 2019 1:14:21 PM> <SEVERE> <CommandExceptionHandler> <handleException> <> <Error: ls() failed.>
72-
```
73-
74-
#### Create Domain Tool with 11g JRF domains
75-
76-
**ISSUE**:
77-
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.
78-
79-
**ACTION**:
80-
Run the WLS `rcu` command before executing `createDomain` for JRF domains
81-
82-
#### Credential in security configuration
83-
84-
**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:
85-
```
86-
java.lang.IllegalArgumentException: In production mode, it's not allowed to set a clear text value to the property: CredentialEncrypted of SecurityConfigurationMBean
87-
```
88-
**ACTION**: Contact Oracle Support to obtain the patch for bug number 30874677 for your WebLogic Server version before running the tool.
89-
90-
#### Assigning security groups to users
91-
92-
**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.
93-
94-
**ACTION**: Contact Oracle Support to obtain the patch for bug number 30319071 for your WebLogic Server version before running the tool.
95-
96-
#### Problems setting `RotateLogOnStartup` attribute
97-
98-
**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.
99-
100-
**ACTION**: Contact Oracle Support to obtain the patch for bug number 29547985 for your WebLogic Server version before running the tool.
25+
#### Known Issues

‎documentation/3.0/content/release-notes/release-2.4.0.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
+++
22
title = "Release 2.4.0"
33
date = 2022-11-02T15:27:38-05:00
4-
weight = 5
4+
weight = 3
55
pre = "<b> </b>"
66
+++
77

@@ -34,5 +34,3 @@ pre = "<b> </b>"
3434
#### Known Issues
3535
- Due to the changes made for WDT-663, the resulting remotely discovered model contains extra fields that would not normally be there.
3636
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.
37-
38-

‎documentation/3.0/content/release-notes/release-2.4.1.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
+++
22
title = "Release 2.4.1"
33
date = 2022-11-03T15:27:38-05:00
4-
weight = 5
4+
weight = 2
55
pre = "<b> </b>"
66
+++
77

@@ -24,5 +24,3 @@ None
2424
#### Known Issues
2525
- 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.
2626
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.
27-
28-

‎documentation/3.0/content/release-notes/release-2.4.2.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
+++
22
title = "Release 2.4.2"
33
date = 2022-11-10T15:27:38-05:00
4-
weight = 5
4+
weight = 1
55
pre = "<b> </b>"
66
+++
77

@@ -25,5 +25,3 @@ None
2525
#### Known Issues
2626
- 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.
2727
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.
28-
29-

‎documentation/3.0/content/userguide/limitations/limitations.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
---
2+
title: "Limitations"
3+
date: 2019-02-23T17:19:24-05:00
4+
draft: false
5+
weight: 4
6+
description: "Review existing WDT limitations."
7+
---
8+
9+
10+
The following sections describe known limitations for WebLogic Deploy Tooling. Each issue may contain a workaround or an associated issue number.
11+
12+
#### Discover Domain Tool `SEVERE` messages
13+
14+
**ISSUE**:
15+
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.
16+
17+
**ACTION**:
18+
Ignore the following messages logged during discovery of a 12.2.1.0 domain.
19+
```
20+
<Jan 14, 2019 1:14:21 PM> <SEVERE> <CommandExceptionHandler> <handleException> <> <Error: cd() failed.>
21+
<Jan 14, 2019 1:14:21 PM> <SEVERE> <CommandExceptionHandler> <handleException> <> <Error: ls() failed.>
22+
```
23+
24+
#### Create Domain Tool with 11g JRF domains
25+
26+
**ISSUE**:
27+
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.
28+
29+
**ACTION**:
30+
Run the WLS `rcu` command before executing `createDomain` for JRF domains
31+
32+
#### Credential in security configuration
33+
34+
**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:
35+
```
36+
java.lang.IllegalArgumentException: In production mode, it's not allowed to set a clear text value to the property: CredentialEncrypted of SecurityConfigurationMBean
37+
```
38+
**ACTION**: Contact Oracle Support to obtain the patch for bug number 30874677 for your WebLogic Server version before running the tool.
39+
40+
#### Assigning security groups to users
41+
42+
**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.
43+
44+
**ACTION**: Contact Oracle Support to obtain the patch for bug number 30319071 for your WebLogic Server version before running the tool.
45+
46+
#### Problems setting `RotateLogOnStartup` attribute
47+
48+
**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.
49+
50+
**ACTION**: Contact Oracle Support to obtain the patch for bug number 29547985 for your WebLogic Server version before running the tool.

0 commit comments

Comments
 (0)