Knowledgebase:
TransferAgent Proxy Configuration
Posted by Aly Essa, Last modified by Aly Essa on 01 April 2020 01:21 PM

Overview

In today's networking environments, particularly corporate ones, application developers have to deal with proxies almost as often as system administrators. In some cases these proxies may require you to configure connection properties in TransferAgent to connect using these proxies. You can establish the following system properties within TransferAgent:

SOCKS Proxy Properties:
  • socksProxyHost: Host connection information of the SOCKS Proxy Server
  • socksProxyPort: Port number of the SOCKS Proxy Server. The default value is 1080.
HTTP Proxy Properties:
  • http.proxyHost: The hostname of the proxy server
  • http.proxyPort: Port number of the proxy server. The default value is 80.
  • http.nonProxyHosts: A list of hosts that should be reached directly, bypassing the proxy. This is a list of patterns separated by a '|' character. The patterns may start or end with a '*' for wildcards. Any host matching one of these patterns will be reached through a direct connection instead of through a proxy.
HTTPS Proxy Properties:
  • https.proxyHost: The host information for the HTTPs proxy Server
  • https.proxyPort: This port information for the proxy. The default value for 443.

Environment

FileCatalyst TransferAgent v3.7.3 and newer

Resolution

How to add system properties to TransferAgent:

To add system properties to TransferAgent configuration, perform one of the following processes:

Process 1: Adding system properties through the TransferAgent web interface
  1. Ensure that TransferAgent is installed on your computer.
  2. Launch the application and wait for the TransferAgent icon to appear.
  3. Right-click on the system tray icon for TransferAgent and select Open Configuration.
  4. In the browser window select the System Properties tab.
  5. Add the system property names and values for the proxy that you will be connecting through.
Process 2: Adding system properties through the TransferAgent configuration files
  • Close any existing TransferAgent instances that may be running on your computer.
  • Navigate to the TransferAgent install directory and find the fcta.conf configuration file.
    1. Note 1: If you are running TransferAgent as a user-level application on Windows, you may find this file in the user home directory under AppData/Local/FileCatalyst/FileCatalyst TransferAgent
    • Note 2: If you are running on macOS X, you will find this file located in the user home directory under Library/Application Support/FileCatalyst/TransferAgent/
      1. Open the configuration file with your text editor of choice.
      2. At the bottom of the file specify the system properties that you need by prefixing the property with the "system.property." prefix.

        • Example: If you wish to set the SOCKS proxy information, you would specify the property:
          system.property.socksProxyHost=10.10.10.10
          system.property.socksProxyPort=1080

      3. Once all properties have been set, save your changes and start the TransferAgent application.