Recording TCP traffic
The HCL OneTest HTTP/TCP Proxy, enables HCL OneTest™ API to record general TCP traffic that is routed through the proxy or to route TCP traffic to stubs automatically when they start instead of routing traffic through the live system.
Before you begin
- In HCL OneTest™ API, create the required physical TCP server
resource and logical TCP connection in your project. Completing this
task enables HCL OneTest™ API to connect to the physical TCP server
and to record logical resources.Note: In the Recording tab of the TCP Server window, click External Proxy Server in the Recording Mode list.
- Ensure that your HCL OneTest™ API project is connected to a
valid instance of HCL Quality Server. Completing this task enables HCL OneTest™ API to issue
commands to the HTTP/TCP proxy.Note: To ensure that the connection is working correctly, click Project > Project Settings on the menu bar, click the Server Settings tab on the Project Settings window, and verify that a green checkmark icon is displayed next to the URL field on the HCL Quality Server area of the tab. If there is no URL displayed or if there is a red cross icon next to the URL field, contact your HCL OneTest™ API project administrator.
- Ensure that a domain is selected on the Server Settings tab
on the Project Settings window. If there are
no domains, a domain must be created by a HCL Quality Server administrator.
Recording occurs within a domain and the HTTP/TCP proxy can be registered
with all domains or a single domain in the HCL Quality Server instance
that you are using. Therefore, selecting a domain in HCL OneTest™ API
enables the application to record TCP transport traffic.Note: If you are using HCL Quality Server 8.5.1.1 or later and domain-level security is enabled, you can connect only to domains to which you have been granted access.
- Install and configure the HTTP/TCP proxy and ensure that the host name and port number of the proxy are entered under Port Forwarding Proxy in the Client tab of the TCP Server window. Completing this task enables HCL OneTest™ API to record TCP transport traffic.
About this task
The HCL OneTest™ API HTTP/TCP proxy supports any data that are sent over TCP/IP but it also supports richer functionality if the messages that are being sent are Financial Information eXchange (FIX) protocol messages.
This additional support enables content-based routing, that is, routing messages by deriving a destination from the actual content of each message rather than by using a specified end-point reference.
Procedure
- Open the Recording Studio perspective.
- Create a recording monitor for the TCP traffic that you want to record.
- Start a recording session by clicking Start Recording () on the toolbar of the Events View window.
- In HCL Quality Server, open the Infrastructure Dashboard, expand the agent card, and from the Activities tab verify that recording has started.
- Wait for recorded events.
- Stop the recording session by clicking Pause recording () on the toolbar of the Events View window.