Recording TCP traffic

The enables Test Integrations and APIs 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

  1. In Test Integrations and APIs, create the required physical TCP server resource and logical TCP connection in your project. Completing this task enables Test Integrations and APIs 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.
  2. Ensure that your Test Integrations and APIs project is connected to a valid instance of Test Virtualization Control Panel. Completing this task enables Test Integrations and APIs 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 Test Virtualization Control Panel 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 Test Integrations and APIs project administrator.
  3. 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 Test Virtualization Control Panel administrator. Recording occurs within a domain and the HTTP/TCP proxy can be registered with all domains or a single domain in the Test Virtualization Control Panel instance that you are using. Therefore, selecting a domain in Test Integrations and APIs enables the application to record TCP transport traffic.
    Note: If you are using Test Virtualization Control Panel 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.
  4. Install and configure the HTTP/TCP proxy and ensure that the hostname 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 Test Integrations and APIs to record TCP transport traffic.

About this task

The Test Integrations and APIs 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

  1. Open the Recording Studio perspective.
  2. Create a recording monitor for the TCP traffic that you want to record.
  3. Start a recording session by clicking Start Recording (Start Recording) on the toolbar of the Events View window.
  4. In Test Virtualization Control Panel, open the Infrastructure Dashboard, expand the agent card, and from the Activities tab verify that recording has started.
  5. Wait for recorded events.
  6. Stop the recording session by clicking Pause recording (Pause recording) on the toolbar of the Events View window.

What to do next

After you finish recording, you can highlight one or more individual events. Click Save Events to create resources such as tests, stubs, and test data sets. For more information, see Creating an operation from recorded events, Creating tests from recorded events, and the Stub creation by using the Recording Studio for creating stubs.