Overview

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

Environment

FileCatalyst Server v3.4 and later.

Linux Environment.

Solaris Environment.

Resolution

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:
   
   ./fc_server_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 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:
    
    ./fc_server_console.sh
    
    Standalone with GUI:
    
    ./fc_server.sh