Upgrade FileCatalyst Server on Linux or Solaris
Posted by Greg Pettit, Last modified by Aly Essa on 11 April 2018 03:04 PM


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



FileCatalyst Server v3.4 and later.

Linux Environment.

Solaris Environment.



  1. Navigate to the install directory of the FileCatalyst Server. This may vary depending on your installation details. For this article we will reference the path /opt/utechsoft/server/.
    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 Server.

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

    service fcserver 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 fcconf.conf ./upgrade/fcconf.conf
    cp ipfilters.xml ./upgrade/ipfilters.xml 
    cp -R .fcdb/ ./upgrade/.fcdb/
    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/server/.

  7. Unpack the archive with the following commands:

    gunzip fc_server.tar.gz
    tar –xvf fc_server.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/fcconf.conf .
    cp ./upgrade/ipfilters.xml .
    cp -R ./upgrade/.fcdb .
    cp –R ./upgrade/service_wrapper ./service_wrapper

  10. Start the FileCatalyst Server.  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 fcserver start

    If running standalone, run the following command:


    Standalone with GUI: