Skip to content

Commit d745164

Browse files
committed
Merge branch 'docs-4.2.0' into 'main'
Docs 4.2.0 See merge request weblogic-cloud/weblogic-deploy-tooling!1694
2 parents 6f5d19e + 2baa1c8 commit d745164

File tree

21 files changed

+1207
-456
lines changed

21 files changed

+1207
-456
lines changed

documentation/4.0/content/concepts/archive.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -184,6 +184,29 @@ file, and restart the server to reinitialize the SAML2 partner data.
184184
Note that this functionality is only present starting in the October 2023 PSUs for WebLogic Server 12.2.1.4 and 14.1.1,
185185
and future versions of WebLogic Server.
186186

187+
#### `wlsdeploy/security/xacmlPolicies`
188+
The directory under which XACML Authorizer policies can be stored when defining policies directly in XACML. The name of the
189+
policy file should match the name of the policy in the model. For example, the following model entry requires that the
190+
XACML policy file be stored in the archive at `wlsdeploy/security/xacmlPolicies/MyQueueSendPolicy.xml`.
191+
192+
```yqml
193+
MyQueueSendPolicy:
194+
ResourceID: 'type=<jms>, application=MyJmsModule, destinationType=queue, resource=MyQueue, action=send'
195+
XacmlDocument: wlsdeploy/security/xacmlPolicies/MyQueueSendPolicy.xml
196+
XacmlStatus: 3
197+
```
198+
199+
#### `wlsdeploy/security/xacmlRoles`
200+
The directory under which XACML Role Mapper role definitions can be stored when defining role directly in XACML. The name
201+
of the role file should match the name of the role in the model. For example, the following model entry requires that the
202+
XACML role definition file be stored in the archive at `wlsdeploy/security/xacmlRoles/users.xml`.
203+
204+
```yqml
205+
users:
206+
XacmlDocument: wlsdeploy/security/xacmlRoles/users.xml
207+
XacmlStatus: 3
208+
```
209+
187210
#### `wlsdeploy/sharedLibraries`
188211
The root directory under which shared libraries and their deployment plans are stored. Shared libraries can be stored
189212
in the archive as EAR, WAR, or JAR files, or as an exploded directory at this location.

documentation/4.0/content/release-notes/_index.md

Lines changed: 40 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
+++
22
title = "Release Notes"
33
date = 2024-01-09T18:27:38-05:00
4-
weight = 71
4+
weight = 70
55
pre = "<b> </b>"
66
+++
77

88

