| Summary: | BRMS User Guide - describe how STDOUT messages can be redirected to the AS FILE appender | ||
|---|---|---|---|
| Product: | [JBoss] JBoss Enterprise BRMS Platform 5 | Reporter: | Tihomir Surdilovic <tsurdilo> |
| Component: | Documentation | Assignee: | Dana Mison <dmison> |
| Status: | CLOSED NEXTRELEASE | QA Contact: | |
| Severity: | unspecified | Docs Contact: | |
| Priority: | high | ||
| Version: | 5.0.1 | ||
| Target Milestone: | --- | ||
| Target Release: | 5.0.2 | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| URL: | http://jira.jboss.org/jira/browse/BRMS-262 | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2010-03-26 19:04:32 UTC | Type: | Feature Request |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
|
Description
Tihomir Surdilovic
2010-03-11 19:04:39 UTC
Summary for clarification: * The BRMS WAR has its own log config that directs all output to STDOUT * The default JBoss log config directs STDOUT to the console * This configuration change is to direct STDOUT to the server logs instead. This doesn't occur when deployed on EAP 4.3.CP07 with the production profile. It does occur with the "default" profile. Added to BRMS User Guide, created new Logging section with following content:
The JBoss Enterprise BRMS Platform web application uses log4j for logging.
The configuration included in the WAR, WEB-INF/classes/log4j.xml, sends all messages to STDOUT. When deployed on the JBoss Enterprise Application Platform where these messages are displayed depends on the server profile. When using the production profile, the log messages are appended to the server log file, $PROFILE/log/server.log. When deployed on the default server profile, the log messages are displayed on the server console.
To change the logging behavior, edit the log4j configuration file for the server profile, jboss-as/server/$PROFILE/conf/jboss-log4j.xml
Adding the following XML to the log4j configuration of the default server profile will create a new category that directs the STDOUT
messages to server log file.
<category name="STDOUT" additivity="false">
<priority value="INFO" />
<appender-ref ref="FILE"/>
</category>
Refer to the JBoss Enterprise Application Platform documentation for additional logging configuration information.
Is this content accurate and adequate ? Any suggestions ? Darrin, this is really good. Thanks! Content has been verified. I'm not really happy with the language in the "what happens in each profile" paragraph, I'll make a note to take another look at it before release if there is time. Added to 5.0.2 release notes as a resolved issue: BRMS-262 A new section (2.7) has been added to the BRMS User Guide to provide some guidance on alternative logging configurations. |