Page tree
Skip to end of metadata
Go to start of metadata

The file transfer process defines how data files are imported and exported to/from your BMC Helix environments. An example of incoming information includes initial and ongoing data loading of people, asset, and related data. Examples of outgoing information include reports and application debug logs. Additionally, Smart Reporting can be configured to write reports directly to the SFTP server account.

The file transfer service outlines the procedures for information delivery in both directions. This topic contains the following information:

File transfer workflow

To facilitate data in and out of your environments, customers are provided distinct and separate accounts for each destination environment (for example, production, QA, and development) on the BMC-hosted SFTP servers. Within each account are separate directories for inbound and outbound transfers. For inbound transfers, customers should upload data to the ToOnDemand directory. Likewise, for outbound transfers, customers can download data from the FromOnDemand directory. When configuring your data transfer, use the following directory paths: 

Receiving data into BMC Helix ITSM: /opt/bmc/ars/data/ToOnDemand

Sending data from BMC Helix ITSM: /opt/bmc/ars/data/FromOnDemand


Design and development of the transfer job is the sole responsibility of the customer. If development assistance is needed, you may consult with BMC Global Services or a trusted partner.

Incoming data loading process

In order to deliver data to the BMC cloud for import into a BMC Helix environment, the file transfer service should be utilized by first uploading the desired data to the designated environment's FTP account using the specific environment account information provided. Once logged in to the FTP server, files should be placed in the ToOnDemand directory. From this location, the data is available for consumption by any import process within the application. To import files from the FTP server into the BMC Helix container, add the following step at the beginning of the Pentaho job definition: 

get a file with FTP

Outgoing information delivery process

For information received from a BMC Helix environment, the reverse process is very similar. Depending on your use case, the application should be configured to write data directly to the specific environment FTP account for the file transfer service. Outgoing data should be placed into the FromOnDemand directory. From this location and path, customers can download their data as needed. 

To export files from the BMC Helix container, add the following step to the Pentaho job definition: 

put a file with FTP

File retention

Files will remain in the FromOnDemand and ToOnDemand directories for no more than seven days. If you have implemented a move process that transfers the file from the ToOnDemand directory to a cloud server, the file will no longer be present upon job execution. Conversely, if you have downloaded a file from the FromOnDemand directory to your local machine, the file will no longer be present once that download is complete.

Supported file transfer standards

BMC supports a variety of protocols to allow maximum flexibility for customer connections utilizing the file transfer service. Both encrypted and unencrypted connections and transfers are supported, however encryption is strongly recommended. For transfers using the FTP protocol, plain FTP and FTPS using Explicit SSL are both supported using passive mode only. File transfers using SFTP are also supported. User/password authentication for all protocols as well as key authentication for SFTP are supported. Port requirements are listed below.


Systems hosted in an AWS location support SFTP only.

Required ports

Ports used for the file transfer process include:

  • FTP – TCP 21 for control channel
  • FTP – TCP 32000-40000 for passive port range (data channel)
  • SFTP – TCP 22

Related topic

Pentaho Community Wiki - Spoon User Guide


  1. Martha Mulvaney, In containers MFT will not transfer the data automatically to containers, Please make the necessary changes and refer the below link provided by R&D. 

    .Remedy containers: Transferring files v18.08.01

    Sirisha Dabiru, please assist here. we need to send the updated link to Customers.




  2. Martha Mulvaney Siddharth Kamble Sirisha Dabiru

    The link provided isn't accessible ".Remedy containers: Transferring files v18.08.01"

    Can you provide an updated link/updated procedure on how MFT works?

    Do I understand correctly the MFT service is seen as an FTP(S) server that from customer side?

    Best regards,


    1. The link in the comments is not available externally . The content of that link is stated on this page however, with the instruction to use the Get and Put FTP commands in the Pentaho job. 

      Yes, the service is seen as an FTPs server.

    • There is no sync job between FTP and Helix ARS server anymore.
    • AI job needs to be used to transfer files from FTP to Helix ARS server
    • After downloading a file from FTP (fromondemand folder) to a local machine it still persists on the FTP and is not getting deleted as mentioned.