File System FTP Agent Settings

This dialog box enables you to configure the Service Virtualization File System FTP Agent. The agent handles communication between a client and a real or virtual service that are using messaging protocols over FTP.

To access
  1. From the main menu, select Tools > Options.
  2. Click Agents.
  3. Under File System - FTP, select a configuration or create a new one.
Important information
  • Each virtual service requires at least one agent configuration for input and one agent configuration for output.
  • Make sure you have entered the correct port number for the FTP server in the Port field.

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.
Location settings
Remote folder The remote root path for the agent. Define the location on the FTP server where the agent reads or writes files.
FTP Server The IP address or hostname of the FTP server.
Port The port number of the FTP server. By default, 21.
Type of Transport

Select a protocol:

  • FTP: No security.
  • FTPS: TLS/SSL security for FTP.
  • SFTP: SSH File Transfer Protocol.
Username Enter the user account name for connecting to the FTP server.
Password The user password for connecting to the FTP server.
Timeout The timeout length for all FTP commands.
Check interval The time interval at which the Service Virtualization agent checks the Remote folder location to read new or modified files.