DXL Broker has two components:
- DXL Broker
All DXL client communications go through the DXL Brokers. Think of them like a router in your home works.
- DXL Broker Integration Pattern Engine (IPE)
- The IPE is a new component of the DXL Broker that allows extending the DXL Broker functionality.
- Integration with ePolicy Orchestrator (ePO) extensions can register Patterns with DXL that are enforced on designated DXL Brokers.
- These Patterns can be transformations on the same fabric or bridges to other networks.
How to enable Windows DXL Broker debug logging:
DXL Windows Broker Service:
Background details
- Service name: McAfee DXL Broker
- Process name: dxlbroker.exe
- Log name: dxlbroker.log
- Log path: C:\programdata\McAfee\dxlbroker\logs\dxlbroker.log
To enable debug logging in the dxlbroker.log file:
- Edit the file name dxlbroker.conf.defaults.
NOTE: The file path is C:\programdata\McAfee\dxlbroker\dxlbroker.conf.defaults
- Scroll down to the line below:
# The broker logging level: error, warn, info, or debug
Default value is: logLevel=info
- Change the document content to the following:
# The broker logging level: error, warn, info, or debug
logLevel=debug
- Restart the McAfee DXL broker service.
NOTE: After the issue is reproduced and the logs are collected, revert the logLevel to Info.
How to enable DXL Windows IPE Service debug logging:
Background details:
- Service name: McAfee DXL IPE
- Process name: dxlipe.exe
- Log name: ipe.log
- Log path: C:\programdata\McAfee\dxlbroker\logs\ipe.log
Enable debug logging for
ipe.log on
Windows DXL Broker and DXL version
6.0.0 HF4 (6.0.0.280) or earlier:
- Edit the file name log4j.properties.
NOTE: The file path for log4j is C:\Program Files\McAfee\dxlbroker\ipe\conf\log4j.properties
- Implement the changes highlighted below:
log4j.rootLogger=debug,file
#File appender
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=C:/ProgramData/McAfee/dxlbroker/logs/ipe.log
log4j.appender.file.MaxFileSize=20MB
log4j.appender.file.MaxBackupIndex=9
- Restart McAfee DXL IPE service.
Enable debug logging for
ipe.log on
Windows DXL broker and DXL version
6.0.0 HF5 (6.0.0.301) or later:
- Edit the file name log4j2.properties.
NOTE: The file path for log4j2 is C:\Program Files\McAfee\dxlbroker\ipe\conf\log4j2.properties
- Implement the changes highlighted below:
appender.rolling.policies.size.size=20MB
appender.rolling.strategy.max=9
rootLogger.level=debug
- Restart McAfee DXL IPE service.
NOTE: If the file log4j2.properties with first line contains string status=warn, this isn't for enabling debug.
How to enable Linux DXL Broker logging:
DXL Linux Broker Service:
Background details:
- Service name: dxlbroker
- Log name: dxlbroker.log
- Log path: /var/McAfee/dxlbroker/logs/dxlbroker.log
To enable debug logging in Linux broker for log file dxlbroker.log:
- Connect to the DXL broker with the root user and password.
- Open the dxlbroker.conf.defaults file. Type the following command and press Enter:
vi /opt/McAfee/dxlbroker/conf/dxlbroker.conf.defaults
- Scroll down to the line below:
# The broker logging level: error, warn, info, or debug
Default value is logLevel=info
- Change the document content as below. Press the insert button to modify the content:
# The broker logging level: error, warn, info, or debug
logLevel=debug
- Save the file. Type ESC :wq
- Restart the dxlbroker service. Type the following command and press Enter:
sudo service dxlbroker restart
NOTE: After the issue is reproduced and the logs are collected, revert the logLevel to Info.
How to enable DXL Linux IPE debug logging:
Background details:
- Service name: dxlbroker
- Log name: ipe.log
- Log path: /var/McAfee/dxlbroker/logs/ipe.log
Enable debug logging for ipe.log on Linux DXL Broker and DXL version 6.0.0 HF4 (6.0.0.280) or earlier:
- Connect to the DXL Bbroker with the root user and password.
- Open the log4j.properties file. Type the following command and press Enter:
vi /opt/McAfee/dxlbroker/ipe/conf/log4j.properties
- Implement the changes highlighted below. Press the insert button to modify the content:
log4j.rootLogger=debug,file
log4j.appender.file.MaxFileSize=20MB
log4j.appender.file.MaxBackupIndex=9
NOTE: After the issue is reproduced and the logs are collected, revert the logLevel to Info.
- Save the file. Type ESC :wq
- Restart the dxlbroker service. Type the following command and press Enter:
sudo service dxlbroker restart
Enable debug logging for ipe.log on Linux DXL Broker and DXL version 6.0.0 HF5 (6.0.0.301) or later:
- Connect to the DXL broker with the root user and password.
- Open the log4j2.properties file. Type the following command and press Enter:
vi /opt/McAfee/dxlbroker/ipe/conf/log4j2.properties
- Implement the changes highlighted below. Press the insert button to modify the content:
appender.rolling.policies.size.size=20MB
appender.rolling.strategy.max=9
rootLogger.level=debug
NOTE: After the issue is reproduced and the logs are collected, revert the logLevel to Info.
- Save the file. Type ESC :wq
- Restart the dxlbroker service. Type the following command and press Enter:
sudo service dxlbroker restart
