Troubleshooting File Connector - Mule 4
To troubleshoot Anypoint Connector for File (File 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 File system.
To resolve this error:
-
Use the configuration file to increase the logging level on the server side.
-
Try to replicate the issue using a File 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 File 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.file” level=“TRACE”/> -
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 File system.
For additional information about enabling verbose logging for SDK components in your Mule application, see the Troubleshooting SDK components documentation.
Troubleshooting Out Of Memory with Repeatable File Store Iterable
In some cases where the file folder contains large files, and you set the Streaming strategy field to the Repeatable file store iterable (Default) option for the List operation, the Mule application might throw a java.lang.OutOfMemoryError message.
To avoid this issue, set the Streaming strategy field from Repeatable file store iterable (Default) to the No repeatable iterable option.
For additional information about repeatable file store, refer to Repeatable File Store.
For additional information about disabling repeatable streaming, refer to Disable repeatable streaming.
Understand Common Throws
Here is a list of common throw messages and how to interpret them:
-
FILE:CONNECTIVITY
The connection to the file server is no longer valid. Apply a reconnection policy if defined in the application setup.
-
FILE:ILLEGAL_PATH
The createParentDirectories property is set to false and neither the target path nor its parent exists.
-
FILE:FILE_ALREADY_EXISTS
The target file already exists and the overwrite property is set to false.
-
FILE:RETRY_EXHAUSTED
The maximum number of retries for the operation is reached.
-
FILE:ACCESS_DENIED
A File Connector operation attempted to access a file or a path and performed an action for which the user does not have permission.
-
FILE:FILE_LOCK
An attempt to lock a file was unsuccessful.
-
FILE:ILLEGAL_CONTENT
The Write operation received invalid content to write.