Logging for Third-Party Components

ActiveMatrix BusinessWorks can use a variety of third-party components. For example, the Apache Tomcat server is used to accept incoming HTTP or SOAP requests or the Arjuna Transaction Service can be used as a transaction manager. Many third-party components can use the standard log4j logging services. ActiveMatrix BusinessWorks provides the bw/<relNum>/lib/log4j.properties file to allow you to configure logging services for third-party components. For more information about log4j, see http://logging.apache.org/log4j/docs/.

The properties defined in bw/<relNum>/lib/log4j.properties are required by the components used by ActiveMatrix BusinessWorks. The supplied log4j.properties file has comments describing property usage. You can alter the properties in this file, if you wish to configure logging for your environment. Do not remove any required properties from this file.

Tip: It is a good idea to create a backup copy of the log4j.properties file before altering it. This allows you to return to the original configuration if your changes result in errors.

To print the location of the log4j configuration file used by log4j, set java.property.log4j.debug property to true.

There can be only one log4j.properties file per Java VM. If you wish to use properties from a different log4j.properties file, you can either add the properties to bw/<relNum>/lib/log4j.properties or you can alter the bwengine.tra file to point to the location of your own log4j.properties file.

If you use your own log4j.properties file, you must include all of the required properties from the file supplied with ActiveMatrix BusinessWorks in your file.