---
schema_version: "1"
id: ef5eebf18396e9572bd53eb7cece2ce9fb628e33b77ad3cba36a0ed9c3911867
title: Troubleshoot FTPS Connector
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/ftps-connector/latest/ftps-troubleshooting.md
canonical_url: https://docs.mulesoft.com/ftps-connector/latest/ftps-troubleshooting
source_site: docs.mulesoft.com
content_type: documentation
content_hash: aae3c1cbf237852e193b637f69a746c6d61c2f9fd24ff3e65fc2e26bc27ba191
description: MuleSoft Documentation Site
release: "2.1"
latest: true
---
---
product: FTPS Connector
version: 2.1
is-latest-version: true
---

# Troubleshoot FTPS Connector

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

To troubleshoot Anypoint Connector for FTPs (FTPS Connector), become familiar with the information
about troubleshooting Mule application issues.

## Troubleshoot Mule Application Issues

Sometimes you are not sure why the application is failing and you require a better understanding of
what is going on in the app’s interaction with the FTPS server.

To resolve this error:

- Use the configuration file to increase the logging level on the server side.

- Try to replicate the issue using an FTPS client, for example, Cyberduck or Filezilla. If the issue
  also occurs with these clients, then it is likely that the issue is not related to the Mule app.

- Get better and more detailed logs on the Mule app side by enabling verbose logging for FTPS
  Connector and for the JSCH driver:

  1.  Access Anypoint Studio and navigate to the **Package Explorer** view.

  2.  Open your application’s project name.

  3.  Open the `src/main/resources` path folder.

  4.  Open the `log4j2.xml` file inside the folder.

  5.  If the following line is already in the `log4j2.xml` file, uncomment it to enable it;
      otherwise, add it:

      ```xml
        <AsyncLogger name=“org.mule.extension.ftp” level=“TRACE”/>
        <AsyncLogger name=“org.apache.commons.net” level=“DEBUG”/>
      ```

  6.  Add the following argument to your run configuration:

      \`-M-Djavax.net.debug=ssl,handshake\`

- Try to minimize or remove unnecessary DataWeave data transformations (you could even use hard
  coded data) to minimize the app’s complexity and determine whether the issue is with the
  interaction between the app and the FTPS server.

For additional information about enabling verbose logging for SDK components in your Mule
application, see the [troubleshoot SDK components](https://docs.mulesoft.com/mule-sdk/latest/troubleshooting)
documentation.

## Handle FTPS Session Reuse Errors

When you use FTPS Connector, connection issues can occur during session reuse, such as a
`SocketTimeoutException` error during data connection. To resolve this, include this JVM system
property in your runtime configuration:

`-Dorg.apache.commons.net.ftp.ipAddressFromPasvResponse=true`

> [!NOTE] This setting ensures the IP address from the PASV response is used during data transfer.
> However, enabling this flag exposes your application to potential security vulnerabilities if the
> PASV response is spoofed or manipulated. Use this setting with caution, especially in untrusted
> network environments.

## Understand Common Throws

Here is a list of common throws messages and how to interpret them.

- FTPS:ACCESS\_DENIED

An FTPS Connector operation attempted to access an FTPS server path and performed an action for
which the user has not been granted permission.

- FTPS:CONNECTIVITY

The connection to the FTPS server was interrupted.

- FTPS:FILE\_ALREADY\_EXISTS

An attempt was made to create a file with the same location and name as an existing file.

- FTPS:FILE\_LOCK

An operation made an unsuccessful attempt to acquire a lock over a file.

- FTPS:ILLEGAL\_CONTENT

The **Write** operation received invalid content to write.

- FTPS:ILLEGAL\_PATH

The specified path is invalid because, for example, it does not exist.

- FTPS:RETRY\_EXHAUSTED

Retries of a certain execution block are exhausted.

## See Also

- [MuleSoft Help Center](https://help.mulesoft.com)

- [FTPS Connector Reference](https://docs.mulesoft.com/ftps-connector/latest/ftps-documentation)