Skip to content

Commit 98f6536

Browse files
committed
update debugging section with failBootOnSiutationalError related info
1 parent 70115bc commit 98f6536

File tree

1 file changed

+13
-0
lines changed
  • docs-source/content/userguide/managing-domains/configoverrides

1 file changed

+13
-0
lines changed

docs-source/content/userguide/managing-domains/configoverrides/_index.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -338,6 +338,11 @@ spec:
338338
339339
Incorrectly formatted override files may be accepted without warnings or errors and will not prevent WebLogic pods from booting. So, it is important to make sure that the template files are correct in a QA environment, otherwise your WebLogic Servers may start even though critically required overrides are failing to take effect.
340340
341+
On WebLogic servers that support the weblogic.SituationalConfig.failBootOnError system property ( Note: it is not supported in WebLogic 12.2.1.3 ),
342+
by default the WebLogic server will fail to boot if any situational configuration files are invalid.
343+
This can be configured by using the `failBootOnSituationalError` attribute in the Domain spec to `false` to start up the WebLogic servers even with
344+
incorrectly formatted override files.
345+
341346
* Make sure you've followed each step in the [Step-by-step guide](#step-by-step-guide).
342347
343348
* If WebLogic pods do not come up at all, then:
@@ -366,6 +371,14 @@ Incorrectly formatted override files may be accepted without warnings or errors
366371
* This directory, or a subdirectory within this directory, should contain each of your custom situational configuration files.
367372
* 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.
368373
374+
* If the Administration Server pod do start but fails to reach ready state:
375+
* Check if there is a message ` WebLogic server failed to start due to missing or invalid situational configuration files` in the Administration Server pod's `kubectl log`
376+
* This suggests that the Administration Server failed to start may be caused by errors found in the a configuration override file.
377+
* Lines containing the String `<Warning>` may be found in the Administration Server pod log to provide more hints.
378+
* For example:
379+
* `<Jun 20, 2019 3:48:45 AM GMT> <Warning> <Management> <BEA-141323> <The situational config file has an invalid format, it is being ignored: XMLSituationalConfigFile[/shared/domains/domain1/optconfig/jdbc/testDS-0527-jdbc-situational-config.xml] because org.xml.sax.SAXParseException; lineNumber: 8; columnNumber: 3; The element type "jdbc:jdbc-driver-params" must be terminated by the matching end-tag "</jdbc:jdbc-driver-params>".`
380+
* The warning message suggests a syntax error is found in the provided configuration override file for the testDS JDBC datasource.
381+
369382
* 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.
370383
* The `domain config` value should reflect the original value in your domain home configuration.
371384
* The `server config` value should reflect the overridden value.

0 commit comments

Comments
 (0)