9-
### Changes in Release 4.1.1
9+
### Changes in Release 4.2.0
1010
- [Major New Features](#major-new-features)
1111
- [Other Changes](#other-changes)
1212
- [Bugs Fixes](#bug-fixes)
@@ -17,19 +17,45 @@ pre = "<b> </b>"
1717
None
1818

1919
#### Other Changes
20-
- #1685 - Filtered out the default `OptionalFeatures` folders when they have no attributes so that they do not show up
21-
in the online discovered model.
20+
- #1682 - Added support for discovering built-in security provider data in online mode. This includes
21+
DefaultAuthenticator users and groups, XACMLAuthorizer policies, XACMLRoleMapper roles, and DefaultCredentialMapper
22+
user/password credential mappings. As with other discovery features, default values are filtered out and will not
23+
appear in the model. By default, discovering users and credential mappings require the use of WDT encryption so that
24+
no clear text passwords are stored in the model or variable files.
25+
- #1682 - Normalized XACMLRoleMapper role handling by removing the previous discovery of XACMLRoleMapper roles (that was
26+
not working with newer versions of WebLogic anyway) and removing version limitations during provisioning.
27+
- #1682 - Deprecated the `-use_encryption` command-line argument and replaced it with `-passphrase_prompt` to make the
28+
purpose of the argument clearer.
29+
- #1682 - Relaxed the JDK 8 requirement to use WDT encryption. Later versions of JDK 7 have the necessary algorithm
30+
support so now WDT determines at startup whether the underlying JDK supports WDT encryption or not.
31+
- #1682 - Used the values of the `-admin_user` and provided password to populate the `domainInfo:/AdminUserName` and
32+
`domainInfo:/AdminPassword` fields when discovering security provider data.
33+
- #1688 - Enhanced variable tokenization support to include passwords in discovered security provider data.
34+
- #1689 - Added the ability to discover the OPSS wallet when running in online mode.
35+
- #1693 - Changed the `wko`, `wko-dii` (deprecated), and `wko-pv` target values to refer to the latest versions instead
36+
of WebLogic Kubernetes Operator 3 versions. Added `wko3`, `wko3-dii`, and `wko3-pv` to accommodate users that still
37+
require the ability to use these older versions.
38+
- #1697 - Added support for the Prepare Model Tool to preserve any one-way hashed passwords in the model.
39+
- #1700 - Added support for storing XACML policy and role definitions that could not be converted to their original
40+
policy and role expressions as XACML files in the archive file.
2241

2342
#### Bug Fixes
24-
- #1677 - Fixed a bug where creating a user with extra attributes would result in invalid LDIFT entries.
25-
- #1678 - Fixed a bug that was causing errors when deploying a new application and the server required a restart.
26-
- #1679 - Fixed a bug where the SSHJ libraries (that only work with JDK 8 and above) were causing the tools to fail
27-
when running with JDK 7.
28-
- #1680 - Fixed the `DataSourceLogFile` and `WebServerLog` folders default value for the `DateFormatPattern` attribute
29-
for WLS versions prior to 12.2.1 so that they no longer show up in the online discovered model.
30-
- #1681 - Worked around a pre-12.2.1 WLST bug that was preventing the online tools from determining the server's WLS version.
31-
- #1683 - Fixed a bug with the Model Help Tool where our use of JLine libraries (that only work with JDK 8 and above)
32-
were causing the Model Help tool to fail when run with JDK 7.
43+
- #1687 - Fixed a problem with the Discover Domain Tool not properly handling Data Source user names with spaces with
44+
older versions of WebLogic Server.
45+
- #1690 - Fixed a problem with determining the default security realm name that caused it to always be `myrealm`.
46+
- #1692 - Fixed a misleading error message when the model points to an application outside of the archive file that
47+
does not exist.
48+
- #1695 - Fixed an issue where the WebLogic Kubernetes Operator `domain.yaml` was including a placeholder for the
49+
`domainHome` attribute in all cases so that the WebLogic Image Tool could populate it when creating the image.
50+
This was occurring even in use cases where the WebLogic Image Tool did not have this information. WDT no longer does
51+
this and will only include the `domainHome` in the case where the user has specified it on the command line.
52+
- #1698 - Fixed issues with the new messages related to the security provider data discovery features.
53+
- #1701 - Moved the TestSummaryHandler logging class out of the installer since it is only meant for supporting unit tests.
54+
- #1702 - Fixed a bug in deployment plan discovery for exploded applications.
55+
- #1703 - Fixed a bug in discovery of `domainBin` scripts.
56+
- #1705 - Added missing validation for the `WLSUserPasswordCredentialMappings` section.
57+
- #1706 - Fixed a validation bug that was causing lax validation to fail when archive entries were missing.
58+
- #1707 - Fixed a bug in the handling of the `ActiveContextHandlerEntry` attribute of an `Auditor` security provider.
3359

3460
#### Known Issues
3561
- SSH support requires a reasonably recent version of Bouncy Castle. WDT picks up Bouncy Castle from WLST so, for example,
@@ -41,7 +67,7 @@ None
4167
1. WLSDPLY-20008: verifySSH argument processing failed: Failed to initialize SSH context: Failed to SSH connect to host myhost.oracle.com: no such algorithm: X25519 for provider BC
4268
```
4369

44-
- SSH support for the Update Domain Tool and Deploy Apps Tool do not work when using an archive file and the remote
70+
- SSH support for the Update Domain Tool and Deploy Apps Tool does not work when using an archive file and the remote
4571
WebLogic Server is running on Windows using the optional, Windows-provided, OpenSSH component. This is due to an
4672
issue with the SSHJ library WDT is using. See https://github.com/hierynomus/sshj/issues/929 for more information.
4773

documentation/4.0/content/release-notes/release-4.0.0.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,7 @@ pre = "<b> </b>"
108108
1. WLSDPLY-20008: verifySSH argument processing failed: Failed to initialize SSH context: Failed to SSH connect to host myhost.oracle.com: no such algorithm: X25519 for provider BC
109109
```
110110

111-
- SSH support for the Update Domain Tool and Deploy Apps Tool do not work when using an archive file and the remote
111+
- SSH support for the Update Domain Tool and Deploy Apps Tool does not work when using an archive file and the remote
112112
WebLogic Server is running on Windows using the optional, Windows-provided, OpenSSH component. This is due to an
113113
issue with the SSHJ library WDT is using. See https://github.com/hierynomus/sshj/issues/929 for more information.
114114

documentation/4.0/content/release-notes/release-4.0.1.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ None
4141
1. WLSDPLY-20008: verifySSH argument processing failed: Failed to initialize SSH context: Failed to SSH connect to host myhost.oracle.com: no such algorithm: X25519 for provider BC
4242
```
4343

44-
- SSH support for the Update Domain Tool and Deploy Apps Tool do not work when using an archive file and the remote
44+
- SSH support for the Update Domain Tool and Deploy Apps Tool does not work when using an archive file and the remote
4545
WebLogic Server is running on Windows using the optional, Windows-provided, OpenSSH component. This is due to an
4646
issue with the SSHJ library WDT is using. See https://github.com/hierynomus/sshj/issues/929 for more information.
4747

documentation/4.0/content/release-notes/release-4.1.0.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ None
3232
1. WLSDPLY-20008: verifySSH argument processing failed: Failed to initialize SSH context: Failed to SSH connect to host myhost.oracle.com: no such algorithm: X25519 for provider BC
3333
```
3434

35-
- SSH support for the Update Domain Tool and Deploy Apps Tool do not work when using an archive file and the remote
35+
- SSH support for the Update Domain Tool and Deploy Apps Tool does not work when using an archive file and the remote
3636
WebLogic Server is running on Windows using the optional, Windows-provided, OpenSSH component. This is due to an
3737
issue with the SSHJ library WDT is using. See https://github.com/hierynomus/sshj/issues/929 for more information.
3838

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
+++
2+
title = "Release 4.1.1"
3+
date = 2024-01-09T18:27:38-05:00
4+
weight = 71
5+
pre = "<b> </b>"
6+
+++
7+
8+
9+
### Changes in Release 4.1.1
10+
- [Major New Features](#major-new-features)
11+
- [Other Changes](#other-changes)
12+
- [Bugs Fixes](#bug-fixes)
13+
- [Known Issues](#known-issues)
14+
15+
16+
#### Major New Features
17+
None
18+
19+
#### Other Changes
20+
- #1685 - Filtered out the default `OptionalFeatures` folders when they have no attributes so that they do not show up
21+
in the online discovered model.
22+
23+
#### Bug Fixes
24+
- #1677 - Fixed a bug where creating a user with extra attributes would result in invalid LDIFT entries.
25+
- #1678 - Fixed a bug that was causing errors when deploying a new application and the server required a restart.
26+
- #1679 - Fixed a bug where the SSHJ libraries (that only work with JDK 8 and later) were causing the tools to fail
27+
when running with JDK 7.
28+
- #1680 - Fixed the `DataSourceLogFile` and `WebServerLog` folders default value for the `DateFormatPattern` attribute
29+
for WLS versions prior to 12.2.1 so that they no longer show up in the online discovered model.
30+
- #1681 - Worked around a pre-12.2.1 WLST bug that was preventing the online tools from determining the server's WLS version.
31+
- #1683 - Fixed a bug with the Model Help Tool where our use of JLine libraries (that only work with JDK 8 and later)
32+
were causing the Model Help tool to fail when run with JDK 7.
33+
34+
#### Known Issues
35+
- SSH support requires a reasonably recent version of Bouncy Castle. WDT picks up Bouncy Castle from WLST so, for example,
36+
the 12.2.1.4.0 GA release fails with the following error, as mentioned at https://github.com/hierynomus/sshj/issues/895.
37+
Applying a recent PSU should resolve the issue for 12.2.1.4 and 14.1.1.
38+
39+
```shell
40+
SEVERE Messages:
41+
1. WLSDPLY-20008: verifySSH argument processing failed: Failed to initialize SSH context: Failed to SSH connect to host myhost.oracle.com: no such algorithm: X25519 for provider BC
42+
```
43+
44+
- SSH support for the Update Domain Tool and Deploy Apps Tool does not work when using an archive file and the remote
45+
WebLogic Server is running on Windows using the optional, Windows-provided, OpenSSH component. This is due to an
46+
issue with the SSHJ library WDT is using. See https://github.com/hierynomus/sshj/issues/929 for more information.
47+
48+
See https://oracle.github.io/weblogic-deploy-tooling/userguide/limitations/limitations/ for the current set of known limitations.

documentation/4.0/content/userguide/install.md

Lines changed: 26 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -10,33 +10,39 @@ weight: 1
1010
The WebLogic Deploy Tooling project repository is located at [`https://github.com/oracle/weblogic-deploy-tooling`](https://github.com/oracle/weblogic-deploy-tooling).
1111
You can download binary distributions of the `weblogic-deploy.zip` installer from the [GitHub Releases page](https://github.com/oracle/weblogic-deploy-tooling/releases).
1212

13-
1. To install the software, simply unzip the `weblogic-deploy.zip` installer on a machine that has the desired versions of WebLogic Server installed.
14-
1. After being unzipped, the software is ready to use, just set the `JAVA_HOME` environment variable to point to a Java 7 or higher JDK and the shell scripts are ready to run.
13+
1. To install the software, simply unzip the `weblogic-deploy.zip` installer on a machine that has the desired versions
14+
of WebLogic Server installed.
15+
2. After being unzipped, the software is ready to use, just set the `JAVA_HOME` environment variable to point to a
16+
Java 7 or higher JDK and the shell scripts are ready to run.
1517

1618
#### Supported WLS versions
1719

18-
The following table specifies the supported WebLogic Server versions, along with the JDK versions, that must be used to run the WDT tool. You must set the `JAVA_HOME` environment variable to specify a JDK version different from the system default version.
20+
The following table specifies the supported WebLogic Server versions, along with the JDK versions, that must be used to
21+
run the WDT tool. You must set the `JAVA_HOME` environment variable to specify a JDK version different from the system
22+
default version.
1923

20-
To create a domain with the proper JDK (particularly if the `JAVA_HOME` is different from the one which will be used by the target domain), set the domain `JavaHome` attribute in the domain model.
24+
To create a domain with the proper JDK (particularly if the `JAVA_HOME` is different from the one which will be used
25+
by the target domain), set the domain `JavaHome` attribute in the domain model.
2126

22-
{{% notice note %}} The Encryption Model Tool used to encrypt and decrypt clear-text passwords in the model and variable files, requires WDT to run with a minimum JDK version of 1.8.
27+
{{% notice note %}} The Encryption Model Tool used to encrypt and decrypt clear-text passwords in the model and variable
28+
files, requires WDT to run with JDK version that supports the necessary encryption algorithms. This means later
29+
versions of JDK 7 and all versions of JDK 8 and 11.
2330
{{% /notice %}}
2431

25-
| WebLogic Server Version | Tool JDK Version |
26-
|--------------------------|-------------------|
27-
| 10.3.6 | 1.7 |
28-
| 12.1.1 | 1.7, 1.8 |
29-
| 12.1.2 <sup>[1]</sup><sup>[2]</sup> | 1.7, 1.8 |
30-
| 12.1.3 | 1.7, 1.8 |
31-
| 12.2.1 <sup>[3]</sup> | 1.8 |
32-
| 12.2.1.1 <sup>[4]</sup> | 1.8 |
33-
| 12.2.1.2 | 1.8 |
34-
| 12.2.1.3 | 1.8 |
35-
| 12.2.1.4 <sup>[5]</sup> | 1.8 |
36-
| 14.1.1 | 1.8, 1.11 |
32+
| WebLogic Server Version | Tool JDK Version |
33+
|-------------------------------------|-------------------|
34+
| 10.3.6 | 1.7 |
35+
| 12.1.1 | 1.7, 1.8 |
36+
| 12.1.2 <sup>[1]</sup><sup>[2]</sup> | 1.7, 1.8 |
37+
| 12.1.3 | 1.7, 1.8 |
38+
| 12.2.1 | 1.8 |
39+
| 12.2.1.1 <sup>[3]</sup> | 1.8 |
40+
| 12.2.1.2 | 1.8 |
41+
| 12.2.1.3 | 1.8 |
42+
| 12.2.1.4 <sup>[4]</sup> | 1.8 |
43+
| 14.1.1 | 1.8, 1.11 |
3744

3845
***1*** First release dynamic clusters are supported
3946
***2*** First release Coherence clusters are supported
40-
***3*** First release WLS roles are supported
41-
***4*** First release multitenancy is supported
42-
***5*** Last release multitenancy is supported
47+
***3*** First release multitenancy is supported
48+
***4*** Last release multitenancy is supported

0 commit comments

Comments
 (0)