Troubleshooting FTP Connector - Mule 4
To troubleshoot Anypoint Connector for FTP (FTP 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 FTP 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 FTP 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 FTP Connector and for the JSCH driver:
-
Access Anypoint Studio and navigate to the Package Explorer view.
-
Open your application’s project name.
-
Open the
src/main/resourcespath folder. -
Open the
log4j2.xmlfile inside the folder. -
If the following line is already in the
log4j2.xmlfile, uncomment it to enable it; otherwise, add it:<AsyncLogger name="org.mule.extension.ftp" level="TRACE"/> <AsyncLogger name="org.apache.commons.net" level="DEBUG"/> -
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 FTP server.
For additional information about enabling verbose logging for SDK components in your Mule application, see the troubleshoot SDK components documentation.
Understand Common Throws
Here is a list of common throw messages and how to interpret them.
-
FTP:ACCESS_DENIED
An FTP Connector operation attempted to access an FTP server path and performed an action for which the user does not have permission.
-
FTP:CONNECTIVITY
The connection to the FTP server was interrupted.
-
FTP:FILE_ALREADY_EXISTS
An attempt was made to create a file with the same location and name as an existing file.
-
FTP:FILE_LOCK
An attempt to lock a file was unsuccessful.
-
FTP:ILLEGAL_CONTENT
The Write operation received invalid content to write.
-
FTP:ILLEGAL_PATH
The specified path is invalid because, for example, it does not exist.
-
FTP:RETRY_EXHAUSTED
Retries of an execution block are exhausted.