How to Upgrade FileCatalyst HotFolder on Linux or Solaris
Posted by , Last modified by Aly Essa on 04 August 2016 12:40 PM


This article describes how to upgrade an existing FileCatalyst HotFolder installation on Linux or Solaris, using the command line.



FileCatalyst Hotfolder v3.4 and later.

Linux Environment.

Solaris Environment.



  1. Navigate to the install directory of the FileCatalyst Hotfolder. This may vary depending on your installation details. For this article we will reference the path /opt/utechsoft/hotfolder/.
    All commands listed from this point forward are assumed to be run from the install directory, using the user which runs the application typically it is root.

  2. Shutdown the FileCatalyst HotFolder.

    If it is running as a service run the following command:

    service fchotfolder stop

    If running standalone, run the following command:


  3. Make sure the service is really down. Perform a kill based on its Process ID (PID) it if it's not. Run the following command to verify that there is no PID registered:

    ps –ef | grep java
  4. Backup all important files and configurations:

    mkdir ./upgrade
    cp fchf.conf ./upgrade/fchf.conf
    cp sites.xml ./upgrade/sites.xml
    cp hotfolders.xml ./upgrade/hotfolders.xml 
    cp schedule.xml ./upgrade/schedule.xml
    cp bandwidth.xml ./upgrade/bandwidth.xml
    cp *.sh ./upgrade/
    cp *.jar ./upgrade/
    cp *.zip ./upgrade/
    cp –R help ./upgrade/
    cp –R images ./upgrade/
    cp –R service_wrapper ./upgrade/

  5. If at any point you need to rollback, move these files from the upgrade directory back down to the installation directory. This should roll back any modifications.

    cp –R ./upgrade/* .
  6. Download the new build to /opt/utechsoft/hotfolder/.

  7. Unpack the archive with the following commands:

    gunzip fc_hotfolder.tar.gz
    tar –xvf fc_hotfolder.tar

  8. Change file permissions to allow scripts to execute. Enter this command:

    chmod u+x *.sh

  9. Restore your configurations with these commands:

    cp ./upgrade/fchf.conf .
    cp ./upgrade/schedule.xml .
    cp ./upgrade/sites.xml .
    cp ./upgrade/hotfolders.xml .
    cp ./upgrade/bandwidth.xml .
    cp –R ./upgrade/service_wrapper ./service_wrapper

  10. Start HotFolder.  This step may be different depending on whether you are running as a service or running standalone.

    If running as a service run the following command:

    service fchotfolder start

If running standalone, run the following command:


Standalone with GUI: