You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/1.9/content/_index.md
+3-4Lines changed: 3 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -52,7 +52,9 @@ This documentation includes sections targeted to different audiences:
52
52
*[Concepts]({{< relref "/concepts/" >}}) explains the underlying metadata models and archive files.
53
53
* The [User Guide]({{< relref "/userguide/" >}}) contains detailed usage information, including how to install and configure WebLogic Deploy Tooling, and how to use each tool.
54
54
* The [Samples]({{< relref "/samples/" >}}) provide informative use case scenarios.
55
-
* The [Developer Guide]({{< relref "/developer/" >}}) provides details for people who want to understand how WDT is built, its features mapped and implemented.
55
+
* The [Developer Guide]({{< relref "/developer/" >}}) provides details for people who
56
+
want to understand how WDT is built, its features mapped and implemented. Those who
57
+
wish to contribute to the WebLogic Deploy Tooling code will find useful information [here]({{< relref "/developer/contribute.md" >}}).
56
58
57
59
### Related projects
58
60
@@ -61,6 +63,3 @@ This documentation includes sections targeted to different audiences:
Those who wish to contribute to the WebLogic Deploy Tooling code will find useful information [here](https://github.com/oracle/weblogic-deploy-tooling/blob/master/CONTRIBUTING.md).
Copy file name to clipboardExpand all lines: documentation/1.9/content/concepts/archive.md
+11-7Lines changed: 11 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,13 @@ The directory where the model is optionally located. Only one model file, either
47
47
The directory where a wallet can be stored for use with Oracle Platform Security Services. The file resource name is not specified in the model, and is assumed to be a single ZIP file in the archive at this location.
48
48
49
49
#### `wlsdeploy/applications`
50
-
The root directory under which applications are stored. Applications can be stored in the archive as EAR or WAR files, or expanded* under this folder. A sample expanded WAR application might have these entries:
50
+
The root directory under which applications are stored. Applications can be stored in the archive as EAR or WAR files, or expanded under this folder.
51
+
52
+
{{% notice note %}} Expanded application directories are supported after WebLogic Deploy Tooling release 1.6.2.
53
+
{{% /notice %}}
54
+
55
+
A sample expanded WAR application might have these entries:
\* Expanded application directories are supported after WebLogic Deploy Tooling release 1.6.2
60
-
61
65
#### `wlsdeploy/classpathLibraries`
62
66
The root directory under which JARs/directories used for server classpaths are stored. Every file resource under this directory is extracted, even those not referenced in the model.
63
67
64
68
#### `wlsdeploy/coherence`
65
69
The root directory under which empty directories must exist for Coherence persistent stores.
66
70
67
71
#### `wlsdeploy/domainBin`
68
-
The root directory under which $DOMAIN_HOME/bin scripts are stored. Only scripts referenced in the `domainInfo/domainBin` section of the model are extracted.
72
+
The root directory under which `$DOMAIN_HOME/bin` scripts are stored. Only scripts referenced in the `domainInfo/domainBin` section of the model are extracted.
69
73
70
74
#### `wlsdeploy/domainLibraries`
71
75
The root directory under which `$DOMAIN_HOME/lib` libraries are stored. Only libraries referenced in the `domainInfo/domainLibraries` section of the model are extracted.
72
76
73
77
#### `wlsdeploy/nodeManager`
74
-
The root directory under which node manager file resources, such as keystore files, are stored.
78
+
The root directory under which Node Manager file resources, such as keystore files, are stored.
75
79
76
80
#### `wlsdeploy/scripts`
77
81
The root directory under which scripts are stored. These can include JDBC create scripts, and WLDF action scripts.
78
82
79
83
#### `wlsdeploy/servers`
80
-
The root directory under which server files, such as keystore files, are stored. These are organized by server name, such as `wlsdeploy/server/my-server/mykey.jks`
84
+
The root directory under which server files, such as keystore files, are stored. These are organized by server name, such as `wlsdeploy/server/my-server/mykey.jks`.
81
85
82
86
#### `wlsdeploy/sharedLibraries`
83
87
The root directory under which shared libraries are stored. These are stored as JAR files within the archive.
@@ -89,7 +93,7 @@ The root directory under which empty directories must exist for `FileStore` elem
89
93
90
94
The Create Domain, Update Domain, Deploy Applications, and Validate Model Tools allow the specification of multiple archive files on the command line. For example:
Copy file name to clipboardExpand all lines: documentation/1.9/content/concepts/model.md
+4-3Lines changed: 4 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -172,7 +172,8 @@ The second method for locating the Kubernetes secret file is to use the environm
172
172
```
173
173
If the `<name>` value has a corresponding mapped directory in `WDT_MODEL_SECRETS_NAME_DIR_PAIRS`, then that directory will take precedence over any roots specified in `WDT_MODEL_SECRETS_DIRS`.
174
174
175
-
NOTE: It is important that the secrets directories contain only secrets files, because those files are examined to create a list of available name/key pairs.
175
+
{{% notice note %}} It is important that the secrets directories contain only secrets files, because those files are examined to create a list of available name/key pairs.
176
+
{{% /notice %}}
176
177
177
178
**Path tokens** are tokens that reference known values, and can be used to make the model more portable. For example, a model may reference a WebLogic library source path as:
178
179
```yaml
@@ -259,13 +260,13 @@ This feature can also remove items that were created by WebLogic Server template
259
260
260
261
This feature does not apply to named security providers within a realm. These items follow a special set of rules that are required to maintain their ordering. See [Modeling security providers]({{< relref "/samples/securityproviders-model.md" >}}) for detailed information.
261
262
262
-
This feature cannot be use to un-deploy applications or remove libraries.
263
+
This feature cannot be use to undeploy applications or remove libraries.
263
264
264
265
### Using multiple models
265
266
266
267
The Create Domain, Update Domain, Deploy Applications, and Validate Model Tools allow the specification of multiple models on the command line. For example:
In this case, the models are merged into a single model before being applied. Each successive model is added to the previous model. In cases where entities exist in both models, the attributes are combined and attribute values from successive models prevail. The resulting model is then verified before being applied.
This will build the entire project and run the unit tests. Omit the `-Dunit-test-wlst-dir=` argument if you have created a `maven.config` file, as described above.
37
37
@@ -40,6 +40,6 @@ the -D setting will take precedence.
40
40
41
41
If you are not making changes and are only interested in building the latest version, then you can skip the unit tests, using this command line:
42
42
43
-
`mvn -DskipTests clean install`
43
+
`$ mvn -DskipTests clean install`
44
44
45
45
The resulting installer ZIP file built is under the `WLSDEPLOY_HOME/installer/target` directory.
Oracle welcomes contributions to this repository from anyone.
9
+
10
+
If you want to submit a pull request to fix a bug or enhance an existing feature,
11
+
first open an issue and link to that issue when you submit your pull request.
12
+
13
+
If you have any questions about a possible submission, feel free to open an issue too.
14
+
15
+
### Contributing to the WebLogic Deploy repository
16
+
Pull requests can be made under [The Oracle Contributor Agreement](https://www.oracle.com/technetwork/community/oca-486395.html) (OCA).
17
+
18
+
For pull requests to be accepted, the bottom of your commit message must have the following line using your name and e-mail address as it appears in the OCA Signatories list.
19
+
20
+
Signed-off-by: Your Name <you@example.org>
21
+
22
+
This can be automatically added to pull requests by committing with:
23
+
24
+
$ git commit --signoff
25
+
26
+
Only pull requests from committers that can be verified as having signed the OCA can be accepted.
27
+
28
+
### Pull request process
29
+
30
+
1. Fork this repository.
31
+
2. Create a branch in your fork to implement the changes. We recommend using the issue number as part of your branch name, for example, 1234-fixes.
32
+
3. Ensure that any documentation is updated with the changes that are required by your fix.
33
+
4. Ensure that any samples are updated if the base image has been changed.
34
+
5. Squash your branch changes into a single commit.
35
+
6. Submit the pull request.
36
+
37
+
a. Do not leave the pull request blank.
38
+
39
+
b. Explain exactly what your changes are meant to do and provide simple steps on how to validate your changes.
40
+
41
+
c. Ensure that you reference the issue you created as well.
42
+
43
+
7. We will assign someone to review the pull request before it is merged.
There are additional sub-folders and attributes available for more configuration options. These can be determined using the [Model Help Tool]({{< relref "/userguide/tools/model_help.md" >}}). For example, this command will list the attributes and sub-folders for the `Server` folder:
For this sample, the machine named `machine-1` and the data source named `jdbc-1` should be defined elsewhere within this model, or should already exist in a domain that is being updated.
Copy file name to clipboardExpand all lines: documentation/1.9/content/samples/jdbc-model.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,8 +31,8 @@ resources:
31
31
Value: scott
32
32
```
33
33
There are additional sub-folders and attributes available for more configuration options. These can be determined using the [Model Help Tool]({{< relref "/userguide/tools/model_help.md" >}}). For example, this command will list the attributes and sub-folders for the `JDBCSystemResource/JdbcResource` folder:
For this sample, the target cluster `cluster-1` should be defined elsewhere within this model, or should already exist in a domain that is being updated.
Copy file name to clipboardExpand all lines: documentation/1.9/content/samples/odl-model.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ description: "A model for configuring Oracle Diagnostic Logging (ODL)."
7
7
---
8
8
9
9
10
-
Oracle Diagnostic Logging (ODL) can be configured and updated with Create Domain, Update Domain, and Deploy Applications Tool, starting with WDT release 1.5.2.
10
+
Oracle Diagnostic Logging (ODL) can be configured and updated with Create Domain, Update Domain, and Deploy Applications Tools, starting with WDT release 1.5.2.
11
11
ODL configuration is supported only for offline mode in WDT. ODL configuration is not added when a model is created using the Discover Domain Tool.
12
12
This example shows how some common configuration elements can be represented in the model.
Copy file name to clipboardExpand all lines: documentation/1.9/content/samples/ohs-model.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ weight: 9
6
6
description: "A model for configuring Oracle HTTP Server (OHS)."
7
7
---
8
8
9
-
Starting with WDT 1.8.0, you can configure and update Oracle HTTP Server (OHS) using the Create Domain, Update Domain, and Deploy Applications Tool, in offline mode only. To discover the OHS configuration, use the Discover Domain Tool, in offline mode only.
9
+
Starting with WDT 1.8.0, you can configure and update Oracle HTTP Server (OHS) using the Create Domain, Update Domain, and Deploy Applications Tools, in offline mode only. To discover the OHS configuration, use the Discover Domain Tool, in offline mode only.
10
10
11
11
#### Prerequisites
12
12
@@ -24,7 +24,7 @@ The revised value would be:
24
24
```
25
25
The file name of this new domain type (without the `.json` extension) is used with the `-domain_type` argument on the WDT command line. For example, the command line to create a domain using the `HttpServer.json` file from the previous steps would look like:
@@ -50,6 +50,6 @@ Each name under the `OHS` folder must match a name under the `SystemComponent` f
50
50
The `ComponentType` field of the `SystemComponent` element must be set to `OHS` in order to allow configuration of the corresponding `OHS` folders.
51
51
52
52
You can use the [Model Help Tool]({{< relref "/userguide/tools/model_help.md" >}}) to determine the complete list of folders and attributes that can be used in these sections of the model. For example, this command will list the attributes in the `OHS` folder:
0 commit comments