Overview

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

Environment

FileCatalyst Hotfolder v3.4 and later.

Linux Environment.

Solaris Environment.

Resolution

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:
   
   ./fc_hotfolder_shutdown.sh
   
   
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:

./fc_hotfolder_console.sh

Standalone with GUI:

./fc_hotfolder.sh