One of the easiest ways to view the traffic traversing the KEMP LoadMaster is to perform a TCP dump. This simple command will capture all of the traffic (or just a specified subset) that is being transmitted and received by the LoadMaster. The results can be examined by analysing the .pcap file with or another packet analyzer.
When using the console to perform the TCP dump, an FTP server that can be reached by the LoadMaster is required in order to retrieve the packet capture files.
The purpose of this document is to educate the reader on how to perform a TCP dump in the KEMP LoadMaster.
This document is intended to be read by anyone who is interested in finding out how to perform a TCP dump in the LoadMaster.
There are two ways to perform a TCP dump in the LoadMaster â€“ via the Web User Interface (WUI), or via the console. Refer to the relevant section below for steps.
To perform a TCP dump via the WUI, follow the steps below:
1. In the main menu, select System Configuration > Logging Options > System Log Files.
2. Click Debug Options.
3. A TCP dump can be captured either by one or all Ethernet ports. In the TCP dump section at the bottom of the screen, select the relevant Interface to run the TCP dump on, or select All.
4. Optionally enter the IP Address and the Port to be monitored.
5. Enter any optional parameters as required in the Options text box.
The maximum number of characters permitted in the Options field is 255.
6. Click Start.
7. Make access from the client to the Virtual Server.
8. When appropriate, click Stop.
9. Click Download.
To perform a TCP dump via the console, follow the steps below:
1. Log in to the console.
2. Select Utilities.
3. Select Diagnostics.
4. Select Diagnostic Shell.
5. Enter the relevant commands at the % prompt, for example:
tcpdump â€“s 1500 â€“c 10000 â€“i eth0 â€“w eth0.pcap FILTER0 &
If performing a TCP dump on a two-armed device, ensure to enter the ampersand (&) at the end of the command and also use the command below.
tcpdump â€“s 1500 â€“c 10000 â€“i eth1 â€“w eth1.pcap FILTER1
6. Please select the appropriate filter for FILTER0 and FILTER1:
a) Host 220.127.116.11
b) Port 1234
c) Host 18.104.22.168 and port 1234
7. For example, a complete TCP dump command might look like this:
tcpdump â€“s 1500 â€“c 10000 â€“i eth0 â€“w eth0.pcap host 22.214.171.124 and port 80
8. This will capture all traffic to or from IP 126.96.36.199 with a source or destination port of 80.
As the example command above is set to quit after 10,000 packets, the capture may need to be restarted if the situation in question does not occur within the first 10,000 packets captured, i.e. in the case of heavy load.
9. Make access from the client to the Virtual Server to produce the error.
10. Return to the diagnostic shell.
11. Stop the packet capture by holding Ctrl on the keyboard and pressing C.
12. If running a TCP dump on a two-armed setup, enter the command fg. The second trace will appear. Stop the second packet capture by holding Ctrl on the keyboard and pressing C.
13. Connect to the FTP server and send the file by entering the command:
ftp <FTP IP address>
14. Enter credentials (this depends on the FTP server).
15. Then, enter the following commands:
put eth1.pcap (if running a packet tract on a two-armed configuration)
17. Use the exit command to exit the Diagnostic Shell.
If instructed by a KEMP Support Engineer, you can send them the packet trace file for analysis. Before sending the packet capture, please open it using a relevant tool, for example , to ensure both the quality of the data and the integrity of the file.
Please keep in mind any security implications of sending the packet capture.
If an error occurs which notifies of a damaged or corrupt file, it is likely that the file was not transferred in binary mode. Repeat Step 13 in the Perform a TCP Dump via the Console section and ensure to issue the binary command before transferring.
Web User Interface (WUI), Configuration Guide
This document was last updated on 06 November 2017.