IBM Support

IBM WebSphere Edge Load Balancer for IPv4 and IPv6 Data Collection Tool

Troubleshooting


Problem

The Load Balancer problem determination tool (lbpd) is used to assist with data collection of critical information needed by IBM® support to aid in problem resolution. The lbpd software is available in levels 8.5.5.12, 9.0.0.4, and higher.
What does the tool collect?
  • The tool gathers operating system-specific information such as adapter configuration and Ethernet statistics.
  • Various load balancer commands are executed to collect current runtime information such as configuration reports and statistics.
  • It also collects installation information, and where possible, it gathers any operating system level messaging and try to handle core dumps.
Download the current version:
The lbpd tool is periodically updated. The most recent version of the tool is provided for download. There is no dependency on the installed Load Balancer level.
  1. Download the specific version of the tool for your operating system. If necessary, rename the file to the file name shown in the download link.
  2. Place the tool in the [IBMULB_root]/servers/bin directory.
  3. Set execution permission if necessary
  4. Start data collection by using the run command provided.
Windows:
AIX:
  • Download:  lbpd-aix.sh    [version: 10.31.2023]
  • Execute command: ./lbpd-aix.sh
  • If an error occurs running the command, see note[1].
Linux:
  • Download: lbpd-linux.sh     [version: 10.31.2023]
  • Execute command: ./lbpd-linux.sh
  • If an error occurs running the command, see note[1].
How do I use the tool?
  1. Open a command prompt with root privileges and navigate to your [IBMULB_root]/servers/bin directory.
  2. Type in the following: lbpd
  3. The tool asks questions about your problem and your configuration in order to collect the necessary information.
  4. After completion, a new directory is created: [IBMULB_root]/PD. All the information collected is listed in this directory along with a bundled file, lbpmr.jar, to provide to IBM®.
Provide the lbpmr.jar file to IBM® support for any load balancer problem.
If the problem involves trouble forwarding traffic to servers, download the appropriate server collection tool based on the server operating system and provide data from the servers as well as the load balancer.
Note[1] - The end of line character can be corrupted during download or file movement. On unix systems, if an error occurs indicating "Wrong interpreter", "No such file", or contains "^M" in the message, the end of line character is likely corrupted.  There are several ways to correct the problem:
  • Edit the file with vi editor. Positioned at the start of the file, press the Esc key and enter:  
    :%s/^V^M//g
!wq
    Where ^V is the Ctrl key + V pressed at the same time; ^M is the Ctrl key + M pressed at the same time.  
  • Edit the file with the vim editor. Positioned at the start of the file, press the Esc key and enter:  
    :set ff=unix
!wq
  • Download and use the dos2unix program to correct the line endings.
  • Use the sed editor to correct the line end character with the command:  
    sed -i -e 's/\r$//' filename.sh

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSEQTP","label":"WebSphere Application Server"},"ARM Category":[{"code":"a8m50000000CdIqAAK","label":"IBM Edge Load Balancer"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.5.0;8.5.5;9.0.0;9.0.5"}]

Document Information

Modified date:
31 October 2023

UID

swg22001538

Page Feedback