Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

BIXFTPListener fails to send a file



BIXFTPListener fails to send a file. However, test connections to a local FTP site from the cloud work fine.

Error Messages

[FILE-Thread-372] [STANDARD] [  ] [  ] (services.file.FileActionImpl) ERROR File.BIXFTPListener|AEYNBHR0HMM3Z0S1AH8ASIFRHHQ06LU4E|-1836961034.1540413184664000 admin - Caught throwable processing FTP Connection failed
Caused by: com.pega.pegarules.integration.engine.external.client.ftp.PegaFTPClient$FTPBadReplyException: Permission denied

Steps to Reproduce


Root Cause

An issue in the custom application code or rules.
According to the FTP server administrator, the directory to be written to was incorrect. Hence, permission denied errors were generated in the logs. This was controlled by the ftpRelativeRemotePath Dynamic System Setting (DSS) which was owned by the Pega-RULES RuleSet. This path was relative to the FTP user home directory.


Perform the following local-change:

Adjust the ftpRelativeRemotePath value.

For example,

When the users home directory is '/Usr/Home', the directory to write to is '/Usr/Home/Dir1/Dir2'. Configure the ftpRelativeRemotePath to 'Dir1/Dir2'.


Published January 17, 2019 - Updated December 2, 2021

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us