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: docs-source/content/userguide/managing-domains/configoverrides/_index.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -188,17 +188,17 @@ The secret macro `SECRETNAME` field must reference the name of a Kubernetes secr
188
188
189
189
* Reference the name of the current bean and each parent bean in any hierarchy you override.
190
190
* Note that the `combine-mode` verbs (`add` and `replace`) should be omitted for beans that are already defined in your original domain home configuration.
191
-
* See [Override template samples](#override-template-samples) for examples.
191
+
* See [Override template samples](#override-template-samples) for examples.
192
192
* Use situational config `replace` and `add` verbs as follows:
193
193
* If you are adding a new bean that doesn't already exist in your original domain home `config.xml`, then specify `add` on the MBean itself and on each attribute within the bean.
194
-
* See the `server-debug` stanza in [Override template samples](#override-template-samples) for an example.
194
+
* See the `server-debug` stanza in [Override template samples](#override-template-samples) for an example.
195
195
* If you are adding a new attribute to an existing bean in the domain home `config.xml`, then the attribute needs an `add` verb.
196
-
* See the `max-message-size` stanza in [Override template samples](#override-template-samples) for an example.
196
+
* See the `max-message-size` stanza in [Override template samples](#override-template-samples) for an example.
197
197
* If you are changing the value of an existing attribute within a domain home `config.xml`, then the attribute needs a `replace` verb.
198
198
* See the `public-address` stanza in [Override template samples](#override-template-samples) for an example.
199
199
* When overriding `config.xml`:
200
200
* The XML namespace (`xmlns:` in the XML) must be exactly as specified in [Override template schemas](#override-template-schemas).
201
-
* For example, use `d:` to reference `config.xml` beans and attributes, `f:` for `add` and `replace``domain-fragment` verbs, and `s:` to reference the situational configuration schema.
201
+
* For example, use `d:` to reference `config.xml` beans and attributes, `f:` for `add` and `replace``domain-fragment` verbs, and `s:` to reference the situational configuration schema.
202
202
* Avoid specifying the domain name stanza, as this may cause some overrides to be ignored (for example, server-template scoped overrides).
203
203
* When overriding modules:
204
204
* It is a best practice to use XML namespace abbreviations `jms:`, `jdbc:`, and `wldf:` respectively for JMS, JDBC, and WLDF (diagnostics) module override files.
@@ -269,7 +269,7 @@ The following `jdbc-testDS.xml` override template demonstrates setting the URL,
269
269
* Create a directory containing (A) a set of situational configuration templates for overriding the MBean properties you want to replace and (B) a `version.txt` file.
270
270
* This directory must not contain any other files.
271
271
* The `version.txt` file must contain exactly the string `2.0`.
272
-
* Note: This version.txt file must stay `2.0` even when you are updating your templates from a previous deployment.
272
+
* Note: This version.txt file must stay `2.0` even when you are updating your templates from a previous deployment.
273
273
* Templates must not override the settings listed in [Unsupported overrides](#unsupported-overrides).
274
274
* Templates must be formatted and named as per [Override template names and syntax](#override-template-names-and-syntax).
275
275
* Templates can embed macros that reference environment variables or Kubernetes secrets. See [Override template macros](#override-template-macros).
@@ -297,8 +297,8 @@ The following `jdbc-testDS.xml` override template demonstrates setting the URL,
297
297
* Any override changes require stopping all WebLogic pods, applying your domain resource (if it changed), and restarting the WebLogic pods before they can take effect.
298
298
* Custom override changes on an existing running domain, such as updating an override configuration map, a secret, or a domain resource, will not take effect until all running WebLogic Server pods in your domain are shutdown (so no servers are left running), and the domain is subsequently restarted with your new domain resource (if it changed), or with your existing domain resource (if you haven't changed it).
299
299
* To stop all running WebLogic Server pods in your domain, apply a changed resource, and then start/restart the domain:
300
-
* Set your domain resource `serverStartPolicy` to `NEVER`, wait, and apply your latest domain resource with the `serverStartPolicy` restored back to `ALWAYS` or `IF_NEEDED` (See [Starting and stopping servers]({{< relref "/userguide/managing-domains/domain-lifecycle/startup/_index.md#starting-and-stopping-servers" >}}).)
301
-
* Or delete your domain resource, wait, and apply your (potentially changed) domain resource.
300
+
* Set your domain resource `serverStartPolicy` to `NEVER`, wait, and apply your latest domain resource with the `serverStartPolicy` restored back to `ALWAYS` or `IF_NEEDED` (See [Starting and stopping servers]({{< relref "/userguide/managing-domains/domain-lifecycle/startup/_index.md#starting-and-stopping-servers" >}}).)
301
+
* Or delete your domain resource, wait, and apply your (potentially changed) domain resource.
302
302
* See [Debugging](#debugging) for ways to check if the situational configuration is taking effect or if there are errors.
303
303
304
304
Example domain resource YAML:
@@ -329,18 +329,18 @@ Incorrectly formatted override files may be accepted without warnings or errors
329
329
330
330
* If WebLogic pods do not come up at all, then:
331
331
* In the domain's namespace, see if you can find a job named `DOMAIN_UID-introspect-domain-job` and a corresponding pod named something like `DOMAIN_UID-introspect-domain-job-xxxx`. If so, examine:
* This line indicates a situational configuration file has been loaded.
342
-
* If the search yields Warning or Error lines, then the format of the custom situational configuration template is incorrect, and the Warning or Error text should describe the problem.
343
-
* Note: The following exception may show up in your server logs when overriding JDBC modules. It is not expected to affect runtime behavior, and can be ignored (a fix is pending for them):
339
+
* The only WebLogic Server log lines that match should look something like:
* This line indicates a situational configuration file has been loaded.
342
+
* If the search yields Warning or Error lines, then the format of the custom situational configuration template is incorrect, and the Warning or Error text should describe the problem.
343
+
* Note: The following exception may show up in your server logs when overriding JDBC modules. It is not expected to affect runtime behavior, and can be ignored (a fix is pending for them):
344
344
```
345
345
java.lang.NullPointerException
346
346
at weblogic.management.provider.internal.situationalconfig.SituationalConfigManagerImpl.registerListener(SituationalConfigManagerImpl.java:227)
@@ -350,8 +350,8 @@ Incorrectly formatted override files may be accepted without warnings or errors
350
350
...
351
351
```
352
352
* Look in your `DOMAIN_HOME/optconfig` directory.
353
-
* This directory, or a subdirectory within this directory, should contain each of your custom situational configuration files.
354
-
* If it doesn't, then this likely indicates your domain resource `configOverrides` was not set to match your custom override configuration map name, or that your custom override configuration map does not contain your override files.
353
+
* This directory, or a subdirectory within this directory, should contain each of your custom situational configuration files.
354
+
* If it doesn't, then this likely indicates your domain resource `configOverrides` was not set to match your custom override configuration map name, or that your custom override configuration map does not contain your override files.
355
355
356
356
* If you'd like to verify that the situational configuration is taking effect in the WebLogic MBean tree, then one way to do this is to compare the `server config` and `domain config` MBean tree values.
357
357
* The `domain config` value should reflect the original value in your domain home configuration.
0 commit comments