TCP agent settings

This dialog box enables you to configure the Service Virtualization TCP agent. The agent handles communication between a client and a real or virtual service.

To access
  1. From the main menu, select Tools > Options.
  2. Click Agents.
  3. Under Fixed Length TCP, select a configuration.
Important information

You can define multiple configurations for each agent.

Relevant tasks
See also

Service Virtualization agents

User interface elements are described below (unlabeled elements are shown in angle brackets):

UI Element Description
<left pane>

Displays the server configured for your project.

Expand the server to display the available agents and configurations.


Enables you to define additional configurations of the agent.

Delete Deletes the selected configuration.

Creates an additional configuration of the agent by copying the selected configuration. You can then modify the configuration settings.

Note: By default, the configuration is created with a sequential unoccupied port number.


Saves the selected agent configuration as a file. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

Export All Exports all agent configurations on the selected server. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

Enables you to select an exported agent configuration file stored on the file system. The file is saved in the .agce file format, and can be imported to any Service Virtualization Server.

If the configuration file you are importing contains multiple configurations, you can select which configurations you want to import.

If you choose to import an agent configuration that is identical to a configuration that already exists on your server, you can choose to overwrite your existing configuration, or create a new, additional configuration.

Agent State The current status of the agent. Values include Running, Not Running.
Test Configuration link Tests the configuration based on the settings you select. If Service Virtualization identifies any problems in your configuration, the details are displayed.

Is Enabled

Turns the agent on and off.
Name Enter a name for the configuration or accept the default name.
Host The hostname or IP address of the Service Virtualization Server where the agent is deployed.

The port of the Service Virtualization Server used by the agent to deploy virtual services.

Remote Host The hostname or IP address of the real service.
Remote Port The remote port of the real service.
Use SSL Enables SSL over TCP/IP. If enabled, you must provide the certificate file and password details.
Certificate File

The path to the server side certificate file, in P12 format, that is to be used by the gateway agent during an SSL handshake.

The certificate is used as the server certificate on the listening port if the Use SSL option is enabled. It is bound to the port during startup of the agent.

Note: When remotely configuring a Service Virtualization Server's agent from the Designer, make sure that the path to the certificate is valid on the server machine on which the agent will run.

If the Certificate File field is left empty and the Use SSL option is selected, then the agent will use the certificate bound to the specified port in Windows.

Certificate Password The password used to access the certificate file specified in the Certificate File field.

Back to top